Magento-Plugin installieren

Mit der Magento-Erweiterung läuft dein configento.app-Konfigurator direkt auf der Produktseite deines Magento-Shops. Deine Kunden konfigurieren, sehen den Preis sofort und legen das Produkt wie gewohnt in den Warenkorb. Bestellung, Steuer und Versand wickelt Magento ab. Die Konfiguration steht in Warenkorb, Bestellung, Bestell-E-Mail und Bestellansicht im Admin.

Voraussetzungen

• Magento Open Source oder Adobe Commerce 2.4, bis einschließlich 2.4.9
• PHP 7.4 bis 8.4, mit den Erweiterungen json und curl
• Composer und Zugriff auf die Kommandozeile deines Magento-Servers
• Ein Login für das Service-Portal (service.configento.app) mit einer aktiven Service Order im Tarif Professional oder Ultimate. Im Tarif Basic lässt sich kein Shop-Plugin verbinden.
• Mindestens eine veröffentlichte Komponente. Dein Shop zeigt immer den zuletzt veröffentlichten Stand.

Magento 1 wird nicht mehr weiterentwickelt. Diese Anleitung gilt nur für Magento 2.

So funktioniert es

1. Du installierst die Erweiterung per Composer.
2. Ein Magento-Admin meldet sich einmal mit seinem Service-Portal-Login bei Configento an. Danach sind Shop und Service Order verbunden – Kunden-ID, Schlüssel und Token trägt die Erweiterung selbst ein.
3. Du hängst an jedes konfigurierbare Produkt eine benutzerdefinierte Option vom Typ configento.app und wählst dort die Komponente.
4. Auf der Produktseite lädt der Konfigurator. Beim Klick auf In den Warenkorb übernimmt Magento den konfigurierten Preis.

Schritt 1: Erweiterung installieren

Die Erweiterung kommt aus dem Composer-Repository von justSelling. Den passenden Befehl findest du auch im Configento-Admin unter Einstellungen → Integrationen in der Karte Magento 2.

Wechsle in das Hauptverzeichnis deiner Magento-Installation und führe aus:

composer config repositories.configento composer https://www.justselling.de/repo/mage2/
composer require justselling/configento:^5.1

Danach aktivierst du das Modul und baust Magento neu:

bin/magento maintenance:enable
bin/magento module:enable Justselling_Configento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy de_DE en_US
bin/magento cache:flush
bin/magento maintenance:disable

• setup:di:compile und setup:static-content:deploy brauchst du nur im Produktivmodus. Gib bei static-content:deploy die Sprachen deiner Shops an.
• Im Entwicklermodus reichen setup:upgrade und cache:flush.

Ohne Composer

Wenn du Composer nicht nutzen kannst, lädst du die ZIP-Datei der gewünschten Version unter www.justselling.de/repo/mage2/ herunter und entpackst sie nach app/code/Justselling/Configento/. Danach folgen dieselben bin/magento-Befehle wie oben. Updates musst du dann jedes Mal von Hand einspielen – Composer ist deshalb der empfohlene Weg.

Schritt 2: Mit Configento verbinden

1. Öffne im Magento-Admin das Menü justSelling → configento.app → configento.app.
2. Beim ersten Aufruf erscheint Mit Configento verbinden. Klicke auf Bei Configento anmelden.
3. Du landest im Service-Portal. Melde dich mit deinem Portal-Login an.
4. Wähle unter Welcher Kunde / welche Service-Order? die Service Order, mit der der Shop arbeiten soll. Angeboten werden nur aktive Service Orders im Tarif Professional oder Ultimate.
5. Bestätige die Freigabe. Die Schaltflächen heißen derzeit noch englisch Approve (bestätigen) und Deny (ablehnen).
6. Zurück in Magento siehst du Mit Configento als … verbunden. und darunter den Configento-Admin. Hier legst du Komponenten an und bearbeitest sie, ohne Magento zu verlassen.

