# configento.app – Full documentation > Complete user documentation of configento.app, the cloud SaaS product configurator for Magento, Shopware, Shopify, PrestaShop and any website (HTML5 snippet). Short overview, pricing and key URLs: https://configento.app/llms.txt ## Contact Questions about configento.app, or need help setting up a configurator? Contact form, live chat and free live webinars: https://configento.app/kontakt - Email: info@configento.app - Phone: +49 2802 70795 20 (office hours 9:30 am – 5:30 pm) - Address: justSelling GmbH, Abteilung configento.app, Am Lippeglacis 2, 46483 Wesel, Germany - Free trial with free advice: https://configento.app/testen - Project services by justSelling (concept, setup, shop integration) with a project request form, plus partner agencies: https://configento.app/partner --- # Erste Komponente anlegen Source: https://configento.app/docs/erste-komponente-anlegen Section: Erste Schritte In configento.app heißt jeder Konfigurator **Komponente**. Eine Komponente enthält alle Merkmale, Werte, Preise und Regeln für ein Produkt oder eine Produktgruppe. Dieser Artikel führt dich einmal komplett durch: von der leeren Komponente über Merkmale und Aufpreise bis zur veröffentlichten Fassung, die dein Shop anzeigt. Die Details zu jedem Schritt findest du in den verlinkten Fachartikeln. ## Das Prinzip in drei Sätzen 1. Du baust die Komponente im Editor auf und **speicherst** sie. Gespeichert ist ein Entwurf – den sieht nur die Vorschau. 2. Mit **Veröffentlichen** wird der aktuelle Stand geprüft und für die Shops freigegeben. 3. Dein Shop oder deine Website bindet die Komponente über ein Plugin oder ein HTML-Snippet ein und zeigt immer die **zuletzt veröffentlichte** Fassung. ## Schritt 1: Admin öffnen Melde dich im [Service-Portal](/docs/login-und-account-navigation) an und klicke bei deinem Dienst auf **Verwalten**. Es öffnet sich die Komponenten-Übersicht. ![Komponenten-Übersicht mit Suche, Tags, „Neue Komponente“ und „ZIP importieren“](/storage/app/media/docs/erste-komponente/01-komponenten-uebersicht.webp) Die Hauptnavigation hat vier Einträge: | Eintrag | Inhalt | |---|---| | **Komponenten** | Alle deine Konfiguratoren | | **Bausteine** | Zentral gepflegte Preislisten und Tabellen, die mehrere Komponenten nutzen | | **Einstellungen** | Einstellungen für das ganze Konto, z. B. Sprachen und Integrationen – siehe [Globale Einstellungen](/docs/globale-einstellungen) | | **Einführung** | Startet die Tour durch die Oberfläche noch einmal | ### Leeres Konto: Beispielkomponenten Ist dein Konto noch leer, fragt dich der Admin beim ersten Besuch, ob er vier **Beispielkomponenten** anlegen soll. Sie zeigen ein kombiniertes Produktbild, Kombinations- und Formelmerkmale, ein Regelwerk und grafische Icons. Du kannst sie wie jede andere Komponente bearbeiten, veröffentlichen oder löschen – sie eignen sich gut als Vorlage zum Abschauen. Hast du die Frage weggeklickt, erreichst du sie über **Einführung** wieder, solange das Konto leer ist. ## Schritt 2: Komponente anlegen ![Dialog „Neue Komponente“ mit dem Feld „Titel“](/storage/app/media/docs/erste-komponente/02-neue-komponente.webp) In der Komponenten-Übersicht hast du zwei Wege: - **Neue Komponente:** Gib einen **Titel** ein, z. B. „Rollo nach Maß“, und klicke auf **Erstellen**. Der Editor öffnet sich mit einer leeren Komponente. - **ZIP importieren:** Übernimmt eine Komponente, die du vorher mit **Komponente exportieren** als ZIP gesichert hast – etwa aus einem anderen Konto. Eine bestehende Komponente als Ausgangspunkt nutzt du mit **Komponente duplizieren** auf ihrer Karte. Lieber per Chat? Der KI-Assistent legt die Komponente samt Merkmalen für dich an – siehe [Mit dem KI-Assistenten](#mit-dem-ki-assistenten). ## Schritt 3: Der Editor im Überblick ![Editor: links der Strukturbaum, in der Mitte die Merkmale, rechts die Einstellungen des gewählten Merkmals](/storage/app/media/docs/erste-komponente/03-editor-ueberblick.webp) Der Editor hat drei Spalten: | Bereich | Inhalt | |---|---| | **Links** | Vier Reiter: **Merkmale** (der Strukturbaum mit Gruppen und Merkmalen), **Regeln**, **Einstellungen** (der ganzen Komponente) und **Versionen** | | **Mitte** | Umschalter **Bearbeiten** / **Vorschau**. *Bearbeiten* zeigt alle Merkmale schematisch – ein Klick wählt ein Merkmal aus. *Vorschau* zeigt den echten Konfigurator. | | **Rechts** | Die **Einstellungen** des ausgewählten Merkmals oder der ausgewählten Gruppe | Oben rechts findest du **Rückgängig**, **Zurücksetzen** (verwirft alle Änderungen und lädt die zuletzt veröffentlichte Fassung neu) und **Veröffentlichen**. Gibt es ungespeicherte Änderungen, erscheint über dem rechten Bereich der Knopf **Speichern**. ## Schritt 4: Gruppen und Merkmale anlegen Merkmale liegen immer in einer **Gruppe**. Eine neue Komponente hat noch keine, deshalb beginnst du dort: 1. Klicke im Reiter **Merkmale** auf **Gruppe hinzufügen**. Es entsteht eine Gruppe „Neue Gruppe“. Über das Zahnrad (**Gruppeneinstellungen**) gibst du ihr einen Namen, z. B. „Maße“. 2. Klicke an der Gruppe auf **+** (**Merkmal hinzufügen**). Es entsteht ein Merkmal „Neues Merkmal“ vom Typ **Auswahl**. 3. Stelle rechts unter **Grundeinstellungen** ein: | Feld | Bedeutung | |---|---| | **Bezeichnung** | Was deine Kunden sehen, z. B. „Farbe“ | | **Interner Name (ID)** | Eindeutiger Name für Formeln und Regeln, z. B. `farbe`. Vergib ihn gleich am Anfang sprechend – den automatisch vergebenen Namen `new_option_…` willst du später in keiner Formel sehen. | | **Datenkategorie** | Grobe Art des Merkmals (siehe unten) | | **Datentyp** | Konkrete Darstellung innerhalb der Kategorie | Wie viele Gruppen du brauchst und wie sie angezeigt werden (ohne Gruppen, als Tabs, als Accordion oder Schritt für Schritt als Wizard), erklärt [Merkmalsgruppen & Wizard](/docs/merkmalsgruppen-wizard). ### Die vier Datenkategorien | Datenkategorie | Datentypen (Auswahl) | Wofür | |---|---|---| | **Diskretes Merkmal** | Auswahl, Radio Buttons, Checkbox, Liste mit Bildern, Mehrfachauswahl | Der Kunde wählt aus festen **Werten**, z. B. Farbe oder Antrieb | | **Freie Eingabe** | Kleines Eingabefeld, Großes Eingabefeld, Datum | Der Kunde gibt etwas ein, z. B. Breite in cm | | **Berechnung** | Formel, Preisliste, Einfache Kombination | Der Konfigurator rechnet selbst, z. B. Fläche oder Matrixpreis | | **Frontend** | Statisches Feld, Aktions-Button, Dateiupload | Inhalte und Aktionen ohne eigene Auswahl, z. B. Hinweistext oder „Angebot anfordern“ | Alle Typen im Detail: [Merkmale & Werte anlegen](/docs/merkmale-optionen-anlegen). ## Schritt 5: Werte und Aufpreise ![Einstellungen eines Werts: Bezeichnung, Wert, Preis, Artikelnummer](/storage/app/media/docs/erste-komponente/04-wert-bearbeiten.webp) Bei einem diskreten Merkmal legst du im Abschnitt **Werte** mit **+ Wert** die Auswahlmöglichkeiten an. Ein Klick auf einen Wert öffnet seine Einstellungen: | Feld | Bedeutung | |---|---| | **Bezeichnung** | Was der Kunde sieht, z. B. „Anthrazit“ | | **Wert** | Interner Wert, z. B. `anthrazit` – wird in Regeln und Formeln verwendet | | **Preis** | Aufpreis, wenn der Kunde diesen Wert wählt | | **Artikelnummer** | Optional, z. B. für Stücklisten im Shop | Wie Aufpreise angezeigt werden, stellst du für die ganze Komponente im Reiter **Einstellungen** unter **Aufpreis** ein: **Preisanzeige** ein oder aus, **Preistyp** **Absolut** (der Aufpreis des Werts) oder **Relativ** (der Unterschied zur aktuellen Auswahl) und das **Preismuster**. Preise, die von Eingaben abhängen – Staffeln, Formeln, Preismatrizen –, erklären [Preisberechnung einrichten](/docs/preisberechnung-einrichten), [Preisformeln](/docs/preisformeln) und [Preismatrizen aus Excel/CSV](/docs/preismatrizen-excel-csv). ## Schritt 6: Grundeinstellungen der Komponente ![Komponenteneinstellungen, Reiter „Allgemein“ mit dem Abschnitt „Aufpreis“](/storage/app/media/docs/erste-komponente/05-komponenten-einstellungen.webp) Im linken Reiter **Einstellungen** findest du die Einstellungen der ganzen Komponente, aufgeteilt in **Allgemein**, **Design**, **Reporting** und **Benutzerdefinierte Felder**. Für den Anfang reichen diese aus **Allgemein**: | Einstellung | Wirkung | |---|---| | **Titel** | Name der Komponente in der Übersicht | | **Überschrift** | Optionale Überschrift über dem Konfigurator | | **Standardsprache für diese Komponente** | Sprache, in der du die Inhalte pflegst | | **Darstellung** | Keine Gruppen, Tabs oder Accordion | | **Frontend-Engine** | **Legacy (Standard)** oder **V3** – siehe unten | Alle weiteren Einstellungen: [Komponenten-Einstellungen](/docs/komponente-einstellungen). ### Frontend-Engine: Legacy oder V3 Die Engine bestimmt, welcher Konfigurator im Shop läuft. **Legacy** ist der bewährte Standard. **V3** ist die neue Engine; einige Funktionen gibt es nur dort, andere nur in Legacy. Für deine erste Komponente lässt du **Legacy (Standard)** eingestellt. Welche Funktionen es nur in einer Engine gibt, wo welche Engine läuft und was das Kennzeichen **V3** in der Übersicht bedeutet, erklärt [Frontend-Engine: Legacy oder V3](/docs/frontend-engine-legacy-v3). ## Schritt 7: Speichern und in der Vorschau testen ![Vorschau im Editor mit Sprachwahl, Desktop/Tablet/Mobile und Gesamtpreis](/storage/app/media/docs/erste-komponente/06-vorschau.webp) Klicke auf **Speichern**. Jedes Speichern legt im Reiter **Versionen** einen Eintrag an – darüber kannst du später zu einem früheren Stand zurück (**Wiederherstellen**) oder zwei Stände vergleichen. Schalte dann in der mittleren Spalte auf **Vorschau**. Du siehst den Konfigurator so, wie ihn deine Kunden sehen werden, mit der eingestellten Frontend-Engine. Prüfe: - Erscheinen alle Merkmale in der richtigen Reihenfolge? - Stimmen die Aufpreise und der Gesamtpreis? - Greifen deine Regeln, falls du schon welche hast? Wichtig zu wissen: - Die Vorschau zeigt den **zuletzt gespeicherten** Stand. Hast du danach etwas geändert, weist ein gelber Hinweis darauf hin – speichere und lade die Vorschau mit **↺** neu. - Die Vorschau braucht die Integration **HTML5**. Ist sie aus, bittet dich der Admin, sie zu aktivieren: unter **Einstellungen** → **Integrationen** den Schalter auf der Karte **HTML5** einschalten. Das ist einmalig nötig. - Mit **In eigenes Fenster verschieben** öffnest du die Vorschau separat – der Editor bekommt dann mehr Platz. ## Schritt 8: Veröffentlichen ![Rückfrage „Komponente veröffentlichen?“](/storage/app/media/docs/erste-komponente/07-veroeffentlichen.webp) Bis hierher sieht dein Shop nichts davon. Solange der gespeicherte Stand von der veröffentlichten Fassung abweicht, steht oben **Noch nicht live**. 1. Klicke oben rechts auf **Veröffentlichen**. 2. Der Admin prüft die Komponente. **Fehler** – etwa eine Preisliste ohne Tabellen-Konfiguration – blockieren das Veröffentlichen und werden aufgelistet. **Warnungen** – etwa eine leere Formel oder ein doppelt vergebener Interner Name – werden ebenfalls angezeigt, das Veröffentlichen bleibt aber möglich. 3. Bestätige mit **Ja, veröffentlichen**. Dabei werden auch ungespeicherte Änderungen gespeichert. Ab jetzt zeigen alle Shops diese Fassung. Änderungen, die du danach speicherst, landen wieder nur im Entwurf – bis zum nächsten Veröffentlichen. ## Schritt 9: Im Shop einbinden Wie die Komponente auf deine Produktseite kommt, hängt von deinem System ab: - **Magento 2 / Adobe Commerce:** [Magento-Plugin installieren](/docs/magento-plugin-installieren) - **Shopware 6:** [Shopware-Plugin installieren](/docs/shopware-plugin-installieren) - **Shopify:** [Shopify-Plugin installieren](/docs/shopify-plugin-installieren) - **WordPress, TYPO3 oder jede andere Website:** [HTML-Snippet Integration](/docs/html-snippet-integration) In jedem Fall wählst du dort die Komponente aus, die auf dem Produkt erscheinen soll. Veröffentliche sie vorher – der Shop zeigt nur veröffentlichte Fassungen. ## Mit dem KI-Assistenten Am unteren Rand des Admins liegt über die volle Breite der **KI-Assistent**. Klicke auf **Neuer Chat** und beschreibe dein Produkt, zum Beispiel: > Ich verkaufe Rollos nach Maß. Lege eine Komponente „Rollo“ an mit Breite und Höhe in cm (je 40 bis 240), Stoffart (Standard, Verdunkelung +15 €) und Antrieb (Kette, Motor +89 €). Der Assistent legt Gruppen, Merkmale, Werte und Aufpreise an. Kontrolliere das Ergebnis anschließend im Editor und in der Vorschau, und veröffentliche selbst. Der KI-Assistent verbraucht [KI-Tokens](/docs/ki-tokens) und erscheint nur, wenn er für dein Konto aktiviert ist. Mehr dazu: [KI-Agent: Konfigurator per Chat aufbauen](/docs/ki-agent-konfigurator-aufbauen). ## Häufige Stolpersteine 1. **Der Shop zeigt meine Änderung nicht** – gespeichert ist nicht veröffentlicht. Steht oben **Noch nicht live**, klicke auf **Veröffentlichen**. 2. **Die Vorschau zeigt einen alten Stand** – sie zeigt immer den zuletzt gespeicherten Stand. Speichern, dann mit **↺** neu laden. 3. **Die Vorschau bleibt leer mit einem Hinweis auf HTML5** – die Integration **HTML5** unter **Einstellungen** → **Integrationen** einschalten. 4. **Ich finde keinen Knopf für ein neues Merkmal** – Merkmale brauchen eine Gruppe. Zuerst **Gruppe hinzufügen**, dann an der Gruppe **+**. 5. **Eine Formel findet ein Merkmal nicht** – Formeln verwenden den **Internen Namen (ID)**, nicht die Bezeichnung. Prüfe die Schreibweise. ## Nächste Schritte - [Merkmale & Werte anlegen](/docs/merkmale-optionen-anlegen) - [Merkmalsgruppen & Wizard](/docs/merkmalsgruppen-wizard) - [Preisberechnung einrichten](/docs/preisberechnung-einrichten) - [Regelwerk aufbauen](/docs/regelwerk-aufbauen) - [Bildvisualisierung & Bilder hochladen](/docs/bildvisualisierung-bilder) - [Der Aktions-Button](/docs/aktions-button) --- # Login und Account-Navigation Source: https://configento.app/docs/login-und-account-navigation Section: Erste Schritte Alles rund um dein Konto – Dienste, Zahlungen, Team und Shop-Verbindungen – erledigst du im **Service-Portal** unter [service.configento.app](https://service.configento.app). Von dort öffnest du auch den Admin, in dem du deine Konfiguratoren baust. Dieser Artikel zeigt, wie du ein Konto anlegst, dich anmeldest und dich im Portal zurechtfindest. ## Konto anlegen Ein neues Konto legst du über den Testzugang auf [configento.app](https://configento.app/?subscribe=true) an. Auch auf der Anmeldeseite des Portals führt der Link **Jetzt Testzugang anlegen!** dorthin. 1. Fülle das Formular aus: Firma, deine Rolle im Unternehmen, Branche, Anrede, Vor- und Nachname, E-Mail, Telefon und ein **Passwort** (8 bis 32 Zeichen). Das Passwort legst du also schon hier fest. 2. Du bekommst eine E-Mail mit einem Bestätigungslink. 3. Ein Klick auf den Link bestätigt deine E-Mail-Adresse, richtet deinen Testzugang ein und meldet dich direkt im Portal an. Oben erscheint der Hinweis „Dein Testzugang ist nun vollständig eingerichtet.“ Der Testzugang läuft **14 Tage** im Tarif **Professional**. Was danach passiert, steht unter [Service-Portal — Überblick](/docs/service-portal-uebersicht#testzugang). Wurdest du von einem Kollegen eingeladen, legst du dein Konto stattdessen über den Link in der Einladungs-E-Mail an – siehe [Team verwalten](/docs/team-verwalten#einladung-annehmen). ## Anmelden 1. Öffne [service.configento.app](https://service.configento.app). 2. Gib **E-Mail** und **Passwort** ein. 3. Optional: Hake **Login im Browser speichern** an. Dann bleibst du in diesem Browser angemeldet, bis du dich abmeldest. 4. Klicke auf **Anmelden**. Nach fünf falschen Versuchen sperrt das Portal die Anmeldung für diese E-Mail-Adresse kurz und zeigt an, wann du es erneut versuchen kannst. ## Passwort vergessen 1. Klicke auf der Anmeldeseite auf **Passwort vergessen?**. 2. Gib deine E-Mail-Adresse ein und klicke auf **Link per E-Mail erhalten**. 3. Über den Link in der E-Mail legst du ein neues Passwort fest. Der Link ist **60 Minuten** gültig. Das Passwort änderst du später jederzeit unter **Profil → Passwort ändern**. ## Die Navigation Welche Einträge du oben in der Navigation siehst, hängt von deiner **Rolle** beim jeweiligen Kunden ab (siehe [Team verwalten](/docs/team-verwalten#rollen-und-rechte)): | Eintrag | Inhalt | Sichtbar für | |---|---|---| | **Dienste** | Deine Dienste, Admin öffnen, Dienst umstellen oder kündigen | alle Rollen | | **Verbindungen** | Verbundene Shop-Plugins | Inhaber, Admin, Bearbeiter, Nur-Lesen | | **Abrechnung** → **Zahlungsarten** | Kreditkarte, SEPA-Lastschrift, PayPal | Inhaber, Admin, Buchhaltung | | **Abrechnung** → **KI-Tokens** | Token-Bestand und Nachkauf | Inhaber, Admin, Bearbeiter, Buchhaltung – sofern KI-Tokens für dein Konto freigeschaltet sind | | **Abrechnung** → **Rechnungen** | Rechnungsanschrift und Rechnungen | Inhaber, Admin, Buchhaltung, Nur-Lesen | | **Team** | Mitglieder einladen und Rollen vergeben | Inhaber, Admin | Rechts daneben findest du: - die **Sprachauswahl** **DE | EN | FR | ES** – sie stellt die Sprache des Portals um, - bei mehreren Kunden die **Kundenauswahl** (siehe unten), - ein Menü mit deinem Namen: **Profil** und **Abmelden**. ## Mehrere Kunden Bist du Mitglied bei mehreren Kunden – etwa weil du als Agentur für mehrere Firmen arbeitest –, erscheint oben rechts ein Feld **Kunde:** mit dem Namen der aktuell gewählten Firma. Darüber wählst du unter **Kunden wechseln** einen anderen Kunden; unter jedem Namen steht seine Kundennummer. Alles im Portal – Dienste, Rechnungen, Team – bezieht sich immer auf den gewählten Kunden. Deine Rolle kann je Kunde eine andere sein. Hast du gar keinen Kunden mehr (zum Beispiel, weil du aus dem Team entfernt wurdest), zeigt das Portal **Kein Kundenzugriff**. Bitte dann den Inhaber, dich erneut einzuladen. ## Den Admin öffnen Deine Konfiguratoren baust du im Admin. Du öffnest ihn unter **Dienste** beim jeweiligen Dienst mit **Verwalten**. Der Admin öffnet sich direkt über dem Portal; du musst dich nicht erneut anmelden. - Bei älteren Verträgen öffnet **Verwalten** noch den bisherigen Admin. Ist für dein Konto der neue Admin freigeschaltet, steht darunter zusätzlich **Manage V3**. - Den Knopf siehst du nur bei aktiven Diensten und nur mit den Rollen Inhaber, Admin oder Bearbeiter. Wie es im Admin weitergeht, zeigt [Erste Komponente anlegen](/docs/erste-komponente-anlegen). ## Profil Unter **Profil** (Menü mit deinem Namen) findest du drei Bereiche: | Bereich | Inhalt | |---|---| | **Dein Profil** | Vorname, Nachname, E-Mail, Telefon, deine Rolle im Unternehmen und **Deine Sprache** | | **Passwort ändern** | Aktuelles Passwort, neues Passwort und Bestätigung | | **Zugang löschen** | Löscht deinen Benutzerzugang nach Eingabe deines Passworts endgültig | **Zugang löschen** entfernt deinen Benutzer. Deine Dienste kündigst du damit nicht – das geht unter **Dienste** mit **Dienst kündigen**. ## Nachrichten im Portal Wichtige Hinweise – etwa zu einer neuen Rechnung, einer fehlgeschlagenen Zahlung oder einem gekündigten Dienst – zeigt das Portal oben auf jeder Seite an. Manche davon bleiben stehen, bis du sie mit **Nachricht gelesen** bestätigst. ## Fehlersuche 1. **Die Anmeldung schlägt fehl, obwohl das Passwort stimmt** – setze das Passwort über **Passwort vergessen?** neu. Das hilft auch bei sehr alten Zugängen. 2. **Ich habe keine Bestätigungs-E-Mail bekommen** – sieh im Spam-Ordner nach. Ohne bestätigte E-Mail-Adresse ist dein Testzugang noch nicht eingerichtet. 3. **Ein Menüpunkt fehlt** – deine Rolle beim gewählten Kunden erlaubt ihn nicht. Prüfe oben rechts, ob der richtige Kunde gewählt ist, und frag sonst den Inhaber. 4. **Der Knopf „Verwalten“ fehlt** – der Dienst ist nicht aktiv (z. B. **temporär deaktiviert** wegen fehlender Zahlungsdaten) oder deine Rolle ist Buchhaltung oder Nur-Lesen. ## Nächste Schritte - [Service-Portal — Überblick](/docs/service-portal-uebersicht) - [Team verwalten](/docs/team-verwalten) - [Erste Komponente anlegen](/docs/erste-komponente-anlegen) --- # Einstieg & Übersicht Source: https://configento.app/docs/einstieg-und-uebersicht Section: Erste Schritte configento.app ist eine Cloud-Lösung für Produktkonfiguratoren, Angebotskonfiguratoren und Preiskalkulatoren. Du baust deinen Konfigurator im Browser auf und bindest ihn per Plugin oder HTML-Snippet in deinen Shop oder deine Website ein. Dieser Artikel zeigt, wie die Teile zusammenhängen, erklärt die wichtigsten Begriffe und gibt dir einen Lernpfad durch die Dokumentation. ## Die drei Teile | Teil | Wofür | Wo | |---|---|---| | **Service-Portal** | Dein Konto: Dienste und Tarife, Zahlungsdaten und Rechnungen, Shop-Verbindungen, Team | [service.configento.app](https://service.configento.app) | | **Admin** | Deine Konfiguratoren: Merkmale, Werte, Preise, Regeln, Vorschau, Veröffentlichen | Im Service-Portal unter **Dienste** mit **Verwalten** | | **Shop oder Website** | Zeigt den Konfigurator auf der Produktseite, übernimmt Preis und Auswahl in den Warenkorb oder verschickt eine Anfrage | Dein Magento-, Shopware-, Shopify- oder PrestaShop-Shop oder jede Website | So fließen die Daten: 1. Du meldest dich im **Service-Portal** an und öffnest mit **Verwalten** den **Admin**. Eine zweite Anmeldung ist nicht nötig. 2. Im Admin baust du eine **Komponente** auf und **speicherst** sie. Gespeichert ist ein Entwurf, den nur die Vorschau im Admin zeigt. 3. Mit **Veröffentlichen** gibst du den Stand frei. Erst dann sieht ihn dein Shop. 4. Der Shop lädt die veröffentlichte Komponente aus der Cloud und zeigt sie deinen Kunden. Für sie ist die Cloud nicht sichtbar – der Konfigurator erscheint als Teil deiner Seite. Bei älteren Verträgen öffnet **Verwalten** noch den bisherigen Admin; der neue steht dann darunter unter **Manage V3**. Mehr dazu: [Login und Account-Navigation](/docs/login-und-account-navigation). ## Die wichtigsten Begriffe | Begriff | Bedeutung | Beispiel | |---|---|---| | **Komponente** | Ein Konfigurator. Sie enthält alles, was zu einem Produkt oder einer Produktgruppe gehört. | „Rollo nach Maß“ | | **Gruppe** | Fasst Merkmale zusammen. Im Shop erscheinen Gruppen z. B. als Reiter oder als Schritte eines Wizards. | „Maße“, „Ausstattung“ | | **Merkmal** | Eine Eigenschaft, die dein Kunde festlegt oder die der Konfigurator berechnet. | Farbe, Breite, Antrieb, Fläche | | **Wert** | Eine wählbare Möglichkeit eines Merkmals, mit optionalem Aufpreis. | Weiß, Anthrazit (+25 €) | | **Regel** | Eine Abhängigkeit zwischen Merkmalen: Werte ausblenden, Werte vorbelegen oder einen Hinweis bzw. Fehler zeigen. | „Bei Solar-Antrieb kein Weiß“ | | **Baustein** | Eine zentral gepflegte Preisliste oder ein zentral gepflegter Staffelpreis, den mehrere Komponenten nutzen. Eine Änderung wirkt in allen verknüpften Komponenten. | Preistabelle Breite × Höhe für fünf Rollo-Modelle | Wie du diese Teile anlegst, zeigt [Erste Komponente anlegen](/docs/erste-komponente-anlegen) Schritt für Schritt. ## Wo der Konfigurator läuft | Integration | Was dein Kunde erlebt | Anleitung | |---|---|---| | **Magento 2 / Adobe Commerce** | Konfigurator auf der Produktseite, Preis und Auswahl gehen in den Warenkorb | [Magento-Plugin installieren](/docs/magento-plugin-installieren) | | **Shopware 6** | Konfigurator auf der Produktseite, Preis und Auswahl gehen in den Warenkorb | [Shopware-Plugin installieren](/docs/shopware-plugin-installieren) | | **Shopify** | Konfigurator auf der Produktseite, Preis und Auswahl gehen in den Warenkorb | [Shopify-Plugin installieren](/docs/shopify-plugin-installieren) | | **PrestaShop 8.1 / 9** | Konfigurator auf der Produktseite, Preis und Auswahl gehen in den Warenkorb | [PrestaShop-Plugin installieren](/docs/prestashop-plugin-installieren) | | **HTML-Snippet** | Konfigurator auf jeder Website – WordPress, TYPO3, Joomla, Jimdo oder eigenes HTML. Ohne Warenkorb schickt der Kunde seine Konfiguration über den Aktions-Button. | [HTML-Snippet Integration](/docs/html-snippet-integration) | Shop-Plugins gibt es ab dem Tarif **Professional**. **Magento 1** und **Shopware 5** werden nur noch für bestehende Konten mit der klassischen Cloud angeboten. Bei diesen Konten findest du die Plugins im Admin unter **Einstellungen → Integrationen** – siehe [Globale Einstellungen](/docs/globale-einstellungen#integrationen). ### Angebots- und Anfragekonfigurator Ohne Warenkorb – oder zusätzlich dazu – schließt der **Aktions-Button** die Konfiguration ab. Er hat vier Aktionen: - **Eigene URL** – sendet die Konfiguration an eine Adresse deiner Wahl, z. B. an dein CRM, - **PDF erzeugen** – der Kunde lädt ein PDF seiner Konfiguration herunter, - **E-Mail verschicken** – die Konfiguration geht per E-Mail an den Kunden, auf Wunsch in Kopie an dich, - **E-Mail mit PDF verschicken** – wie oben, mit dem PDF im Anhang. Mehr dazu: [Der Aktions-Button](/docs/aktions-button). ## Zwei Frontend-Engines Jede Komponente läuft im Shop mit einer von zwei Frontend-Engines: **Legacy**, dem bewährten Konfigurator, oder **V3**, der neuen Engine. Beide lesen dieselben Daten, einige Funktionen gibt es aber nur in einer der beiden. Shopify und PrestaShop laufen immer mit V3, Shopware 6 immer mit Legacy; in Magento 2 und in der Vorschau stellst du die Engine je Komponente ein. Alles dazu: [Frontend-Engine: Legacy oder V3](/docs/frontend-engine-legacy-v3). ## Der KI-Assistent Am unteren Rand des Admins liegt der **KI-Assistent**. Du beschreibst dein Produkt im Chat, und er legt Gruppen, Merkmale, Werte, Preistabellen und Regeln für dich an. Er liest auch PDF-Datenblätter und Bilder, die du anhängst. Veröffentlichen musst du selbst – das kann der Assistent nicht. Der Assistent verbraucht **KI-Tokens**; jeder Tarif enthält ein monatliches Kontingent. Abschalten kannst du ihn unter **Einstellungen → KI**. - [KI-Agent: Konfigurator per Chat aufbauen](/docs/ki-agent-konfigurator-aufbauen) - [KI-Agent: Produktdaten importieren](/docs/ki-agent-daten-importieren) - [KI-Tokens](/docs/ki-tokens) ## Dein Lernpfad **1. Konto einrichten** - [Login und Account-Navigation](/docs/login-und-account-navigation) - [Service-Portal — Überblick](/docs/service-portal-uebersicht) - [Zahlungsarten & Rechnungen](/docs/zahlungsarten-verwalten) - [Team verwalten](/docs/team-verwalten) **2. Den ersten Konfigurator bauen** - [Erste Komponente anlegen](/docs/erste-komponente-anlegen) - [Merkmale & Werte anlegen](/docs/merkmale-optionen-anlegen) - [Gruppen, Darstellung & Wizard](/docs/merkmalsgruppen-wizard) - [Bildvisualisierung & Bilder hochladen](/docs/bildvisualisierung-bilder) **3. Preise und Regeln** - [Preisberechnung einrichten](/docs/preisberechnung-einrichten) - [Formeln & Berechnungen](/docs/preisformeln) - [Preismatrizen aus Excel/CSV](/docs/preismatrizen-excel-csv) - [Regelwerk aufbauen](/docs/regelwerk-aufbauen) **4. Feinschliff und Einstellungen** - [Der Aktions-Button](/docs/aktions-button) - [Komponenten-Einstellungen](/docs/komponente-einstellungen) - [Globale Einstellungen](/docs/globale-einstellungen) - [Frontend-Engine: Legacy oder V3](/docs/frontend-engine-legacy-v3) **5. In den Shop bringen** - [Magento-Plugin installieren](/docs/magento-plugin-installieren) - [Shopware-Plugin installieren](/docs/shopware-plugin-installieren) - [Shopify-Plugin installieren](/docs/shopify-plugin-installieren) - [PrestaShop-Plugin installieren](/docs/prestashop-plugin-installieren) - [HTML-Snippet Integration](/docs/html-snippet-integration) **6. Schneller mit KI und API** - [KI-Agent: Konfigurator per Chat aufbauen](/docs/ki-agent-konfigurator-aufbauen) - [KI-Agent: Produktdaten importieren](/docs/ki-agent-daten-importieren) - [KI-Agent: Regeln per Chat definieren](/docs/ki-agent-regeln-definieren) - [KI-Tokens](/docs/ki-tokens) - [API — Einstieg & Übersicht](/docs/api-einstieg) --- # Service-Portal — Überblick Source: https://configento.app/docs/service-portal-uebersicht Section: Erste Schritte Das **Service-Portal** unter [service.configento.app](https://service.configento.app) ist die Verwaltung deines configento.app-Kontos: Hier siehst du deine Dienste, öffnest den Admin, stellst Tarife um, pflegst Zahlungsdaten und Rechnungsanschrift, verwaltest Shop-Verbindungen und dein Team. Dieser Artikel geht alle Bereiche durch. Anmeldung, Navigation und Kundenauswahl erklärt [Login und Account-Navigation](/docs/login-und-account-navigation). Welche Bereiche du siehst, hängt von deiner Rolle ab – siehe [Team verwalten](/docs/team-verwalten#rollen-und-rechte). ## Dienste Unter **Dienste** steht die Tabelle **Meine Dienste** mit allen Diensten des gewählten Kunden, der neueste oben. Ein Dienst ist ein gebuchter Tarif, zum Beispiel „configento.app Professional“. | Spalte | Inhalt | |---|---| | **Dienst** | Tarif und Dienstnummer, darunter **Kunde** (deine Kundennummer) und – sofern vorhanden – der **Sicherheitsschlüssel**, jeweils mit **copy**-Knopf. Läuft ein Test, steht hier auch sein Ende. | | **Status** | **aktiv**, **gekündigt** oder **temporär deaktiviert**, jeweils mit Datum (**seit …**) | | **Preis** | Preis pro Monat oder pro Jahr und **Nächste Zahlung fällig am …** – nur bei aktiven, kostenpflichtigen Diensten | | **Aktionen** | Die Knöpfe unten | Kundennummer und Sicherheitsschlüssel brauchst du nur noch für die [klassische Anmeldung](/docs/shopware-plugin-installieren#klassische-anmeldung) von Shop-Plugins. Neue Plugins verbinden sich über **Mit Configento verbinden**. ### Aktionen Welche Knöpfe erscheinen, hängt vom Dienst ab. Bedienen dürfen sie nur die Rollen Inhaber, Admin und Bearbeiter. | Knopf | Erscheint, wenn … | Wirkung | |---|---|---| | **Verwalten** | der Dienst aktiv ist | Öffnet den Admin über dem Portal. Bei älteren Verträgen öffnet er den bisherigen Admin, der neue steht dann unter **Manage V3**. | | **Dienst umstellen** | der Dienst aktiv ist, nicht im Test und nicht über Shopify abgerechnet | Wechselt den Tarif, siehe unten | | **Dienst kündigen** | der Dienst nicht schon gekündigt ist und nicht über Shopify abgerechnet wird | Kündigt sofort, siehe unten | | **Jährlich bezahlen** | der Dienst monatlich bezahlt wird, nicht im Test ist und keinen Sonderpreis hat | Stellt auf jährliche Zahlung um – „Jetzt Dienst auf jährliche Zahlung umstellen und jedes Jahr zwei Monatsraten sparen!“ | | **Monatlich bezahlen** | der Dienst jährlich bezahlt wird (gleiche Bedingungen) | Stellt auf monatliche Zahlung um | Die Umstellung der Zahlweise bestätigst du in einem Dialog (**Auf jährliche Zahlung umstellen** bzw. **Auf monatliche Zahlung umstellen**). Sie gilt ab der nächsten Abrechnung; das Portal meldet „Die Abrechnung für deinen Dienst erfolgt künftig jährlich.“ ### Dienst umstellen **Dienst umstellen** zeigt deinen aktuellen Tarif und die Tarife, auf die du wechseln kannst. - Beim **Wechsel in einen teureren Tarif** wird die Preisdifferenz für die restlichen Tage des laufenden Zeitraums sofort in Rechnung gestellt und abgebucht. - Beim **Wechsel in einen günstigeren Tarif** gibt es **keine Erstattung** bereits bezahlter Gebühren. - Der Dienst bekommt dabei eine **neue Dienstnummer**; der alte erscheint als gekündigt in der Liste. - Wechselst du von Professional oder Ultimate auf **Basic**, werden alle Shop-Plugin-Verbindungen dieses Dienstes getrennt – Basic enthält keine Shop-Plugins. ### Dienst kündigen **Dienst kündigen** fragt „Möchtest du den Dienst wirklich endgültig kündigen?“ und weist darauf hin: > Alle Konfiguratoren, Bilder und Einstellungen dieses Dienstes werden dabei gelöscht und lassen sich nicht wiederherstellen. Die Kündigung wirkt **sofort**. Sichere deine Komponenten deshalb vorher im Admin mit **Komponente exportieren** als ZIP. Der Inhaber bekommt eine Bestätigung per E-Mail. ### Testzugang Ein neuer Testzugang läuft 14 Tage im Tarif Professional. Zwei Tage vor Ablauf bekommt der Inhaber eine Erinnerung per E-Mail. Am Ende des Tests - wird der Dienst automatisch kostenpflichtig weitergeführt, wenn eine **Rechnungsanschrift** und eine aktive **Zahlungsart** hinterlegt sind, - sonst wird er **temporär deaktiviert**. Sobald du beides nachträgst, kannst du ihn wieder nutzen. ### Temporär deaktiviert Ein Dienst wird temporär deaktiviert, wenn eine Zahlung endgültig fehlgeschlagen ist oder bei einem fälligen Dienst Zahlungsart oder Rechnungsanschrift fehlen. Neben dem Dienst steht dann „Überprüfe deine Zahlungsdaten um den Dienst wieder zu aktivieren.“ Wie es dazu kommt und wie du ihn wieder aktivierst: [Zahlungsarten & Rechnungen](/docs/zahlungsarten-verwalten#wenn-eine-zahlung-fehlschlägt). ### Über Shopify gebuchte Dienste Dienste, die du über den Shopify App Store gebucht hast, rechnet Shopify ab. Im Portal stehen dafür weder **Dienst umstellen** noch **Dienst kündigen** – Tarifwechsel und Kündigung erledigst du in Shopify. Das Portal sagt dazu: „Abrechnung und Verwaltung erfolgen über den Shopify App Store.“ ## Verbindungen Unter **Verbindungen** siehst du alle Shop-Plugins, die mit dem gewählten Kunden über **Mit Configento verbinden** verbunden sind (Magento 2, Shopware 6, …): | Spalte | Inhalt | |---|---| | **Shop-Host** | Adresse des Shops | | **Plugin** | Welches Plugin verbunden ist | | **Dienst** | Der verbundene Dienst mit Dienstnummer | | **Verbunden von** | Wer die Verbindung hergestellt hat | | **Aktive Tokens** | Wie viele Anmeldungen der Shop gerade hält | | **Zuletzt verwendet** | Wann der Shop die Verbindung zuletzt genutzt hat | Mit **Widerrufen** (Rückfrage **Sicher?**) trennst du einen Shop vollständig – etwa wenn du keinen Zugriff mehr auf ihn hast. Der Shop muss sich danach neu verbinden. Widerrufen dürfen Inhaber, Admin und Bearbeiter. ## Abrechnung Das Menü **Abrechnung** fasst drei Seiten zusammen: - **Zahlungsarten** – Kreditkarte, SEPA-Lastschrift oder PayPal hinterlegen. Details: [Zahlungsarten & Rechnungen](/docs/zahlungsarten-verwalten) - **KI-Tokens** – Bestand und Nachkauf für den KI-Assistenten. Details: [KI-Tokens](/docs/ki-tokens) - **Rechnungen** – Rechnungsanschrift und alle Rechnungen als PDF. Details: [Zahlungsarten & Rechnungen](/docs/zahlungsarten-verwalten#zuerst-die-rechnungsanschrift) ## Team Unter **Team** laden Inhaber und Admins Kollegen ein und vergeben Rollen. Details: [Team verwalten](/docs/team-verwalten) ## Fehlersuche 1. **„Dienst umstellen“ fehlt** – der Dienst ist im Test, nicht aktiv oder wird über Shopify abgerechnet. 2. **Nach dem Tarifwechsel ist mein Shop nicht mehr verbunden** – du bist auf Basic gewechselt. Shop-Plugins gibt es erst ab Professional. 3. **Der Dienst ist „temporär deaktiviert“** – hinterlege Rechnungsanschrift und Zahlungsart, siehe [Zahlungsarten & Rechnungen](/docs/zahlungsarten-verwalten). 4. **Ich sehe „KI-Tokens“ nicht** – KI-Tokens sind für dein Konto noch nicht freigeschaltet, oder deine Rolle ist Nur-Lesen. ## Nächste Schritte - [Login und Account-Navigation](/docs/login-und-account-navigation) - [Zahlungsarten & Rechnungen](/docs/zahlungsarten-verwalten) - [KI-Tokens](/docs/ki-tokens) - [Team verwalten](/docs/team-verwalten) --- # Entwurf, Vorschau & Veröffentlichen Source: https://configento.app/docs/entwurf-vorschau-veroeffentlichen Section: Konfigurator aufbauen Jede Komponente gibt es in zwei Ständen: dem **Entwurf**, an dem du im Admin arbeitest, und der **veröffentlichten Fassung**, die deine Shops zeigen. Speichern ändert nur den Entwurf, erst **Veröffentlichen** bringt ihn in den Shop. Dieser Artikel erklärt, wie Speichern, Vorschau, Veröffentlichen und Versionen zusammenspielen – und wie du sicher zu einem früheren Stand zurückkommst. ## Die zwei Stände einer Komponente | Stand | Wer sieht ihn | Wie er sich ändert | |---|---|---| | **Entwurf** | Du im Editor und in der **Vorschau** | Mit jedem **Speichern** – auch Änderungen des KI-Assistenten landen hier | | **Veröffentlichte Fassung** | Deine Kunden im Shop – in Magento, Shopware, Shopify und im HTML-Snippet | Nur mit **Veröffentlichen** | Solange sich die beiden unterscheiden, steht oben rechts im Editor **Noch nicht live**. Fährst du mit der Maus darüber, erscheint: „Die Shops zeigen bis zum Veröffentlichen weiter die zuletzt veröffentlichte Fassung.“ Du kannst also in Ruhe umbauen, testen und erst dann freigeben, wenn alles stimmt – deine Kunden merken bis dahin nichts. ## Speichern Sobald du etwas änderst, erscheint über dem rechten Bereich der Knopf **Speichern**, im Reiter **Regeln** zusätzlich mit dem Hinweis **Ungespeicherte Änderungen**. - **Speichern** schreibt deinen Stand in den Entwurf und legt eine neue Version an (siehe [Versionen](#versionen)). - **Rückgängig** oben rechts nimmt die letzte Änderung zurück, auch mehrfach hintereinander. Das gilt nur für die aktuelle Sitzung: Nach dem Neuladen der Seite ist der Verlauf leer – zurück geht es dann über die Versionen. - Der Admin speichert nicht automatisch. Willst du den Editor mit ungespeicherten Änderungen verlassen, fragt er „Du hast ungespeicherte Änderungen. Den Editor trotzdem verlassen?“ – beim Schließen des Browser-Tabs fragt der Browser selbst nach. Beim Speichern prüft der Admin die Komponente nicht. Fehler zeigt er erst beim Veröffentlichen. ## Vorschau Die Vorschau zeigt den Konfigurator so, wie ihn deine Kunden sehen werden – mit der eingestellten [Frontend-Engine](/docs/frontend-engine-legacy-v3), aber mit dem **gespeicherten Entwurf** statt der veröffentlichten Fassung. So testest du Änderungen, bevor sie live gehen. 1. Schalte in der mittleren Spalte von **Bearbeiten** auf **Vorschau**. 2. Hast du ungespeicherte Änderungen, fragt der Admin: „Aktuellen Stand vor der Vorschau speichern? Andernfalls wird der zuletzt gespeicherte Stand angezeigt.“ Bestätigst du, speichert er zuerst. 3. Änderst du danach weiter, erscheint in der Vorschau der Hinweis **Vorschau zeigt die zuletzt gespeicherte Version. Speichere, um deine Änderungen zu sehen.** Speichere und lade mit **↺** (**Vorschau aktualisieren**) neu. Weitere Möglichkeiten: - **Sprache:** Hat dein Konto mehrere Sprachen aktiv, wählst du oben in der Vorschau, in welcher Sprache du den Konfigurator sehen willst. - **In eigenes Fenster verschieben:** öffnet die Vorschau in einem eigenen Fenster, der Editor wird breiter. Das Fenster lädt nach jedem Speichern im Editor selbst neu. - **Bereiche ein- und ausblenden:** In der Leiste über der Vorschau schaltest du **Gesamtpreis**, **Kombiniertes Produktbild** (wenn die Komponente eines hat) und **Zusammenfassung** ein oder aus. Die Schalter wirken nur auf die Vorschau, nicht auf den Shop. - **Kombinierte Artikelnummer** (nur V3): zeigt neben dem Gesamtpreis die Artikelnummer des konfigurierten Produkts, z. B. `CL-W-GR` – zusammengesetzt aus den Artikelnummern der gewählten Werte. So prüfst du, welche Nummer in den Warenkorb geht, auch wenn sie in der Zusammenfassung ausgeschaltet ist. Anfangs aus. Mehr dazu in den [Komponenten-Einstellungen](/docs/komponente-einstellungen). Die Vorschau braucht die Integration **HTML5**. Ist sie aus, erscheint stattdessen ein Hinweis, sie unter **Einstellungen** → **Integrationen** zu aktivieren. ## Veröffentlichen Der Knopf **Veröffentlichen** oben rechts erscheint, sobald es etwas zu veröffentlichen gibt – bei einer neuen Komponente immer. 1. Klicke auf **Veröffentlichen**. Ungespeicherte Änderungen speichert der Admin zuerst. 2. Der Dialog **Komponente veröffentlichen?** prüft die Komponente (**Wird geprüft …**): - **Veröffentlichen blockiert – diese Fehler müssen behoben werden:** – zum Beispiel ein Preislisten-Merkmal ohne Matrix-Einstellungen. **Ja, veröffentlichen** bleibt gesperrt, bis du den Fehler behoben hast. - **Warnungen (Veröffentlichen trotzdem möglich):** – zum Beispiel eine leere Formel, ein doppelt vergebener interner Name oder ein E-Mail-Button ohne Captcha. 3. Bestätige mit **Ja, veröffentlichen**. Der Dialog erinnert daran: Eine frühere Version kannst du jederzeit unter **Versionen** wiederherstellen und erneut veröffentlichen. Danach öffnet sich **Komponente wird veröffentlicht** mit dem Fortschritt. Dabei werden auch neue Bilder übertragen; bei großen Komponenten mit vielen Bildern dauert das einen Moment. Du kannst die Seite verlassen – das Veröffentlichen läuft im Hintergrund weiter. Öffnest du die Komponente in der Zwischenzeit wieder, zeigt der Editor den Fortschritt erneut an. Ist alles durch, verschwindet **Noch nicht live**, und alle Shops zeigen die neue Fassung. ### Das erste Veröffentlichen Eine neue, noch nie veröffentlichte Komponente trägt in der Übersicht das Kennzeichen **Lokal** und statt einer Nummer **ID —**. Beim ersten Veröffentlichen bekommt sie ihre endgültige **ID**, und der Editor wechselt automatisch auf die neue Adresse. Erst mit dieser ID kannst du die Komponente in deinem Shop einem Produkt zuordnen – siehe [Magento-Plugin](/docs/magento-plugin-installieren), [Shopware-Plugin](/docs/shopware-plugin-installieren), [Shopify-Plugin](/docs/shopify-plugin-installieren) oder [HTML-Snippet](/docs/html-snippet-integration). ### Wenn das Veröffentlichen scheitert Schlägt das Veröffentlichen fehl, meldet der Dialog: „Veröffentlichen fehlgeschlagen — dein lokaler Entwurf ist unverändert. Behebe den Fehler unten und versuche es erneut.“ Unter **Fehlgeschlagene Uploads** stehen Bilder, die nicht übertragen werden konnten. Dein Entwurf bleibt erhalten, die Shops zeigen weiter die bisherige Fassung. **SVG-Bilder:** Die klassische Cloud nimmt nur JPEG, PNG, BMP und GIF an. SVG-Bilder werden deshalb nicht dorthin übertragen – der Dialog meldet **SVG-Bilder bleiben im V3-Konfigurator**. In V3 erscheinen sie normal, nur Legacy kann sie nicht laden. ## Zurück zur veröffentlichten Fassung Willst du alle Änderungen seit dem letzten Veröffentlichen verwerfen, klicke oben rechts auf **Zurücksetzen** und bestätige **Auf veröffentlichte Version zurücksetzen?** mit **Ja, zurücksetzen**. Der Entwurf wird durch die veröffentlichte Fassung ersetzt. Das lässt sich nicht rückgängig machen – auch nicht über **Rückgängig**. Eine Komponente, die noch nie veröffentlicht wurde, hat diesen Knopf nicht. ## Versionen Im Reiter **Versionen** findest du den **Versionsverlauf** der Komponente, die neueste Version oben. ![Reiter „Versionen“: Versionsverlauf mit „Mit Entwurf vergleichen“, „Wiederherstellen“ und „Vergleichen“ für zwei Versionen](/storage/app/media/docs/entwurf-vorschau-veroeffentlichen/01-versionen.webp) - **Jedes Speichern** legt eine Version an, ebenso jede Änderung des KI-Assistenten und jede Wiederherstellung. - **Jedes Veröffentlichen** legt eine eigene Version mit der Markierung **Veröffentlicht** an – genau der Stand, den die Shops seitdem bekommen. - Die Versionen bleiben erhalten, bis du die Komponente löschst. Gibt es noch keine Version, steht dort **Noch keine Versionen — speichere die Komponente, um eine zu erstellen.** ### Vergleichen | Aktion | Was sie zeigt | |---|---| | **Mit Entwurf vergleichen** | Die gewählte Version gegenüber deinem **Aktuellen Entwurf** | | Zwei Versionen anhaken, dann **Vergleichen** | Die ältere gegenüber der neueren der beiden. Hakst du eine dritte an, fällt die zuerst gewählte heraus. | Der Vergleich listet die Unterschiede nach Bereichen – Komponente (**Oberste Ebene**), Gruppen, Merkmale, Regeln. Mit **Springen zu** wechselst du zwischen den Bereichen. Sind beide Stände gleich, steht dort **Keine Unterschiede**. Mit **Vergleich an KI senden** übergibst du den Vergleich an den [KI-Assistenten](/docs/ki-agent-konfigurator-aufbauen). Er kann dir dann erklären, was sich geändert hat. Ein typischer Einsatz: Vor dem Veröffentlichen die zuletzt veröffentlichte Version mit **Mit Entwurf vergleichen** öffnen – so siehst du genau, was gleich live geht. ### Wiederherstellen 1. Klicke bei der gewünschten Version auf **Wiederherstellen**. 2. Bestätige „Diese Version wiederherstellen? Dein aktueller Entwurf wird überschrieben.“ Der Entwurf hat jetzt den Stand dieser Version, und es entsteht eine neue Version. Die Wiederherstellung lässt sich also ihrerseits wieder rückgängig machen, indem du die vorherige Version wiederherstellst. Ungespeicherte Änderungen gehen dabei verloren. Im Shop ist der wiederhergestellte Stand erst nach dem **Veröffentlichen** zu sehen. So machst du ein missglücktes Veröffentlichen rückgängig: die letzte gute **Veröffentlicht**-Version wiederherstellen und erneut veröffentlichen. ## Mehrere Personen an einer Komponente Der Admin sperrt eine Komponente nicht, während jemand sie bearbeitet. Speichern zwei Personen nacheinander, gilt das zuletzt Gespeicherte – die Änderungen der anderen Person sind dann nur noch in den [Versionen](#versionen) zu finden. Beim Veröffentlichen prüft der Admin zusätzlich, ob die Komponente in der Cloud seit dem Öffnen des Editors geändert wurde, etwa im alten Admin. Dann erscheint **Gleichzeitige Bearbeitung erkannt!**. Veröffentlichst du trotzdem, überschreibst du diese Änderungen. Diese Prüfung erkennt nicht jeden Fall – gespeicherte, aber noch nicht veröffentlichte Änderungen einer anderen Person im Admin zum Beispiel nie. Sprecht euch deshalb ab, wer gerade an einer Komponente arbeitet. Hast du eine Komponente lange offen gelassen, lade sie vor dem Weiterarbeiten neu. ## Bausteine: veröffentlichen für viele Komponenten Nutzen mehrere Komponenten denselben **Baustein** – eine zentral gepflegte Preistabelle oder Staffel –, änderst du ihn unter **Bausteine** in der Hauptnavigation. Beim Speichern entscheidest du mit **Betroffene Komponenten veröffentlichen**, ob die verknüpften Komponenten gleich veröffentlicht werden. Komponenten mit eigenen unveröffentlichten Änderungen werden dabei nur im Entwurf aktualisiert – sonst gingen diese Änderungen ungefragt mit live. Der Admin listet sie danach auf; du veröffentlichst sie, wenn ihre eigenen Änderungen fertig sind. ## Fehlersuche 1. **Meine Änderung ist im Shop nicht zu sehen** – du hast nur gespeichert. Steht oben **Noch nicht live**, klicke auf **Veröffentlichen**. 2. **Die Vorschau zeigt meine Änderung nicht** – die Vorschau zeigt den gespeicherten Stand. Speichere und klicke auf **↺**. 3. **Ja, veröffentlichen ist ausgegraut** – der Dialog listet einen Fehler unter **Veröffentlichen blockiert**. Behebe ihn, speichere und öffne den Dialog erneut. 4. **Die Vorschau bleibt leer mit einem Hinweis auf HTML5** – aktiviere die Integration unter **Einstellungen** → **Integrationen** (siehe [Globale Einstellungen](/docs/globale-einstellungen#integrationen)). 5. **Eine Änderung meiner Kollegin ist verschwunden** – ihr habt gleichzeitig gespeichert. Öffne **Versionen**, vergleiche ihre Version mit dem Entwurf und übernimm die fehlenden Änderungen oder stelle ihre Version wieder her. 6. **Im Shop fehlt die Komponente, obwohl sie veröffentlicht ist** – im Shop braucht es die endgültige ID. Prüfe in der Übersicht, ob die Komponente noch **Lokal** ist, und ob dem Produkt die richtige ID zugeordnet ist. 7. **Die kombinierte Artikelnummer erscheint in der Vorschau nicht** – die Komponente läuft mit Legacy, oder weder die gewählten Werte noch die Merkmale haben eine Artikelnummer. ## Nächste Schritte - [Komponenten-Einstellungen](/docs/komponente-einstellungen) - [Frontend-Engine: Legacy oder V3](/docs/frontend-engine-legacy-v3) - [Erste Komponente anlegen](/docs/erste-komponente-anlegen) - [KI-Agent: Konfigurator per Chat aufbauen](/docs/ki-agent-konfigurator-aufbauen) --- # Frontend-Merkmale: Statisches Feld & Diagramm Source: https://configento.app/docs/frontend-merkmale Section: Konfigurator aufbauen Nicht jedes Merkmal fragt etwas ab. Die Merkmale der Datenkategorie **Frontend** gestalten den Konfigurator: Sie zeigen Texte und Bilder, nehmen Dateien entgegen oder lösen eine Aktion aus. Dieser Artikel stellt sie vor – vor allem das **Statische Feld**, mit dem du Hinweise, Zwischenüberschriften und Bilder an jede Stelle des Konfigurators setzt. ## Die Frontend-Merkmale im Überblick Du wählst sie unter **Grundeinstellungen**: **Datenkategorie** **Frontend**, dann den **Datentyp**. | Datentyp | Wofür | Mehr dazu | |---|---|---| | **Statisches Feld** | Text, Bilder, Links und Hinweise an einer festen Stelle | dieser Artikel | | **Dateiupload** | Der Kunde lädt Dateien hoch, z. B. eine Druckvorlage | [Uploads & Deep Links](/docs/uploads-und-deep-links) | | **Diagramm** | Zeigt ein Diagramm | siehe [unten](#diagramm) | | **Aktions-Button** | Verschickt eine E-Mail, erzeugt ein PDF oder sendet die Konfiguration an eine eigene Adresse | [Der Aktions-Button](/docs/aktions-button) | | **Captcha (nur V3)** | Schützt den Aktions-Button vor Spam | [Captcha-Spamschutz](/docs/captcha-spamschutz) | **Dateiupload** und **Diagramm** gibt es nur im Tarif **Ultimate**. ## Statisches Feld Ein Statisches Feld zeigt einen Inhalt, den du im Admin festlegst. Der Kunde kann nichts auswählen oder eingeben. Typische Einsätze: - **Zwischenüberschrift**, die eine lange Gruppe gliedert, z. B. „Maße“ und „Ausstattung“, - **Hinweis** an der richtigen Stelle, z. B. „Maße bitte in Zentimetern angeben“, - **Bild**, z. B. eine Maßskizze vor den Eingabefeldern für Breite und Höhe, - **Link** auf eine Seite mit Montageanleitung oder Farbmustern. ![Statisches Feld im Editor: in der Mitte die Vorschau des Inhalts, rechts der Abschnitt „Inhalt“ mit dem Texteditor](/storage/app/media/docs/frontend-merkmale/01-statisches-feld.webp) ### Anlegen 1. Lege im Strukturbaum ein neues Merkmal an der gewünschten Stelle an. 2. Stelle unter **Grundeinstellungen** die **Datenkategorie** auf **Frontend** und den **Datentyp** auf **Statisches Feld**. 3. Schreibe im Abschnitt **Inhalt** den Text. 4. Speichere. Die **Vorschau** zeigt das Feld sofort. Die **Bezeichnung** des Merkmals erscheint wie bei jedem Merkmal als Überschrift über dem Inhalt, die **Informationen** darunter. Lässt du die Bezeichnung leer, erscheint keine Überschrift – in Legacy wie in V3. So steht ein Hinweistext ohne eigene Überschrift im Konfigurator. ### Der Inhalt Das Feld **Inhalt** ist ein Editor mit Formatierung: | Werkzeug | Wirkung | |---|---| | **Fett**, **Kursiv**, **Unterstrichen**, **Durchgestrichen** | Textauszeichnung | | **Überschrift 2**, **Überschrift 3** | Zwischenüberschriften | | **Liste**, **Nummerierte Liste**, **Zitat** | Gliederung | | **Linksbündig**, **Zentriert**, **Rechtsbündig** | Textausrichtung | | **Link einfügen** | Verlinkt den markierten Text | | **Bild einfügen** | Lädt ein Bild hoch (höchstens 5 MB) und setzt es in den Text | | **HTML-Quelltext bearbeiten** | Zeigt den Inhalt als HTML zum direkten Bearbeiten | Den Inhalt pflegst du je Inhaltssprache. Wechselst du oben die Sprache, bearbeitest du die Übersetzung; ist für eine Sprache nichts eingetragen, steht der Inhalt der Standardsprache als grauer Platzhalter im Feld. Fehlt eine Übersetzung, zeigt V3 im Konfigurator den Inhalt einer anderen Sprache. Ist der Inhalt leer, zeigt das Feld nur Bezeichnung und Informationen. ### Statisches Feld per Regel ein- und ausblenden Wie jedes Merkmal kannst du ein Statisches Feld mit einer **Blacklist**-Regel ausblenden. So erscheint ein Hinweis nur, wenn er passt – etwa „Ab 6 m Breite ist ein zusätzlicher Pfosten nötig“ nur bei großen Breiten. Siehe [Regelwerk aufbauen](/docs/regelwerk-aufbauen). ### Inhalte aus Magento-CMS-Blöcken In Magento 2 setzt du mit `$content[kennung]` den Inhalt eines CMS-Blocks ein; `kennung` ist die Kennung des Blocks. Dazu muss in der Erweiterung **CMS Block Integration** aktiv sein, siehe [Magento-Plugin installieren](/docs/magento-plugin-installieren). In den **Informationen** eines Merkmals funktioniert das mit beiden Engines, im **Inhalt** eines Statischen Felds nur mit V3. ## Einstellungen, die für alle Frontend-Merkmale gelten | Einstellung | Bei Frontend-Merkmalen | |---|---| | **Pflichtfeld** | Fehlt beim Statischen Feld, Diagramm, Aktions-Button und Captcha – der Kunde füllt sie nicht aus. Beim **Dateiupload** vorhanden. | | **Sichtbarkeit** | **Ja (sichtbar)** oder **Nur Shop** zeigen das Merkmal im Konfigurator, **Nein (versteckt)** und **Nur Backend** blenden es aus. | | **Bild** | Beim Statischen Feld kannst du zusätzlich ein Merkmalbild hinterlegen, wie bei anderen Merkmalen auch. | | **Informationen** / **Zusätzliche Informationen** | Hinweistexte neben dem Merkmal, wie bei anderen Merkmalen | | **CSS-Klasse** | Eigene Klasse für individuelles Styling, z. B. um einen Hinweis farbig hervorzuheben | Statisches Feld, Diagramm, Aktions-Button und Captcha landen nicht in der Zusammenfassung und nicht im Warenkorb – sie haben keinen Wert. Mehr zu den Einstellungen: [Merkmale & Werte anlegen](/docs/merkmale-optionen-anlegen#verhalten). ## Diagramm Den Datentyp **Diagramm** kannst du anlegen, seine Einstellungen folgen im Admin aber erst in einer späteren Version. V3 zeigt an seiner Stelle nur einen Platzhalter. Ein Diagramm, das in einer älteren Komponente schon eingerichtet ist, stellt nur Legacy dar; in Shopware 6 und Magento 2 muss dafür die Einstellung **Chart-Plugin laden** aktiv sein. ## Unterschiede zwischen Legacy und V3 | | Legacy | V3 | |---|---|---| | **Statisches Feld** | Zeigt den Inhalt | Zeigt den Inhalt | | `$content[…]` im Inhalt eines Statischen Felds | Wird nicht ersetzt | Wird durch den Magento-CMS-Block ersetzt | | **Dateiupload** | Funktioniert | Funktioniert, siehe [Uploads & Deep Links](/docs/uploads-und-deep-links) | | **Diagramm** | Zeigt ein vorhandenes Diagramm | Zeigt einen Platzhalter | | **Captcha (nur V3)** | Kann es nicht darstellen | Funktioniert | Mehr zu den Engines: [Frontend-Engine: Legacy oder V3](/docs/frontend-engine-legacy-v3). ## Fehlersuche 1. **Das Statische Feld erscheint nicht** – prüfe die **Sichtbarkeit** und ob eine Blacklist-Regel es ausblendet. 2. **`$content[…]` steht als Text im Konfigurator** – das funktioniert nur in Magento 2 mit aktiver **CMS Block Integration**, im Inhalt eines Statischen Felds nur mit V3. Prüfe außerdem die Kennung des CMS-Blocks. 3. **Eingefügte `