VibeFox Mondial Relay for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

Mondial-Relay-Geschäftskonto: der Markencode (Enseigne) und der Private Key gehören zu einem Geschäftskonto bei Mondial Relay: siehe den Bereich für Profis auf mondialrelay.fr, Ihren Kundenbereich „Connect“ oder Ihren Vertriebskontakt. Für die Kartenauswahl genügt der Markencode. Die Liste der nächstgelegenen Stationen benötigt beides. Für Tests stellt Mondial Relay den Markencode BDTEST13 mit dem Private Key PrivateK bereit.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können den Ordner vfd_mondialrelay auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Mondial Relay oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie Ihren Markencode (Enseigne) und für den Listenmodus den Private Key ein. Füllen Sie Country prices aus.

6. Fügen Sie VibeFox Mondial Relay unter WooCommerce > Settings > Shipping > Shipping zones den Versandzonen Ihrer Lieferländer hinzu oder aktivieren Sie Ignore shipping zones.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Mondial Relay. Sie gelten für jede Versandzone. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name dieser Option in der Kasse. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

Warnungen oben auf der Seite zeigen Probleme, durch die die Methode ausgeblendet wird: ein fehlender Markencode, ein fehlender Private Key im Listenmodus und kein Preis für Frankreich, Belgien oder Spanien.

Allgemein

Enable/Disable: schaltet Mondial Relay global ein oder aus.

Name: der Name der Versandmethode, den Kunden in der Kasse sehen. Standard: Mondial Relay Point Relais.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht.

Mondial-Relay-Konto

Brand code (Enseigne): erforderlich, bis zu 8 Zeichen, zum Beispiel BDTEST13 für Tests. Wird von der Karte für Abholstationen und vom Web Service verwendet. Ohne ihn können Kunden keinen Point Relais wählen, daher wird die Methode in der Kasse nicht angezeigt.

Private Key: nur für den Auswahlmodus List of nearest points nötig. Wenn Markencode und Private Key gesetzt sind, wird die Verbindung zum Web Service von Mondial Relay bei jedem Speichern der Einstellungen geprüft, und eine Meldung zeigt, ob sie gültig sind.

Auswahl der Abholstation

Selector: wie der Kunde einen Point Relais auswählt.

Tarife (in Ihrer Shopwährung)

Country prices: Preis nach Zielland und Paketgewicht. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Verwenden Sie die Zeile * Default für alle übrigen Länder. Jede Zeile hat eine Spalte Price sowie Gewichtsspalten: XS bis 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg und XL über 5 kg. Ist eine Gewichtsspalte leer oder 0, wird die Spalte Price verwendet. Dezimalstellen mit Punkt oder Komma (4.90 oder 4,90). Zeilen ohne Preis werden beim Speichern entfernt, und Werte, die keine Zahlen sind, werden gemeldet und leer gelassen.

Fallback cost: wird für Länder ohne Zeile in der Tabelle verwendet. Lassen Sie das Feld leer, um die Methode für diese Länder auszublenden.

Calculation type: wie der Preis berechnet wird.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, ohne Steuer), ab der die Lieferung kostenlos ist. Leer lassen, wenn es keinen kostenlosen Versand gibt.

Verfügbarkeit

Min weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. 0 bedeutet keine Grenze.

Max weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Mondial Relay nimmt Pakete bis 30 kg in Points Relais an. Standard: 30. 0 bedeutet keine Grenze.

Minimum subtotal: zeigt die Methode nur, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Disabled shipping classes: blendet die Methode aus, wenn der Warenkorb Artikel dieser WooCommerce-Versandklassen enthält.

Ignore shipping zones: bietet die Methode für die unten genannten Länder an, oder für alle unterstützten Länder, wenn die Liste leer ist, auch wenn keine Versandzone sie enthält.

Countries (ignore zones): die Zielländer für diesen Modus. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: protokolliert die Tarifberechnung und die Aufrufe des Web Service unter WooCommerce > Status > Logs (Quelle vfd-mondialrelay). Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Schlüssel oder Kundendaten werden nicht protokolliert.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins die Einstellungen und die Zonenmethoden. Deaktivierung löscht nie etwas. Die in Bestellungen gespeicherten Abholstationen bleiben erhalten.

So funktioniert es in der Kasse

Die Methode wird nur für Länder mit Points Relais angeboten: Frankreich, Belgien, Luxemburg, Spanien, Portugal und die Niederlande. Sie wird ausgeblendet, wenn der Kunde keinen Point wählen könnte: ohne Markencode oder im Listenmodus ohne Private Key.

Sobald der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft das Warenkorbgewicht, die Mindestzwischensumme und die ausgeschlossenen Versandklassen. Der Preis stammt aus der Zeile des Landes (oder der Zeile *): aus der Gewichtsspalte, sonst aus Price. Ohne Zeile werden die Ersatzkosten verwendet. Gibt es keinen Preis, wird die Methode ausgeblendet. Erreicht die Zwischensumme Free shipping from, wird der Preis 0.

