# Erste Schritte

## Wo finde ich die Einstellungen?

Die Anpassungen erfolgen nicht in der Plugin-Konfiguration, sondern direkt bei der jeweiligen Dokumentkonfiguration:

**Einstellungen > Dokumente > \[Dokumenttyp auswählen]**

Wählen Sie dort z. B. **Rechnung**, **Lieferschein**, **Gutschrift** oder **Stornorechnung**. Unterhalb der Shopware-Standardeinstellungen blendet das Plugin zwei zusätzliche Karten ein:

| Karte                                                         | Inhalt                                                                                                                                                |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Dokumenten Template bearbeiten (allgemeine Einstellungen)** | Inhalt und CSS der Dokumentblöcke (Briefkopf, Empfänger, Absender, Positionen, Zusammenfassung, Fußzeile) sowie der Schalter „Lieferdatum ausblenden" |
| **Dokumenten Template bearbeiten (Bestellposition)**          | Twig-Template und CSS der Positionstabelle sowie das Template der Zusammenfassung                                                                     |

> **Wichtig:** Die Bearbeitungsfelder erscheinen erst, **nachdem die Dokumentkonfiguration einmal gespeichert wurde**. Bei einer brandneuen Konfiguration sehen Sie zunächst den Hinweis „Da es sich um ein neues Dokument handelt, müssen Sie dieses zuerst speichern." Speichern Sie dann einmal – danach stehen die Editoren bereit.

## Aufbau der Oberfläche

### Karte „Allgemeine Einstellungen"

* **Lieferdatum ausblenden** – Schalter, um das Lieferdatum im Dokument auszublenden.
* **Block-Auswahl** – Über ein Dropdown wählen Sie den zu bearbeitenden Dokumentbereich (Briefkopf, Empfänger, Absender, Positionen, Zusammenfassung, Fußzeile).
* **Sprachumschalter** – Rechts neben der Block-Auswahl. Inhalte und Templates werden je Sprache gespeichert.
* **Style-Editor (CSS)** – Code-Editor für das CSS des gewählten Blocks.
* **Inhalt-Editor (Rich-Text)** – Texteditor für den Inhalt des gewählten Blocks.

### Karte „Bestellposition"

* **Styles für die Tabelle der Bestellpositionen** – CSS-Editor für die Positionstabelle, inkl. Button **Standard-Style (CSS) laden**.
* **Tabelle für Bestellpositionen (Twig-Template)** – Twig-Editor für die Positionstabelle (Experteneinstellung), inkl. Button **Standardvorlage laden**.
* **Twig-Template für die Zusammenfassung** – Twig-Editor für die Summen-/Berechnungsdarstellung unterhalb der Positionen, inkl. Button **Standardvorlage laden**.

## Empfohlener Ablauf

1. Dokumenttyp öffnen und – falls neu – einmal speichern.
2. Über den **Sprachumschalter** die gewünschte Sprache wählen.
3. Inhalte und Styles in den Blöcken anpassen bzw. die Standardvorlagen für Tabelle/Zusammenfassung laden und bearbeiten.
4. Speichern.
5. Mit der [Vorschau](/pdf-dokumenten-template-bearbeiten/vorschau.md) das Ergebnis anhand einer echten Bestellung als PDF prüfen.

> **Tipp:** Beginnen Sie mit der Funktion **Standardvorlage laden** für die Positionstabelle und die Zusammenfassung. So starten Sie mit dem originalgetreuen Shopware-Layout und passen nur die Stellen an, die Sie wirklich ändern möchten.


---

# 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/erste-schritte.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.