Installation

Das 0.1 Isotope Bundle 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

1 / Composer.json anpassen

Installiere das 0.1 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/zero-one-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/zero-one-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 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

Logge dich mit deinem erstellten Benutzer-Account im Backend ein und wähle in der linken Navigation unter CONTAO-THEMES-NET den Menüpunkt 0.1 Theme Setup aus. Anschließend klickst du auf den Button Theme-Dateien synchronisieren. Damit werden alle Dateien in der Dateiverwaltung unter dem Ordner zeroOne 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 0.1 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

Unter dem Menüpunkt 0.1 Theme Setup muss die die Datenbank-Tabelle ‘tl_files’ geleert werden, indem du auf den Button Tabelle ‘tl_files’ leeren klickst. Dieser Schritt muss vor dem Importieren der Datenbank erfolgen.

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 0.1_isotope_attributes.sql. Setze unbedingt das Häkchen für Tabellen nicht leeren.

Anschließend muss der Cache geleert werden.

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

8 / Theme und Isotope Demodaten importieren

Importiere nun im Install-Tool das Template mit dem Namen 0.1_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 auswählst und anschließend den Button Daten bereinigen wählst.

Symlinks neu erstellen

10 / Einstellungen

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

Spectre 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ügen in der custom.scss (Dateiverwaltung, unter zeroOne/scss) folgende Zeile ein, damit das Styling geladen wird:

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

Fügen zusätzlich noch folgende Zeile ein um den Dark Mode zu aktivieren:

@import '../../../web/bundles/contaothemesnetzerooneisotope/scss/dark_mode';