Dokument-Anpassung

Die PDF-Dokumente sind bewusst konfigurationsgetrieben — die meisten Layoutänderungen sind Schalter und Zahlenfelder in den Plugin-Einstellungen, keine Twig-Template-Anpassungen.

Was Sie in den Einstellungen ändern können

Änderung	Wo
Ein Produkt-Custom-Field als Zusatzspalte	Drucken
Breite dieser Spalte	Breite der zusätzlichen Spalte 1 (px)
Foto, Artikelnummer, Herstellernummer, EAN ein-/ausblenden	Spalten, die in der Artikelliste angezeigt werden sollen
Welche Positionstypen gedruckt werden	Arten von Artikeln, die angezeigt werden sollen
Digitale Artikel ausblenden	Digitale Artikel nicht anzeigen
Sortierung	Sortierreihenfolge + Sortierrichtung
Zeilengruppierung (Artikelliste)	Gruppieren nach
Zahlungs-, Versand-, Zusammenfassungs-Block ein-/ausblenden (Lieferschein)	Zahlungsart / Versandart / Auftragszusammenfassung anzeigen
Schriftgrößen anpassen	Schriftgröße, Schriftgröße für Artikel, Schriftgröße für Kommentar
Kundenkommentar fett setzen	Fette Schrift für Kommentar
Menge > 1 hervorheben	Menge-Highlight-Schalter

Jeder PDF-Typ (Lieferschein, Artikelliste) hat seine eigene Karte, sodass die beiden Layouts unabhängig getunt werden.

Spalte für benutzerdefiniertes Feld

Die Auswahl für das benutzerdefinierte Feld akzeptiert jedes Produkt-Custom-Field. In Ihrer Ausgabe:

Der Spaltentitel ist das Label des Custom Fields.
Der Zellwert ist der Wert des Custom Fields für das Produkt, ohne weitere Formatierung außer Escaping.
Leere Werte ergeben leere Zellen.

Anwendungsfälle: Lagerort (storage_location), Chargencode, Altersbeschränkungs-Flag, Gewicht, Verpackungshinweise.

Typografie-Leiter

Drei Schriftgrößen-Regler decken fast jede Lesbarkeitsanforderung ab:

Schriftgröße — Basis-Textgröße für Adressen, Kopfzeile, Fußzeile.
Schriftgröße für Artikel — meist größer als die Basis, damit Kommissionierer sie aus Armlänge lesen können.
Schriftgröße für Kommentar — die Checkout-Notiz des Kunden, unabhängig von den Positionen dimensioniert, weil der Kommentar “weicher” Inhalt ist als die “harte” Kommissionierliste.

Die Standards — 12 / 14 / 12 — funktionieren für die meisten A4-Drucke. Erhöhen Sie sie um 2 – 4 für Thermodrucker und großformatige Lesbarkeit.

Über die Einstellungen hinaus: Templates bearbeiten

Wenn Schalter und Schriftgrößen nicht ausreichen, liegen die Twig-Templates unter:

src/Resources/documents/
  view_orders.html.twig    ← Lieferscheine
  view_items.html.twig     ← Artikelliste

Das sind Standard-Shopware-Twig-Templates, die aus Ihrem Projekt überschrieben werden können (z. B. Resources/views/storefront/documents/ in Ihrem Shop-Plugin / Theme-Override). Gängige Anpassungen:

Eigener Kopf-/Fußbereich mit Shop-Branding.
Bedingte Bereiche für bestimmte Verkaufskanäle oder Versandarten.
Anpassung der Seitenumbrüche (Dompdf respektiert page-break-after: always etc.).

Beim Überschreiben beachten: Das Dokument wird von Dompdf gerendert — die CSS-Unterstützung ist eine Teilmenge des vollen Browser-CSS. Bleiben Sie bei Layout-Primitiven (Tabellen-Layouts, einfache float-/display-Regeln, kein Flexbox / Grid).

Seitennummerierung

Die “X / Y”-Fußzeile wird in PHP hinzugefügt, nachdem Dompdf das Dokument gerendert hat, indem das Dompdf-Canvas gelesen wird. Sie ist nicht Teil des Twig-Templates — versuchen Sie nicht, einen eigenen “Page”-Platzhalter einzubauen, das kollidiert.