Installation

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

Je nachdem welche Version des Contao Managers du installiert hast, sehen die Bezeichnungen für die einzelnen Schaltflächen etwas anders aus. Daher haben wir zwei Anleitungen verfasst. Die Version findest du immer im Fußbereich ganz links.

Installation mit Contao Manager 1.1.x:

  1. Contao Manager aufrufen: www.ihre-domain.de/contao-manager.phar.php
  2. Bei allen vorhandenen Paketen auf Aktualisieren klicken. In dem Fall sind dies nur die Contao-Pakete. Danach noch NICHT auf Änderungen anwenden klicken, sondern erst die nächsten Schritte befolgen.
  3. Auf Pakete suchen klicken und im Eingabefeld nach MATE Theme suchen.
  4. Das Paket mit dem Namen MATE Theme hinzufügen.
  5. Im Fußbereich auf Änderungen prüfen und anschließend Änderungen anwenden klicken.
  6. Danach rufst du das Install-Tool auf und aktualisierst die Datenbank. Im Install-Tool musst du noch einen Admin-Benutzeraccount erstellen.

Installation mit Contao Manager 1.2.x:

  1. Contao Manager aufrufen: www.ihre-domain.de/contao-manager.phar.php
  2. Bei allen vorhandenen Paketen auf Aktualisieren klicken. In dem Fall sind dies nur die Contao-Pakete. Danach noch NICHT auf Änderungen anwenden klicken, sondern erst die nächsten Schritte befolgen.
  3. Im Menü auf Entdecken klicken und im Eingabefeld nach MATE Theme suchen.
  4. Das Paket mit dem Namen MATE Theme hinzufügen.
  5. Im Menü auf Pakete klicken und im Fußbereich auf Änderungen anwenden klicken.
  6. Danach rufst du das Install-Tool auf und aktualisierst die Datenbank. Im Install-Tool musst du noch einen Admin-Benutzeraccount erstellen.

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

Hilfreiches Video

Hinweise

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