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


---

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