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