PrestaShop-Plugin installieren

Mit dem PrestaShop-Modul erscheint dein configento.app-Konfigurator direkt auf der Produktseite deines PrestaShop-Shops. Deine Kunden stellen das Produkt zusammen, sehen den Gesamtpreis sofort und legen die fertige Konfiguration in den normalen Warenkorb. Bestellung, Steuer und Versand laufen danach ganz regulär über PrestaShop. Deine Komponenten bearbeitest du im eingebetteten Admin, ohne das Backoffice zu verlassen.

Voraussetzungen

• PrestaShop 9 (das Modul ist für PrestaShop ab 9.0 gebaut; ältere Versionen lassen sich nicht installieren)
• Suchmaschinenfreundliche URLs (Friendly URLs) müssen in deinem Shop eingeschaltet sein. Nur dann kann sich das Modul mit configento.app verbinden – siehe Fehlersuche.
• Ein Zugang zum PrestaShop-Backoffice mit dem Recht, Module zu installieren
• Ein Login im Service-Portal für den Dienst, mit dem du den Shop verbinden willst
• Mindestens eine veröffentlichte Komponente – unveröffentlichte Entwürfe kannst du im Shop nicht auswählen

Welche Frontend-Engine läuft

Das PrestaShop-Modul 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, 360°-Ansicht, Autocomplete oder Mengenvorbelegung –, stehen in PrestaShop also nicht zur Verfügung. Die Übersicht findest du unter Frontend-Engine: Legacy oder V3.

Modul herunterladen

Das Modul bekommst du in configento.app unter Einstellungen → Integrationen, Karte PrestaShop 9, Button Modul herunterladen. Du erhältst eine ZIP-Datei – entpacke sie nicht.

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

Modul installieren

Im Backoffice

1. Öffne die Modulverwaltung deines PrestaShop-Backoffice und lade die ZIP-Datei des Moduls hoch. Entpacke sie vorher nicht.
2. Installiere das Modul configento.app.

Bei der Installation legt das Modul einen eigenen Menüpunkt configento.app im Bereich Katalog an.

Per Konsole

Wenn du Zugriff auf die Kommandozeile hast, kopiere den entpackten Ordner configento in das Verzeichnis modules/ deines Shops und führe im Shop-Verzeichnis aus:

php bin/console prestashop:module install configento

Der technische Name des Moduls ist configento. Achte darauf, dass der Ordner danach dem Benutzer des Webservers gehört.

Mit configento.app verbinden

Die Verbindung stellst du einmal aus dem Backoffice heraus her. Ein Token musst du dabei nicht kopieren.

1. Öffne Katalog → configento.app.
2. Du siehst die Karte Mit configento.app verbinden. Klicke auf Verbinden.
3. Du wirst zum Service-Portal weitergeleitet. Melde dich an und bestätige die Verbindung.
4. Danach kommst du zurück ins Backoffice, und der Admin von configento.app öffnet sich direkt in der Seite.

Beim Verbinden richtet das Modul zugleich alles ein, was die Produktseite braucht: Es holt die Zugangsdaten für deinen Shop und meldet die Domains deines Shops an configento.app (siehe Shop-Domain freigeben).

Jeder Backoffice-Benutzer verbindet sich einzeln. Die Verbindung gilt für das Benutzerkonto, das sie hergestellt hat, nicht für den ganzen Shop. Arbeitet ein Kollege mit einem eigenen Login, sieht er beim ersten Öffnen von Katalog → configento.app wieder die Karte Mit configento.app verbinden.

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

Komponenten im Backoffice bearbeiten

Nach dem Verbinden öffnet Katalog → configento.app den Admin von configento.app direkt im Backoffice. 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.

Shop-Domain freigeben

Der Konfigurator lädt nur auf Domains, die für deinen Dienst freigegeben sind. Das Modul meldet die Domains deines Shops beim Verbinden, gibt sie aber nicht selbst frei:

1. Öffne im Admin von configento.app Einstellungen → Domänen.
2. Im Abschnitt Von verbundenen Shops gemeldet stehen die gemeldeten Domains deines PrestaShop-Shops.
3. Wähle den Typ, zum Beispiel Produktion, und klicke auf In die Lizenz übernehmen.

Gemeldet werden die aktiven Shop-Adressen, auch die weiteren Shops eines Multistores. Kommt später eine neue Domain dazu, trägst du sie unter Einstellungen → Domänen selbst ein oder verbindest das Modul neu. Mehr dazu: Globale Einstellungen.

Produkt mit einer Komponente verknüpfen

1. Öffne im Backoffice das Produkt.
2. Im Produkt bindet das Modul den Abschnitt configento.app ein.
3. Wähle unter Component die Komponente aus der Liste. Über das Suchfeld darüber findest du sie nach Titel oder ID. Die Liste zeigt die veröffentlichten Komponenten deines verbundenen Dienstes.
4. Speichere das Produkt.

Ein Produkt hat genau eine Komponente. Zum Lösen wählst du — not linked — und speicherst.

