Docs  /  Integrationen  /  Shopware-Plugin installieren

Shopware-Plugin installieren

Zuletzt aktualisiert: 22. Oktober 2026

Mit dem Shopware-Plugin erscheint dein Konfigurator direkt auf der Produktseite deines Shopware-Shops. Deine Kunden stellen das Produkt zusammen, sehen den Preis sofort und legen die fertige Konfiguration in den normalen Shopware-Warenkorb. Die Bestellung läuft danach ganz regulär über Shopware.

Voraussetzungen

  • Shopware 6.7 (das aktuelle Plugin ist für 6.7 gebaut)
  • PHP 8.2 bis 8.5
  • Ein Zugang zum Shopware-Admin mit dem Recht, Erweiterungen 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

Du nutzt eine ältere Shopware-6-Version? Dann melde dich beim Support, bevor du installierst.

Plugin herunterladen

Das Plugin bekommst du in configento.app unter Einstellungen → Integrationen.

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

Welche Karte du dort siehst, hängt von deinem Konto ab:

Du siehst … Das bedeutet Anmeldung im Plugin
eine Karte Shopware 6.7 mit dem Button Plugin herunterladen Dein Shop verbindet sich über dein Service-Portal-Login. Ein Sicherheitstoken brauchst du nicht. Mit Configento verbinden (empfohlen)
eine Karte Shopware 6 mit Schalter, Sicherheitstoken und dem Link Plugin herunterladen Dein Konto nutzt noch die klassische Anmeldung. Kunden-ID, Secure Key und Security Token von Hand eintragen – siehe Klassische Anmeldung

Lade die ZIP-Datei herunter und entpacke sie nicht.

Plugin installieren

Im Shopware-Admin

  1. Öffne Erweiterungen → Meine Erweiterungen.
  2. Lade die ZIP-Datei über Erweiterung hochladen hoch.
  3. Installiere und aktiviere das Plugin configento.app Plugin.
  4. Leere den Shopware-Cache.

Per Konsole

Wenn du Zugriff auf die Shopware-Konsole hast, kopiere den entpackten Ordner JustsellingProductConfigurator nach custom/plugins/ und führe im Shopware-Verzeichnis aus:

bin/console plugin:refresh
bin/console plugin:install --activate JustsellingProductConfigurator
bin/console cache:clear

Der technische Name des Plugins ist JustsellingProductConfigurator. Ältere Anleitungen nennen hier einen anderen Namen, der nicht funktioniert.

Mit Configento verbinden

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

  1. Öffne die Konfiguration des configento.app Plugin in der Erweiterungsverwaltung.
  2. In der Karte Allgemein steht unter Configento-Verbindung der Button Mit Configento verbinden. Klicke darauf.
  3. Du wirst zum Service-Portal weitergeleitet. Melde dich an und bestätige die Verbindung.
  4. Danach kommst du zurück in den Shopware-Admin. Unter Configento-Verbindung steht jetzt Verbunden als mit deinem Portal-Login.

Lass den Schalter Klassische Anmeldung verwenden dabei aus.

Beim Verbinden trägt das Plugin die Zugangsdaten für die Produktseite selbst ein. Du findest sie in der Karte Allgemein als Kunden-ID, Secure Key und Security Token. Ändern musst du dort nichts.

Jeder Admin-Benutzer verbindet sich einzeln. Die Verbindung gilt für den Shopware-Benutzer, der sie hergestellt hat. Arbeitet ein Kollege mit einem eigenen Shopware-Login, sieht er beim ersten Öffnen des Konfigurators die Meldung Mit Configento verbinden und klickt auf Jetzt verbinden.

Die bestehende Verbindung prüfst du jederzeit mit Verbindung testen.

Komponenten im Shopware-Admin bearbeiten

Nach dem Verbinden gibt es im Katalog-Bereich des Shopware-Hauptmenüs den Eintrag Produktkonfigurator Cloud. Dort öffnet sich configento.app direkt im Shopware-Admin. Du bearbeitest deine Komponenten also, ohne den Shop zu verlassen.

