WooCommerce- und WordPress-Plugin installieren

Mit dem WordPress-Plugin bringst du deine configento.app-Konfiguratoren auf jede Seite deiner WordPress-Website – per Block oder Shortcode. Ist WooCommerce installiert, erscheint der Konfigurator außerdem auf der Produktseite: Deine Kunden stellen das Produkt zusammen, sehen den Gesamtpreis sofort und legen die fertige Konfiguration in den normalen Warenkorb. Den Preis prüft configento.app dabei auf dem Server. Deine Komponenten bearbeitest du im eingebetteten Admin, ohne wp-admin zu verlassen.

Voraussetzungen

• WordPress 6.6 oder neuer und PHP 8.1 oder neuer. Für den Shop zusätzlich WooCommerce 9 oder neuer.
• Sprechende Permalinks: unter Einstellungen → Permalinks eine andere Einstellung als Einfach. Nur dann kann sich das Plugin mit configento.app verbinden – siehe Fehlersuche.
• Ein WordPress-Benutzer mit dem Recht, Plugins zu installieren und Einstellungen zu ändern (Administrator).
• Ein Login im Service-Portal für den Dienst, mit dem du die Website verbinden willst.
• Mindestens eine veröffentlichte Komponente.

Welche Frontend-Engine läuft

Das Plugin lädt immer die V3-Engine. Die Einstellung Frontend-Engine in der Komponente spielt hier keine Rolle. Funktionen, die es nur in Legacy gibt – etwa Accordion, Autocomplete oder Mengenvorbelegung –, stehen in WordPress also nicht zur Verfügung. Die Übersicht findest du unter Frontend-Engine: Legacy oder V3.

Plugin herunterladen

Das Plugin bekommst du in configento.app unter Einstellungen → Integrationen, Karte WordPress / WooCommerce, Button Plugin herunterladen. Du erhältst eine ZIP-Datei – entpacke sie nicht.

Ist der Tab gesperrt, akzeptiere zuerst unter Einstellungen → Auftragsverarbeitung den Vertrag zur Auftragsverarbeitung.

Plugin installieren

1. Öffne in wp-admin Plugins → Neues Plugin hinzufügen und klicke oben auf Plugin hochladen.
2. Wähle die ZIP-Datei aus und klicke auf Jetzt installieren.
3. Klicke auf Plugin aktivieren.

Das Plugin legt in wp-admin den Menüpunkt configento an. Per Kommandozeile geht es mit wp plugin install configento-wordpress-*.zip --activate.

Eine neue Version installierst du genauso: WordPress fragt, ob es das vorhandene Plugin ersetzen soll. Verbindung und Verknüpfungen bleiben erhalten.

Mit configento.app verbinden

Die Verbindung stellst du einmal aus wp-admin heraus her. Einen Schlüssel musst du dabei nicht kopieren.

1. Öffne den Menüpunkt configento.
2. Du siehst die Karte Dein configento.app-Konto verbinden. Klicke auf Mit configento.app verbinden.
3. Du wirst zum Service-Portal weitergeleitet. Melde dich an und bestätige die Verbindung.
4. Danach kommst du zurück nach wp-admin, und der Admin von configento.app öffnet sich direkt in der Seite.

Sind die Permalinks auf Einfach gestellt, steht in der Karte statt des Buttons ein Hinweis, wo du das änderst.

Beim Verbinden richtet das Plugin zugleich alles ein, was deine Seiten brauchen: Es holt die Zugangsdaten für deine Website und meldet ihre Domain an configento.app (siehe Domain freigeben). Ist dein Dienst eine eigene Enterprise-Instanz, nennt das Service-Portal sie beim Verbinden, und das Plugin arbeitet mit dieser Instanz.

Jeder WordPress-Benutzer verbindet sich einzeln. Die Verbindung gilt für das Benutzerkonto, das sie hergestellt hat. Arbeitet ein Kollege mit einem eigenen Login, sieht er beim ersten Öffnen von configento wieder die Karte zum Verbinden. Der Konfigurator auf deinen Seiten läuft unabhängig davon, solange mindestens ein Benutzer verbunden ist.

