VibeFox GIG Logistics for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

GIG-Logistics-API-Zugangsdaten (nur für Live-Preise): Live-Preise nutzen die Drittanbieter-API von GIG Logistics. GIG Logistics stellt Geschäftskunden einen API-Benutzernamen (meist eine E-Mail-Adresse) und ein Passwort aus. Beantragen Sie sie auf der Entwicklerseite von GIG Logistics (giglogistics.com/developer). Test-Zugangsdaten funktionieren nur mit der Test-API. Wenn Sie nur die Preistabelle und die Ersatzkosten nutzen, brauchen Sie keine API-Zugangsdaten.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine 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_gig_logistics auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox GIG Logistics, oder klicken Sie auf der Seite Plugins 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. Füllen Sie die Preistabelle und/oder die Ersatzkosten aus. Für Live-Preise geben Sie außerdem API-Benutzername und Passwort, die Telefonnummer des Absenders, Stadt und Bundesstaat der Abholung sowie den Umrechnungskurs ein, falls die Shop-Währung nicht NGN ist (siehe Konfiguration).

6. Fügen Sie VibeFox GIG Logistics unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Nigeria hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus.

Konfiguration

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

Title (zone): der Name, den Kunden für diese Zone sehen. Leer lassen, um den allgemeinen Method title zu verwenden.

Oberhalb der Felder zeigt die Seite Warnungen, wenn Live-Preise nicht genutzt werden können: Nur einer der beiden Werte API-Benutzername und Passwort ist eingetragen, Sender phone oder Abholstadt und Bundesstaat fehlen, oder die Shop-Währung ist nicht NGN und keine Currency conversion rate ist gesetzt. Bei jedem Speichern der Einstellungen werden zwischengespeicherte Preise und API-Token gelöscht.

General

Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus. Standard: ein.

Method title: der Name der Versandart, der im Warenkorb und in der Kasse angezeigt wird. Standard: GIG Logistics. Ein Zonentitel überschreibt ihn.

Tax status: Taxable fügt die Versandsteuer Ihres Shops auf den Preis auf, None nicht. Wählen Sie None, wenn der GIG-Preis bereits alles enthält, was Sie berechnen möchten.

GIG-Logistics-API (Live-Preise) (optional)

Mit API-Zugangsdaten wird der Preis für jede nigerianische Adresse bei GIG Logistics abgefragt. Ohne Zugangsdaten oder wenn die API keinen Preis liefert, werden die Preistabelle und die Ersatzkosten verwendet.

API username: Ihr API-Benutzername bei GIG Logistics als Drittanbieter, meist Ihre E-Mail-Adresse.

API password: Ihr API-Passwort bei GIG Logistics als Drittanbieter. Es dient nur der Anmeldung an der API und wird nie protokolliert.

Test mode: nutzt die Test-API (dev) von GIG Logistics. Test-Zugangsdaten funktionieren nur mit der Test-API. Für echte Preise ausschalten. Standard: aus.

Currency conversion rate: GIG Logistics liefert Preise in NGN. Wenn Ihre Shop-Währung nicht NGN ist, geben Sie ein, wie viel ein NGN in Ihrer Shop-Währung wert ist (1 NGN = ? Ihrer Währung, zum Beispiel 0.0006). Ohne ihn werden Live-GIG-Preise nicht verwendet. Ist Ihre Shop-Währung NGN, wird dieses Feld nicht benötigt. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Abholadresse (Absender)

Wo GIG Logistics die Pakete in Nigeria abholt. Befindet sich Ihr Shop in Nigeria, übernehmen leere Felder für Straße, Stadt und Bundesstaat die Shop-Adresse aus WooCommerce > Settings > General.

Sender name: der Absendername für GIG Logistics. Leer bedeutet: der Name der Website.

Sender phone: Ihre Telefonnummer, zum Beispiel 08030000000. GIG Logistics verlangt sie für Live-Preise.

Street address: die Straßenadresse der Abholung.

City / area: die Stadt oder der Stadtteil der Abholung, zum Beispiel Victoria Island. Für Live-Preise erforderlich.

