Alle Seiten
Bereitgestellt von GitBook
1 von 1

Loading...

Backup-Manager

Der Backup-Manager sichert, überträgt und bearbeitet deine Theme-Konfiguration direkt im Tab "Backup" des ThemeWare® Hubs. Er bündelt drei Funktionen: den Export der Konfiguration als JSON-Datei, einen geführten Import mit verpflichtender Pre-Backup-Sicherung und einen erweiterten Modus mit Inline-JSON-Editor für die Direkt-Bearbeitung.

Wichtig: Der Backup-Manager ist ein Add-on und muss separat freigeschaltet werden.

Theme-Konfiguration

Exportieren

Lädt die Konfigurationswerte des Themes als JSON-Datei herunter. Geeignet für Sicherungen vor größeren Änderungen oder zum Übertragen zwischen Shops.

Schritt für Schritt:

  1. Im Backup-Tab das gewünschte Theme suchen.

  2. Auf "Exportieren" klicken.

  3. Der Browser lädt eine Datei mit dem Schema tcinn-<theme-name>-<datum>.json.

Spielt eine zuvor exportierte JSON-Datei in das gewählte Theme ein. Bestehende Konfigurationswerte werden dabei vollständig ersetzt, daher führt der Import-Dialog vorab durch ein Backup.

Schritt für Schritt:

  1. Im Backup-Tab beim Ziel-Theme auf "Importieren" klicken. Das Modal "Theme-Konfiguration importieren" öffnet sich.

  2. Im Modal "Backup herunterladen" klicken (Schritt 1). Die aktuelle Konfiguration wird zur Sicherheit als JSON gespeichert.

  3. "Datei wählen …" klicken (Schritt 2) und die zu importierende JSON-Datei auswählen.

  4. Falls das Theme die Datei akzeptiert, "Konfiguration importieren" klicken.

Das Theme wird automatisch neu kompiliert.


Für fortgeschrittene Nutzer: ein JSON-Editor direkt unter jedem Theme, mit dem die Konfiguration ohne Umweg über die Standard-Oberfläche bearbeitet werden kann.

Schritt für Schritt:

  1. Im Backup-Tab oben auf "Erweiterten Modus aktivieren" klicken.

  2. Unter jedem Theme erscheint ein JSON-Editor mit der aktuellen Konfiguration.

  3. Vor dem Speichern beim betroffenen Theme zwingend "Exportieren" klicken (Backup-Pflicht).

  4. Änderungen im JSON-Feld vornehmen.

Das Theme wird automatisch neu kompiliert.


Typische Szenarien für die Backup-Funktionen:

  • Sicherung vor größeren Änderungen — Vor einem Plugin-Update, einer umfangreichen Theme-Anpassung oder dem Aktivieren des "Erweiterten Modus" eine Sicherung herunterladen.

  • Wiederherstellung nach einem Fehler — Eine Änderung hat das Theme beschädigt oder unerwünschte Effekte verursacht? Die zuvor exportierte JSON-Datei einfach in das betroffene Theme zurückimportieren.

  • Konfiguration in ein anderes Theme reinschreiben — Du hast ein bestehendes Custom-Duplikat und möchtest die Konfiguration einer anderen Variante (z.B. aus Plants) dort einfließen lassen. Im Quell-Theme exportieren, im Ziel-Theme importieren.

  • Setup von Test-Shop auf Live-Shop übertragen — Du entwickelst auf einem Test-Shop und möchtest das fertige Theme-Setup im Produktiv-Shop einspielen. Export auf Test, Datei herunterladen, Import auf Live.

  • Detail-Anpassungen am JSON für Power-User — Einzelne Konfigurationswerte sollen schnell und gezielt geändert werden, ohne den Umweg über die Standard-Oberfläche im Theme-Manager. Dafür den "Erweiterten Modus" aktivieren.

Auf "Speichern" klicken.

Warum Add-ons?

Was wird exportiert? Nur die Werte, die du selbst geändert hast (configValues). Felder, die du nie angepasst hast, stehen nicht in der Datei und nutzen nach dem Import die Standardwerte des Themes. Das Backup ist also keine vollständige Kopie aller Einstellungen. Das bedeutet:

  • Gleiches Theme, gleiche Installation: Das Backup stellt deinen Stand exakt wieder her.

  • Andere Variante: Nicht angepasste Felder übernehmen die Standardwerte der Ziel-Variante.

  • Nach einem Update: Standardwerte werden nicht mitgesichert. Ändert ein Update einen Standardwert, gilt für nicht angepasste Felder der neue Wert.

  • Duplikate: Ein Duplikat erbt die Einstellungen seines Basis-Themes. Gesichert werden nur die Werte, die direkt im Duplikat geändert wurden. Sichere deshalb zusätzlich das Basis-Theme.

  • Medien: Hochgeladene Logos und Bilder sind nur als Verweis enthalten, die Mediendateien selbst werden nicht mit exportiert.

Importieren

Bestehende Konfiguration wird ersetzt Der Import überschreibt die bisherigen Konfigurationswerte komplett. Deshalb ist das Backup in Schritt 1 verpflichtend – fehlt es, bleibt der Importieren-Button deaktiviert.

Cross-Variant-Import Stammt die Import-Datei aus einer anderen ThemeWare®-Variante (z.B. Plants-Datei in Modern-Theme), erkennt der Import das automatisch und zeigt einen Hinweis. Deine Anpassungen werden übernommen, nicht angepasste Felder nutzen die Defaults der aktuellen Variante.

Medien-Hinweis Enthält die Datei Verweise auf Medien-IDs (Logos, Bilder), existieren diese ggf. nicht im Ziel-Shop und müssen nach dem Import manuell zugewiesen werden.

Erweiterter Modus

Vorsicht beim Editieren Fehlerhafte JSON-Eingaben können das Theme beschädigen oder die Storefront beeinträchtigen. Der "Speichern"-Button bleibt deshalb so lange deaktiviert, bis ein Backup für das Theme erstellt wurde und die Eingabe gültiges JSON ist.

Erweiterter Modus deaktivieren Über "Erweiterten Modus beenden" oben auf der Seite. Die Editoren werden ausgeblendet, ungespeicherte Änderungen gehen dabei verloren.

Anwendungsfälle

Sichern und Wiederherstellen

Übertragen zwischen Themes oder Shops

Direkt-Bearbeitung