felixlohmeier
/
seminar-praxis-der-digitalen-bibliothek
mirror of https://github.com/felixlohmeier/seminar-praxis-der-digitalen-bibliothek.git
2
0
Fork 0
Code Releases Activity

Überarbeitung Installation TYPO3-find in Kapitel 4

This commit is contained in:
Felix Lohmeier 2017-05-12 00:49:48 +02:00
parent c6beec4e1e
commit 5972b3fdc3
5 changed files with 47 additions and 67 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
3-2-3-tsv-dateien-in-solr-laden.md
View File

@ -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.

36
4-1-1-installation-von-typo3.md
View File

@ -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 "<VirtualHost *:80>
DocumentRoot /var/www/katalog/web
ServerName katalog
Options -Indexes
DirectoryIndex index.php index.html
</VirtualHost>" > /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.```

68
4-1-2-erweiterung-typo3-find-installieren.md
View File

@ -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.

6
4-1-3-typo3-find-anpassen.md
View File

@ -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```.

2
5-0-erweiterungsmoeglichkeiten.md
View File

@ -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:
* [...]()
* [...]()