Contao 4

Das Theme kann nur in einer leeren Contao-Installation installiert werden und ist mit Contao 4.4 oder höher kompatibel.

Die folgenden Schritte sind nur bei der ersten Installation notwendig und nicht bei einem Update des Themes. Wenn du das Theme aktualisieren willst, kannst du das ganz einfach über den Contao Manager durchführen. Anschließend rufst du das Install-Tool auf und aktualisierst die Datenbank. Ein Backup der Datenbank kann nie schaden!


Schritte

Um das MATE Theme zu installieren folge den folgenden Schritten. Am Ende der Anleitung findest du auch noch ein hilfreiches Video.

1) MATE Theme Bundle installieren

Rufe als erstes den Contao Manager über die folgende URL auf: www.deine-domain.de/contao-manager.phar.php. Wähle die Schaltfläche Entdecken aus, gib im Suchfeld mate theme ein und füge das Paket MATE Theme hinzu.

Wechsle dann zu Pakete, gib über das Zahnrad-Icon die Version ^2.20 ein und starte die Installation des Themes über den Button Änderungen anwenden. Bei neueste Version würde der Contao Manager ansonsten die Version 3.x installieren, die nur ab Contao 5 kompatibel ist.

Rufe danach das Installtool auf und aktualisiere die Datenbank.

2) Theme-Dateien synchronisieren und Tabelle ‘tl_files’ leeren

Logge dich mit deinen erstellten Benutzer-Account im Backend ein und wähle in der linken Navigation unter MATE THEME den Menüpunkt Mate Theme Setup aus. Anschließend auf den Button Theme-Dateien synchronisieren (siehe Bild 2) klicken. Damit werden alle Dateien in der Dateiverwaltung unter dem Ordner mate angelegt und die SQL-Dateien zum Importieren der Datenbank in den templates-Ordner kopiert.

Danach musust du die Datenbank-Tabelle ‘tl_files’ leeren, indem du auf den Button Tabelle ‘tl\files’ leeren klickst.
Dieser Schritt muss vor dem Importieren der Datenbank erfolgen.

Theme-Dateien synchronisieren und Tabelle ‘tl\files’ leeren Bild 2: Theme-Dateien synchronisieren

3) Datenbank importieren

Rufe nun das Install-Tool auf. Unter dem Reiter Ein Template importieren (siehe folgender Screenshot) kannst du eine .sql-Datei aus dem templates-Verzeichnis importieren. Wähle die Datei für Ihre Contao-Version aus und aktiviere den Haken Tabellen nicht leeren. Anschließend klickst du auf Ein Template importieren.

Wenn du im Contao Manager die minimale Contao-Installation (ohne News, Kalender, Newsletter, Kommentare, Auflistungen, FAQ) ausgewählt hast, wähle die SQL-Datei mit dem Namen minimal_installtool.sql aus.

Wenn die Datenbank erfolgreich importiert wurde, solltst du eine Meldung, dass ein Template importiert wurde, wie im folgenden Screenshot, erhalten.

Alternativ kannst du die sql-Datei auch über phpMyAdmin importieren.

Datenbank importieren Bild 3: Ein Template importieren

Anschließend wechselst du wieder ins Contao-Backend, wählen den Menüpunkt Systemwartung aus und erstellst die Symlinks neu, indem du die Checkbox bei Symlinks neu erstellen auswählst und anschließend den Button Daten bereinigen betätigst.

5) Einstellungen

In den Einstellungen musst du unter Frontend-Einstellungen Auto_item und Ordner-URLs verwenden aktivieren. Ab Contao 4.7 gibt es die Einstellung Auto_Item aktivieren im Backend nicht mehr, es ist immer standardmäßig aktiv. Ab Contao 4.11 befindet sich die Option “Ordner-URLs verwenden” nicht mehr in den Einstellungen, sondern beim Seiten-Startpunkt unter URL-Einstellungen.

Einstellungen Bild 4: Frontend-Einstellungen

Unter Erweiterte CSS-Einstellungen müssen SIe noch das Klassen-Set materialize.json auswählen (siehe Bild 5).

Erweiterte CSS-Einstellungen
Bild 5: Erweiterte CSS-Einstellungen

Hinweise

Fehlermeldung: Diese Seite funktioniert nicht / Die Seite hat dich zu oft umgeleitet

Bearbeite die Root-Seite und stelle unter URL-Einstellungen das Protokoll auf http:// oder https://, je nachdem wie deine Seite aufgerufen werden soll.

Fehlermeldung: imagick not installed

Sollte die Fehlermeldung imagick not installed unter Verwendung von PHP 8.0 auftreten, kannst du es mit einer Anpassung in der config.yml und anschließendem Cache leeren lösen. mehr Informationen im PDIR-Blogbeitrag

Hilfreiches Video