Dies ist der erste Artikel in der Serie TYPOlight Tutorials. Im Artikel “Mehrsprachige Seiten mit TYPOlight” hatte ich zwar bereits das Thema angerissen, dennoch gehe ich hier nochmal auf die Installation von TYPOlight ein. Zudem zeige ich, wie man eine bestehende Installation manuell aktualisiert.
In diesem Teil und den anderen Teilen der Serie nehme ich an, dass die Domain example.org lautet und das CMS direkt über diese Domain erreichbar sein soll. Möchte man TYPOlight in einem Unterverzeichnis betreiben – zum Beispiel example.org/cms/ – sind die Pfade natürlich entsprechend anzupassen.
Installation
Für TYPOlight müssen folgende Systembedingungen erfüllt sein:
- Apache Webserver oder IIS. Apache wird empfohlen.
- PHP in der Version 5.1 oder höher
- MySQL in Version 4.1 oder höher
- GDLib
- mcrypt (optional)
Zuerst laden wir uns TYPOlight von der Projektseite herunter, entpacken das Archiv und laden die Dateien auf unserem Server oder Webspace. Anschließend überprüfen wir, ob die Datei system/config/localconfig.php beschreibbar ist, sonst bekommen wir einen entsprechenden Hinweis bei der Installation. TYPOlight wird während der Installation versuchen, in die Datei zu schreiben.
Sollte noch keine Datenbank angelegt sein, holen wir das nun nach. Als nächstes rufen wir das Installtool auf, welches sich unter http://example.org/typolight/install.php befindet. Bei der Erstinstallation lautet das Passwort, nach dem wir gefragt werden, “typolight”.
Anschließend kann und sollte das Passwort für spätere Aufrufe – zum Beispiel für Updates – geändert werden. Als nächstes geben wir einen Encryption Key ein oder lassen es uns direkt generieren, indem wir das Feld einfach leer lassen. Mit diesem Schlüssel können Daten in verschlüsselter Form gespeichert werden. Den Hinweis, dass wir uns den Key notieren und – sofern es verschlüsselte Daten gibt – in Zukunft nicht ändern sollen beherzigen wir.
Nun geben wir die Daten für die Datenbankverbindung ein und führen im nächsten Schritt das Update auf die Datenbank aus. Dabei werden alle Tabellen für unsere TYPOlight-Installation angelegt.
Anschließend kann man eine Beispielwebsite importieren. Davon sehen wir aber ab und legen in einem der nächsten Teile dieser Serie die Seitenstruktur nach unseren Bedürfnissen an. Zu guter Letzt legen wir jetzt noch unseren Adminuser an.
Updates
Die Prozedur für Updates ist ähnlich einer Installation. Grundsätzlich sollte man vor einem Update eine Sicherung seiner Daten vornehmen. Darunter fallen die Dateien im Verzeichnis tl_files, templates sowie die Dateien system/config/localconfig.php, system/config/dcaconfig.php und – falls vorhanden – sitemap*.xml. Auch sollte man die Hinweise in der Datei CHANGELOG.txt beachten. Beispielsweise war beim Update auf Version 2.6.4 eine Änderung am Template fe_page notwendig.
Als nächstes laden wir uns die aktuelle Version von TYPOlight herunter, entpacken die Dateien und laden sie auf den Server. Bis auf die oben genannten Dateien können wir die bestehenden überschreiben. Anschließend rufen wir wieder unser Installtool unter http://example.org/typolight/install.php auf.
Hier geben wir das Passwort ein, dass wir bei der Installation vergeben haben. Wir brauchen im Grunde nur den Anweisungen des Tools folgen. Alle Daten, die bereits bei der Installation angegeben wurden, stehen uns direkt zur Verfügung. In einigen Fällen ist ein Update der Datenbank erforderlich. Nur noch auf den Button “Update database” klicken, das war es auch schon.
Wer das Nachrichtenmodul nutzt, sollte anschließend dieses Modul im Backend aufrufen, damit der Nachrichtenfeed wieder generiert wird.
Schlusswort
Wie man sieht ist sowohl die Installation als auch das Aktualisieren von TYPOlight recht einfach. Sollte es doch einmal irgendwo hapern, lohnt sich oft ein Blick in die Dokumentation und dem Forum auf der Projektseite.
Ein Kommentar zu “TYPOlight Tutorial #1: Installation und Updates”