Lässt sich die Liste nicht laden – etwa weil dein Benutzerkonto noch nicht verbunden ist –, zeigt der Abschnitt stattdessen ein einfaches Feld. Dort trägst du die ID der Komponente ein, wie sie auf ihrer Kachel in der Komponenten-Übersicht steht.

In einem Multistore gilt die Verknüpfung für den Shop, in dem du das Produkt gerade bearbeitest.

Was im Shop passiert

Auf der Produktseite

• Der Konfigurator erscheint direkt unter dem Preis, über dem Kaufbereich.
• Preis: Angezeigt wird der Preis des Produkts plus der Aufpreis aus der Konfiguration. Der Preis im Kaufbereich deines Themes läuft bei jeder Auswahl mit. Gerechnet wird mit dem Steuersatz, der in PrestaShop für dieses Produkt gilt.
• Brutto oder netto: Der Konfigurator zeigt Preise so an wie dein Shop. Sieht die Kundengruppe des Besuchers Preise ohne Steuer – etwa eine B2B-Gruppe – oder sind die Steuern im Shop ausgeschaltet, sind auch die Aufpreise netto, und PrestaShop schlägt die Steuer wie beim Produktpreis selbst auf. Sonst rechnet der Konfigurator brutto mit dem Steuersatz des Produkts. Dieselbe Komponente funktioniert so in Shops mit ganz unterschiedlichen Steuereinstellungen.
• Währung: Hat dein Shop mehrere Währungen, zeigt der Konfigurator den Gesamtpreis und die Aufpreise der einzelnen Werte in der Währung des Besuchers. Umgerechnet wird mit den Kursen deines Shops. Die Währung, in der die Komponente ihre Preise führt, muss dafür in deinem Shop angelegt sein.
• Kombination: Wählt der Kunde eine andere Kombination, etwa eine andere Größe, rechnet der Konfigurator mit deren Preis als Grundpreis und mit deren Attributen weiter. In den Warenkorb kommt die gewählte Kombination.
• Produktbild: Erzeugt deine Komponente ein kombiniertes Produktbild, erscheint es als eigenes, erstes Bild in der Bildergalerie deines Themes, mit eigenem Vorschaubild. Deine Kunden können zwischen ihren Fotos und der Konfiguration wechseln; sobald sie etwas ändern, springt die Ansicht zurück auf die Konfiguration. Themes ohne Bildergalerie zeigen das Bild an der Stelle des Produktfotos.
• Menge: Ändert der Kunde die Menge, bleibt die Konfiguration erhalten.

In den Warenkorb legen

Der Knopf In den Warenkorb deines Themes legt die Konfiguration in den Warenkorb, nicht das nackte Produkt. Vorher prüft der Konfigurator die Pflichtfelder und springt zum ersten fehlenden Merkmal.

Den Preis berechnet configento.app beim Hinzufügen noch einmal auf dem Server. Was im Browser angezeigt wird, kann also nicht manipuliert in den Warenkorb gelangen. Danach geht es direkt in den Warenkorb.

Warenkorb, Kasse und Bestellung

• An der Position stehen zwei Angaben: Konfiguration mit der Zusammenfassung der Auswahl und Vorschau mit dem kombinierten Produktbild.
• Warenkorb, Kasse, Bestellbestätigung und Bestellung zeigen das kombinierte Bild statt des Katalogfotos. Gäste ohne Kundenkonto sehen es über die Bestellreferenz ebenfalls.
• Der Aufpreis steckt im Preis der Position. PrestaShop rechnet die Steuer wie gewohnt.

Konfiguration ändern

An jeder konfigurierten Warenkorbposition steht der Link Konfiguration ändern. Er führt zurück auf die Produktseite, der Konfigurator zeigt die gespeicherte Auswahl. Legt der Kunde die geänderte Konfiguration in den Warenkorb, ersetzt sie die alte Position.

Produktlisten

In Kategorie- und Suchlisten blendet PrestaShop bei konfigurierbaren Produkten den Knopf zum direkten Kauf aus, damit niemand das Produkt ohne Konfiguration in den Warenkorb legt. Der Knopf zur Produktseite heißt dort Jetzt konfigurieren.

Produktdaten in Formeln

Merkmale vom Datentyp Produktattribut lesen Werte des PrestaShop-Produkts, damit eine Formel etwa mit Breite, Gewicht oder Größe rechnen kann. Als Code trägst du im Merkmal ein:

Gibt es einen Code mehrfach, gewinnt die Quelle weiter oben in der Tabelle. Namen von Eigenschaften und Attributgruppen gelten in der Sprache des Besuchers – benenne sie in einem mehrsprachigen Shop deshalb in allen Sprachen gleich, sonst bleibt das Merkmal in den anderen Sprachen leer.

Wechselt der Kunde die Kombination, bekommen die Merkmale die Werte der neuen Kombination. Die Preisprüfung beim Hinzufügen zum Warenkorb rechnet mit denselben Werten. Einkaufspreis, Lieferantendaten, Lagerort und Beschreibungen gibt das Modul nie heraus, denn die Werte stehen im Quelltext der Produktseite. Mehr zum Datentyp: Berechnungs-Merkmale.

