Personalizacja dokumentów

Dokumenty PDF są celowo sterowane konfiguracją — większość zmian layoutu to przełączniki i pola liczbowe w ustawieniach wtyczki, nie edycje szablonów Twig.

Co można zmienić w ustawieniach

Zmiana	Gdzie
Pole własne produktu jako dodatkowa kolumna	Druk
Szerokość tej kolumny	Szerokość dodatkowej kolumny 1 (px)
Pokaż/ukryj zdjęcie, numer produktu, numer producenta, EAN	Kolumny do wyświetlenia na liście pozycji
Które typy linii drukować	Typy pozycji do wyświetlenia
Ukryj pozycje cyfrowe	Nie pokazuj pozycji cyfrowych
Porządek sortowania	Porządek sortowania + Kierunek sortowania
Grupowanie wierszy (Lista pozycji)	Grupuj po
Pokaż / ukryj bloki płatności, dostawy, podsumowania (Packing Slip)	Pokaż metodę płatności / dostawy / podsumowanie zamówienia
Dostosuj rozmiary fontów	Rozmiar fontu, Rozmiar fontu pozycji, Rozmiar fontu komentarza
Pogrub komentarz klienta	Pogrubiony font dla komentarza
Podświetl ilość > 1	Przełącznik podświetlenia

Każdy typ PDF (Packing Slip, Lista pozycji) ma osobną kartę, więc dwa layouty stroi się niezależnie.

Kolumna pola własnego

Selektor pola własnego przyjmuje dowolne pole własne produktu. W wydruku:

• Tytuł kolumny to label pola własnego.
• Wartość komórki to wartość pola własnego dla danego produktu, bez formatowania poza escapingiem.
• Puste wartości renderują się jako puste komórki.

Przykłady: lokalizacja magazynowa (storage_location), kod partii, flaga ograniczenia wiekowego, waga, notatki pakownicze.

Drabina typograficzna

Trzy regulatory rozmiaru fontu pokrywają niemal każdą potrzebę czytelności:

• Rozmiar fontu — bazowy rozmiar tekstu, używany dla adresów, nagłówków, stopki.
• Rozmiar fontu pozycji — zwykle większy od bazowego, by kompletator mógł czytać z odległości ramienia.
• Rozmiar fontu komentarza — notatka klienta z checkout, dimensjonowana niezależnie od linii, bo komentarz to “miękka” treść w kontraście do “twardej” pick listy.

Defaulty — 12 / 14 / 12 — działają dla większości wydruków A4. Podbij o 2 – 4 dla drukarek termicznych i czytelności wielkoformatowej.

Poza ustawieniami: edycja szablonów

Jeśli przełączniki i rozmiary fontów nie pokrywają tego, czego potrzebujesz, szablony Twig leżą w:

src/Resources/documents/
  view_orders.html.twig    ← Packing Slips
  view_items.html.twig     ← Lista pozycji

To standardowe szablony Twig Shopware, które można nadpisać z poziomu projektu (np. Resources/views/storefront/documents/ w override Twojej wtyczki / motywu). Typowe modyfikacje:

• Własny header / footer z brandingiem sklepu.
• Sekcje warunkowe dla konkretnych kanałów sprzedaży lub metod dostawy.
• Tweaki page-breakingu (Dompdf respektuje page-break-after: always itd.).

Przy nadpisywaniu pamiętaj: dokument jest renderowany przez Dompdf — wsparcie CSS to podzbiór pełnego CSS przeglądarki. Trzymaj się prymitywów layoutowych (layouty tabelowe, proste reguły float / display, bez Flexbox / Grid).

Numeracja stron

Stopka “X / Y” jest dodawana w PHP po renderze Dompdf, przez odczyt canvasu Dompdf. Nie jest częścią szablonu Twig — nie próbuj wkładać własnego placeholdera “page”, zderzy się.