Produkt mit einer Komponente verknüpfen

  1. Öffne im Shopware-Admin das Produkt.
  2. Wechsle in den Tab Produktkonfigurator.
  3. Klicke auf Komponente hinzufügen.
  4. Wähle unter Komponenten-Name die Komponente aus. Die Liste zeigt die Komponenten deines verbundenen Dienstes mit ihrem Namen.
  5. Optional: Trage eine Überschrift ein. Sie steht über der Zusammenfassung der Konfiguration auf der Produktseite (siehe Plugin-Einstellungen).
  6. Speichere das Produkt.

Ein Produkt hat genau eine Komponente. Ist schon eine verknüpft, verschwindet der Button Komponente hinzufügen. Willst du eine andere Komponente verknüpfen, entferne die alte mit Komponente entfernen und füge danach die neue hinzu.

Erscheint eine Komponente nicht in der Liste, ist sie meist noch nicht veröffentlicht. Veröffentliche sie in configento.app und öffne das Produkt neu.

Welche Frontend-Engine läuft

Ab Version 5.2.0 lädt das Plugin für jede Komponente die passende Frontend-Engine. V3 läuft, wenn du sie bei der Komponente eingestellt hast, wenn die Komponente ein Merkmal enthält, das V3 braucht, oder wenn dein Konto ohne die klassische Cloud läuft. Sonst bleibt es bei Legacy. Mit der Einstellung Konfigurator-Version legst du das für den ganzen Shop fest, siehe Konfigurator im Shop. Was die beiden Engines unterscheidet, steht unter Frontend-Engine: Legacy oder V3.

Mit V3 gilt zusätzlich:

  • Der Preis oben auf der Produktseite enthält die Konfiguration und ändert sich mit jeder Auswahl.
  • Erzeugt die Komponente ein kombiniertes Produktbild, ersetzt es auf der Produktseite die Produktfotos. Im Warenkorb, an der Kasse und in der Bestellung steht es als Bild der Position.
  • Der Warenkorb berechnet immer den Preis, den configento.app für die Konfiguration ermittelt – unabhängig von der Preisprüfung.
  • Der Link am Produkt im Warenkorb öffnet den Konfigurator mit der gespeicherten Auswahl. Der Kunde ändert sie und legt das Produkt neu in den Warenkorb.

Shop-Domain freigeben

V3 lädt nur auf Domains, die für deinen Dienst freigegeben sind. Ab Version 5.2.3 meldet das Plugin die Domains deiner Verkaufskanäle beim Verbinden an configento.app, gibt sie aber nicht selbst frei. Übernimm sie im Admin von configento.app unter Einstellungen → Domänen im Abschnitt Von verbundenen Shops gemeldet, bevor du eine Komponente auf V3 umstellst. Kommt später eine Domain dazu, trägst du sie dort selbst ein oder verbindest das Plugin neu. Mehr dazu: Globale Einstellungen.

Was im Shop passiert

  1. Der Kunde öffnet die Produktseite. Der Konfigurator erscheint im Kaufbereich und ersetzt dort den normalen Warenkorb-Button.
  2. Der Kunde stellt das Produkt zusammen. Der Preis wird bei jeder Auswahl neu berechnet.
  3. Mit In den Warenkorb landet das Produkt samt Konfiguration im Shopware-Warenkorb. Die gewählten Merkmale stehen unter dem Produkt.
  4. Shopware wickelt die Bestellung normal ab. In der Bestellung im Shopware-Admin siehst du die Konfiguration an der Bestellposition.

Der Warenkorbpreis ergibt sich aus dem Preis des Shopware-Produkts plus den Aufpreisen der Konfiguration. Trägst du in Shopware einen Grundpreis ein, wird er also zum Konfigurationspreis addiert. Soll der Konfigurator den kompletten Preis bestimmen, setze den Shopware-Preis auf 0.

Der Shop zeigt immer den zuletzt veröffentlichten Stand der Komponente. Änderungen, die du nur gespeichert hast, sehen deine Kunden erst nach dem Veröffentlichen.

Produktdaten in Formeln

Merkmale vom Datentyp Produktattribut lesen mit V3 Werte des Shopware-Produkts, ab Version 5.2.1 des Plugins. So rechnet eine Formel etwa mit Breite, Gewicht oder einer Eigenschaft. Als Code trägst du im Merkmal ein:

