VibeFox GLS ParcelShop for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.
PHP: 8.0 oder neuer.
GLS: Das Plugin verwendet kein GLS-Konto und keinen API-Schlüssel und benötigt sie auch nicht. Die ParcelShop-Karte ist öffentlich. Für den Versand der Pakete an die gewählten ParcelShops brauchen Sie einen Vertrag mit GLS.
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 aus und klicken Sie auf Install Now. Alternativ können Sie den Ordner vfd_gls_parcelshop per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop, 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. Legen Sie den Namen und Ihre Preise fest: mindestens eine Zeile unter Country prices (zum Beispiel * Default) oder einen Fallback cost (siehe Konfiguration).
6. Fügen Sie VibeFox GLS ParcelShop unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu oder aktivieren Sie Ignore shipping zones.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Sie gelten für alle Versandzonen. Wenn Sie die Versandart einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:
Title (zone): der Name der Versandart, den Kunden in dieser Zone sehen. Lassen Sie das Feld leer, um den globalen Wert Name zu verwenden.
Warnungen oben auf der Einstellungsseite weisen auf Konfigurationsprobleme hin, zum Beispiel wenn kein Preis festgelegt ist oder keines der ausgewählten Länder von der GLS-Karte abgedeckt wird. Ungültige Zahlen werden mit einer Meldung abgelehnt, und der bisherige Wert bleibt erhalten.
Allgemein
Dieser Abschnitt listet die Länder auf, die von der GLS-Karte abgedeckt werden. Die Versandart wird für andere Zielländer nicht angeboten.
Enable/Disable: schaltet die Versandart in allen Zonen gleichzeitig ein oder aus. Standard: ein.
Name: der Name der Versandart, der dem Kunden angezeigt wird. Eine Zone kann ihn mit einem eigenen Title überschreiben. Standard: GLS ParcelShop.
Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None fügt keine hinzu. Standard: Taxable.
Preise
Preise werden in der Währung Ihres Shops eingegeben. Dezimalstellen können mit Komma oder Punkt angegeben werden (4,99 oder 4.99).
Calculation type: legt fest, wie der Preis angewendet wird.
Country prices: eine Tabelle mit einer Zeile je Zielland. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine Zeile zu entfernen. Jede Zeile hat ein Country, einen Price und fünf Gewichtsspalten: XS bis 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg und XL über 5 kg. Verwendet wird die Spalte für das Gewicht des Warenkorbs. Eine Gewichtsspalte, die auf 0 bleibt, verwendet die Spalte Price. Die Zeile * Default gilt für Länder ohne eigene Zeile. Neue Zeilen beginnen mit 0 in allen Spalten, und eine Zeile, in der alle Preise 0 sind, bedeutet kostenlose Lieferung. Tragen Sie die Preise daher vor dem Speichern ein.
Fallback cost: der Preis, der verwendet wird, wenn die Tabelle für das Zielland keine Zeile und keine Zeile * Default hat. Lassen Sie das Feld leer, um die Versandart für diese Länder auszublenden.
Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer), ab der die Lieferung mit GLS ParcelShop kostenlos ist. Lassen Sie das Feld leer, wenn die Lieferung nie kostenlos sein soll.
Verfügbarkeit
Minimum weight (kg): blendet die Versandart aus, wenn der Warenkorb weniger wiegt. Das Gewicht wird aus der Gewichtseinheit Ihres Shops umgerechnet. Leer oder 0 bedeutet keine Begrenzung.
Maximum weight (kg): blendet die Versandart aus, wenn der Warenkorb mehr wiegt. Standard: 20. GLS ParcelShops nehmen in der Regel Pakete bis 20 kg an. Prüfen Sie dies in Ihrem GLS-Vertrag. Leer oder 0 bedeutet keine Begrenzung.
Minimum cart subtotal: bietet die Versandart nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer) diesen Betrag erreicht. Lassen Sie das Feld leer, wenn es kein Minimum gibt.
Excluded shipping classes: blendet die Versandart aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.
Ignore shipping zones: Ist die Option aktiviert, wird die Versandart für die unten gewählten Länder angeboten, auch wenn sie nicht der passenden Versandzone zugeordnet ist. Ist sie deaktiviert, wird sie nur in den Zonen angeboten, denen sie zugeordnet ist. Standard: aus.
Countries (ignore zones mode): die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder der GLS-Karte zu verwenden. Länder, die nicht von der GLS-Karte abgedeckt werden, werden übersprungen. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.
Erweitert
Debug log: protokolliert die Tarifberechnung und die Auswahl der ParcelShops unter WooCommerce > Status > Logs (Quelle vfd-gls-parcelshop). Personenbezogene Daten der Kunden werden nicht protokolliert. Schalten Sie das Protokoll nach Abschluss der Arbeiten wieder aus.
Remove data on uninstall: ist die Option aktiviert, werden beim Löschen des Plugins die Einstellungen und die Zoneninstanzen dieser Versandart entfernt. Das Deaktivieren des Plugins löscht nie etwas. Der in Bestellungen gespeicherte ParcelShop bleibt immer erhalten.
So funktioniert es an der Kasse
Sobald der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Lieferland von der GLS-Karte abgedeckt, Gewicht des Warenkorbs, Mindestbetrag der Warenkorb-Zwischensumme und ausgeschlossene Versandklassen. Erreicht die Warenkorb-Zwischensumme Free shipping from, ist die Lieferung kostenlos. Andernfalls wird der Preis aus der Zeile des Landes (oder der Zeile * Default) und der Gewichtsspalte oder aus Fallback cost entnommen. Wird kein Preis gefunden, wird die Versandart ausgeblendet.
Wählt der Kunde GLS ParcelShop, erscheint unter der Versandart eine Schaltfläche Select GLS ParcelShop. Sie öffnet die offizielle GLS-ParcelShop-Karte für das Versandland. Nachdem ein ParcelShop gewählt wurde, werden sein Name und seine Adresse angezeigt, und die Schaltfläche wechselt zu Change ParcelShop. Die Auswahl wird in der Kundensitzung gespeichert und bleibt daher nach einer Aktualisierung der Kasse oder einem Neuladen der Seite erhalten.
Beim Abschluss der Bestellung prüft das Plugin, ob ein ParcelShop gewählt wurde und ob er im Versandland liegt. Andernfalls sieht der Kunde Bitte wählen Sie einen GLS ParcelShop aus. oder Der gewählte GLS ParcelShop liegt nicht in Ihrem Versandland. Bitte wählen Sie erneut einen ParcelShop aus., und die Bestellung wird nicht abgeschlossen. Lässt sich das Skript der GLS-Karte nicht laden, sieht der Kunde eine Meldung, die Seite neu zu laden oder eine andere Versandart zu wählen.
Die GLS-Karte läuft im Browser des Kunden. Auf der Kassenseite lädt das Plugin das Skript der GLS-Karte von map.gls-croatia.com, und die Karte lädt die ParcelShop-Daten und Kartenkacheln von GLS. GLS erhält die üblichen Anfragedaten des Besuchers (IP-Adresse, Browser). Von Ihrem Server wird nichts an GLS gesendet.
Die Versandart funktioniert an der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin ruft keine aktuellen GLS-Tarife ab, erstellt keine GLS-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Auf Ihrem Server gibt es keine Liste der ParcelShops, daher kann es die ParcelShop-ID nicht gegen GLS prüfen. Übergeben Sie die ParcelShop-ID aus der Bestellung auf Ihrem üblichen Weg an GLS (MyGLS, Ihre GLS-Software oder ein anderes Plugin).
Abholpunkte
Der gewählte ParcelShop wird mit der Bestellung gespeichert: seine ID, sein Name mit der Adresse und sein Land.
Bestellseite im Admin-Bereich: Name und Adresse des ParcelShops mit der ParcelShop-ID und dem Land werden unter der Lieferadresse angezeigt. Hat eine GLS-ParcelShop-Bestellung keinen ParcelShop, zeigt die Seite Für diese Bestellung wurde kein ParcelShop ausgewählt.
Kundenseiten: Der ParcelShop wird auf der Danke-Seite und auf der Bestellansicht im Kundenkonto angezeigt.
E-Mails: Der ParcelShop wird den Bestell-E-Mails hinzugefügt, in HTML und als Nur-Text. E-Mails an den Shop-Administrator enthalten zusätzlich die ParcelShop-ID.
Entwickler können den ParcelShop aus den Bestell-Metadaten _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name und _vfd_glps_parcelshop_country auslesen.
Lizenzschlüssel
Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. 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 GLS ParcelShop Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen sie weiterhin, gekennzeichnet mit (nicht lizenziert – nur für Administratoren sichtbar), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. 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, doch für Updates und Support ist eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
GLS ParcelShop erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Versandart der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones eingeschaltet und das Land erlaubt ist). Prüfen Sie, ob das Zielland zu den Ländern der GLS-Karte gehört und einen Preis hat (eine Länderzeile, die Zeile * Default oder Fallback cost). Prüfen Sie die Gewichtsgrenzen, Minimum cart subtotal und Excluded shipping classes. Schalten Sie Debug log ein, um den Grund unter WooCommerce > Status > Logs zu sehen.
Die Karte öffnet sich nicht: Der Kunde sieht „Die GLS-ParcelShop-Karte konnte nicht geladen werden...“, wenn das Skript der GLS-Karte blockiert wird, zum Beispiel durch einen Werbe- oder Datenschutzblocker, eine Content-Security-Policy oder einen Ausfall bei GLS. Erlauben Sie map.gls-croatia.com in Ihrer Content-Security-Policy.
Die Lieferung ist für ein Land versehentlich kostenlos: Prüfen Sie die Zeile dieses Landes unter Country prices. Eine Zeile, in der Price und alle Gewichtsspalten 0 sind, bedeutet kostenlose Lieferung.
Die Tabelle oder ein Feld wurde nicht gespeichert: Ein Wert ist keine gültige Zahl. Die Meldung oben auf der Seite nennt den Wert. Verwenden Sie Ziffern mit Komma oder Punkt als Dezimaltrennzeichen.
Entwicklerfilter: vfd_glps_map_countries ändert die Liste der Länder der GLS-Karte, vfd_glps_widget_url ändert die URL des Skripts der GLS-Karte.
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. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt, zusammen mit alten Caches und der Protokolldatei der Version 1.0. Einstellungen und Zoneninstanzen der Versandart werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Der in Bestellungen gespeicherte ParcelShop bleibt immer erhalten, und bestehende Bestellungen behalten ihre Versandpositionen.
GLS ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit GLS verbunden und wird von GLS weder unterstützt noch empfohlen.