Über dem eingebetteten Admin stehen die E-Mail-Adresse deines Portal-Logins und der Button Verbindung trennen.

Komponenten in wp-admin bearbeiten

Nach dem Verbinden öffnet configento den Admin von configento.app direkt in wp-admin. Dort legst du Komponenten an, pflegst Merkmale, Werte, Preise und Regeln und veröffentlichst sie – genau wie unter admin.configento.app. Die Grundlagen stehen in Erste Komponente anlegen.

Bleibt die Seite länger offen, läuft die Sitzung des eingebetteten Admins irgendwann ab. Das Plugin erneuert sie dann im Hintergrund; du musst die Seite nicht neu laden.

Domain freigeben

Der Konfigurator lädt nur auf Domains, die für deinen Dienst freigegeben sind. Das Plugin meldet die Domain deiner Website, gibt sie aber nicht selbst frei. Solange sie nicht freigegeben ist, steht auf der Seite configento ein Hinweis.

1. Öffne im eingebetteten Admin Einstellungen → Domänen.
2. Im Abschnitt Von verbundenen Shops gemeldet steht die Domain deiner Website mit dem Hinweis WooCommerce.
3. Wähle den Typ, zum Beispiel Produktion oder Staging, und klicke auf In die Lizenz übernehmen.

Gemeldet wird beim Verbinden und jedes Mal, wenn du unter Einstellungen → Allgemein die Adresse der Website änderst – etwa beim Umzug von einer Testumgebung auf die Live-Domain. Die neue Domain musst du danach nur noch in die Lizenz übernehmen. Mehr dazu: Globale Einstellungen.

Konfigurator auf einer Seite zeigen

Auf jeder Seite und in jedem Beitrag – auch ohne WooCommerce, etwa für Anfrage-Konfiguratoren mit dem Aktions-Button.

Mit dem Block

1. Füge im Block-Editor den Block configento-Konfigurator ein (Kategorie Einbettungen).
2. Wähle unter Konfigurator die Komponente aus der Liste. Die Liste zeigt die Komponenten deines verbundenen Dienstes. Lässt sie sich nicht laden, trägst du stattdessen die Konfigurator-ID ein, wie sie auf der Kachel in der Komponenten-Übersicht steht.
3. Optional in der Seitenleiste unter Einstellungen:
   • Mindesthöhe, zum Beispiel 600px. Verhindert, dass die Seite springt, während der Konfigurator lädt.
   • Sprachauswahl: Besucher können zwischen den Sprachen des Konfigurators wechseln.

Im Editor zeigt der Block nur, welcher Konfigurator erscheint. Den Konfigurator selbst siehst du in der Vorschau und auf der Seite.

Mit dem Shortcode

Für den klassischen Editor und Page-Builder:

[configento id="10722"]

Was dabei passiert

• Der Konfigurator erscheint in der Sprache der Seite. Mehrsprachige Websites (etwa mit WPML oder Polylang) zeigen ihn so automatisch in der richtigen Sprache; fehlt eine Übersetzung, nimmt er eine andere vorhandene.
• Das Konfigurator-Skript lädt nur auf Seiten mit Konfigurator.
• Im Quelltext der Seite steht weder ein Zugangsschlüssel noch ein Token: Der Konfigurator holt sich ein kurzlebiges Token über deine Website. Seiten mit Konfigurator dürfen deshalb von Caching-Plugins zwischengespeichert werden.
• Ist die Website nicht verbunden, sehen nur angemeldete Redakteure einen Hinweis; Besucher sehen nichts.

WooCommerce: Produkt mit einer Komponente verknüpfen

1. Öffne das Produkt unter Produkte.
2. Im Bereich Produktdaten gibt es den Reiter configento.
3. Wähle unter Konfigurator die Komponente aus der Liste. Lässt sie sich nicht laden, erscheint stattdessen das Feld Konfigurator-ID.
4. Aktualisiere das Produkt.