Die Methode funktioniert in der klassischen Kasse und in den Blöcken Warenkorb und Kasse. Sie ist mit High-Performance Order Storage (HPOS) von WooCommerce kompatibel.

Das Plugin fragt keine Live-Tarife ab, da Mondial Relay keine öffentliche Tarif-API hat. Es erstellt keine Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Erstellen Sie die Sendungen in Ihrem Mondial-Relay-Bereich „Connect“ mit der Point-Relais-Nummer, die in der Bestellung angezeigt wird. Haustürzustellung (Domicile) wird nicht angeboten.

Abholstationen

Kartenmodus: Wenn der Kunde Mondial Relay auswählt, erscheint unter der Methode die Schaltfläche Choose a Point Relais. Sie öffnet die offizielle Karte von Mondial Relay für das Lieferland, die Postleitzahl und das Paketgewicht. Nachdem der Kunde einen Point ausgewählt hat, wird er als Selected: angezeigt, und die Schaltfläche wechselt zu Change Point Relais. Das Kartenwidget wird von widget.mondialrelay.com und die Kartenbibliothek von unpkg.com erst geladen, wenn der Kunde die Karte öffnet. Erwähnen Sie dies in Ihrer Datenschutzerklärung.

Listenmodus: Ein Auswahlmenü - Choose a Point Relais - zeigt die 10 nächstgelegenen Stationen zur Lieferpostleitzahl mit ihrer Entfernung. Der gewählte Point wird mit seinen Öffnungszeiten angezeigt. Die Liste wird von Ihrem Server geladen, daher läuft kein Drittanbieter-Skript im Browser. Listen werden 12 Stunden zwischengespeichert, leere Antworten 1 Stunde, und eine fehlgeschlagene Anfrage wird 5 Minuten lang gemerkt. Das Timeout des Web Service beträgt 10 Sekunden. Ist die Liste nicht verfügbar, sieht der Kunde „The list of pickup points is not available right now. Please use the map.“ und die Karte wird angeboten.

Ein Point ist erforderlich. Ohne ihn sieht der Kunde Please choose a Mondial Relay pickup point. und die Bestellung wird nicht aufgegeben. Ein Point in einem anderen Land als der Lieferadresse wird abgelehnt. Im Listenmodus wird der Point außerdem mit der Liste für die Adresse geprüft.

Nummer, Land, Name und Adresse des Point Relais werden in der Bestellung gespeichert. Sie werden auf der Bestellseite unter der Lieferadresse (mit der Point-Relais-Nummer), auf der Dankeseite, unter My account > Orders und in den Bestell-E-Mails (HTML und Nur-Text) als Mondial Relay pickup point angezeigt.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Mondial Relay. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Mondial Relay Kunden in der Kasse nicht angezeigt. Angemeldete Shopverwalter sehen es weiterhin, mit dem Hinweis (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen bleiben unberührt.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Mondial Relay erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Einstellungsseite: Die Methode wird ohne Markencode, im Listenmodus ohne Private Key, für ein Land ohne Preis, außerhalb der Gewichts- und Zwischensummengrenzen sowie für Länder ohne Points Relais ausgeblendet.

Web-Service-Test nach dem Speichern fehlgeschlagen: Die Meldung zeigt den Fehler von Mondial Relay, zum Beispiel einen ungültigen Markencode oder einen ungültigen Sicherheitsschlüssel. Prüfen Sie Markencode und Private Key bei Mondial Relay.

Die Liste der Stationen ist leer oder nicht verfügbar: Der Kunde muss zuerst eine Postleitzahl eingeben. Schlägt der Web Service fehl, wird stattdessen die Karte angeboten. Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-mondialrelay, um den Grund zu sehen.

Die Karte öffnet sich nicht: Die Karte wird von widget.mondialrelay.com und unpkg.com geladen. Prüfen Sie, ob ein Datenschutz- oder Skriptblocker sie nicht sperrt. Entwickler können die Skript-URLs mit den Filtern vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url und vfd_mrel_leaflet_style_url ändern. Die Liste der unterstützten Länder lässt sich mit dem Filter vfd_mrel_supported_countries anpassen.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Die Deaktivierung des Plugins behält alle Einstellungen. Nur die zwischengespeicherten Listen der Abholstationen werden gelöscht. Zum Entfernen deaktivieren und löschen Sie das Plugin auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die Caches werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Die in Bestellungen gespeicherten Abholstationen bleiben erhalten, und bestehende Bestellungen behalten ihre Versandpositionen.

Mondial Relay ist eine Marke des jeweiligen Inhabers. Dieses Plugin ist weder mit Mondial Relay verbunden noch von Mondial Relay unterstützt.