Bestellungen im Backoffice

Auf der Bestellseite im Backoffice zeigt das Modul die Karte Konfigurationen (configento.app). Für jede konfigurierte Position siehst du:

• Produkt und Menge, die Komponente und den Geprüften Aufpreis – den Preis, den configento.app beim Hinzufügen bestätigt hat
• alle Merkmale mit ihrem Wert, auch die, die der Kunde nicht gesehen hat, etwa versteckte Berechnungen. Sie tragen den Hinweis für den Kunden nicht sichtbar.
• das kombinierte Produktbild, wenn die Komponente eins erzeugt
• den Button Konfiguration herunterladen (JSON) mit der vollständigen Konfiguration als Datei, etwa für die Fertigung

Abo-Status im Backoffice

Gibt es bei deinem configento.app-Abo etwas zu tun, zeigt das Modul oben auf jeder Backoffice-Seite einen Hinweis mit dem Link Abo verwalten ins Service-Portal:

Bedient configento.app deinen Shop nicht mehr, zeigen die Produktseiten statt des Konfigurators den Satz Dieses Produkt kann derzeit nicht konfiguriert werden. So steht kein Kunde vor einem Konfigurator, der nicht lädt. Den Status fragt das Modul höchstens einmal pro Stunde ab. Nach einer Verlängerung kann es also bis zu einer Stunde dauern, bis der Hinweis verschwindet.

Verbindung trennen

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

Wichtig: Solange noch ein anderer Backoffice-Benutzer verbunden ist, läuft der Konfigurator im Shop weiter. Trennt der letzte verbundene Benutzer, löscht das Modul auch die Zugangsdaten des Shops – der Konfigurator verschwindet dann von allen Produktseiten, bis sich wieder jemand verbindet.

Modul deinstallieren

Beim Deinstallieren entfernt das Modul seine Verbindungen, die Verknüpfungen zwischen Produkten und Komponenten und die gespeicherten Konfigurationen offener Warenkörbe. Bestellungen behalten ihre Zusammenfassung und das Vorschaubild.

Löse vor dem Deinstallieren an jedem Produkt die Komponente (— not linked —) und klicke einmal auf Verbindung trennen. Sonst bleiben die Produkte für PrestaShop „konfigurierbar“, und die Freigabe im Service-Portal bleibt bestehen.

Fehlersuche

1. Nach „Verbinden“ kommt eine Fehlermeldung, oder das Portal lehnt die Verbindung ab – prüfe, ob die suchmaschinenfreundlichen URLs (Friendly URLs) deines Shops eingeschaltet sind. Ohne sie kann das Modul die Rücksprungadresse nicht bilden, die das Service-Portal verlangt.
2. „Verbunden, aber der Storefront-Token konnte nicht geholt werden“ – die Verbindung steht, aber die Zugangsdaten für die Produktseite fehlen. Trenne die Verbindung und verbinde dich neu.
3. Auf der Produktseite erscheint kein Konfigurator – entweder ist am Produkt keine Komponente verknüpft, oder es ist kein Backoffice-Benutzer mehr verbunden. Prüfe beides unter Katalog → configento.app und am Produkt.
4. „Komponente konnte nicht geladen werden (HTTP 401)“ – die Domain deines Shops ist nicht freigegeben. Siehe Shop-Domain freigeben.
5. Die Komponentenliste am Produkt fehlt, es gibt nur ein Eingabefeld – dein Benutzerkonto ist nicht verbunden oder das Service-Portal war gerade nicht erreichbar. Verbinde dich unter Katalog → configento.app oder trage die ID der Komponente direkt ein.
6. „Der Preis konnte gerade nicht geprüft werden. Bitte versuchen Sie es in einem Moment erneut.“ – die Preisprüfung bei configento.app war kurz nicht erreichbar, oder die Währung der Komponente ist in deinem Shop nicht angelegt. Nichts ist im Warenkorb gelandet; der Kunde kann es gleich noch einmal versuchen. Kommt die Meldung immer wieder, such im Log deines Shops nach Einträgen mit „configento: Preisprüfung nicht verfügbar“.
7. „Diese Konfiguration ist nicht mehr gültig. Bitte stellen Sie sie neu zusammen.“ – die Komponente wurde geändert, während der Kunde konfiguriert hat. Hier hilft nur, die Seite neu zu laden und die Konfiguration neu zusammenzustellen.
8. Im Warenkorb fehlt das Bild der Konfiguration – die Komponente erzeugt kein kombiniertes Produktbild. Dann zeigt der Warenkorb das Katalogfoto.
9. „Dieses Produkt kann derzeit nicht konfiguriert werden.“ – dein configento.app-Abo bedient den Shop nicht mehr. Siehe Abo-Status im Backoffice.
10. Ein Produktattribut-Merkmal bleibt leer – der Code passt nicht, oder die Eigenschaft bzw. Attributgruppe heißt in der Sprache des Besuchers anders. Siehe Produktdaten in Formeln.

Nächste Schritte

• Erste Komponente anlegen
• Frontend-Engine: Legacy oder V3
• Preisberechnung einrichten
• Globale Einstellungen