Quelle Code Beispiel
Feld des Produkts Name des Felds in Shopware productNumber, name, ean, manufacturerNumber, manufacturer, width, height, length, weight, purchaseUnit, referenceUnit, packUnit, minPurchase, purchaseSteps
Zusatzfeld des Produkts Technischer Name des Zusatzfelds custom_banner_material
Eigenschaft des Produkts Name der Eigenschaftsgruppe Material liefert z. B. Wolle; mehrere Ausprägungen kommen mit Komma getrennt
Variante Name der Eigenschaftsgruppe der Variante Größe liefert z. B. XL

Gibt es einen Code mehrfach, gewinnt die Quelle weiter oben in der Tabelle. Namen von Eigenschaftsgruppen gelten in der Sprache des Verkaufskanals. Benenne sie in einem mehrsprachigen Shop deshalb in allen Sprachen gleich, sonst bleibt das Merkmal in den anderen Sprachen leer.

Die Preisprüfung im Warenkorb rechnet mit denselben Werten. Einkaufspreise, Lagerbestand und Beschreibungen gibt das Plugin nie heraus, denn die Werte stehen im Quelltext der Produktseite. Mehr zum Datentyp: Berechnungs-Merkmale.

Konfiguration in der Bestellbestätigung

Die Shopware-Bestellbestätigung zeigt die gewählten Merkmale nicht von selbst. Ergänze dafür in der E-Mail-Vorlage Bestellbestätigung innerhalb der Schleife über die Bestellpositionen diesen Block.

In der HTML-Version:

{% if nestedItem.payload.justselling_options is defined and nestedItem.payload.justselling_options|length >= 1 %}
    <div>
        {% for option in nestedItem.payload.justselling_options %}
            {{ option.group }}: {{ option.option }}
            {% if nestedItem.payload.justselling_options|last != option %}<br>{% endif %}
        {% endfor %}
    </div>
{% endif %}

In der Text-Version:

{% if lineItem.payload.justselling_options is defined and lineItem.payload.justselling_options|length >= 1 %}, {% for option in lineItem.payload.justselling_options %}{{ option.group }}: {{ option.option }}{% if lineItem.payload.justselling_options|last != option %}{{ " | " }}{% endif %}{% endfor %}{% endif %}

Die Variablennamen nestedItem und lineItem müssen zu deiner Vorlage passen. Verwendet deine Schleife einen anderen Namen, ersetze sie entsprechend.

Plugin-Einstellungen

Alle Einstellungen findest du in der Konfiguration des configento.app Plugin.

Konfigurator im Shop

Konfigurator-Version Wirkung
Automatisch (wie bei der Komponente eingestellt) (Standard) Das Plugin fragt configento.app für jede Komponente, ob sie mit V3 läuft – siehe Welche Frontend-Engine läuft.
Immer V3 Alle Komponenten laufen mit V3.
Immer die bisherige Version Alle Komponenten laufen mit Legacy.

Einstellungen

Einstellung Wirkung Standard
Chart-Plugin laden Einschalten, wenn deine Komponenten Merkmale mit Diagrammen enthalten. Nur für Legacy. aus
Dropzone-Plugin laden Einschalten, wenn deine Komponenten Datei-Uploads enthalten. Ohne diese Option funktioniert der Upload im Shop nicht. Nur für Legacy. aus
jQuery laden Lädt jQuery für den Konfigurator. Nur ausschalten, wenn dein Theme jQuery schon selbst lädt und es Konflikte gibt. Nur für Legacy. an
Stückliste bei Bestellung erstellen Statt eines konfigurierten Produkts werden bei der Bestellung die einzelnen Shopware-Produkte bestellt, die zu den gewählten Werten gehören. Dafür muss die Artikelnummer (SKU) eines Werts in configento.app der Produktnummer eines Shopware-Produkts entsprechen. Siehe Stücklisten über Artikelnummern. aus
CSS-Pfad für den Container für kombinierte Produktbilder CSS-Selektor des Bereichs auf der Produktseite, in dem das kombinierte Produktbild erscheinen soll. Mit V3 ersetzt das Bild dort die Produktfotos. Leer lassen nimmt den Bildbereich der Produktseite. leer

Preisprüfung

Ab Plugin-Version 5.0.1 rechnet configento.app den Aufpreis jeder Konfiguration auf dem eigenen Server nach. So landet ein im Browser manipulierter Preis nicht im Warenkorb.

