# Einführung

Willkommen zur offiziellen Dokumentation des Plugins **Dokumenten Template bearbeiten** (`HuebertCustomDocuments`) von Hubyte für Shopware 6.

## Was macht dieses Plugin?

Mit diesem Plugin können Sie die Twig-Templates der PDF-Dokumente in Shopware – also **Rechnung**, **Lieferschein**, **Gutschrift** und **Stornorechnung** – direkt in der Administration anpassen. Layout, Inhalt und Aufbau der Dokumente lassen sich vollständig überarbeiten, ohne dafür eigene Dateien im Theme oder ein individuelles Plugin entwickeln zu müssen.

Die Anpassungen erfolgen pro **Dokumentkonfiguration** (Dokumenttyp) und werden in der Datenbank gespeichert. Beim Erzeugen eines Dokuments werden Ihre individuellen Inhalte, Styles und Templates automatisch in das Standard-Dokument von Shopware eingefügt.

### Kernfunktionen

* **Bearbeitbare Dokumentbereiche** – Briefkopf, Empfänger, Absender, Positionen, Zusammenfassung und Fußzeile mit eigenem Inhalt (Rich-Text) und eigenem CSS
* **Eigene Positionstabelle** – Das Twig-Template für die Tabelle der Bestellpositionen frei bearbeiten (Experteneinstellung)
* **Eigene Zusammenfassung** – Das Twig-Template für die Berechnung/Summen unterhalb der Positionen anpassen
* **Mehrsprachig** – Inhalte und Templates pro Sprache pflegen (Sprachumschalter)
* **Lieferdatum ausblenden** – Lieferdatum bei Bedarf per Schalter ausblenden
* **Live-Vorschau** – Dokument mit einer echten Bestellung als PDF-Vorschau erzeugen, ohne ein Dokument anzulegen
* **Standardvorlagen laden** – Mit einem Klick die mitgelieferten Standard-Templates (Tabelle, Styles, Zusammenfassung) wiederherstellen

## Übersicht

| Bereich                                                                                           | Beschreibung                                                          |
| ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [Installation & Aktivierung](/pdf-dokumenten-template-bearbeiten/installation.md)                 | Plugin installieren und aktivieren                                    |
| [Erste Schritte](/pdf-dokumenten-template-bearbeiten/erste-schritte.md)                           | Wo finde ich die Einstellungen und wie ist die Oberfläche aufgebaut?  |
| [Dokumentenblöcke](/pdf-dokumenten-template-bearbeiten/dokument-bloecke.md)                       | Briefkopf, Empfänger, Absender, Positionen, Zusammenfassung, Fußzeile |
| [Tabelle der Bestellpositionen](/pdf-dokumenten-template-bearbeiten/bestellpositionen-tabelle.md) | Twig-Template und CSS der Positionstabelle anpassen                   |
| [Zusammenfassung der Berechnung](/pdf-dokumenten-template-bearbeiten/zusammenfassung-template.md) | Summen-/Berechnungsblock unterhalb der Positionen anpassen            |
| [Vorschau](/pdf-dokumenten-template-bearbeiten/vorschau.md)                                       | Dokument-Vorschau mit echter Bestellung erzeugen                      |
| [Twig-Variablen & Beispiele](/pdf-dokumenten-template-bearbeiten/twig-variablen.md)               | Verfügbare Variablen und praktische Beispiele                         |
| [Häufige Fragen (FAQ)](/pdf-dokumenten-template-bearbeiten/faq.md)                                | Antworten auf typische Fragen                                         |

## Systemanforderungen

* Shopware 6.7.\*
* PHP 8.2 oder höher

> **Hinweis:** Dieses Plugin verändert keine Standard-Dateien von Shopware. Alle Anpassungen werden als Erweiterung der jeweiligen Dokumentkonfiguration gespeichert und beim Rendern eingefügt. Wird das Plugin deinstalliert (ohne Beibehaltung der Daten), werden die individuellen Anpassungen entfernt und es greifen wieder die Standard-Dokumente von Shopware.


---

# 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/readme.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.