Shop-Plugins

Die Shop-Plugins von punchout.dev sind optionale Erweiterungen für Shopware 6, WooCommerce und Magento 2, die das Script-Tag ausgeben, den Warenkorb markieren und Einkäufer anmelden.

Brauchen Sie ein Plugin?

Nein. Jeder Shop funktioniert allein mit dem Script-Tag, siehe Das Tag einbinden. Ein Plugin ergänzt zwei Dinge, die das Tag allein nicht kann, und eine Erleichterung:

Funktion	Nur Script-Tag	Mit Plugin
Warenkorb-Container	Einmal von der geführten Warenkorb-Erkennung gefunden und im Tab Warenkorb gespeichert	Im Warenkorb-Template mit data-punchout-cart markiert, nichts zu erkennen
Anmeldung des Einkäufers	Der Einkäufer kauft als Gast ein	Auto-Login: Der Einkäufer landet angemeldet in seinem Kundenkonto
Script-Tag	Sie fügen es ins Layout-Template ein	Das Plugin gibt es aus seinen Einstellungen aus

Der Warenkorb-Marker

Jedes Plugin umschließt den Warenkorb auf der Warenkorbseite mit einem schlichten Element ohne Klasse, ID oder Style:

<div data-punchout-cart>
  <!-- the cart's line items -->
</div>

Mit dem Marker liest punchout.dev nur den markierten Warenkorb. Der Marker hat immer Vorrang vor einem Warenkorb-Container, den die Warenkorb-Erkennung gefunden hat.

Ein erkannter Warenkorb-Container beschreibt das Theme, wie es heute ist. Verschiebt ein Theme-Update den Warenkorb, wird der Container nicht mehr gefunden. Der Marker dagegen sitzt im Warenkorb-Template und wandert mit. So übersteht ein Shop mit Plugin ein Redesign ohne neue Warenkorb-Erkennung.

Tipp

Führen Sie nach der Installation eines Plugins einmal den Setup-Selbsttest durch. Erzeugen Sie im Tab Einrichtung des Shops einen Setup-Link, öffnen Sie ihn auf der Warenkorbseite und klicken Sie auf Warenkorb erkennen. Das Panel meldet die Quelle Shop-Plugin. Mit Ihrer Bestätigung ist der Schritt Warenkorb erkannt im Portal erledigt.

Auto-Login

Ohne Anmeldung kauft ein Punchout-Einkäufer als Gast ein und sieht Gastpreise. Jedes Plugin bringt einen Login-Endpunkt mit. Ist Auto-Login eingerichtet, schickt der Launch den Browser des Einkäufers mit einem signierten Einmal-Token zuerst dorthin, und das Plugin meldet den zugeordneten Kunden an. Siehe Auto-Login.

Welches Plugin für welche Plattform

Plattform	Plugin	Download-Datei	Login-Endpunkt	Anleitung
Shopware 6.7	PunchoutDev	PunchoutDev-<version>.zip	/punchout-dev/login	Shopware 6
WordPress mit WooCommerce	punchout-dev	punchout-dev-<version>.zip	/wp-json/punchout-dev/v1/login	WooCommerce
Magento 2.4	Modul PunchoutDev_Bridge	PunchoutDev-Bridge-<version>.zip	/punchout-dev/login	Magento 2

Jede Zip-Datei enthält einen Ordner auf oberster Ebene, wie ihn die Plattform erwartet: PunchoutDev/ für Shopware, punchout-dev/ für WordPress, PunchoutDev/Bridge/ für Magentos app/code.

Auf jeder anderen Plattform markieren Sie den Warenkorb selbst und bauen den Login-Endpunkt, wenn Sie Auto-Login möchten. Siehe Eigene Integration.

Download

Die Plugins laden Sie im Portal herunter, immer in ihrer aktuellen Version. Einen öffentlichen Download-Link gibt es nicht.

1. Melden Sie sich unter punchout.dev/login an und öffnen Sie den Shop.
2. Stellen Sie im Tab Allgemein das Shopsystem auf Shopware, WooCommerce oder Magento und speichern Sie.
3. Öffnen Sie den Tab Einbindung. Der Abschnitt Shopware-Plugin, WooCommerce-Plugin oder Magento-Modul enthält die Schaltfläche Plugin herunterladen (Version …).

Steht das Shopsystem auf Anderes, zeigt der Tab Einbindung nur die Schritte für das Script-Tag.

Einstellungen, die alle Plugins teilen

Die Plugins verwenden die Begriffe des Portals. So lässt sich jeder Wert Feld für Feld kopieren:

Plugin-Einstellung	Wert	Kopieren aus
Snippet einbinden (Embed the snippet)	Standardmäßig an
Snippet-URL (Snippet URL)	https://js.punchout.dev/pob.js	Tab Einbindung, Snippet-URL
API-Basis-URL, optional (API base URL)	Leer lassen
Auto-Login aktivieren (Enable auto-login)	Standardmäßig an
Shop-ID (Shop ID)	pob_live_…	Tab Einbindung, Shop-ID
Public-Key-Zeilen (Public key lines)	Jede Zeile, die das Portal zeigt	Tab Auto-Login, Öffentliche Schlüssel

Eine deutsche Shopware-Administration zeigt die deutschen Bezeichnungen. Die Einstellungsseiten von WooCommerce und Magento sind englisch; ihre Bezeichnungen stehen in der Tabelle in Klammern.

Die Shop-ID hat zwei Aufgaben. Das Plugin gibt sie als data-shop-id am Script-Tag aus, und es akzeptiert ein Login-Token nur, wenn das Token für diese Shop-ID ausgestellt wurde. Ohne Shop-ID oder Snippet-URL gibt das Plugin kein Script-Tag aus.

Updates

Die Plugins aktualisieren sich nicht selbst.

1. Laden Sie die neue Zip-Datei aus dem Tab Einbindung herunter.
2. Ersetzen Sie damit das installierte Plugin. Die Schritte unterscheiden sich je Plattform und stehen auf der Seite der Plattform.

Die Einstellungen liegen in der Datenbank des Shops (Shopware-Systemkonfiguration, eine WordPress-Option, Magento-Konfiguration) und bleiben erhalten, wenn Sie die Plugin-Dateien ersetzen.

Achtung

Version 2.0.0 hat jeden technischen Bezeichner von PunchoutNinja / punchout-ninja in PunchoutDev / punchout-dev umbenannt. Für die Shop-Plattform ist das ein neues Plugin, kein Update. Entfernen Sie zuerst das Plugin 1.x und betreiben Sie nie beide, denn jedes gibt sein eigenes Script-Tag aus. Tragen Sie danach die Einstellungen neu ein und ändern Sie den Login-Pfad im Tab Auto-Login des Portals. Die Einzelheiten stehen auf den Plattformseiten.

Vollständige Plugin-Dokumentation

Die READMEs der Plugins sind unverändert und auf Englisch veröffentlicht:

• README des Shopware-Plugins
• README des WooCommerce-Plugins
• README des Magento-Moduls
• Spezifikation des Login-Tokens für Ihren eigenen Endpunkt