Contao 5 - Installation und Kundenleitfaden

Contao ist ein seitenbasiertes Content-Management-System. Inhalte werden in Artikeln und Inhaltselementen organisiert; Erweiterungen werden üblicherweise mit dem Contao Manager und Composer verwaltet. Diese Anleitung bezieht sich auf Contao 5.

Voraussetzungen

• Hosting mit einer von der gewünschten Contao-5-Unterversion unterstützten PHP- und Datenbankversion.
• Eine leere Datenbank mit eigenem Benutzer.
• HTTPS.
• Der Dokumentenstamm muss auf das öffentliche Verzeichnis public der Contao-Installation zeigen.
• Ausreichende PHP-Speicher- und Ausführungsgrenzen für Composer.

Prüfen Sie die Systemanforderungen der konkreten Contao-Version unmittelbar vor der Installation.

Installation mit Contao Manager

1. Laden Sie den aktuellen Contao Manager von contao.org herunter.
2. Legen Sie die Datei als contao-manager.phar.php im Verzeichnis public ab.
3. Öffnen Sie https://ihre-domain.example/contao-manager.phar.php.
4. Legen Sie das Manager-Konto an und lassen Sie die Serverkonfiguration prüfen.
5. Wählen Sie die gewünschte unterstützte Contao-Version und starten Sie die Installation.
6. Öffnen Sie anschließend das Contao Install Tool, tragen Sie die Datenbankzugangsdaten ein und führen Sie die Datenbankmigration aus.
7. Legen Sie das erste Backend-Konto an.
8. Öffnen Sie das Backend unter /contao und melden Sie sich an.

Contao-Manager-Konto und Contao-Backend-Konto sind getrennte Konten.

Contao-Grundprinzip

• Seitenstruktur: bildet Hierarchie und Seitentypen der Website ab.
• Artikel: gehören fest zu einer Seite und zu einem Layoutbereich.
• Inhaltselemente: einzelne Bausteine wie Text, Bild, Tabelle oder Galerie.
• Themes: bündeln unter anderem Layouts, Stylesheets, Frontend-Module und Templates.
• Frontend-Module: liefern dynamische Ausgaben, etwa Navigation, Login oder Nachrichtenliste.
• Benutzer: melden sich im Backend an; Mitglieder gehören zum Frontend.

Seite und Inhalt anlegen

1. Öffnen Sie die Seitenstruktur.
2. Legen Sie eine neue reguläre Seite an und wählen Sie die richtige übergeordnete Seite.
3. Vergeben Sie Seitennamen, Alias, Sprache und Veröffentlichungsstatus.
4. Öffnen Sie die Artikel-Verwaltung.
5. Legen Sie auf der gewünschten Seite einen Artikel im passenden Layoutbereich an.
6. Fügen Sie Inhaltselemente hinzu, beispielsweise Text oder Bild.
7. Speichern Sie und prüfen Sie die Vorschau.
8. Veröffentlichen Sie Seite, Artikel und Elemente erst nach der Kontrolle.

Wenn Inhalt fehlt, prüfen Sie alle drei Ebenen: Seite, Artikel und Inhaltselement.

Themes und Layouts

Ein Theme kann exportiert und in eine andere Installation importiert werden. Prüfen Sie vor einem Import, welche Layouts, Module, Stylesheets, Dateien und Templates enthalten sind. Ein importiertes Theme weist Seiten nicht automatisch immer das richtige Layout zu.

Ändern Sie Hersteller-Templates nicht ohne dokumentierte Kopie beziehungsweise Override, damit Updates Anpassungen nicht überschreiben.

Erweiterung mit Contao Manager installieren

1. Erstellen Sie ein vollständiges Backup.
2. Öffnen Sie /contao-manager.phar.php und melden Sie sich an.
3. Suchen Sie nach der Erweiterung und klicken Sie auf Add.
4. Öffnen Sie den Tab Packages.
5. Klicken Sie auf Apply changes.
6. Warten Sie, bis Composer ohne Fehler abgeschlossen ist.
7. Öffnen Sie das Contao Install Tool und führen Sie die Datenbankmigration aus.
8. Konfigurieren und testen Sie die Erweiterung.

Der Vorgang kann mehrere Minuten dauern. Brechen Sie ihn nicht nur wegen fehlender Bildschirmausgabe ab; öffnen Sie die Konsolenausgabe des Managers.

Benutzer und Rechte

Contao kann Backend-Module, Theme-Module, Inhaltselemente, Formularfelder, Seitenbäume und Dateiordner getrennt freigeben.

1. Legen Sie Gruppen nach Aufgaben an.
2. Konfigurieren Sie Seiten- und Dateifreigaben.
3. Erlauben Sie nur benötigte Backend- und Theme-Module.
4. Ordnen Sie Benutzer der Gruppe zu.
5. Testen Sie mit einem separaten Konto.

Benutzer können in ihrem Sicherheitsbereich Zwei-Faktor-Authentifizierung per TOTP aktivieren und Backupcodes erzeugen.

Updates und Wartung

1. Erstellen Sie Backups von Dateien und Datenbank.
2. Prüfen Sie Kompatibilität installierter Erweiterungen.
3. Aktualisieren Sie zuerst eine Testkopie über Contao Manager.
4. Führen Sie die Datenbankmigration aus.
5. Leeren Sie Caches und prüfen Sie Frontend, Formulare, Nachrichten, Events und Benutzerrechte.
6. Aktualisieren Sie erst danach die Produktionswebsite.

Häufige Probleme

Seite oder Inhalt ist nicht sichtbar

Prüfen Sie Veröffentlichungsstatus von Seite, Artikel und Inhaltselement sowie Start-/Endzeit und Zugriffsregeln.

Contao Manager bricht ab

Prüfen Sie PHP-Version, Speichergrenze, Ausführungszeit, freien Speicherplatz und die Konsolenausgabe.

Änderung erscheint nicht

Leeren Sie Contao- und Browsercache und prüfen Sie, ob das richtige Seitenlayout verwendet wird.

Verwandte Artikel

• CMS auswählen - WordPress, Joomla, TYPO3, Drupal und Contao
• Plesk - PHP-Version und PHP-Einstellungen ändern
• Plesk - Backup erstellen und wiederherstellen