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

# Installation & Aktivierung

## Installation über den Shopware Store

In der Regel beziehen Sie das Plugin direkt über den Shopware Store. Die Installation erfolgt dann vollständig in der Administration – Konsolenbefehle sind nicht erforderlich.

1. Erwerben bzw. abonnieren Sie das Plugin im Shopware Store: [Artikel Konfigurator für Eigene/Zusätzliche Felder](https://store.shopware.com/de/huebe59281510521m/artikel-konfigurator-fuer-eigene-zusaetzliche-felder.html).
2. Öffnen Sie in der Administration **Erweiterungen > Meine Erweiterungen**.
3. Klicken Sie bei „Artikel Konfigurator für Eigene/Zusätzliche Felder" auf **Installieren**.
4. Aktivieren Sie das Plugin anschließend über den Schalter.

> **Tipp:** Falls das Plugin noch nicht in der Liste erscheint, klicken Sie oben rechts auf **Aktualisieren**, damit die erworbenen Erweiterungen geladen werden.

## Alternative: Installation per ZIP-Upload

Liegt Ihnen das Plugin als ZIP-Datei vor, können Sie es auch manuell hochladen:

1. Öffnen Sie **Erweiterungen > Meine Erweiterungen**.
2. Klicken Sie auf **Erweiterung hochladen** und wählen Sie die Datei `HuebertAddOrderAttributes.zip` aus.
3. Klicken Sie nach dem Upload bei „Artikel Konfigurator für Eigene/Zusätzliche Felder" auf **Installieren** und aktivieren Sie das Plugin.

## Nach der Aktivierung

Beim Installieren legt das Plugin die benötigten Datenbanktabellen für die Felder, Übersetzungen, Zuordnungen (Produkt, Kategorie, dynamische Produktgruppe) und Abhängigkeiten an. Zusätzlich erweitert es die Storefront, die Produkt- und Bestellansicht in der Administration sowie das Beleg-Template.

Nach der Aktivierung finden Sie den Konfigurator in der Administration unter:

**Kataloge > Artikel Konfigurator**

## Deinstallation

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

* **Daten beibehalten:** Ihre angelegten Felder, Zuordnungen und Abhängigkeiten bleiben in der Datenbank erhalten. Bei einer erneuten Installation stehen sie wieder zur Verfügung.
* **Daten entfernen:** Die vom Plugin angelegten Tabellen werden gelöscht und alle Felder, Zuordnungen und Abhängigkeiten unwiderruflich entfernt.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/artikel-konfigurator/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.