Einführung

Willkommen zur offiziellen Dokumentation des Plugins Dokumenten Template bearbeiten (HuebertCustomDocuments) von Hubyte für Shopware 6.

Was macht dieses Plugin?

Mit diesem Plugin können Sie die Twig-Templates der PDF-Dokumente in Shopware – also Rechnung, Lieferschein, Gutschrift und Stornorechnung – direkt in der Administration anpassen. Layout, Inhalt und Aufbau der Dokumente lassen sich vollständig überarbeiten, ohne dafür eigene Dateien im Theme oder ein individuelles Plugin entwickeln zu müssen.

Die Anpassungen erfolgen pro Dokumentkonfiguration (Dokumenttyp) und werden in der Datenbank gespeichert. Beim Erzeugen eines Dokuments werden Ihre individuellen Inhalte, Styles und Templates automatisch in das Standard-Dokument von Shopware eingefügt.

Kernfunktionen

• Bearbeitbare Dokumentbereiche – Briefkopf, Empfänger, Absender, Positionen, Zusammenfassung und Fußzeile mit eigenem Inhalt (Rich-Text) und eigenem CSS

• Eigene Positionstabelle – Das Twig-Template für die Tabelle der Bestellpositionen frei bearbeiten (Experteneinstellung)

• Eigene Zusammenfassung – Das Twig-Template für die Berechnung/Summen unterhalb der Positionen anpassen

• Mehrsprachig – Inhalte und Templates pro Sprache pflegen (Sprachumschalter)

• Lieferdatum ausblenden – Lieferdatum bei Bedarf per Schalter ausblenden

• Live-Vorschau – Dokument mit einer echten Bestellung als PDF-Vorschau erzeugen, ohne ein Dokument anzulegen

• Standardvorlagen laden – Mit einem Klick die mitgelieferten Standard-Templates (Tabelle, Styles, Zusammenfassung) wiederherstellen

Übersicht

Bereich	Beschreibung
Installation & Aktivierung	Plugin installieren und aktivieren
Erste Schritte	Wo finde ich die Einstellungen und wie ist die Oberfläche aufgebaut?
Dokumentenblöcke	Briefkopf, Empfänger, Absender, Positionen, Zusammenfassung, Fußzeile
Tabelle der Bestellpositionen	Twig-Template und CSS der Positionstabelle anpassen
Zusammenfassung der Berechnung	Summen-/Berechnungsblock unterhalb der Positionen anpassen
Vorschau	Dokument-Vorschau mit echter Bestellung erzeugen
Twig-Variablen & Beispiele	Verfügbare Variablen und praktische Beispiele
Häufige Fragen (FAQ)	Antworten auf typische Fragen

Systemanforderungen

• Shopware 6.7.*

• PHP 8.2 oder höher

Hinweis: Dieses Plugin verändert keine Standard-Dateien von Shopware. Alle Anpassungen werden als Erweiterung der jeweiligen Dokumentkonfiguration gespeichert und beim Rendern eingefügt. Wird das Plugin deinstalliert (ohne Beibehaltung der Daten), werden die individuellen Anpassungen entfernt und es greifen wieder die Standard-Dokumente von Shopware.