Isotope Bundle

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 Sie das Theme aktualisieren wollen, können Sie das ganz einfach über den Contao Manager durchführen. Anschließend rufen Sie das Install-Tool auf und aktualisieren die Datenbank. Ein Backup der Datenbank kann nie schaden!


Schritte

1 / Composer.json anpassen

Installieren Sie das 0.1 Isotope Bundle, indem Sie die Datei composer.json im Contao Root-Verzeichnis bearbeiten. An das Ende der Datei fügen Sie die folgende Zeile ein (wie im Beispiel der folgenden composer.json). Ersetzen Sie die Domain und das Passwort.

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

An das Ende von require fügen Sie folgende Zeile ein. Vergessen Sie 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

Rufen Sie nun den Contao Manager auf und führen Sie das Update aus, indem Sie unten auf den Button Änderungen anwenden klicken.

3 / Datenbank aktualisieren

Danach rufen Sie das Install-Tool auf und aktualisieren die Datenbank. Im Install-Tool müssen sie noch einen Admin-Benutzeraccount erstellen.

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

4 / Theme Dateien synchronisieren und tl_files leeren

Loggen Sie sich mit Ihrem erstellten Benutzer-Account im Backend ein und wählen Sie in der linken Navigation unter CONTAO-THEMES-NET den Menüpunkt 0.1 Theme Setup aus. Anschließend klicken Sie 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.

Danach müssen die die Datenbank-Tabelle ‘tl_files’ leeren, indem Sie auf den Button Tabelle ‘tl_files’ leeren klicken. 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.

5 / Isotope Dateien synchronisieren

Wählen Sie in der linken Navigation unter CONTAO-THEMES-NET den Menüpunkt 0.1 Isotope Setup und wählen Sie 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 / Attribute importieren

Importieren Sie im Install-Tool das Template mit dem Namen 0.1_isotope_attributes.sql. Setzen Sie unbedingt das Häkchen für Tabellen nicht leeren.

Anschließend muss der Cache geleert werden.

Wenn Sie nun wieder das Installtool aufrufen, sollten einige neue Felder angelegt werden. Aktualisieren Sie die Datenbank.

7 / Theme und Isotope Demodaten importieren

Importieren Sie nun im Install-Tool das Template mit dem Namen 0.1_isotope_demo_contao_4.x.x.sql (je nach Contao-Version). Setzen Sie unbedingt das Häkchen für Tabellen nicht leeren.

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

Symlinks neu erstellen

9 / Einstellungen

Unter Erweiterte CSS-Einstellungen müssen SIe noch das Klassen-Set spectre.json auswählen.

Spectre Set auswählen

10 / CSS importieren

Fügen Sie in der custom.scss (Dateiverwaltung, unter zeroOne/scss) folgende Zeile ein, damit das Styling geladen wird:

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

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

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

Unter dem Menüpunkt Shop sollten Sie nun die 0.1 Isotope Shop Demo sehen.

Weitere Anpassungen

Das Handbuch zu Isotope finden Sie hier: Benutzerhandbuch

Damit die Bestellbestätigungsmails versendet werden, müssen noch die SMTP-Daten eingetragen werden. Die Einstellungen findet man im Contao Backend unter dem Menüpunkt Gateways (unter Notification Center). Dazu muss der Eintrag Email Gateway bearbeitet werden und die SMTP-Einstellungen überschreiben.

SMTP-Daten eintragen