Einführung

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

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	Plugin installieren und aktivieren
Erste Schritte	Wo finde ich den Konfigurator und wie ist er aufgebaut?
Felder anlegen & Feldtypen	Alle Feldtypen und ihre Einstellungen im Detail
Feldzuordnung & Prioritäten	Felder über Produkte, Kategorien oder dynamische Produktgruppen anzeigen
Preisaufschläge & Multiplikator	Optionen mit Preis oder Faktor versehen
Abhängigkeiten (Checkbox)	Felder erst nach Bestätigung einer Checkbox einblenden
Medienupload	Datei-Upload, Formate, Größe und Vorschaubild
Plugin-Konfiguration	Globale Einstellungen des Plugins
Ausgabe in Bestellung & Belegen	Anzeige in Administration, Belegen und Bestätigungs-Mail
E-Mail-Template & Variablen	Zusatzfelder in E-Mails ausgeben – Vorlage, Beispiele und Variablen
PDF-Dokumente & Variablen	Zusatzfelder auf Belegen ausgeben – Vorlage, Beispiele und Variablen
Häufige Fragen (FAQ)	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.