Modus Wirkung
Aus Keine Prüfung. Der Warenkorb übernimmt den Preis aus dem Konfigurator.
Beobachten (Standard) Der Warenkorb übernimmt weiter den Preis aus dem Konfigurator. Jede Abweichung steht als configento.price.divergence im Shopware-Log.
Erzwingen Der Warenkorb berechnet den geprüften Preis. Liegt keiner vor, etwa weil configento.app nicht erreichbar ist, sperrt Shopware die Bestellung mit einem Hinweis für den Kunden.

Lass das Plugin nach dem Update einige Tage auf Beobachten laufen. Stehen im Log keine Abweichungen, stellst du auf Erzwingen um.

Für Komponenten mit V3 gilt diese Einstellung nicht: Der Warenkorb berechnet dort immer den geprüften Preis.

Produkt-Ansicht

Einstellung Wirkung Standard
Zusammenfassung im Tab auf Produkt-Seite anzeigen Zeigt die gewählte Konfiguration im Beschreibungs-Tab der Produktseite aus
Zusammenfassung unter dem Preis auf Produkt-Seite anzeigen Zeigt die gewählte Konfiguration unter dem Preis, mit der Überschrift aus der Produktverknüpfung aus

Entwickler-Einstellungen

Debug-Modus, Entwickler-Modus und die URL-Felder darunter sind für die Fehlersuche mit dem Support gedacht. Lass sie im Live-Shop aus und leer.

Abo-Status in der Administration

Ab Version 5.2.1 zeigt das Plugin einmal pro Sitzung in der Shopware-Administration einen Hinweis configento.app-Abo, wenn es bei deinem Abo etwas zu tun gibt:

Hinweis Bedeutung
Ihr Testzeitraum endet am … Der Testzeitraum läuft in den nächsten 7 Tagen ab.
Ihr Abo ist nicht mehr aktiv. Die Konfiguratoren laufen in Ihrem Shop noch bis zum … Das Abo ist beendet. Bis zum genannten Datum läuft der Konfigurator weiter.
Ihr Abo ist nicht mehr aktiv. Verlängern Sie es, … (bzw. Ihr Testzeitraum ist abgelaufen. Schließen Sie ein Abo ab, …) Abo oder Testzeitraum sind abgelaufen, der Konfigurator läuft aber noch. Verlängere, bevor er abgeschaltet wird.
… Die Konfiguratoren stehen in Ihrem Shop nicht mehr zur Verfügung. Testzeitraum oder Abo sind abgelaufen.

Bedient configento.app deinen Shop nicht mehr, zeigen die Produktseiten statt des Konfigurators den Satz Dieses Produkt kann gerade nicht konfiguriert werden. Den Status fragt das Plugin höchstens einmal pro Stunde ab. Nach einer Verlängerung kann es also bis zu einer Stunde dauern, bis der Hinweis verschwindet. Dein Abo verwaltest du im Service-Portal.

Klassische Anmeldung

Konten, die unter Einstellungen → Integrationen die Karte Shopware 6 mit Sicherheitstoken sehen, verbinden das Plugin über drei Zugangsdaten:

Feld im Plugin Wo du den Wert findest
Kunden-ID Service-Portal, Seite Dienste: der Wert hinter Kunde beim jeweiligen Dienst
Secure Key Service-Portal, Seite Dienste: der Sicherheitsschlüssel beim jeweiligen Dienst
Security Token configento.app, Einstellungen → Integrationen, Karte Shopware 6. Schalte die Karte ein, damit ein Token erzeugt wird.

Schalte in der Plugin-Konfiguration Klassische Anmeldung verwenden ein, trage die drei Werte ein und speichere. Mit Verbindung testen prüfst du die Zugangsdaten. Stimmen sie, erscheint Klassische Cloud-Verbindung OK. Mit Neues Token erzeugst du ein neues Token. Danach musst du es auch im Plugin austauschen.

Plugin aktualisieren

Lade die neue ZIP-Datei wie bei der Installation unter Erweiterungen → Meine Erweiterungen hoch und führe das Update aus. Per Konsole kopierst du den neuen Ordner über den alten und rufst auf:

