Theme-Manager
Themes verwalten, bearbeiten, testen und aktivieren
Im Theme-Manager verwaltest Du installierte Shop-Themes, aktivierst oder kopierst Designs, pflegst Theme-Stammdaten und bearbeitest Themebereiche mit Parametern, CSS, HTML- und JavaScript-Versionen.
- Wofür der Theme-Manager da ist
- Theme-Übersicht und Tabelle
- Optionen in der Theme-Tabelle
- Theme-Stammdaten bearbeiten
- Globale Theme-Einstellungen
- Themebereiche bearbeiten
- Alle Parameter
- Einzelnen Themebereich bearbeiten
- Parameter eines Bereichs
- CSS-Bereich
- Dateien und Versionen
- Eigenes CSS und Bild-Manager
- Sichere Vorgehensweise
- War diese Seite hilfreich?
Wofür der Theme-Manager da ist
Ein Theme bestimmt die sichtbare Gestaltung des Shops. Dazu gehören Layout, Farben, Bilder, Abstände, Schriften, Header, Footer, Produktansichten, Contentbereiche, Warenkorb und Checkout-Darstellung.
Die Theme-Verwaltung trennt Designarbeit von Produkt-, Kunden- und Bestelldaten. Dadurch können Designs vorbereitet, kopiert und per Vorschau geprüft werden, bevor ein Theme aktiv genutzt wird.
Theme-Übersicht und Tabelle
Die Übersicht zeigt die installierten Themes in einer Tabelle. Die sichtbaren Spalten hängen teilweise vom Shoptyp und vom technischen Betriebsmodus ab.
- Vorschau: zeigt ein Vorschaubild des Themes, wenn ein Bild gepflegt ist. Ohne Bild erscheint eine neutrale Leeranzeige.
- Name: Bezeichnung des Themes. Diese Spalte ist die primäre Theme-Kennung in der Übersicht.
- Typ: Theme-Typ aus der Theme-Verwaltung. Die Spalte ist auf kleinen Ansichten ausgeblendet.
- PaketName: technischer Paketname; erscheint nur in Entwicklerumgebungen.
- St: Kennzeichnung für Standard-Themes; erscheint nur in Entwicklerumgebungen.
- Ex: Export-/Import-Markierung; erscheint nur in Entwicklerumgebungen und kann direkt umgeschaltet werden.
- Aktiv: bei einem einzelnen Shop zeigt ein Radiobutton, welches Theme aktiv ist. Das Umschalten schreibt die Theme-Zuordnung und erzeugt die CSS-Ausgabe neu.
- Multishops: bei mehreren Shops zeigt diese Spalte, welchen Shops das Theme zugeordnet ist.
- Optionen: enthält Bearbeiten, Löschen, Kopieren, Elemente festlegen und Vorschau.
Optionen in der Theme-Tabelle
- Bearbeiten: öffnet die Theme-Stammdaten im Modal.
- Löschen: entfernt ein Theme nach Bestätigung. Diese Aktion wird bei Standard-Themes nicht angeboten.
- Kopieren: erstellt eine Kopie des Themes. Das ist der sichere Startpunkt für größere Anpassungen.
- Elemente festlegen: öffnet den Themebereich-Editor für Parameter, CSS, Dateien und Versionen.
- Vorschau: öffnet das Theme im Shopkontext, ohne es als aktives Theme zu setzen. Bei mehreren Shops kann vorher eine Shopauswahl erscheinen.
- Aktiv setzen: bei einem einzelnen Shop kann das aktive Theme direkt über den Radiobutton gesetzt werden.
Theme-Stammdaten bearbeiten
Die Aktion Bearbeiten öffnet ein Modal für die Stammdaten des Themes.
- Bezeichnung: Pflichtfeld für den sichtbaren Theme-Namen in der Übersicht.
- Bezeichnung (PackageName): Pflichtfeld nur in Entwicklerumgebungen. Es ordnet das Theme einem Paketnamen zu.
- Beschreibung: Freitext zur Einordnung des Themes, zum Beispiel Einsatzzweck oder Besonderheiten.
- Aktuelle Vorschau entfernen: erscheint, wenn bereits ein Vorschaubild vorhanden ist, und löscht dieses beim Speichern.
- Vorschaubild: Datei-Upload für ein neues Vorschaubild des Themes.
Beim Speichern werden die Stammdaten aktualisiert. Wird ein neues Vorschaubild hochgeladen, ersetzt es das bisherige Bild.
Globale Theme-Einstellungen
Unterhalb der Theme-Tabelle stehen globale Einstellungen für die Theme-Verarbeitung.
- Theme-Optimierung ist aktiv: entfernt unnötige Zeilenumbrüche aus der erzeugten HTML-Ausgabe. Das kann die Ausgabe schlanker machen, muss bei eigenem JavaScript aber sorgfältig geprüft werden.
- Agenturmodus ist aktiv: deaktiviert die dynamische Themebearbeitung im Backend. Der Modus ist für externe Dateibearbeitung gedacht; solange er aktiv ist, ist die normale Bearbeitung von Themebereichen gesperrt.
Themebereiche bearbeiten
Über Elemente festlegen öffnest Du den Themebereich-Editor für das ausgewählte Theme. Dort werden Bereiche, Parameter, CSS und Dateiversionen gepflegt.
- Zurück zur Themeauswahl: führt zurück zur Theme-Tabelle.
- Vorschau anzeigen / Im Shop anzeigen: öffnet das Theme im passenden Shopkontext.
- Eigenes CSS: öffnet ein Modal für zusätzlichen CSS-Code des Themes.
- Bild-Manager: öffnet die Verwaltung der Themebilder.
- Themebereiche: linke Navigation mit Bereichsgruppen und einzelnen Themebereichen.
- Direkt zu... springt direkt zu einem ausgewählten Themebereich.
- Alle auf / Alle zu: öffnet oder schließt die Bereichsgruppen.
Wenn der Agenturmodus aktiv ist, zeigt der Editor einen Hinweis und bricht die dynamische Bearbeitung ab.
Alle Parameter
Ohne ausgewählten Einzelbereich zeigt der Editor Alle Parameter des Themes gruppiert nach Themebereich.
- Parameter suchen: filtert die Parameter nach Gruppennamen, Bereichsnamen, Label, Parametername und Beschreibung.
- Parameter speichern: speichert alle geänderten Parameterwerte.
- Alle auf / Alle zu: öffnet oder schließt alle Parametergruppen.
- Parametergruppen: zeigen die Anzahl der enthaltenen Parameter.
Parameter sind der bevorzugte Weg für normale Designänderungen, weil sie strukturierte Eingabefelder verwenden und ohne direkten Codeeingriff auskommen.
Einzelnen Themebereich bearbeiten
Ein ausgewählter Themebereich zeigt Metadaten und je nach Bereich unterschiedliche Bearbeitungsblöcke.
- Datei: zeigt die zugehörige Theme-Datei oder JavaScript-Datei.
- Beschreibung: erklärt den Zweck des Bereichs.
- CSS-Bearbeitungs-Modus: wechselt bei Themebereichen zwischen dynamisch und statisch.
- Gesperrt: sperrt den Themebereich oder die JavaScript-Datei gegen automatische Änderungen.
- Parameter: erscheint im dynamischen Modus, wenn der Bereich Parameter besitzt.
- CSS-Bereich: erscheint im statischen Modus und bietet ein Textfeld für CSS-Code.
- Dateien & Versionen: erscheint bei dateibasierten Bereichen und bei JavaScript-Dateien.
Parameter eines Bereichs
Der Block Parameter zeigt die Felder des gewählten Themebereichs in einer Tabelle.
- Parameter speichern: übernimmt die geänderten Werte des Bereichs.
- Parameter hinzufügen: erscheint nur in Entwicklerumgebungen und öffnet ein Modal für neue Parameter.
- Parameter bearbeiten: erscheint nur in Entwicklerumgebungen und öffnet Name, Label, Typ und Beschreibung eines Parameters.
- Parameter löschen: erscheint nur in Entwicklerumgebungen und entfernt den Parameter nach Bestätigung.
Der konkrete Feldtyp wird vom Parameter vorgegeben. Typische Parameter sind Texte, Farben, Auswahlfelder, Bildwerte, Zahlen oder Schalter.
CSS-Bereich
Im statischen CSS-Modus zeigt der Block CSS-Bereich ein Textfeld mit dem CSS-Code des gewählten Themebereichs.
- css_code: Textbereich für den CSS-Code dieses Bereichs.
- CSS speichern: speichert den Code und aktualisiert das Theme.
Direkter CSS-Code sollte gezielt und nachvollziehbar eingesetzt werden. Wenn eine Anpassung über Parameter möglich ist, ist der Parameterweg meist wartbarer.
Dateien und Versionen
Dateibasierte Themebereiche und JavaScript-Dateien besitzen Versionen. Eine Version ist aktiv, weitere Versionen können geöffnet, verglichen oder bearbeitet werden.
- Aktiv: Radiobutton für die aktive Version. Beim Wechsel wird die Version gespeichert und das Theme aktualisiert.
- Version: Versionsbezeichnung der Datei.
- Beschreibung: interne Beschreibung der Version.
- Optionen: öffnet eine Version, vergleicht sie mit der aktiven Version oder kopiert sie in Entwicklerumgebungen.
- Code: Textbereich für HTML- oder JavaScript-Code der geöffneten Version.
- Syntax-Vorschau: zeigt den Code parallel formatiert an.
- Änderungsnotiz: dokumentiert, was geändert wurde und warum.
Eigenes CSS und Bild-Manager
- Eigenes CSS: speichert zusätzlichen CSS-Code am Theme. Dieser Code eignet sich für kleinere Anpassungen, die nicht über Parameter abgebildet werden.
- Bild-Manager: lädt neue Themebilder hoch und zeigt vorhandene Bilder mit Löschaktion an.
- neues Bild hochladen: Datei-Upload für ein Themebild. Das Feld ist für KI-Bildunterstützung vorbereitet.
- Aktion löschen: entfernt ein vorhandenes Bild aus der Bildliste.
Nach Bild- oder CSS-Änderungen sollte die betroffene Frontendstelle in der Vorschau geprüft werden.
Sichere Vorgehensweise
- Aktives Theme und betroffenen Shop prüfen.
- Für größere Änderungen zuerst eine Theme-Kopie erstellen.
- Stammdaten und Vorschaubild der Kopie eindeutig pflegen.
- Designänderungen zuerst über Parameter vornehmen.
- CSS, HTML und JavaScript nur gezielt bearbeiten und mit Änderungsnotiz dokumentieren.
- Vorschau für Startseite, Produktlisten, Produktdetails, Contentseiten, Warenkorb und Checkout prüfen.
- Bei alten Frontend-Ausgaben anschließend die Cache-Einstellungen prüfen oder den Cache leeren.