Ein Produkt hat genau eine Komponente. Zum Lösen wählst du Kein Konfigurator. Der Preis des Produkts ist der Grundpreis; die Konfiguration kommt als Aufpreis dazu.

Was im Shop passiert

Auf der Produktseite

• Der Konfigurator erscheint über dem Knopf In den Warenkorb.
• Preis: Der Preis auf der Produktseite zeigt Produktpreis plus Konfiguration und läuft bei jeder Auswahl mit – es ist der Betrag, den der Warenkorb berechnet. Bei variablen Produkten zählt die gewählte Variante: Ihr Preis plus Konfiguration erscheint dort, wo WooCommerce den Variantenpreis zeigt.
• Brutto oder netto: Der Konfigurator zeigt Preise so an wie dein Shop. Zeigt WooCommerce Preise ohne Steuer oder sind die Steuern ausgeschaltet, sind auch die Aufpreise netto. Sonst rechnet er mit dem Steuersatz, den WooCommerce für dieses Produkt und den Kunden anwendet.
• Währung: Die Komponente muss ihre Preise in der Währung deines Shops führen.
• Menge: Sperrst du in der Komponente die Menge im Warenkorb (siehe Komponenten-Einstellungen), zeigt die Produktseite kein Mengenfeld, und jede Konfiguration bleibt im Warenkorb bei Menge 1.

In den Warenkorb legen

Der Knopf In den Warenkorb legt die Konfiguration in den Warenkorb, nicht das nackte Produkt. Vorher prüft der Konfigurator die Pflichtfelder und markiert, was fehlt.

Den Preis berechnet configento.app beim Hinzufügen noch einmal auf dem Server. Auch die Beschreibung der Konfiguration, die an der Bestellung steht, baut configento.app aus der geprüften Auswahl. Was im Browser angezeigt wird, kann also nicht manipuliert in den Warenkorb gelangen. Das gilt für den klassischen Warenkorb und für den Warenkorb-Block gleichermaßen.

Produktlisten

In Shop-, Kategorie- und Suchlisten heißt der Knopf bei verknüpften Produkten Konfigurieren und führt zur Produktseite. So legt niemand das Produkt ohne Konfiguration in den Warenkorb – auch nicht über einen Warenkorb-Block oder die Store API.

Warenkorb, Kasse und Bestellung

• An der Position steht Konfiguration mit der Zusammenfassung der Auswahl.
• Erzeugt die Komponente ein kombiniertes Produktbild, zeigen Warenkorb, Kasse, Bestellansicht in wp-admin und Bestellmails dieses Bild statt des Produktfotos.
• Dieselbe Konfiguration ein zweites Mal ergibt eine Position mit Menge 2 – bei gesperrter Menge meldet WooCommerce stattdessen, dass das Produkt schon im Warenkorb liegt; eine andere Konfiguration bekommt eine eigene Position.
• Bestellung, Bestellmails und Kundenkonto zeigen die Konfiguration an der Position.
• Das Plugin unterstützt die WooCommerce-Bestelltabellen (HPOS).

Konfiguration ändern

Im klassischen Warenkorb steht an jeder konfigurierten Position der Link Konfiguration ändern; im Warenkorb-Block führt der Produktname dorthin. Die Produktseite zeigt dann die gespeicherte Auswahl. Legt der Kunde die geänderte Konfiguration in den Warenkorb, ersetzt sie die alte Position, und er landet wieder im Warenkorb.

Daten für Warenwirtschaft und Fertigung

An jeder Bestellposition speichert das Plugin neben der sichtbaren Konfiguration verdeckte Felder, die Schnittstellen und Exporte auslesen können:

Abo-Status

Gibt es bei deinem configento.app-Abo etwas zu tun, zeigt die Seite configento einen Hinweis mit dem Link Portal öffnen. Bedient configento.app deine Website nicht mehr, zeigen die Seiten statt des Konfigurators den Satz Dieser Konfigurator ist derzeit nicht verfügbar., und WooCommerce nimmt keine Konfigurationen mehr in den Warenkorb. Den Status fragt das Plugin höchstens einmal pro Stunde ab.

