> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/pdf-dokumenten-template-bearbeiten/vorschau.md).

# Vorschau

Damit Sie Ihre Anpassungen nicht erst durch das Anlegen eines echten Dokuments prüfen müssen, bietet das Plugin eine **Live-Vorschau**. Diese erzeugt das Dokument als PDF anhand einer echten Bestellung und öffnet es in einem neuen Tab.

<figure><img src="/files/aPtSqlcgfnOcpDK1pJqi" alt=""><figcaption></figcaption></figure>

## Vorschau erzeugen

Die Vorschau-Funktion finden Sie im Kopfbereich der Dokumentkonfiguration (neben den Aktions-Buttons), sobald die Konfiguration gespeichert wurde:

1. **Bestellung wählen** – Über das Auswahlfeld „Bestellung wählen (Standard: neueste)" wählen Sie die Bestellung, mit der die Vorschau erstellt werden soll. Treffen Sie keine Auswahl, wird automatisch die **neueste Bestellung** verwendet.
2. **Vorschau** – Klicken Sie auf den Button **Vorschau**. Das PDF wird generiert und in einem neuen Browser-Tab geöffnet.

> **Wichtig:** Speichern Sie Ihre Änderungen, bevor Sie die Vorschau erzeugen. Die Vorschau rendert den aktuell gespeicherten Stand des Dokuments.

## Voraussetzungen

* Es muss **mindestens eine Bestellung** im Shop vorhanden sein. Andernfalls erscheint die Meldung: *„Keine Bestellung gefunden. Es wird mindestens eine Bestellung benötigt, um eine Vorschau zu generieren."*
* Die Dokumentkonfiguration muss gespeichert sein (kein neues, ungespeichertes Dokument).

## Fehlerbehebung

Schlägt die Generierung fehl, zeigt die Administration eine Fehlermeldung mit der konkreten Ursache an (z. B. ein Twig-Syntaxfehler in Ihrem Template). Typische Ursachen:

| Meldung / Symptom                             | Mögliche Ursache & Lösung                                                        |
| --------------------------------------------- | -------------------------------------------------------------------------------- |
| Twig-/Syntaxfehler in der Fehlermeldung       | Prüfen Sie Ihr Twig-Template auf nicht geschlossene Tags oder Tippfehler         |
| „Die Vorschau konnte nicht generiert werden." | Allgemeiner Fehler – prüfen Sie Template, gewählte Bestellung und Server-Logs    |
| „Keine Bestellung gefunden."                  | Legen Sie mindestens eine Bestellung an oder wählen Sie eine konkrete Bestellung |

> **Tipp:** Die Vorschau ist ideal, um Twig-Anpassungen an Positionstabelle und Zusammenfassung schnell zu testen, da Fehler im Template direkt als Meldung sichtbar werden.