VibeFox The Courier Guy 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.

ShipLogic-API-Schlüssel (für Echtzeittarife und Locker): The Courier Guy läuft auf der ShipLogic-Plattform. Erstellen Sie einen API-Schlüssel in Ihrem Kurierportal von The Courier Guy unter Settings > API Keys (Geschäftskonto). Ohne den Schlüssel wird nur die Preistabelle verwendet, und die Locker-Zustellung kann nicht angeboten werden.

Versand nach Südafrika: Echtzeittarife und Locker gibt es nur für südafrikanische Adressen. Ihr Shop muss nach Südafrika liefern (WooCommerce > Settings > General > Shipping location(s)).

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_the_courier_guy auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox The Courier Guy oder klicken Sie auf der Plugin-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 den API key von ShipLogic ein. Für Echtzeittarife füllen Sie die Absenderadresse aus (Straße, Stadt, Provinz, Postleitzahl) und, falls die Shopwährung nicht ZAR ist, die ZAR conversion rate.

6. Füllen Sie die Preistabelle und/oder die Ausweichkosten aus.

7. Fügen Sie VibeFox The Courier Guy unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Südafrika hinzu, wählen Sie den Delivery type (Courier oder TCG locker) und optional einen Titel. Fügen Sie die Methode ein zweites Mal für den anderen Liefertyp hinzu.

Konfiguration

Die wichtigsten Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox The Courier Guy. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, enthält das Zonenfenster zwei Felder:

Title (zone): der Name dieses Tarifs an der Kasse in dieser Zone. Lassen Sie das Feld leer, um den globalen Method name zu verwenden.

Delivery type (zone): Courier to the door (Standard) oder TCG locker (customer chooses a locker). Fügen Sie die Methode zweimal hinzu, um beide anzubieten. Locker benötigen den ShipLogic-API-Schlüssel und sind nur in Südafrika verfügbar.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Tarife und Locker gelöscht. Warnhinweise über den Einstellungen zeigen an, wenn der Shop nicht nach Südafrika liefert, der API-Schlüssel fehlt, der ZAR-Umrechnungskurs oder die Absenderadresse fehlt, weder Preistabelle noch Ausweichkosten hinterlegt sind oder die letzte ShipLogic-Anfrage fehlgeschlagen ist (mit Datum und Fehler).

Allgemein

Enable/Disable: schaltet die Methode überall aus, auch in den Versandzonen.

Method name: der Name, der an der Kasse angezeigt wird. Bei Locker-Zustellung wird „locker“ angehängt, zum Beispiel „The Courier Guy locker“. Eine Zone kann ihn mit einem eigenen Titel überschreiben. Standard: The Courier Guy.

Tax status: Taxable: Echtzeittarife werden ohne MwSt. übernommen, und WooCommerce fügt die eigene Steuer hinzu. None: Echtzeittarife werden inklusive MwSt. übernommen.

ShipLogic-API (Echtzeittarife und Locker)

API key: Ihr ShipLogic-API-Schlüssel aus dem Portal von The Courier Guy.

Account ID: optional. Die numerische ShipLogic-Konto-ID, nur wenn Ihr Schlüssel Zugriff auf mehrere Konten hat.

Echtzeittarife (für südafrikanische Adressen; wenn kein Echtzeittarif verfügbar ist, wird die Preistabelle verwendet)

Price source: woher der Preis kommt.

ZAR conversion rate: ShipLogic rechnet in südafrikanischen Rand (ZAR). Wenn die Shopwährung nicht ZAR ist, geben Sie an, wie viel 1 ZAR in Ihrer Shopwährung entspricht, zum Beispiel 0.05. Ohne diesen Wert werden keine Echtzeittarife verwendet, und es gilt die Preistabelle. Ist die Shopwährung ZAR, lassen Sie das Feld leer. Der Kurs wird nicht automatisch aktualisiert.

Absenderadresse (für Echtzeittarife) (wo The Courier Guy die Pakete in Südafrika abholt; für Echtzeittarife werden Straße, Stadt, Provinz und Postleitzahl benötigt)

Sender company: der Name Ihres Unternehmens.

Sender street address: zum Beispiel 12 My Road.

Sender suburb: der Stadtteil der Absenderadresse.

Sender city: die Stadt der Absenderadresse.

Sender province: wählen Sie die südafrikanische Provinz aus der Liste.

Sender postal code: die Postleitzahl der Absenderadresse.