Verbindung trennen

Mit Verbindung trennen über dem eingebetteten Admin löst du die Verbindung deines Benutzerkontos – im Plugin und im Service-Portal.

Wichtig: Solange noch ein anderer Benutzer verbunden ist, läuft der Konfigurator weiter. Trennt der letzte verbundene Benutzer, löscht das Plugin auch die Zugangsdaten der Website – der Konfigurator verschwindet dann von allen Seiten, bis sich wieder jemand verbindet.

Plugin löschen

Beim Löschen unter Plugins entfernt das Plugin Verbindungen, Zugangsdaten und den gespeicherten Abo-Status. Die Verknüpfung am Produkt und die Konfigurationen an bisherigen Bestellungen bleiben erhalten.

Klicke vor dem Löschen einmal auf Verbindung trennen. Sonst bleibt die Freigabe im Service-Portal bestehen.

Welche Daten an configento.app gehen

• Beim Verbinden: die Adresse deiner Website und der Rücksprung nach wp-admin an das Service-Portal.
• Danach: die Domain deiner Website, damit der Konfigurator dort laden darf, und Abfragen zum Abo-Status.
• Auf Seiten mit Konfigurator: Die Browser deiner Besucher laden den Konfigurator von configento.app und schicken ihm die gewählten Werte.
• Im Warenkorb: die Auswahl und der Steuersatz des Produkts zur Preisprüfung.

Vor dem Verbinden schickt das Plugin keine Anfragen nach außen.

Fehlersuche

1. Statt des Buttons „Mit configento.app verbinden“ steht ein Hinweis zu Permalinks – stelle unter Einstellungen → Permalinks eine andere Einstellung als Einfach ein. Das Service-Portal verlangt eine Rücksprungadresse, die auf /configento/connect/callback endet.
2. „Komponente konnte nicht geladen werden (HTTP 401)“ – die Domain deiner Website ist nicht freigegeben. Siehe Domain freigeben.
3. Auf der Seite erscheint kein Konfigurator – ist im Block oder Shortcode eine Komponente gewählt, und ist mindestens ein Benutzer verbunden? Angemeldete Redakteure sehen an der Stelle einen Hinweis.
4. Die Liste der Konfiguratoren fehlt, es gibt nur ein Feld für die ID – die Website ist nicht verbunden, oder configento.app war gerade nicht erreichbar. Verbinde dich unter configento oder trage die ID direkt ein.
5. „Bitte konfiguriere das Produkt zuerst auf seiner Seite.“ – das Produkt sollte ohne Konfiguration in den Warenkorb, etwa über einen Listen- oder Warenkorb-Block. Verknüpfte Produkte lassen sich nur über ihre Produktseite kaufen.
6. „Der Preis konnte gerade nicht geprüft werden. Bitte versuche es gleich noch einmal.“ – die Preisprüfung war kurz nicht erreichbar, oder die Komponente führt ihre Preise in einer anderen Währung als dein Shop. Den Grund findest du unter WooCommerce → Status → Logs in den Einträgen der Quelle configento.
7. „Diese Konfiguration ist nicht mehr gültig. Bitte stelle sie neu zusammen.“ – die Komponente wurde geändert, während der Kunde konfiguriert hat. Die Seite neu laden und die Konfiguration neu zusammenstellen.
8. „Dieses Produkt kann derzeit nicht konfiguriert werden.“ – dein configento.app-Abo bedient die Website nicht mehr. Siehe Abo-Status.
9. „Der Shop ist noch nicht eingerichtet: Trenne die Verbindung und verbinde dich neu.“ – beim Verbinden konnten die Zugangsdaten für deine Seiten nicht geholt werden. Trenne die Verbindung und verbinde dich erneut.
10. Im Warenkorb fehlt das Bild der Konfiguration – die Komponente erzeugt kein kombiniertes Produktbild. Dann zeigt der Warenkorb das Produktfoto.

Nächste Schritte

• Erste Komponente anlegen
• Komponenten-Einstellungen
• Der Aktions-Button
• Globale Einstellungen