State: der nigerianische Bundesstaat der Abholadresse. Standardmäßig wird der Bundesstaat des Shops verwendet. Für Live-Preise erforderlich.

Pickup latitude: optionaler Breitengrad des Abholpunkts auf der Karte, zum Beispiel 6.4281. GIG Logistics berechnet den Preis nach Entfernung. Leer bedeutet: Die Koordinaten werden aus der Adresse ermittelt.

Pickup longitude: optionaler Längengrad des Abholpunkts auf der Karte, zum Beispiel 3.4219.

Address lookup: ermittelt Kartenkoordinaten von Adressen mit OpenStreetMap (Nominatim). GIG Logistics berechnet den Preis aus den Koordinaten von Abholung und Lieferung. Straße, Stadt und Bundesstaat des Kunden werden an nominatim.openstreetmap.org gesendet, und die Ergebnisse werden 30 Tage zwischengespeichert. Ohne diese Option wird nur der Adresstext gesendet, und GIG Logistics liefert unter Umständen keinen Preis. Standard: ein.

Preistabelle und Ersatzkosten

Wird für andere Länder verwendet, wenn Live-Preise nicht konfiguriert sind oder GIG Logistics keinen Preis liefert. Die Preise sind in Ihrer Shop-Währung.

Country prices: eine Tabelle mit einem Grundpreis je Land. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Wählen Sie * Any other country für alle Länder ohne eigene Zeile. Die Spalten XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg) sind optionale Gewichtsstufenpreise: Ein Stufenpreis über 0 ersetzt den Grundpreis für Warenkörbe in dieser Stufe. Ein Preis von 0 bedeutet kostenlosen Versand. Leere Preisfelder werden als 0 gespeichert, tragen Sie daher für jede hinzugefügte Zeile den Grundpreis ein. Länder ohne Zeile (wenn keine *-Zeile vorhanden ist) erhalten keinen Tabellenpreis.

Fallback cost: wird verwendet, wenn weder GIG Logistics noch die Tabelle einen Preis liefern. Leer bedeutet: Die Versandart wird in diesem Fall ausgeblendet.

Table / fallback price is: Per order berechnet den Preis einmal. Per item (multiplied by the number of items) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Live-GIG-Preise gelten immer für die gesamte Bestellung.

Bedingungen

Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. Leer bedeutet: nie kostenlos.

Minimum subtotal: Die Methode wird nur angezeigt, wenn die Warenkorb-Zwischensumme diesen Betrag erreicht. Leer bedeutet: immer.

Min weight (kg): das minimale Warenkorbgewicht in kg. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet. 0 bedeutet keine Grenze.

Max weight (kg): das maximale Warenkorbgewicht in kg. Standard: 30. 0 bedeutet keine Grenze.

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 wenn sie keiner Zone hinzugefügt ist. Ist die Option aus, erscheint die Methode nur in den Versandzonen, denen sie hinzugefügt wurde.

Countries: die Zielländer für diesen Modus. Leer bedeutet: alle Länder, in die Sie liefern. Wird nur mit Ignore shipping zones verwendet.

Erweitert

Debug log: protokolliert Preisberechnungen unter WooCommerce > Status > Logs, Quelle vfd-gig-logistics. API-Fehler werden immer protokolliert, auch bei ausgeschaltetem Protokoll. Passwörter, Token oder Kundenadressen werden nicht geschrieben.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins seine Einstellungen, Zonenmethoden und Caches. Das Deaktivieren des Plugins löscht nie etwas.

So funktioniert es in der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Preis. Das Plugin prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht, Mindest-Zwischensumme und ausgeschlossene Versandklassen. Erreicht die Zwischensumme Free shipping from, wird die Methode mit dem Preis 0 angezeigt, aber nur, wenn das Land einen Preis hat: eine Zeile in Country prices, eine Fallback cost oder ein Live-Preis von GIG Logistics. GIG Logistics wird nur abgefragt, wenn die Tabelle und die Ersatzkosten keinen Preis liefern.