Preistabelle (Ihre eigenen Preise in der Shopwährung: werden mit Price table only, außerhalb Südafrikas und immer dann verwendet, wenn kein Echtzeittarif vorliegt; ein Dezimalkomma oder ein Dezimalpunkt wird akzeptiert)

Calculation type: gilt nur für die Preistabelle. Ein Echtzeittarif gilt immer für die ganze Bestellung.

Prices by weight: eine Tabelle mit Ländern, einer Spalte Price und den Gewichtsstufen XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg). Klicken Sie auf + Add row, um eine Zeile hinzuzufügen (eine neue Zeile beginnt mit Südafrika), und auf das Kreuz, um sie zu entfernen. Eine leere Stufe oder 0 verwendet die Spalte Price. Ein Preis von 0 bedeutet kostenlosen Versand. Die Zeile * Any country gilt für Länder ohne eigene Zeile und für eine Länderzeile ohne Preis.

Fallback cost: wird verwendet, wenn weder ein Echtzeittarif noch ein Tabellenpreis vorliegt. Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.

Bedingungen

Min weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.

Max weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 30. 0 bedeutet keine Grenze.

Minimum order amount: zeigt die Methode nur ab dieser Zwischensumme des Warenkorbs an. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Free shipping from: die Zwischensumme des Warenkorbs, ab der diese Methode kostenlos ist. Kostenloser Versand wird nur angeboten, wenn die Methode für das Ziel einen Preis hat: einen Echtzeittarif, einen Tabellenpreis oder die Fallback cost. Wenn die Tabelle oder die Fallback cost einen Preis hat, wird für den Tarif keine Anfrage an ShipLogic gesendet. Lassen Sie das Feld leer, um nie kostenlosen Versand anzubieten.

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

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch dort, wo keine Zone sie enthält.

Delivery type without zones: Courier oder TCG locker für diesen Modus. Wird nur zusammen mit Ignore shipping zones verwendet.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zu verwenden, in die Sie liefern. Locker werden nur in Südafrika angeboten.

Erweitert

Debug log: schreibt Debug-Meldungen unter WooCommerce > Status > Logs, Quelle vfd-the-courier-guy. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Der API-Schlüssel und Kundendaten werden nie protokolliert.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins die Einstellungen und die Zonentarife dieser Methode. Das Deaktivieren des Plugins löscht nie Einstellungen. Locker und Sendungsverfolgung, die in Bestellungen gespeichert sind, bleiben erhalten.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Gilt kostenloser Versand und hat das Ziel einen Preis, wird die Methode mit einem Preis von 0 angezeigt.

Courier to the door: Das Plugin fragt ShipLogic nach dem günstigsten Service von Ihrer Absenderadresse bis zur Adresse des Kunden. Straße, Stadt, Provinz und Postleitzahl des Kunden müssen zuerst vollständig sein. Bis dahin wird der Preis aus der Tabelle angezeigt.

TCG locker: Der Echtzeittarif ist der günstigste Service von Haustür zu Locker bis zum Locker, der der Stadt des Kunden am nächsten liegt. Er wird nicht für den Locker neu berechnet, den der Kunde auswählt.

Die gesamte Bestellung wird als ein Paket kalkuliert: das Gesamtgewicht, die größte Länge und Breite sowie die gestapelten Höhen. Produkte ohne Maße zählen als Würfel mit 10 cm Kantenlänge. Der Rand-Betrag wird in Ihre Shopwährung umgerechnet. Die Servicestufe, zum Beispiel ECO, wird in der Versandzeile der Bestellung gespeichert.

ShipLogic-Anfragen laufen nach 12 Sekunden ab. Tarife werden 1 Stunde, Locker 6 Stunden und Fehler 10 Minuten zwischengespeichert, damit eine langsame API nicht jede Aktualisierung des Checkouts verlangsamt. Gibt es keinen Echtzeittarif, kommt der Preis aus der Tabelle, danach aus den Fallback cost. Trifft nichts davon zu, wird die Methode ausgeblendet.

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

Das Plugin erstellt keine Sendungen, Frachtbriefe oder Etiketten und aktualisiert die Sendungsverfolgung nicht automatisch. Es gibt keine Locker-Karte: Locker werden aus einer Liste gewählt. Echtzeittarife und Locker gelten nur für Südafrika. Andere Länder erhalten die Preistabelle. Pro Zoneninstanz wird nur ein Tarif angezeigt (die günstigste Servicestufe), ohne Auswahl von Servicestufen, Versicherung oder Extras an der Kasse.

