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

# Plugin-Konfiguration

Die globalen Einstellungen des Plugins finden Sie unter:

<figure><img src="/files/H6x4mMs0N9UsYqn1v64E" alt=""><figcaption></figcaption></figure>

**Einstellungen > System > Plugins**, dann beim Plugin **Artikel Konfigurator für Eigene/Zusätzliche Felder** auf das Kontextmenü **… > Konfiguration** klicken.

Die Einstellungen sind in mehrere Bereiche (Karten) unterteilt.

## Verwaltung der Felder

Ein Hinweis, der erklärt, dass die eigentliche Verwaltung des Konfigurators unter **Kataloge > Artikel Konfigurator** erfolgt. Dort verwalten Sie die Felder und steuern über Abhängigkeiten die Anzeige per Checkbox.

## Einstellungen

| Option                                          | Schlüssel               | Beschreibung                                                                                                                                                                       |
| ----------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Preisaufschlag für Optionsfelder aktivieren** | `enablePrices`          | Aktiviert die Preisfunktion. Erst dann lassen sich Optionen mit Preis bzw. Faktor hinterlegen (siehe [Preise & Multiplikator](/artikel-konfigurator/preise-und-multiplikator.md)). |
| **Attribute an Kundenkommentar übergeben**      | `showInCustomerComment` | Wenn aktiv, werden die ausgefüllten Attribute zusätzlich in den Kundenkommentar der Bestellung übernommen.                                                                         |
| **Getrennte Menge für Attribut mit Preisen**    | `separatedQuantity`     | Für eine zukünftige Version vorgesehen, aktuell deaktiviert.                                                                                                                       |
| **Faktoren im Warenkorb anzeigen**              | `displayMarkupFactors`  | Zeigt die zugrunde liegenden Faktoren im Warenkorb an. Nur relevant bei Verwendung von Multiplikatoren.                                                                            |

## Wenn Felder über Kategorien zugeordnet werden

| Option                                | Schlüssel                | Beschreibung                                                                      |
| ------------------------------------- | ------------------------ | --------------------------------------------------------------------------------- |
| **Unter-Kategorien mit einbeziehen**  | `includeChildCategories` | Berücksichtigt zusätzlich die untergeordneten Kategorien der gewählten Kategorie. |
| **Eltern-Kategorien mit einbeziehen** | `includeParentCategory`  | Berücksichtigt zusätzlich die übergeordneten Kategorien der gewählten Kategorie.  |

Beide Optionen greifen nur, wenn die Feldzuordnung **per Kategorie** erfolgt (siehe [Feldzuordnung & Prioritäten](/artikel-konfigurator/feldzuordnung.md)).

## Zusatzfeld im Artikel für Admin (Shopbetreiber)

| Option                                                             | Schlüssel                | Beschreibung                                                                                                      |
| ------------------------------------------------------------------ | ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Label für das zusätzliche Feld in der Bestellbestätigungs-Mail** | `konfiguratorAdminLabel` | Definiert die Beschriftung, die vor dem Text dieses Zusatzfeldes in der Bestellbestätigungs-Mail ausgegeben wird. |

Der zugehörige **Text** wird je Artikel im Reiter **Allgemein** ganz unten in der Karte **Hubyte Artikel Konfigurator** hinterlegt. Damit kann der Shopbetreiber pro Artikel eine zusätzliche, eigene Angabe in die Bestellbestätigungs-Mail einfließen lassen.

## Feldtyp: Medienupload

| Option                        | Schlüssel             | Beschreibung                                                 |
| ----------------------------- | --------------------- | ------------------------------------------------------------ |
| **Vorschaubild anzeigen**     | `previewImage`        | Zeigt beim Medienupload ein Vorschaubild im Artikel an.      |
| **Bildbreite in px**          | `imageWidth`          | Breite des Vorschaubildes (Standard: 50).                    |
| **Dateiformate einschränken** | `fileTypeRestriction` | Ermöglicht das Einschränken zulässiger Dateiformate je Feld. |

Mehr dazu unter [Medienupload](/artikel-konfigurator/medienupload.md).

> **Hinweis:** Mehrere Einstellungen (z. B. Preise) können pro **Sales Channel** unterschiedlich gesetzt werden. Wählen Sie dazu oben in der Konfiguration den gewünschten Verkaufskanal aus.


---

# 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/plugin-konfiguration.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.