> 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/faq.md).

# Häufige Fragen (FAQ)

### Ich sehe die Bearbeitungsfelder nicht – woran liegt das?

Die Editoren erscheinen erst, **nachdem die Dokumentkonfiguration einmal gespeichert wurde**. Bei einer neuen Konfiguration sehen Sie zunächst nur den Hinweis „Da es sich um ein neues Dokument handelt, müssen Sie dieses zuerst speichern." Speichern Sie die Konfiguration – danach werden die Felder geladen (ggf. lädt die Seite einmal automatisch neu).

### Für welche Dokumente funktioniert das Plugin?

Für die Standard-PDF-Dokumente von Shopware: **Rechnung**, **Lieferschein**, **Gutschrift** und **Stornorechnung**. Die Anpassung erfolgt pro Dokumenttyp unter **Einstellungen > Dokumente**.

### Gelten meine Anpassungen für alle Verkaufskanäle/Sprachen?

Inhalte und Templates werden **pro Sprache** gespeichert (siehe Sprachumschalter). Die Zuordnung zu Verkaufskanälen erfolgt über die Dokumentkonfiguration von Shopware selbst.

### Was passiert, wenn ich ein Feld leer lasse?

Dann wird der jeweilige Standard von Shopware verwendet. Beispiele: Eine leere Fußzeile zeigt die Standard-Fußzeile; eine leere Positionstabelle bzw. Zusammenfassung verwendet das Standard-Rendering von Shopware.

### Wie komme ich zum Originallayout zurück?

Nutzen Sie die Buttons **Standardvorlage laden** bzw. **Standard-Style (CSS) laden**. Diese stellen die mitgelieferten, originalgetreuen Vorlagen wieder her. Alternativ leeren Sie das jeweilige Feld, um auf das Shopware-Standardrendering zurückzufallen.

### Meine Vorschau bzw. das Dokument schlägt fehl – was tun?

Meist liegt ein Twig-Syntaxfehler im angepassten Template vor (z. B. ein nicht geschlossenes Tag). Die [Vorschau](/pdf-dokumenten-template-bearbeiten/vorschau.md) zeigt die konkrete Fehlermeldung an. Korrigieren Sie das Template und versuchen Sie es erneut.

### Werden meine Anpassungen bei einem Plugin-Update überschrieben?

Nein. Ihre Inhalte, Styles und Templates liegen in der Datenbank (`hue_custom_document`) und bleiben bei Updates erhalten. Lediglich beim Klick auf **Standardvorlage laden** wird das jeweilige Feld bewusst mit der mitgelieferten Vorlage überschrieben.

### Was passiert bei der Deinstallation?

Wählen Sie beim Deinstallieren **Daten beibehalten**, bleiben Ihre Anpassungen erhalten. Wählen Sie **Daten entfernen**, werden die Plugin-Tabellen gelöscht und alle Anpassungen unwiderruflich entfernt; es greifen wieder die Standard-Dokumente von Shopware.

### Ich brauche Unterstützung bei einer individuellen Anpassung.

Gerne unterstützen wir Sie: [hubyte.de/projekt-anfragen](https://www.hubyte.de/projekt-anfragen)
