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

# Installation & activation

## Installation

You can install the plugin in the usual ways:

**Via the administration (ZIP upload)**

1. Open **Settings > System > Plugins**.
2. Click **Upload plugin** and select the file `HuebertCustomDocuments.zip`.
3. After the upload, click **Install** next to "Edit documents template".
4. Then activate the plugin via the toggle.

**Via the console (Composer/CLI)**

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

## After activation

During installation the plugin creates the required database tables (`hue_custom_document` and `hue_custom_document_translation`) and extends the Shopware document configuration. No further global settings are required – customizations are made directly per document type (see [Getting started](/pdf-dokumenten-template-bearbeiten/english-documentation/erste-schritte.md)).

> **Tip:** Clear the cache once after installation so the extension is loaded correctly in the administration and during document rendering.

## Uninstallation

When uninstalling, you are asked whether the user data should be kept:

* **Keep data:** Your custom templates and styles remain in the database. They are available again upon reinstallation.
* **Remove data:** The tables `hue_custom_document` and `hue_custom_document_translation` are dropped and all customizations are removed irreversibly. Shopware's standard documents apply again.