# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hubyte.de/pdf-dokumenten-template-bearbeiten/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
