Installation

Das MATE Isotope Bundle kann nur in einer leeren Contao-Installation installiert werden und ist mit Contao 4.9 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

1 / Composer.json anpassen

Installiere das MATE Isotope Bundle, indem du die Datei composer.json im Contao Root-Verzeichnis bearbeitest. An das Ende der Datei fügst du die folgende Zeile ein (wie im Beispiel der folgenden composer.json). Ersetze die Domain und das Passwort.

,
"repositories": [
  {
    "type": "composer",
    "url": "https://[DOMAIN]:[PASSWORT]@packages.contao.store"
  }
]

An das Ende von require fügst du folgende Zeile ein. Vergesse dabei nicht das Komma in der vorletzten Zeile zu setzen.

"contao-themes-net/mate-isotope-bundle": "^1.0"

Beispiel, wie die composer.json für Contao 4.4 aussehen sollte:

{
    "type": "project",
    "require": {
        "contao/calendar-bundle": "^4.4",
        "contao/comments-bundle": "^4.4",
        "contao/conflicts": "*@dev",
        "contao/faq-bundle": "^4.4",
        "contao/listing-bundle": "^4.4",
        "contao/manager-bundle": "4.4.*",
        "contao/news-bundle": "^4.4",
        "contao/newsletter-bundle": "^4.4",
        "contao-themes-net/mate-isotope-bundle": "^1.0"
    },
    "extra": {
        "contao-component-dir": "assets"
    },
    "scripts": {
        "post-install-cmd": [
            "Contao\\ManagerBundle\\Composer\\ScriptHandler::initializeApplication"
        ],
        "post-update-cmd": [
            "Contao\\ManagerBundle\\Composer\\ScriptHandler::initializeApplication"
        ]
    },
    "repositories": [
        {
            "type": "composer",
            "url": "https://BENUTZERNAME:PASSWORT@packages.contao.store"
        }
    ]
}

2 / Composer Update ausführen

Rufe nun den Contao Manager auf, klicke bei allen vorhandenen Paketen (also nur Contao) auf Aktualisieren und führe das Update aus, indem du unten auf den Button Änderungen anwenden klickst.

3 / Datenbank aktualisieren

Danach rufst du das Install-Tool auf und aktualisierst die Datenbank. Im Install-Tool musst du noch einen Admin-Benutzeraccount erstellen.

Das Install-Tool erreichst du im Contao Manager über den Menüpunkt Tools oder über die URL: www.ihre-domain.de/contao/install.

4 / Theme Dateien synchronisieren

Melde dich mit deinem erstellten Benutzer-Account im Backend an und wähle in der linken Navigation unter CONTAO-THEMES-NET den Menüpunkt MATE Theme Setup aus. Anschließend klickst du auf den Button Theme-Dateien synchronisieren. 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.

5 / Isotope Dateien synchronisieren

Wähle in der linken Navigation unter CONTAO-THEMES-NET den Menüpunkt MATE Isotope Setup und den Button Dateien synchronisieren aus um alle Produktbilder anzulegen und die SQL-Dateien in den templates-Ordner zu verschieben, damit diese importiert werden können.

6 / Tabelle tl_files leeren

Danach musst du die Datenbank-Tabelle ‘tl_files’ leeren, indem du im MATE Theme Setup auf den Button Tabelle ‘tl_files’ leeren klickst.

Mit dem Leeren der tl_files Tabelle werden die Bilder-Verknüpfungen gelöscht. Das ist nur bei der ersten Installation des Themes notwendig.

7 / Attribute importieren

Importiere im Install-Tool das Template mit dem Namen mate_isotope_attributes.sql. Setze unbedingt das Häkchen für Tabellen nicht leeren.

Anschließend muss der Cache geleert werden.

Wenn du jetzt das Installtool aufrufst, sollten einige neue Felder angelegt werden. Aktualisiere die Datenbank.

8 / Theme und Isotope Demodaten importieren

Importiere im Install-Tool das Template mit dem Namen mate_isotope_demo_contao_4.x.x.sql (je nach Contao-Version). Setze unbedingt das Häkchen für Tabellen nicht leeren.

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

Symlinks neu erstellen

10 / Einstellungen

Unter Erweiterte CSS-Einstellungen musst du noch das Klassen-Set materialize.json auswählen.

Materialize Set auswählen

Außerdem muss Ordner-URLs verwenden aktiv sein, dies findest du in den Einstellungen unter Frontend-Einstellungen (bis Contao 4.10) oder in der Seitenstruktur bei den Einstellungen des Startpunktes unter URL-Einstellungen (ab Contao 4.11).

11 / CSS importieren

Füge in der custom.scss (Dateiverwaltung, unter mate/sass) folgende Zeile ein, damit das Styling geladen wird:

@import '../../../web/bundles/contaothemesnetmateisotope/scss/isotope';

Bei einer lokalen Installation muss die Zeile wie folgend aussehen:

@import '../../contaothemesnetmateisotope/scss/isotope';

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