Theme exportieren#

Um das TOPAS-Theme in einer neuen Kunden-Instanz über den Contao-Manager zu installieren, muss zunächst eine Installations-Datei erstellt werden.

Wurde die Datei einmal erstellt, kann sie immer wieder verwendet werden.

Wenn Änderungen am Theme-System erfolgt sind, muss eine aktuelle Installations-Datei erstellt werden.

Hintergrund-Informationen#

s. Offizielle Contao-Dokumentation

Installations-Datei erstellen#

Das Ergebnis der folgenden Schritte ist eine .zip-Datei, welche sich über den Contao-Manager installieren lässt.

1. Datenbank-Dump erstellen#

  1. Im Contao-Manager anmelden.
  2. Im Bereich Systemwartung auf den Button Backup erstellen klicken und abwarten, bis das Backup erstellt wurde.
  3. Das Backup wird in der Projektstruktur des TOPAS-Themes im Order /var/backups/*.sql.gz abgelegt.

2. Contao-Theme exportieren#

  1. Im Contao-Backend als Administrator anmelden
  2. Im Bereich Layout → Theme das 'TOPAS-Theme' exportieren (Icon ganz rechts)

Hinweis: Dieser Vorgang kann einige Zeit dauern, da Contao auch alle Dateien (Bilder, Video, etc) für die weitere Verarbeitung exportiert. Das exportierte Theme wird ungefähr 900MB groß.

Wenn der Vorgang abgeschlossen ist, wird eine Datei names topas_theme.cto erstellt und heruntergeladen. Diese Datei sollte sich anschließend im Downloads-Ordner des PCs befinden.

3. Weitere Daten ergänzen#

Die in Schrit 2. heruntergeladene .cto Datei ist eigentlich ein normales ZIP-Archiv. Daher kann die Dateiendung einfach in .zip geändert und die Datei anschließend entpackt werden.

  1. topas_theme.cto umbenennen in topas_theme.zip
  2. topas_theme.zip entpacken

Der entpackte Ordner enthält folgende Dateien und Ordner:

theme.xml
/files/
    /Inhalte/
    /Seitenteaser/
    /System/
    /theme/

In den entpackten Ordner müssen nun weitere Dateien und Ordner aus dem TOPAS-Theme Projekt kopiert werden:

composer.json
/templates/
/translations/

Anschließend noch den folgenden Ordner anlegen

/var/backups/

und den in Schritt 1 erstellten Datenbank-Dump in diesen Ordner kopieren.

4. Installierbare Datei erstellen#

Der Inhalt des Ordners sollte nun so aussehen:

composer.json
theme.xml
/files/
    /Inhalte/
    /Seitenteaser/
    /System/
    /theme/
/templates/
/translations/
/var/backups/*.sql.gz

Alle Dateien dann zu einem neuen ZIP-Archiv komprimieren. Die so erstellte ZIP-Datei kann dann über den Contao-Manager in ein neues Kunden-System importiert werden. s. Setup-Guide