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

# Installation & Aktivierung

## Installation

Sie können das Plugin auf den üblichen Wegen installieren:

**Über die Administration (ZIP-Upload)**

1. Öffnen Sie **Einstellungen > System > Plugins**.
2. Klicken Sie auf **Plugin hochladen** und wählen Sie die Datei `HuebertCustomDocuments.zip` aus.
3. Klicken Sie nach dem Upload bei „Dokumenten Template bearbeiten" auf **Installieren**.
4. Aktivieren Sie das Plugin anschließend über den Schalter.

**Über die Konsole (Composer/CLI)**

```bash
bin/console plugin:refresh
bin/console plugin:install --activate HuebertCustomDocuments
bin/console cache:clear
```

## Nach der Aktivierung

Beim Installieren legt das Plugin die benötigten Datenbanktabellen an (`hue_custom_document` und `hue_custom_document_translation`) und erweitert die Shopware-Dokumentkonfiguration. Es sind keine weiteren globalen Einstellungen nötig – die Anpassungen erfolgen direkt pro Dokumenttyp (siehe [Erste Schritte](/pdf-dokumenten-template-bearbeiten/erste-schritte.md)).

> **Tipp:** Leeren Sie nach der Installation einmal den Cache, damit die Erweiterung in der Administration und beim Dokument-Rendering korrekt geladen wird.

## Deinstallation

Beim Deinstallieren werden Sie gefragt, ob die Benutzerdaten beibehalten werden sollen:

* **Daten beibehalten:** Ihre individuellen Templates und Styles bleiben in der Datenbank erhalten. Bei einer erneuten Installation stehen sie wieder zur Verfügung.
* **Daten entfernen:** Die Tabellen `hue_custom_document` und `hue_custom_document_translation` werden gelöscht und alle individuellen Anpassungen unwiderruflich entfernt. Es greifen wieder die Standard-Dokumente von Shopware.