Zur Erstellung des Angebots-PDF wird die Shopware Standard Komponente zur PDF-Belegerstellung verwendet. Die zugehörige Konfiguration findest du unter Einstellungen → Grundeinstellungen → Shopeinstellungen → PDF-Belegerstellung. Hier kannst du das Dokument an deine Vorstellungen anpassen, indem du eine eigens erstellte Template-Datei verwendest. Das Template erweitert das Shopware Standard Rechnungstemplate index.tpl. Hierdurch erbt das Template die Grundstruktur und das Styling des Rechnungstemplates.
Hier findest du die Anleitung von Shopware zum Erstellen bzw. Anpassen von PDF-Dokumenten.
Template-Datei erstellen oder anpassen
- Erstelle eine .tpl Datei im Ordner themes/Frontend/Bare/documents bzw. in dem Ordner deines verwendeten Themes für Dokumente mit folgendem Inhalt:
{extends file=“documents/offer.tpl”}
{namespace name=“documents/viison_offer_management/offer”} - Alternativ kannst du auch die bestehende Template-Datei für das Angebots-PDF öffnen unter:
/engine/Shopware/Plugins/Community/Backend/ViisonOfferManagement/Views/documents/offer.tpl - Nun können nach der Shopware Standardlogik zur Dokumentenerweiterung eigene Felder hinzugefügt werden. Für eigene Felder pro Position auf dem Dokument sind extra_fields Blöcke vorgesehen.
- Jede Spalte der Tabelle (Header-Zeile und Inhalt) kann durch Blöcke erweitert oder ersetzt werden.
- Innerhalb der Tabelle (block name="document_index_table_each") hast du über {$position.articleDetail} [Instanz des Shopware Models Shopware\Models\Article\Detail] Zugriff auf die Artikelinformationen der jeweiligen Angebotsposition. Bitte beachte, dass nicht zu jeder Angebotsposition zwingend Artikelinformationen zur Verfügung stehen. Beim Zugriff auf die Artikelinformationen einer Angebotsposition solltest du daher zunächst immer prüfen, ob diese auch zur Verfügung stehen:
{if $position.articleDetail}
{$position.articleDetail->getNumber()}
{/if} - Anschließend muss in der PDF-Belegerstellung nur noch der Name des “Templates” durch den Namen der neuen .tpl Datei ersetzt werden.
- Wichtig: Die erstellte Datei darf NICHT offer.tpl heißen.
Bitte beachte, dass nach erfolgreicher Anpassung des Dokumententemplates die Vorschau-Funktion in der PDF Belegerstellung von Shopware für das Angebote-PDF unter Umständen nicht korrekt funktioniert. Die PDF wird bei Angebotserstellung dennoch korrekt erzeugt.