Zum Inhalt

Import und Export

Wozu

Unter Theme → Importieren / Exportieren lässt sich der Stand einer Installation als Datei sichern und in eine andere übertragen. Gedacht ist das für den Weg von der Entwicklungs- auf die Live-Umgebung und für den Start eines Projekts aus einer Vorlage.

Das Dateiformat ist ein ZIP mit der Endung .twtheme.zip. Darin liegt eine manifest.json mit Quelladresse, Theme, WordPress-Version und der Liste der enthaltenen Bereiche, dazu je Bereich eine JSON-Datei und optional ein Ordner media/.

Die Seite Theme → Importieren / Exportieren mit den Spalten Export und Import

Einstellungen

Was exportiert werden kann

Links stehen sieben Gruppen. Jede hat rechts ein Paar Alle | Keiner, oben gelten Alles auswählen und Keine auswählen für die ganze Spalte.

Gruppe Inhalt
Theme-Einstellungen die Options-Keys des Themes, einzeln wählbar
Theme-Inhaltstypen Inhaltstypen mit Theme-Feldern
Taxonomien Taxonomien samt Begriffen
Site-Editor Vorlagen, Vorlagenteile, globale Stile
Navigation Navigationsmenüs und Menüorte
Widgets Widgets und Seitenleisten
Seiten und Beiträge Inhalte je Inhaltstyp

Dazu ein Schalter API-Schlüssel/Geheimnisse einschließen, standardmäßig aus. Das ist die richtige Voreinstellung: Schlüssel gehören selten in eine Datei, die weitergegeben wird.

Am Ende der Spalte steht .twtheme.zip exportieren.

Beim Import

Option Standard
Vorhandene Einträge überspringen, anstatt sie zu aktualisieren aus, es wird also aktualisiert
Mediendateien importieren an
API-Schlüssel/Geheimnisse importieren aus

Mediendateien importieren lädt Bilder und Dateien aus dem Bundle quer und ordnet die Anhangs-IDs neu zu.

Verwenden

Exportieren

  1. Bereiche auswählen; Alles auswählen und Keine auswählen helfen dabei
  2. Bei Bedarf die API-Schlüssel einschließen
  3. .twtheme.zip exportieren

Für eine vollständige Übertragung

Die Seite empfiehlt selbst: Alles auswählen verwenden und Medien einschließen.

Importieren

  1. Datei unter Bundle-Datei (.twtheme.zip) wählen
  2. Optionen setzen
  3. Bundle importieren

Nach dem Lauf erscheint ein Bericht, welche Einträge angelegt und welche aktualisiert wurden.

Intern läuft der Import in fester Reihenfolge — Taxonomien, Medien, Inhaltstypen, Inhalte, Optionen, Site-Editor, Navigation, Widgets, und zuletzt die Zuordnung der IDs. Deshalb bleiben Verweise zwischen Inhalten erhalten.

Transienten und Laufzeitcache gehen nie mit.

Entwicklertipps

Drei Filter steuern das Verhalten:

Filter Zweck
twtheme_bundle_sections welche Bereiche angeboten werden
twtheme_bundle_import_order Reihenfolge beim Import
twtheme_bundle_excluded_options Optionen, die nie mitgehen

Der Code liegt unter includes/engine/import-export/.

Weiter