Beim ersten Verbinden trägt die Erweiterung die Zugangsdaten für den Shop automatisch ein und meldet die Aktivierung an configento.app. Du musst weder eine Kunden-ID noch einen Sicherheitstoken abtippen.

Mehrere Admin-Benutzer

Die Anmeldung gilt pro Magento-Admin-Benutzer. Jeder, der den Configento-Admin in Magento öffnen will, meldet sich einmal selbst an. Damit siehst du später, wer verbunden ist, und kannst einzelne Zugänge entfernen (siehe Verbindungen verwalten).

Klassische Anmeldung

Installationen, die schon vor Version 5 liefen, können bei der bisherigen Anmeldung mit Kunden-ID, Secure Key und Sicherheitstoken bleiben. Dazu stellst du in der Konfiguration Klassische Anmeldung verwenden auf Ja. Für neue Installationen lässt du die Einstellung aus.

Schritt 3: Produkt mit einer Komponente verknüpfen

1. Öffne das Produkt im Magento-Admin.
2. Öffne den Abschnitt mit den benutzerdefinierten Optionen (Customizable Options) und füge eine Option hinzu.
3. Gib der Option einen Titel, z. B. „Konfiguration“. Er erscheint im Warenkorb vor der Zusammenfassung.
4. Wähle als Option Type den Eintrag configento.app.
5. Im Feld Template wählst du die Komponente. Die Liste zeigt die Komponenten deiner verbundenen Service Order mit ihrem Namen.
6. Speichere das Produkt.

Auf der Produktseite erscheint jetzt der Konfigurator. Eine Komponente lässt sich an beliebig viele Produkte hängen.

Liste leer? Die Komponentenliste kommt von configento.app. Ist sie leer, ist der Shop noch nicht verbunden (Schritt 2) oder die Service Order hat noch keine Komponente.

Was im Shop passiert

• Produktseite: Komponenten mit der Frontend-Engine V3 werden direkt in die Seite eingebaut. Preis und Zusammenfassung zeigt der Shop an der gewohnten Stelle, Produktbilder landen in der Galerie. Komponenten mit der Engine Legacy laufen wie bisher. Beide Arten können im selben Shop nebeneinander laufen.
• Warenkorb: Der konfigurierte Preis gilt für Warenkorb, Steuer, Versand und Bestellung. Die Konfiguration wird als Liste unter dem Artikel angezeigt.
• Wunschzettel und Sofortkauf: Die Konfiguration wird mitgespeichert. Über Bearbeiten im Warenkorb oder Wunschzettel öffnet sich der Konfigurator wieder mit der gespeicherten Auswahl.
• Bestellung: Die Konfiguration steht in der Bestellbestätigung und in der Bestellansicht im Admin.

Einstellungen der Erweiterung

Die Einstellungen öffnest du über justSelling → configento.app → Konfiguration. Einige Bezeichnungen erscheinen auch im deutschen Admin auf Englisch – wir nennen sie hier so, wie du sie siehst.

Configento-Verbindungen

General

Entwickler-Modus, Backend URL, Frontend URL, Cloud Base URL und CORS: Allow Private Network sind für die Entwicklung gedacht und bleiben im Live-Shop aus bzw. leer.

Product View

Neuer Konfigurator (V3)

Ab Version 5.0.0-beta21. Gilt für Produkte, deren Komponente den neuen Konfigurator (V3) nutzt.

Cart, Checkout and Backend

Asset Synchronisation

Preisprüfung

Den Preis berechnet der Konfigurator im Browser. Mit der Preisprüfung lässt dein Shop jeden Preis beim Hinzufügen zum Warenkorb von configento.app mit demselben Rechenweg nachrechnen. So kann niemand einen manipulierten Preis in den Warenkorb schicken.

So stellst du um:

1. Starte mit Beobachten und lass den Shop einige Tage normal laufen.
2. Suche im Magento-Log nach configento.v3.price.divergence. Jeder Eintrag ist eine Konfiguration, bei der Browser und Server unterschiedlich gerechnet haben – Ursache ist meist ein abweichender Steuersatz oder ein Wert, den nur der Shop kennt.
3. Erst wenn keine Abweichungen mehr auftauchen, schaltest du auf Erzwingen.

