Mit dem Template-Editor passt du das Layout und die Inhalte deiner Bestelldokumente direkt in der Shopware Admin an — ohne eigene Twig-Datei, ohne eigenes Plugin und ohne Entwickler. Der Editor steht für Rechnung, Lieferschein, Gutschrift, Stornorechnung, Rechnungskorrektur und die Pickware-Pickliste zur Verfügung.
[zu prüfen: Einzelne Dokumenttypen können laut Konzept bewusst von der Bearbeitung ausgenommen sein (z. B. der POS-Bon) — bitte gegen die Live-Admin prüfen, ob das aktuell zutrifft, und diesen Satz ggf. um eine Ausnahme ergänzen.]
Template-Editor öffnen
Navigiere zu Einstellungen → Handel → Dokumente und öffne den gewünschten Dokumententyp. Auf der Detailseite findest du oben rechts den Button Dokument gestalten, über den sich der Template-Editor öffnet.
📸 SCREENSHOT: Button „Dokument gestalten" auf der Dokumenten-Detailseite
[zu prüfen: Ist mindestens ein Dokument dieses Typs bereits erzeugt worden, bevor der Editor sich öffnen lässt? Laut Konzept ist der Editor gesperrt, solange für den Dokumententyp noch kein Beispieldokument existiert — falls das zutrifft, hier ergänzen, mit welchem Hinweistext das in der UI angezeigt wird.]
Einzelne Bereiche des Dokuments anpassen
Im Editor siehst du eine Liste der Bereiche (Blocks), aus denen das Dokument aufgebaut ist. Wählst du einen Bereich aus, kannst du ihn entweder vollständig ersetzen oder erweitern — beim Erweitern bleibt der ursprüngliche Inhalt erhalten und wird um deine Ergänzung ergänzt.
📸 SCREENSHOT: Blockliste mit Auswahl „Ersetzen"/„Erweitern"
[zu prüfen: Exakte Bezeichnungen der Aktionen „Ersetzen"/„Erweitern" gegen die Live-Admin prüfen.]
Eine Sidebar zeigt dir die im aktuellen Dokumententyp verfügbaren Variablen an — etwa Bestell-, Kunden- oder Positionsdaten —, die du in deiner Anpassung verwenden kannst. Zusätzlich lässt sich das Erscheinungsbild über eigene CSS-Regeln anpassen.
Eine Live-Vorschau zeigt dir direkt, wie sich deine Änderung auf das fertige Dokument auswirkt, bevor du sie speicherst.
Geltungsbereich der Anpassung
Du kannst eine Anpassung global (für alle Verkaufskanäle) oder gezielt für einen einzelnen Verkaufskanal vornehmen. Ist für einen Verkaufskanal keine eigene Anpassung hinterlegt, gilt automatisch die globale Anpassung — ist auch keine globale Anpassung vorhanden, wird der ursprüngliche Bereich des Dokuments verwendet.
Wenn eine Anpassung nicht gespeichert werden kann
Führt deine Anpassung dazu, dass sich das Dokument nicht mehr korrekt erzeugen lässt, weist dich der Editor bereits vor dem Speichern darauf hin — die fehlerhafte Änderung wird dann nicht übernommen.
[zu prüfen: Exakten Wortlaut der Fehlermeldung im Editor gegen die Live-Admin prüfen und hier ergänzen.]
Was der Template-Editor nicht kann
Der Template-Editor ersetzt nicht jede denkbare Twig-Funktion — aus Sicherheitsgründen ist der Funktionsumfang eingeschränkt. Für sehr weitgehende Anpassungen, die über die Möglichkeiten des Editors hinausgehen, bleibt die Anpassung über eine eigene Twig-Datei weiterhin möglich.