Dann wird der Preis aus der ersten Quelle genommen, die einen liefert. Zuerst der Live-Preis von GIG Logistics, sofern API-Zugangsdaten eingegeben sind, die Adresse in Nigeria liegt, der Kunde eine Stadt oder einen Bundesstaat eingegeben hat, Telefon, Stadt und Bundesstaat der Abholung gesetzt sind und für Shops mit einer anderen Währung als NGN ein Umrechnungskurs gesetzt ist. Das Plugin meldet sich an der GIG-Logistics-API an und sendet Abhol- und Lieferadressen und -koordinaten sowie die Warenkorbartikel mit Namen, Mengen, Gewichten und Werten. Produkte ohne Gewicht werden als 1 kg gesendet. Der Preis wird für die Zustellung per bike angefragt. Zweitens die Tabelle Country prices. Drittens die Fallback cost. Liefert keine von ihnen einen Preis, wird die Versandart für diesen Warenkorb ausgeblendet.

Jede Antwort von GIG wird 1 Stunde zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage oder eine fehlgeschlagene Anmeldung wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf GIG Logistics wartet. Das Anmelde-Token wird 30 Minuten gespeichert und automatisch erneuert, wenn GIG es ablehnt. Das API-Timeout beträgt 10 Sekunden, das Timeout der Adresssuche 5 Sekunden.

Gibt GIG Logistics einen Fehler oder einen Preis von null zurück, sieht der Kunde keinen Fehler. Der Tabellen- oder Ersatzpreis wird verwendet, und der Fehler wird protokolliert.

Die Methode funktioniert in der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit dem High-Performance-Bestellspeicher von WooCommerce (HPOS) kompatibel.

Das Plugin berechnet nur Preise. Es erstellt keine Sendungen, Versandbelege oder Etiketten von GIG Logistics, bucht keine Abholungen, verfolgt keine Pakete und lässt Kunden kein Servicecenter wählen. Bestellungen werden wie gewohnt über Ihr GIG-Logistics-Konto versandt. Live-Preise werden nur für nigerianische Adressen abgefragt. Für andere Länder verwenden Sie die Preistabelle.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox GIG Logistics. 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 für eine 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 GIG Logistics Kunden in der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Eine Erinnerung erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

GIG Logistics erscheint nicht in 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, Minimum subtotal und Excluded shipping classes. Prüfen Sie, ob die Tabelle (das Land oder *) oder die Fallback cost einen Preis für das Land liefert.

Der Preis stammt aus der Tabelle, nicht von GIG Logistics: Live-Preise benötigen API-Benutzername und Passwort, Sender phone, Abholstadt und Bundesstaat, eine nigerianische Lieferadresse mit Stadt oder Bundesstaat und für Shops mit einer anderen Währung als NGN die Currency conversion rate. Achten Sie auf die Warnungen oben auf der Einstellungsseite. Aktivieren Sie das Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-gig-logistics, um den Grund zu sehen. Eine fehlgeschlagene Anfrage wird nach 10 Minuten erneut versucht.

Login failed im Protokoll: GIG Logistics hat den API-Benutzernamen oder das Passwort abgelehnt. Prüfen Sie beides und prüfen Sie den Test mode: Test-Zugangsdaten funktionieren nur mit der Test-API. Speichern Sie die Einstellungen, um sofort erneut zu versuchen.

GIG Logistics liefert keinen Preis: GIG berechnet Preise nach Entfernung. Lassen Sie Address lookup eingeschaltet oder geben Sie Pickup latitude und Pickup longitude ein. Bestätigen Sie die Preise mit Ihrem GIG-Logistics-Konto, bevor Sie live gehen.

Steuer wird auf den GIG-Preis aufgeschlagen: Setzen Sie Tax status auf None, wenn der GIG-Preis bereits alles enthält, was Sie berechnen möchten.

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

Eigener Geocoder: Entwickler können mit dem Filter vfd_gigl_pre_geocode eine eigene Adresssuche bereitstellen.

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

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonenmethoden, zwischengespeicherte Preise, Token und Adresssuchen werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen.

GIG Logistics ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit GIG Logistics verbunden und wird von GIG Logistics weder unterstützt noch empfohlen.