# Backup-Manager

...

## 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`.

{% hint style="info" %}
**Was wird exportiert?**\
Nur die Theme-Konfigurationswerte (configValues) – also alle Anpassungen am Theme. Hochgeladene Medien (Logos, Bilder) sind als Verweise enthalten, die Mediendateien selbst werden im aktuellen Format nicht mit exportiert.
{% endhint %}

### Importieren

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.

{% hint style="warning" %}
**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.
{% endhint %}

{% hint style="info" %}
**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.
{% endhint %}

{% hint style="info" %}
**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.
{% endhint %}

***

## Erweiterter Modus

**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.
5. Auf "Speichern" klicken.

Das Theme wird automatisch neu kompiliert.

{% hint style="danger" %}
**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.
{% endhint %}

{% hint style="info" %}
**Erweiterter Modus deaktivieren**\
Über "Erweiterten Modus beenden" oben auf der Seite. Die Editoren werden ausgeblendet, ungespeicherte Änderungen gehen dabei verloren.
{% endhint %}

***

## Anwendungsfälle

Typische Szenarien für die Backup-Funktionen:

### Sichern und Wiederherstellen

* **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.

### Übertragen zwischen Themes oder Shops

* **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.

### Direkt-Bearbeitung

* **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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doku.themeware.design/zusatzfunktionen/add-ons/backup-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.