Geprüft werden nur Komponenten mit der Frontend-Engine V3. Komponenten mit der Engine Legacy werden übersprungen und wie bisher berechnet.

Abo-Status im Backend

Ab Version 5.0.0-beta25 zeigt die Erweiterung oben im Magento-Backend eine Systemmeldung mit dem Link Abo verwalten ins Service-Portal, wenn es bei deinem configento.app-Abo etwas zu tun gibt:

Bedient configento.app deinen Shop nicht mehr, zeigen die Produktseiten statt des Konfigurators den Satz Dieses Produkt kann derzeit nicht konfiguriert werden. Den Status fragt die Erweiterung höchstens einmal pro Stunde ab. Nach einer Verlängerung kann es also bis zu einer Stunde dauern, bis die Meldung verschwindet.

Verbindungen verwalten

• In Magento: Unter Configento-Verbindungen in der Konfiguration siehst du alle verbundenen Admin-Benutzer und trennst einzelne Verbindungen mit Trennen.
• Im Service-Portal: Unter Verbindungen siehst du alle verbundenen Shops deiner Service Order mit Shop-Host, Plugin, verbindendem Benutzer und letzter Nutzung. Widerrufen trennt dort einen Shop vollständig.

Update

Mit Composer holst du die neueste Version so:

composer update justselling/configento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy de_DE en_US
bin/magento cache:flush

Die installierte Version siehst du oben in der Konfiguration der Erweiterung. Was sich in jeder Version geändert hat, steht in den Release Notes, die mit der Erweiterung ausgeliefert werden.

Fehlersuche

Gehe diese Punkte der Reihe nach durch:

1. „Das Shop-Plugin kann nur mit einer Professional- oder Ultimate-Order verbunden werden“ – deine Service Order hat den Tarif Basic oder ist nicht aktiv. Wechsle im Service-Portal den Tarif oder wähle eine andere Service Order.
2. Der Configento-Admin in Magento zeigt nur „Mit Configento verbinden“ – dieser Admin-Benutzer hat sich noch nicht angemeldet. Die Anmeldung gilt pro Benutzer.
3. Das Feld „Template“ zeigt keine Komponente – der Shop ist noch nicht verbunden, oder die Service Order hat noch keine Komponente.
4. Der Konfigurator erscheint nicht auf der Produktseite – prüfe, ob das Produkt die Option vom Typ configento.app hat und die Komponente veröffentlicht ist. Leere danach den Magento-Cache und lade die Seite ohne Browser-Cache neu.
5. Änderungen an der Komponente kommen nicht im Shop an – der Shop zeigt den zuletzt veröffentlichten Stand. Veröffentliche die Komponente im Configento-Admin.
6. Fehler beim Kompilieren oder nach dem Update – führe setup:upgrade, setup:di:compile und cache:flush erneut aus. Im Produktivmodus fehlen nach einem Update sonst die neuen Klassen.
7. „Der Preis für Ihre Konfiguration konnte nicht bestätigt werden“ – die Preisprüfung steht auf Erzwingen, und configento.app war nicht erreichbar oder konnte die Komponente nicht berechnen. Stelle auf Beobachten zurück und prüfe das Log.
8. Weitere Hinweise – aktiviere den Debug-Modus und sieh in die Browser-Konsole. Die Erweiterung schreibt außerdem in var/log/configento.log, Meldungen zur Anmeldung in var/log/configento-oauth.log.

Hilft das alles nicht, erreichst du den Support über den Chat im Service-Portal. Schick die Version der Erweiterung und die passenden Log-Einträge gleich mit.

Nächste Schritte

• Erste Komponente anlegen
• Shopware-Plugin installieren
• HTML-Snippet Integration
• JavaScript-Schnittstelle (V3)