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


---

# 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/english-documentation/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.