Abholstellen

Wenn der Kunde im klassischen Checkout oder im Block-Checkout einen TCG-Locker-Tarif wählt, erscheint darunter eine Locker-Auswahl. Sie listet die Locker auf, die ShipLogic für die Stadt der Lieferadresse zurückgibt, zuerst der nächstgelegene. Der Kunde kann eine andere Stadt, einen Stadtteil oder eine Postleitzahl eingeben und auf Search klicken. Ein Locker muss ausgewählt werden, bevor die Bestellung aufgegeben werden kann.

Der Locker wird serverseitig erneut gegen die Liste von ShipLogic geprüft. Name und Anbieter stammen von ShipLogic, nie aus dem Browser. Die Auswahl bleibt bei Aktualisierungen des Checkouts erhalten und wird zurückgesetzt, wenn sich die Adresse ändert.

Wenn ShipLogic nicht erreichbar ist, zeigt die Auswahl an, dass die Locker nicht geladen werden können, und die Bestellung kann ohne Locker aufgegeben werden. Die Bestellung wird dann markiert: „Not chosen — ShipLogic was unavailable at checkout. Agree the locker with the customer.“ (Nicht gewählt: ShipLogic war an der Kasse nicht verfügbar. Vereinbaren Sie den Locker mit dem Kunden.)

Bestellungen

Der gewählte Locker (Name, ID und Anbieter) wird in der Bestellung gespeichert. Er wird auf dem Bestellbildschirm im Admin-Bereich, auf den Seiten „Vielen Dank“ und „Mein Konto“ sowie in den Bestell-E-Mails (HTML und Nur-Text) angezeigt. Die Admin-E-Mail zeigt außerdem die Locker-ID.

Auf dem Bestellbildschirm im Admin-Bereich haben Bestellungen dieser Methode ein Feld The Courier Guy tracking reference. Geben Sie die Referenz aus Ihrem Portal bei The Courier Guy ein und klicken Sie auf Save. Die Referenz wird dem Kunden auf der Bestellseite und in später gesendeten E-Mails angezeigt.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox The Courier Guy. 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 Konto auf vibefox.net.

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

Ohne aktiven Schlüssel wird The Courier Guy Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen die Methode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugin-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, aber für Updates und Support ist eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

The Courier Guy erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Landes des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, den Minimum order amount und die Excluded shipping classes. Prüfen Sie, ob die Tabelle oder die Fallback cost einen Preis hat. Locker-Tarife erscheinen nur für südafrikanische Adressen.

Kunden sehen keine Locker-Liste: Locker benötigen den API-Schlüssel, eine Zonenmethode mit Delivery type „TCG locker“ und eine südafrikanische Lieferadresse. Die Einstellungsseite zeigt den letzten ShipLogic-Fehler an, falls vorhanden, zum Beispiel einen abgelehnten Schlüssel.

Der Preis ist immer der Tabellenpreis: Prüfen Sie die Warnhinweise auf der Einstellungsseite. Ein Echtzeittarif benötigt den API-Schlüssel, die vollständige Absenderadresse und bei Shops, die nicht in Rand abrechnen, den ZAR-Umrechnungskurs. Für die Lieferung an die Haustür müssen Straße, Stadt, Provinz und Postleitzahl des Kunden vollständig sein. Für Locker muss ShipLogic einen Locker in der Nähe der Stadt des Kunden finden. Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-the-courier-guy.

ShipLogic ist nicht erreichbar: Es wird der Tabellen- oder der Ausweichpreis angezeigt. Bestellungen mit Locker können ohne Locker aufgegeben werden und werden in der Bestellung markiert.

Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Tarife und Locker gelöscht.

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 Konto auf vibefox.net 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

Das Deaktivieren des Plugins behält die Einstellungen und löscht nur die zwischengespeicherten Tarife und Locker. Zum Entfernen deaktivieren Sie das Plugin und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins, die zwischengespeicherten Tarife und Locker sowie der letzte Fehler werden immer entfernt. Einstellungen und Zonentarife werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Locker und Tracking-Referenzen werden nie entfernt, und bestehende Bestellungen behalten ihre Versandzeilen.

The Courier Guy und ShipLogic sind Marken ihrer jeweiligen Inhaber. Dieses Plugin ist nicht mit The Courier Guy oder ShipLogic verbunden und wird von ihnen nicht unterstützt.