bin/console plugin:refresh
bin/console plugin:update JustsellingProductConfigurator
bin/console cache:clear

Verbindung, Einstellungen und Produktverknüpfungen bleiben beim Update erhalten.

Verbindung trennen

Verbindung trennen steht unter Configento-Verbindung in der Plugin-Konfiguration.

Achtung: Trennen wirkt für den ganzen Shop, nicht nur für deinen Admin-Benutzer. Dabei werden alle Verknüpfungen zwischen Produkten und Komponenten im Shop gelöscht und die gespeicherten Zugangsdaten zurückgesetzt. Die Komponenten selbst in configento.app bleiben erhalten. Nach einer neuen Verbindung musst du sie aber wieder mit den Produkten verknüpfen.

Trenne die Verbindung also nur, wenn der Shop configento.app nicht mehr nutzen oder mit einem anderen Dienst arbeiten soll. Für einen Wechsel des Admin-Benutzers ist das nicht nötig.

Im Service-Portal siehst du unter Verbindungen alle verbundenen Shops: Shop-Host, Plugin, Dienst, Verbunden von und Zuletzt verwendet. Dort kannst du eine Verbindung auch widerrufen, etwa wenn du keinen Zugriff mehr auf den Shop hast.

Fehlersuche

Die Komponentenliste im Produkt-Tab ist leer

  • Ist dein Admin-Benutzer verbunden? Öffne die Plugin-Konfiguration und prüfe, ob dort Verbunden als steht.
  • Ist die Komponente veröffentlicht? Entwürfe erscheinen nicht.

Unter Produktkonfigurator Cloud erscheint eine Fehlermeldung

  • „Gespeicherte Configento-Verbindung ist beschädigt“: Klicke auf Verbindung trennen und verbinde neu. Bedenke, dass dabei die Produktverknüpfungen gelöscht werden.
  • „Configento-Service-Portal konnte aktuell kein Token ausstellen“: Versuche es nach einigen Minuten mit Erneut versuchen.
  • „Plugin ist noch nicht mit Configento verbunden“: Klicke auf Jetzt verbinden.

Der Konfigurator erscheint nicht auf der Produktseite

  • Ist im Tab Produktkonfigurator des Produkts eine Komponente gewählt und das Produkt gespeichert?
  • Leere den Shopware-Cache und lade die Seite im Browser neu.
  • Bei der klassischen Anmeldung: Stimmen Kunden-ID, Secure Key und Security Token? Ist die Karte Shopware 6 unter Einstellungen → Integrationen eingeschaltet?

Datei-Upload oder Diagramm funktioniert im Shop nicht Schalte Dropzone-Plugin laden bzw. Chart-Plugin laden ein und leere den Cache.

Mit V3 bleibt der Konfigurator leer oder lädt nicht Ist die Domain deines Shops unter Einstellungen → Domänen eingetragen? Siehe Shop-Domain freigeben.

Ein Produktattribut-Merkmal bleibt leer Der Code passt nicht, oder die Eigenschaftsgruppe heißt in der Sprache des Verkaufskanals anders. Mit Legacy bleibt das Merkmal in Shopware immer leer. Siehe Produktdaten in Formeln.

Die Produktseite zeigt „Dieses Produkt kann gerade nicht konfiguriert werden.“ Dein Abo oder dein Testzeitraum ist abgelaufen. Siehe Abo-Status in der Administration.

Der Preis im Warenkorb ist zu hoch Der Shopware-Produktpreis wird zum Konfigurationspreis addiert. Setze ihn auf 0, wenn der Konfigurator den ganzen Preis liefert.

Der Shop zeigt einen alten Stand Veröffentliche die Komponente in configento.app. Der Shop zeigt nur veröffentlichte Stände.

Hilft das alles nicht, wende dich über den Chat im Service-Portal an den Support. Schreib dazu die Shopware-Version, die Plugin-Version und den Link zur betroffenen Produktseite.

Shopware 5

Shopware 5 wird von Shopware selbst nicht mehr weiterentwickelt. Auch das configento.app-Plugin für Shopware 5 bekommt keine neuen Funktionen mehr. Für neue Shops verwende Shopware 6.7.

Nächste Schritte

← Alle Artikel 14 Tage kostenlos testen