> 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/readme.md).

# Einführung

Willkommen zur offiziellen Dokumentation des Plugins **Artikel Konfigurator für Eigene/Zusätzliche Felder** (`HuebertAddOrderAttributes`) von Hubyte für Shopware 6.

<figure><img src="/files/V8QWZbwkU2LKSZ7eZmSG" alt="" width="375"><figcaption></figcaption></figure>

## Was macht dieses Plugin?

Mit diesem Plugin erweitern Sie Ihre Artikel um zusätzliche Eingabe- und Auswahlfelder, die der Kunde direkt auf der Produktdetailseite ausfüllt. Die Eingaben werden in den Warenkorb übernommen, zur Bestellung gespeichert und können in der Administration, auf Belegen (z. B. Lieferschein) sowie in E-Mails ausgegeben werden.

So lassen sich konfigurierbare Produkte umsetzen – von einem einfachen Wunschtext über Gravuren, Maßangaben und Farbauswahl bis hin zum Datei-Upload. Optional können einzelne Optionen einen **Preisaufschlag** oder einen **Multiplikator** auf den Verkaufspreis auslösen.

### Kernfunktionen

* **Viele Feldtypen** – Textfeld, Textbereich, Zahlenfeld, Datum, Datum & Uhrzeit, Dropdown, Einzel-/Mehrfachauswahl, Farbauswahl als Farbkachel, Infotext (Tooltip/neben/unter dem Feld) und Medienupload
* **Flexible Zuordnung** – Felder pro Produkt, pro Kategorie oder über dynamische Produktgruppen anzeigen, mit klarer Prioritätenregel
* **Preisaufschläge & Multiplikator** – Optionen oder Zahlenfelder mit Preis hinterlegen; wahlweise als fester Aufschlag oder als Faktor auf den Verkaufspreis
* **Abhängigkeiten per Checkbox** – Felder erst nach Bestätigung einer Checkbox einblenden
* **Pflichtfelder & Validierung** – Felder als Pflicht markieren, Zeichenlängen begrenzen und per Regex validieren
* **Medienupload** – Dateiformate einschränken, maximale Upload-Größe und Vorschaubild konfigurieren
* **Ausgabe überall** – Anzeige im Warenkorb, in der Bestellung (Administration), auf Belegen und in der Bestellbestätigungs-Mail

## Übersicht

| Bereich                                                                                          | Beschreibung                                                             |
| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| [Installation & Aktivierung](/artikel-konfigurator/installation.md)                              | Plugin installieren und aktivieren                                       |
| [Erste Schritte](/artikel-konfigurator/erste-schritte.md)                                        | Wo finde ich den Konfigurator und wie ist er aufgebaut?                  |
| [Felder anlegen & Feldtypen](/artikel-konfigurator/felder-anlegen.md)                            | Alle Feldtypen und ihre Einstellungen im Detail                          |
| [Feldzuordnung & Prioritäten](/artikel-konfigurator/feldzuordnung.md)                            | Felder über Produkte, Kategorien oder dynamische Produktgruppen anzeigen |
| [Preisaufschläge & Multiplikator](/artikel-konfigurator/preise-und-multiplikator.md)             | Optionen mit Preis oder Faktor versehen                                  |
| [Abhängigkeiten (Checkbox)](/artikel-konfigurator/abhaengigkeiten.md)                            | Felder erst nach Bestätigung einer Checkbox einblenden                   |
| [Medienupload](/artikel-konfigurator/medienupload.md)                                            | Datei-Upload, Formate, Größe und Vorschaubild                            |
| [Plugin-Konfiguration](/artikel-konfigurator/plugin-konfiguration.md)                            | Globale Einstellungen des Plugins                                        |
| [Ausgabe in Bestellung & Belegen](/artikel-konfigurator/ausgabe-bestellung-belege.md)            | Anzeige in Administration, Belegen und Bestätigungs-Mail                 |
| [E-Mail-Template & Variablen](/artikel-konfigurator/ausgabe-bestellung-belege/email-template.md) | Zusatzfelder in E-Mails ausgeben – Vorlage, Beispiele und Variablen      |
| [PDF-Dokumente & Variablen](/artikel-konfigurator/ausgabe-bestellung-belege/pdf-dokumente.md)    | Zusatzfelder auf Belegen ausgeben – Vorlage, Beispiele und Variablen     |
| [Häufige Fragen (FAQ)](/artikel-konfigurator/faq.md)                                             | Antworten auf typische Fragen                                            |

## Systemanforderungen ab Plugin Version 4.x

* Shopware 6.7.\*
* PHP 8.x

> **Hinweis:** Die Felder werden zentral im Konfigurator verwaltet und den Produkten zugeordnet. Sie müssen also nicht an jedem Produkt einzeln gepflegt werden – ein Feld kann für viele Produkte, ganze Kategorien oder dynamische Produktgruppen gelten.