PrestaShop-Plugin installieren

Zuletzt aktualisiert: 06. November 2026

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 8.1, 8.2 oder 9. Ältere Versionen lassen sich nicht installieren. Die Stückliste bei Bestellung gibt es nur unter PrestaShop 9.
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, 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 8.1 / 9, Button Modul herunterladen. Eine Datei für alle unterstützten Versionen. 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

Öffne die Modulverwaltung deines PrestaShop-Backoffice und lade die ZIP-Datei des Moduls hoch. Entpacke sie vorher nicht.
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.

Aktualisieren

Eine neue Version lädst du genauso hoch wie die erste. PrestaShop erkennt das vorhandene Modul und führt das Update aus; Verbindung, Verknüpfungen und Einstellungen bleiben erhalten.

Mit configento.app verbinden

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

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

Sind die Friendly URLs ausgeschaltet, steht über der Karte ein Hinweis, wo du sie einschaltest.

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.

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

Shop-Domain freigeben

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

Öffne im Admin von configento.app Einstellungen → Domänen.
Im Abschnitt Von verbundenen Shops gemeldet stehen die gemeldeten Domains deines PrestaShop-Shops.
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 – beim Verbinden und jedes Mal, wenn du in PrestaShop eine Shop-Adresse anlegst oder änderst. Eine neue Domain musst du danach nur noch in die Lizenz übernehmen. Mehr dazu: Globale Einstellungen.

Produkt mit einer Komponente verknüpfen

Öffne im Backoffice das Produkt.
Im Produkt bindet das Modul den Abschnitt configento.app ein.
Wähle unter Komponente 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.
Speichere das Produkt.

Ein Produkt hat genau eine Komponente. Zum Lösen wählst du — nicht verknüpft — 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.

Einstellungen des Moduls

In der Modulverwaltung öffnest du mit Konfigurieren beim Modul configento.app die Einstellungen. Im Abschnitt Warenkorb und Bestellung:

Einstellung	Was sie tut	Ab Werk
Konfigurationen zum Preis von 0 ablehnen	Kostet eine Konfiguration 0 oder weniger, kommt sie nicht in den Warenkorb. Das schützt vor einer fehlerhaften Regel im Konfigurator und vor manipulierten Anfragen. Der Kunde sieht „Diese Konfiguration kann nicht in den Warenkorb gelegt werden.“	an
Artikelnummer an die Bestellposition anhängen	An die Referenz der Bestellposition wird die Artikelnummer angehängt, die configento.app aus den gewählten Werten bildet – aus `BANNER` wird etwa `BANNER-PVC-OESEN`. So nennen Bestellung, Rechnung und Exporte in die Warenwirtschaft genau das, was konfiguriert wurde.	an

Im Abschnitt Stückliste schaltest du die Stückliste bei Bestellung ein. Unter PrestaShop 8 ist der Schalter gesperrt und trägt den Hinweis Erfordert PrestaShop 9.

In einem Multistore gelten die Einstellungen für den Shop, den du oben im Backoffice gewählt hast.

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.

Inhalte aus CMS-Seiten

Texte, die du an einer Stelle pflegen willst – etwa Liefer- oder Montagehinweise –, legst du in PrestaShop als CMS-Seite an und holst sie mit dem Platzhalter $content[…] in die Texte deiner Komponente. In die Klammern gehört die Kennung der Seite:

ihre suchmaschinenfreundliche URL (Friendly URL), zum Beispiel $content[lieferung]
oder ihre ID, zum Beispiel $content[4]

Der Konfigurator zeigt den Inhalt der Seite in der Sprache des Besuchers. Es zählen nur aktive Seiten des aktuellen Shops; gibt es keine passende Seite, bleibt die Stelle leer. Welche Platzhalter eine Komponente verwendet, fragt das Modul bei configento.app ab und merkt es sich zehn Minuten lang. Eine neu eingefügte Kennung erscheint also spätestens nach zehn Minuten im Shop – oder sofort, wenn du den Cache von PrestaShop leerst. Änderungen am Text der CMS-Seite selbst sind gleich sichtbar.

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.

Wunschliste

Konfigurationen lassen sich nicht auf die Wunschliste setzen. Die Wunschliste von PrestaShop merkt sich nur das Produkt, nicht die Auswahl im Konfigurator.

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:

Quelle	Code	Beispiel
Feld des Produkts	Name des Felds in PrestaShop	`weight`, `width`, `height`, `depth`, `reference`, `ean13`, `price`, `manufacturer_name`
Eigenschaft (Feature) des Produkts	Name der Eigenschaft	`Material`
Attribut der gewählten Kombination	Name der Attributgruppe	`Größe` liefert z. B. `XL`

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
Hochgeladene Dateien: alles, was der Kunde im Konfigurator hochgeladen hat, zum Herunterladen
den Button Konfiguration herunterladen (JSON) mit der vollständigen Konfiguration als Datei, etwa für die Fertigung

