Installation
Aus Contao Community Documentation
Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.
Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis. |
Die hier angeführte Anleitung beschreibt die Standard-Vorgehensweise zur Installation von Contao. Speziell benötigte Anpassungen zu den einzelnen Webhostern bzw Hoster-spezifische Installationsanleitungen ist auf der Seite Webhoster zu finden.
Inhaltsverzeichnis
- 1 Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster
- 2 Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster
Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster
- Download des Contao-Cores auf contao.org bzw. Sourceforge
- Entpacken auf dem Heimrechner
- Hochladen der Dateien mittles FTP auf Ihren Server
- Hochladen des Systemdiagnosetools ins Verzeichnis der Contao-Installation (gewöhnlicherweise das Root-Verzeichnis Ihrer Webadresse)
- Aufrufen der Diagnosedatei in der Adresszeile Ihres Browsers und eventuelle Fehlermeldungen beseitigen
- Aufrufen der Installationsdatei: www.IhreDomain.com/contao/install.php (ersetzen Sie "www.IhreDomain.com" mit Ihrer tatsächlichen Webadresse; in diesem Fall ist Contao im Rootverzeichnis Ihres Webservers installiert; der Zugang zum BackEnd (BE) liegt im Unterverzeichnis "contao/")
- Das Installationsskript führt Sie durch die abschließenden Schritte (die erforderlichen Daten zur Datenbank erhalten Sie von Ihrem Webhoster)
- Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")
Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster
Download von Contao und entpacken auf dem Heimrechner
Auf www.contao.org begibt man sich auf den Bereich Herunterladen und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
Anmerkung: Contao wird in zwei unterschiedlichen Archivformaten angeboten. pkzip (Zip-Archiv) und tar.gz (gzipped Tarball). Sollten man einen Windows PC verwenden, sollte die pkzip Version verwendet werden. |
Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. 7-zip, welches nahezu alle gängigen Archivformate beherrscht.
FTP-Programm einrichten
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden. Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.
Upload Contao
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.
Das ganze Paket (ab Basisverzeichnis) ladet man jetzt per FTP auf den Webspace hoch. Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.
Aufruf des Installtools
Installtool-Passwort
Den Installer ruft man einfach mit http://contao.meinedomain.de/contao/install.php auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).
Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").
Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
Einen Verschlüsselungsschlüssel erstellen
Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys. Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
Anmerkung: Diese Eingabe ist nur notwendig, wenn ein Webseitentemplate importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key. |
Datenbankverbindung prüfen
Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
Hier werden alle Daten eingetragen, die man von seinem Provider erhalten hat. Wenn die eingegebenen Daten korrekt sind, wird nach dem Speichern die Meldung "Datenbankverbindung ok." ausgegeben |
Tabellen aktualisieren
Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.
Ein Template importieren
Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der Demonstrationswebseite bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein und eine komplett neue Webseite erstellt werden, so lässt man das Auswahlmenü leer.
Ein Administratorkonto anlegen
Abschliessend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)
Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.
Gratulation, die Installation ist abgeschlossen.
Absichern des Install-Tools
Nach erfolgreicher Installation ist es ratsam, das Install-Tool gegen fremden Zugriff abzusichern. Dies kann man mit 2 Möglichkeiten:
- Durch Umbenennen der Datei /contao/install.php
- Durch Abbrechen des Install-Skrips. Dazu die Datei /contao/install.php bearbeiten und in Zeile 2 folgenden Code einfügen:
exit();