diff --git a/3-2-3-tsv-dateien-in-solr-laden.md b/3-2-3-tsv-dateien-in-solr-laden.md index f80aede..26bf477 100644 --- a/3-2-3-tsv-dateien-in-solr-laden.md +++ b/3-2-3-tsv-dateien-in-solr-laden.md @@ -30,7 +30,7 @@ Rufen Sie die Browsing-Oberfläche auf (http://localhost:8983/solr/gettingstarte Solr wurde als Prozess gestartet, der bis zum nächsten Neustart des Rechners weiterläuft. Sie können Solr jederzeit manuell beenden und starten: * Solr beenden:```~/solr-6.5.0/bin/solr stop``` -* Solr starten:```~/solr-6.5.0/bin/solr start -s /solr-6.5.0/example/schemaless/solr``` +* Solr starten:```~/solr-6.5.0/bin/solr start -s ~/solr-6.5.0/example/schemaless/solr``` Etwa 15-30 Sekunden nach dem Startbefehl sollte die Administrations- und die Browsingoberfläche unter den gewohnten Adressen erreichbar sein. diff --git a/4-1-1-installation-von-typo3.md b/4-1-1-installation-von-typo3.md index d4181da..78ce144 100644 --- a/4-1-1-installation-von-typo3.md +++ b/4-1-1-installation-von-typo3.md @@ -2,10 +2,10 @@ Für Ubuntu gibt es derzeit kein Installationspaket, daher müssen wir die für TYPO3 benötigten Komponenten (Webserver, Datenbank, PHP) manuell installieren. -## Benötigte Pakete (Apache, MySQL, PHP) installieren +## Benötigte Pakete (Apache, MySQL, PHP, Composer) installieren ``` -sudo apt-get install apache2 libapache2-mod-php7.0 php7.0 php7.0-mysql mysql-server php-gd php-json php-imagick php-mbstring php-curl php-apcu php-soap php-xml php-zip +sudo apt-get install apache2 libapache2-mod-php7.0 php7.0 php7.0-mysql mysql-server php-gd php-json php-imagick php-mbstring php-curl php-apcu php-soap php-xml php-zip composer ``` Während der Installation müssen Sie ein Root-Passwort für MySQL vergeben. Denken Sie sich eins aus und notieren Sie dies. @@ -38,23 +38,27 @@ Abschließend ist ein Neustart des Webservers erforderlich: sudo /etc/init.d/apache2 restart ``` -## TYPO3 installieren +## TYPO3 mit Composer installieren -Geben Sie folgende Befehle ins Terminal ein, um die neueste Version von TYPO3 7 zu installieren. +Wir nutzen eine [Distribution von Cedric Ziel](https://github.com/cedricziel/typo3-find-distribution), die TYPO3 und die Erweiterung TYPO3-find beinhaltet. Die Installation erfolgt mit Hilfe des Tools Composer, das wir im ersten Schritt zusammen mit den anderen Paketen installiert haben. + +Geben Sie folgende Befehle ins Terminal ein: ``` cd /var/www/ -sudo wget get.typo3.org/7 --content-disposition -sudo tar xzf typo3_src-7* -sudo rm -f typo3_src-7*.tar.gz -sudo chown root:www-data -R html -sudo chmod 775 html -cd html -sudo ln -s $(find .. -name typo3_* -type d) typo3_src -sudo ln -s typo3_src/typo3 typo3 -sudo ln -s typo3_src/index.php index.php -sudo rm index.html -sudo touch FIRST_INSTALL +sudo composer create-project cedricziel/typo3-find-distribution katalog dev-master +cd katalog +sudo chown www-data:www-data -R web +sudo touch web/FIRST_INSTALL +sudo sh -c 'echo " + DocumentRoot /var/www/katalog/web + ServerName katalog + Options -Indexes + DirectoryIndex index.php index.html +" > /etc/apache2/sites-available/katalog.conf' +sudo a2ensite katalog.conf +sudo a2dissite 000-default.conf +sudo service apache2 reload ``` ## Konfiguration von TYPO3 mit dem Installationsassistent @@ -63,4 +67,4 @@ Nach der Installation erreichen Sie TYPO3 unter der Adresse http://localhost. Do * In Schritt 2 muss als Username ```typo3_db_user``` und das von Ihnen für den Nutzer typo3_db_user gesetzte Passwort (secretpassword) eingetragen werden. * In Schritt 3 wählen Sie "use an existing empty database" * In Schritt 4 müssen Sie einen weiteren Account anlegen, diesmal für die Administration von TYPO3. Notieren Sie sich Benutzername und Passwort. -* Wählen Sie in Schritt 5 die Option ```Yes, download the list of distributions.``` und installieren Sie nach dem Login das Paket ```The official Introduction Package``` +* Wählen Sie in Schritt 5 die Option ```Yes, create a base empty page to start from.``` diff --git a/4-1-2-erweiterung-typo3-find-installieren.md b/4-1-2-erweiterung-typo3-find-installieren.md index e659a15..7ec5ce2 100644 --- a/4-1-2-erweiterung-typo3-find-installieren.md +++ b/4-1-2-erweiterung-typo3-find-installieren.md @@ -1,63 +1,33 @@ # 4.1.2 Erweiterung TYPO3-find installieren -Normalerweise können Erweiterungen für TYPO3 ganz einfach über die Administrationsoberfläche installiert werden, so wie bei einem App Store. Die EntwicklerInnen legen ihre Erweiterungen dazu im offiziellen TYPO3 Extension Repository ab. Leider ist zum Zeitpunkt der Erstellung des Skripts (April 2017) von der Erweiterung TYPO3-find nur eine uralte Version im Extension Repository verfügbar. Dort liegt Version 1.0.1 (Nov 2013), während bei GitHub Version 3.0.0 (Jan 2017) zur Verfügung steht. - -## Schritt 1: Installation von TYPO3-find aus Quellcode bei GitHub - -Wir installieren den Code aus dem GitHub-Repository https://github.com/subugoe/typo3-find - -### 1.1 Code aus GitHub Repository herunterladen - +Bevor wir die Erweiterung TYPO3-find installieren und konfigurieren, starten wir zunächst erneut den Suchindex Solr (vgl. Kapitel 3.2.3): ``` -cd ~ -wget https://github.com/subugoe/typo3-find/archive/3.0.0.zip -unzip 3.0.0.zip -cd typo3-find-3.0.0 +~/solr-6.5.0/bin/solr start -s ~/solr-6.5.0/example/schemaless/solr ``` -### 1.2 Abhängigkeiten der TYPO3-Erweiterung mit Composer nachladen +Die Administrationsoberfläche von TYPO3 ist unter folgender URL verfügbar: http://localhost/typo3/. -``` -php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" -php -r "if (hash_file('SHA384', 'composer-setup.php') === '669656bab3166a7aff8a7506b8cb2d1c292f042046c5a994c43155c0be6190fa0355160742ab2e1c88d40d5be660b410') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" -php composer-setup.php -php -r "unlink('composer-setup.php');" -php composer.phar install -``` +## 1. Menü Extensions -### 1.3 Daten in Extension-Verzeichnis kopieren +* In der Liste neben dem Eintrag ```Find``` auf den Würfel klicken, um die Extension zu aktivieren -``` -sudo mkdir /var/www/html/typo3/ext -sudo cp -r . /var/www/html/typo3/ext/find -sudo chown www-data:www-data /var/www/html/typo3/ext/find -``` +## 2. Menü Page -## Schritt 2: Extension in Administrationsoberfläche aktivieren +* Seite ```Home``` auswählen +* Button +Content in Spalte "Normal" drücken und im Reiter ```Plugins``` das Plugin ```TYPO3 Find``` auswählen +* Oben den Save-Button betätigen. -Login in Administrationsoberfläche unter http://localhost/typo3 (localhost durch IP-Adresse ersetzen) - -### 2.1 Menü Extensions - -* Neben Extension ```Find``` auf den Würfel klicken, um die Extension zu aktivieren - -### 2.2 Menü Page - -* Seite auswählen, auf welcher der Katalog eingefügt werden soll, hier ```Congratulations``` (Startseite) -* Folgende Kästen löschen (Mülleimer-Symbol): "Start browsing", "Example Pages", "Test the CMS", "Make it your own" -* Button +Content in Spalte "Normal" drücken und im Reiter ```Plugins / General Plugin``` auswählen -* Im Reiter Plugin unter ```Selected Plugin``` die Erweiterung ```Find``` auswählen, die Abfrage mit OK bestätigen und anschließend oben den Save-Button betätigen. - -### 2.3 Menü Template +## 3. Menü List * Gleiche Seite auswählen, auf der vorhin das Plugin eingefügt wurde (müsste noch vorausgewählt sein) -* Im Pulldown oben ```Info/Modify``` auswählen -* Button ```Edit the whole template record``` -* Reiter ```Includes```: Rechts bei ```available items``` die Option ```Find (find)``` anklicken -* Oben den Save-Button betätigen -* Reiter ```General```: In Textfeld ```Setup``` Folgendes einfügen - +* Das Template ```Main TypoScript Rendering``` bearbeiten +* Reiter ```General```: In Textfeld ```Setup``` den vorhandenen Inhalt durch Folgendes ersetzen ``` +page = PAGE +page.100 < styles.content.get +page.javascriptLibs.jQuery = 1 +page.includeJS.find = EXT:find/Resources/Public/JavaScript/find.js +plugin.tx_find.features.requireCHashArgumentForActionArguments = 0 plugin.tx_find.settings { connections { default { @@ -86,3 +56,7 @@ plugin.tx_find.settings { } } ``` +* Reiter ```Includes```: Rechts bei ```available items``` das Item ```Find (find)``` anklicken. +* Oben den Save-Button betätigen + +Rufen Sie anschließend die Webseite http://localhost auf. Der Katalog sollte erscheinen. diff --git a/4-1-3-typo3-find-anpassen.md b/4-1-3-typo3-find-anpassen.md index e1519d3..522e4b7 100644 --- a/4-1-3-typo3-find-anpassen.md +++ b/4-1-3-typo3-find-anpassen.md @@ -1,6 +1,6 @@ # 4.1.3 TYPO3-find anpassen -Über die Setup-Datei (vgl. den letzten Schritt aus Kapitel 9.3) kann die Erweiterung TYPO3-find konfiguriert werden. +Über das Template im Textfeld ```Setup``` (vgl. den letzten Schritt aus dem vorigen Kapitel) kann TYPO3-find konfiguriert werden. ## Aufgabe: Ergänzen Sie eine weitere Facette @@ -51,4 +51,6 @@ plugin.tx_find.settings { ## Bonus: Darstellung der Trefferliste und Detailseite anpassen -Für die Anpassung der Detailseiten müssen gemäß der Dokumentation von TYPO3-find die Dateien ```Result.html``` und ```Detail.html``` im Ordner ```Resources/Private/Partials/Display/``` bearbeitet werden. +Für die Anpassung der Detailseiten müssen gemäß der Dokumentation von TYPO3-find die Dateien ```Result.html``` und ```Detail.html``` im Ordner ```Resources/Private/Partials/Display/``` der Extension bearbeitet werden. + +Die Dateien liegen bei unserer Installation im Ordner ```/var/www/katalog/web/typo3conf/ext/find/Resources/Private/Partials/Display```. diff --git a/5-0-erweiterungsmoeglichkeiten.md b/5-0-erweiterungsmoeglichkeiten.md index cb81729..f677276 100644 --- a/5-0-erweiterungsmoeglichkeiten.md +++ b/5-0-erweiterungsmoeglichkeiten.md @@ -2,7 +2,7 @@ Ziel: ... -Bitte nehmen Sie sich für die folgenden Abschnitte insgesamt etwa 4 Stunden Zeit: +Bitte nehmen Sie sich für die folgenden Abschnitte insgesamt etwa 8 Stunden Zeit: * [...]() * [...]()