Hochgeladene Dateien bleiben im Shop. Das Modul kopiert sie beim ersten Öffnen der Bestellung von configento.app in deinen Shop (Ordner upload/configento/, nicht öffentlich erreichbar). Die Dateien gehören damit zur Bestellung und bleiben auch dann erhalten, wenn dein configento.app-Abo endet. Heruntergeladen werden sie über das Backoffice, nur von Benutzern mit Zugriff auf Bestellungen.

Ist Artikelnummer an die Bestellposition anhängen eingeschaltet, steht die Artikelnummer der Konfiguration außerdem in der Referenz der Bestellposition (siehe Einstellungen des Moduls).

Stückliste bei Bestellung

Ab Modul 0.5.0, nur unter PrestaShop 9. Kennt deine Warenwirtschaft nur Einzelartikel, bestellt der Shop statt des konfigurierten Produkts die Artikel, deren Referenz den Artikelnummern im Konfigurator entspricht – zum Beispiel Folie, Ösen und Druck statt eines Banners. Im Warenkorb sieht der Kunde weiter das konfigurierte Produkt. Du schaltest die Funktion in den Einstellungen des Moduls mit Stückliste bei Bestellung erstellen ein; der Reiter configento.app am Produkt zeigt dann, ob jede Artikelnummer einen Artikel trifft. Alles dazu: Stücklisten über Artikelnummern.

Multistore

Das Modul arbeitet mit dem Multistore von PrestaShop:

Verbinden: Ist oben im Backoffice ein einzelner Shop gewählt, gilt die Verbindung für diesen Shop. So kann jeder Shop an einen eigenen configento.app-Dienst angebunden sein. Verbindest du mit Alle Shops, gilt sie für alle Shops und ersetzt deren eigene Verbindung.
Verknüpfungen zwischen Produkt und Komponente gelten je Shop.
Einstellungen des Moduls gelten je Shop.
Domains aller aktiven Shops werden gemeldet (siehe Shop-Domain freigeben).

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:

Hinweis	Bedeutung
Dein Testzeitraum endet am …	Der Testzeitraum läuft in den nächsten 7 Tagen ab.
Dein Abo ist nicht mehr aktiv. Konfiguratoren funktionieren in deinem Shop noch bis …	Das Abo ist beendet. Bis zum genannten Datum läuft der Konfigurator weiter.
Dein Abo ist nicht mehr aktiv. Verlängere es, damit die Konfiguratoren in deinem Shop weiterlaufen. (bzw. Dein Testzeitraum ist abgelaufen. Schließe ein Abo ab, …)	Abo oder Testzeitraum sind abgelaufen, der Konfigurator läuft aber noch. Verlängere, bevor er abgeschaltet wird.
… Konfiguratoren sind in deinem Shop nicht mehr verfügbar.	Testzeitraum oder Abo sind abgelaufen.

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 räumt das Modul hinter sich auf: Es gibt alle verknüpften Produkte wieder frei, sodass sie wie normale Produkte gekauft werden können, und entfernt Zugangsdaten, Einstellungen, Verbindungen, die Verknüpfungen zwischen Produkten und Komponenten und die gespeicherten Konfigurationen offener Warenkörbe. Bestellungen behalten ihre Zusammenfassung, das Vorschaubild und die kopierten Dateien.

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

Fehlersuche

Nach „Verbinden“ kommt eine Fehlermeldung, oder das Portal lehnt die Verbindung ab – prüfe, ob die suchmaschinenfreundlichen URLs (Friendly URLs) deines Shops eingeschaltet sind (Shop-Parameter → Traffic & SEO). Ohne sie kann das Modul die Rücksprungadresse nicht bilden, die das Service-Portal verlangt.
„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.
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. In einem Multistore prüfe, ob der Shop des Besuchers verbunden ist.
„Komponente konnte nicht geladen werden (HTTP 401)“ – die Domain deines Shops ist nicht freigegeben. Siehe Shop-Domain freigeben.
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.
„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“.
„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.
„Diese Konfiguration kann nicht in den Warenkorb gelegt werden.“ – die Konfiguration kostet 0 oder weniger, und Konfigurationen zum Preis von 0 ablehnen ist eingeschaltet. Prüfe Preise und Regeln der Komponente. Das Log deines Shops vermerkt jeden abgelehnten Versuch.
Im Warenkorb fehlt das Bild der Konfiguration – die Komponente erzeugt kein kombiniertes Produktbild. Dann zeigt der Warenkorb das Katalogfoto.
„Dieses Produkt kann derzeit nicht konfiguriert werden.“ – dein configento.app-Abo bedient den Shop nicht mehr. Siehe Abo-Status im Backoffice.
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.
Ein Platzhalter $content[…] bleibt leer – es gibt keine aktive CMS-Seite mit dieser Friendly URL oder ID im Shop und in der Sprache des Besuchers, oder du hast die Kennung gerade erst eingefügt. Siehe Inhalte aus CMS-Seiten.
Eine hochgeladene Datei fehlt in der Bestellung – configento.app war beim Öffnen der Bestellung nicht erreichbar. Öffne die Bestellung später noch einmal; das Modul holt fehlende Dateien dann nach. Dateien über 50 MB kopiert es nicht.

Nächste Schritte

← Alle Artikel 14 Tage kostenlos testen