VibeFox GLS ParcelShop for OpenCart — Hilfe

Voraussetzungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3), mit dem Standard-Theme und dessen Einseiten-Kasse.

PHP: 8.0 oder neuer.

GLS: Die Erweiterung verwendet weder ein GLS-Konto noch einen 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 benötigen Sie einen Vertrag mit GLS.

Content Security Policy: Wenn Ihr Shop eine Content Security Policy sendet, erlauben Sie map.gls-croatia.com, von dort wird das Skript der GLS-Karte geladen.

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

Installation

Der Download ist eine einzelne ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 vfd_gls_parcelshop-oc3-(version).ocmod.zip und das Paket für OpenCart 4 vfd_gls_parcelshop.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_gls_parcelshop-oc3-(version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, daher müssen Sie Extensions > Modifications nicht aktualisieren. Statt des Installers können Sie den Inhalt des Ordners upload aus diesem Paket auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions, wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox GLS ParcelShop und klicken Sie auf Install (die grüne +-Schaltfläche).

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Edit ein und klicken Sie auf Activate (siehe License key).

5. Legen Sie Ihre Preise fest: mindestens eine Zeile in Country prices (zum Beispiel * Default) oder einen Fallback cost (siehe Konfiguration). Aktivieren Sie Enable/Disable und klicken Sie auf Save.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_gls_parcelshop.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions, wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox GLS ParcelShop, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 4 und 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach der Installation ist die Versandart deaktiviert, bis Sie Enable/Disable einschalten und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die gespeicherten Einstellungen wieder verwendet.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit. Die Abschnitte sind links aufgelistet. Eine Schaltfläche Save unten speichert die gesamte Seite ohne Neuladen. Nur Admin-Benutzer mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.

Warnungen oben auf der Seite, und nach jedem Speichern erneut, weisen auf Konfigurationsprobleme hin: Es ist kein Preis festgelegt, einige oder alle ausgewählten Countries (ignore zones mode) sind nicht von der GLS-Karte abgedeckt, oder die Gewichtseinheit des Shops ist der Erweiterung nicht bekannt und es gibt keine Gewichtsklasse mit der Einheit kg (fügen Sie eine unter System > Localisation > Weight Classes hinzu). Eine ungültige oder negative Zahl wird mit einer Meldung abgelehnt, die das Feld nennt, zum Beispiel Fallback cost: "abc" is not a valid number of 0 or more - the previous value was kept. Die übrigen Felder werden trotzdem gespeichert. Ein ungültiger Name, eine ungültige Sortierreihenfolge, Steuerklasse oder Geozone wird auf dieselbe Weise abgelehnt.

Allgemein

Der Abschnitt listet die Länder auf, die von der GLS-Karte abgedeckt werden: Österreich, Belgien, Bulgarien, Kroatien, Tschechien, Dänemark, Finnland, Frankreich, Deutschland, Griechenland, Ungarn, Italien, Luxemburg, die Niederlande, Polen, Portugal, Rumänien, Serbien, die Slowakei, Slowenien und Spanien. Die Versandart wird für andere Zielländer nicht angeboten.

Enable/Disable: blendet GLS ParcelShop an der Kasse ein oder aus. Standard: aus.

Name: der Name der Versandart, den der Kunde sieht. Standard: GLS ParcelShop. Pflichtfeld, höchstens 64 Zeichen, ohne die Zeichen < > ; = # { }.

Tax status: None (shipping is not taxed) oder die Steuerklasse, die angewendet wird, wenn der Versand steuerpflichtig ist.

Sort order: die Position unter den Versandarten an der Kasse. Eine ganze Zahl.

Preise

Die Preise werden in der Standardwährung Ihres Shops ohne Steuern eingegeben. Dezimalstellen dürfen mit Komma oder Punkt geschrieben werden (4,99 oder 4.99). Der Preis wird dem Kunden in seiner Währung angezeigt.

Calculation type: wie der Preis angewendet wird.

Country prices: eine Tabelle mit einer Zeile pro Zielland. Klicken Sie auf Add country, um eine Zeile hinzuzufügen. 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. Es wird die Spalte für das Warenkorbgewicht verwendet. Eine Gewichtsspalte, die auf 0 bleibt, verwendet die Spalte Price. Die Zeile * Default wird für Länder ohne eigene Zeile verwendet. Eine Zeile, in der alle Preise 0 sind, bedeutet kostenlose Lieferung. Wählen Sie das Land daher aus und tragen Sie die Preise ein, bevor Sie speichern. Wenn ein Wert in der Tabelle keine gültige Zahl von 0 oder mehr ist, wird die gesamte Tabelle nicht gespeichert, und die Meldung nennt die fehlerhaften Werte.

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 solche Länder auszublenden.

Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuern), 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 den Gewichtsklassen der Produkte umgerechnet. Leer oder 0 bedeutet kein Limit.

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 daher Ihren GLS-Vertrag. Leer oder 0 bedeutet kein Limit. Wenn das Minimum größer als das Maximum ist, werden beide Gewichte mit einer Meldung abgelehnt und die bisherigen Werte beibehalten.

Minimum cart subtotal: bietet die Versandart nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuern) diesen Betrag erreicht. Leer lassen für kein Minimum.

Geo zone: bietet die Versandart nur für Adressen in dieser Geozone an. All zones bedeutet kein Limit. Wird nicht verwendet, wenn Ignore shipping zones eingeschaltet ist. Geozonen werden unter System > Localisation > Geo Zones verwaltet.

Ignore shipping zones: ist die Option eingeschaltet, wird die Versandart für die unten ausgewählten Länder angeboten (alle Länder der GLS-Karte, wenn die Liste leer ist), unabhängig von der Geozone. Ist sie ausgeschaltet, wird die Versandart nur in der oben gewählten Geozone angeboten. Standard: aus.

Countries (ignore zones mode): die Zielländer für diesen Modus. Leer lassen, 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 eingeschaltet ist.

Erweitert

Debug log: schreibt Tarifberechnungen und ParcelShop-Auswahlen in storage/logs/vfd_glps_debug.log.php (bei OpenCart 4 system/storage/logs/vfd_glps_debug.log.php). Die Datei kann nicht über das Web gelesen werden. Fehler werden immer protokolliert. Es werden keine personenbezogenen Daten von Kunden protokolliert. Schalten Sie das Protokoll wieder aus, wenn Sie fertig sind. Erreicht die Datei 5 MB, wird sie nach vfd_glps_debug.old.log.php verschoben und ein neues Protokoll begonnen.

Log: zeigt die Größe und die neuesten Einträge des Debug-Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: ist die Option eingeschaltet, löscht die Deinstallation der Erweiterung die Einstellungen und das Protokoll. Ist sie ausgeschaltet, bleibt alles für eine erneute Installation erhalten. Der in Bestellungen gespeicherte ParcelShop bleibt immer erhalten.

Import / Export

Export: klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen, zum Beispiel in einem anderen Shop. Ungültige Werte werden gemeldet und nicht importiert.

So funktioniert es an der Kasse

Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem Preis für GLS ParcelShop. Ist eine Geo zone festgelegt (und Ignore shipping zones ausgeschaltet) und die Adresse liegt außerhalb davon, wird die Versandart nicht angeboten. Nur Produkte, bei denen Requires Shipping auf Yes steht, zählen: Andere Produkte erhöhen weder das Gewicht noch fließen sie in die Warenkorb-Zwischensumme ein. Die Zwischensumme ist der Preis dieser Produkte nach dem Rabatt des Gutscheins, ohne Steuern. Danach prüft die Erweiterung die Bedingungen: Zielland von der GLS-Karte abgedeckt (und bei eingeschaltetem Modus in Countries (ignore zones mode) ausgewählt), Warenkorbgewicht und minimale Warenkorb-Zwischensumme. 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 genommen oder aus Fallback cost. Wird kein Preis gefunden, wird die Versandart ausgeblendet. Der Preis wird auf die Dezimalstellen Ihrer Standardwährung gerundet und mit der Steuer der gewählten Tax status angezeigt.

Wählt der Kunde GLS ParcelShop, erscheint unter der Versandart ein Kasten GLS ParcelShop mit einer Schaltfläche Select GLS ParcelShop. Sie öffnet die offizielle GLS-ParcelShop-Karte für das Lieferland. Ein ParcelShop in einem anderen Land wird sofort abgelehnt. Nach der Auswahl werden Name und Adresse des ParcelShops angezeigt, und die Schaltfläche wird zu Change ParcelShop. Die Auswahl wird in der Sitzung des Kunden gespeichert, sodass sie beim erneuten Laden des Versandschritts erhalten bleibt. Ändert sich die Lieferadresse in ein anderes Land, muss der Kunde erneut einen ParcelShop wählen.

Klickt der Kunde im Schritt der Versandart auf Continue, prüft die Erweiterung, ob ein ParcelShop gewählt wurde und ob er im Lieferland liegt. Andernfalls sieht der Kunde Please select a GLS ParcelShop. oder The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. und bleibt in diesem Schritt. Kann der ParcelShop nicht gespeichert werden, sieht der Kunde The ParcelShop could not be saved. Please try again. Kann das Skript der GLS-Karte nicht geladen werden, sieht der Kunde The GLS ParcelShop map could not be loaded. Please reload the page or choose another shipping method.

Bei OpenCart 4 klickt der Kunde im Block der Versandart auf der Kassenseite auf Choose und wählt GLS ParcelShop im Fenster Shipping method options. Der Kasten GLS ParcelShop mit der Schaltfläche Select GLS ParcelShop erscheint in diesem Fenster unter der Versandart, und die GLS-Karte öffnet sich über dem Fenster. Die Schaltfläche Continue des Fensters führt nicht weiter, ohne einen gültigen ParcelShop, mit denselben Meldungen. OpenCart 4 führt für die Kasse eine einzige Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt; der ParcelShop der Bestellung wird damit mit aktualisiert.

Die GLS-Karte läuft im Browser des Kunden. Auf der Kassenseite lädt die Erweiterung 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). Ihr Server sendet nichts an GLS. Ein Fehler in der Erweiterung unterbricht nie die Kasse für andere Versandarten; er wird im Protokoll festgehalten.

Die Erweiterung 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 sie die ParcelShop-ID nicht gegen GLS prüfen. Übergeben Sie die ParcelShop-ID aus der Bestellung wie gewohnt an GLS (MyGLS, Ihre GLS-Software oder eine andere Erweiterung).

Abholstellen

Wenn die Bestellung aufgegeben wird, wird der an der Kasse gewählte ParcelShop mit der Bestellung gespeichert: seine ID, sein Name mit der Adresse und sein Land. Nach Abschluss der Bestellung wird die Auswahl gelöscht, sodass der nächste Warenkorb ohne ParcelShop beginnt.

Name der Versandart: Der ParcelShop wird dem Namen der Versandart in der Bestellung hinzugefügt, zum Beispiel GLS ParcelShop: name, address (zuerst der Name der Versandart, dann der ParcelShop) (OpenCart 3 speichert davon höchstens 128 Zeichen, OpenCart 4 höchstens 255). So erscheint der ParcelShop in der Bestellbestätigungs-E-Mail an den Kunden, auf der Bestellseite im Order History des Kunden und unter Sales > Orders. OpenCart zeigt die Versandart auf der Erfolgsseite der Bestellung nicht an.

Bestellseite im Admin: Unter Sales > Orders zeigt ein Feld GLS ParcelShop den Namen und die Adresse des ParcelShops mit der ParcelShop ID und dem Land. Hat eine GLS-ParcelShop-Bestellung keinen ParcelShop, zeigt das Feld No ParcelShop was selected for this order. Das Feld zeigt nur den ParcelShop an; dort kann er nicht geändert werden.

E-Mail an den Händler: Die E-Mail mit der Benachrichtigung über neue Bestellungen an den Shop enthält den ParcelShop mit seiner ParcelShop ID im Kommentarblock.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox GLS ParcelShop ist der erste Block unter Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-shipping-gls-parcelshop und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung zum Ändern für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird die Versandart GLS ParcelShop Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht die Versandart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird die Versandart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admins eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support benötigen aber eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin öffnen: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

GLS ParcelShop erscheint nicht an der Kasse: Prüfen Sie, dass die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Prüfen Sie Geo zone oder Ignore shipping zones und Countries (ignore zones mode). Prüfen Sie, dass 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 Gewichtslimits und Minimum cart subtotal sowie, dass die Produkte Requires Shipping auf Yes haben. Schalten Sie Debug log ein und sehen Sie im Feld Log nach dem Grund.

Die Karte öffnet sich nicht: Der Kunde sieht „The GLS ParcelShop map could not be loaded...“, wenn das GLS-Skript 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.

Der Kasten für den ParcelShop erscheint nicht unter der Versandart: Die Erweiterung wurde mit dem Standard-Theme von OpenCart und dessen Kasse getestet. Ein Theme oder eine Kassen-Erweiterung, die den Schritt der Versandart ersetzt, zeigt den Kasten möglicherweise nicht an.

Die Lieferung ist für ein Land irrtümlich 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 von 0 oder mehr. Die Meldung oben auf der Seite nennt den Wert. Verwenden Sie Ziffern mit Komma oder Punkt als Dezimaltrennzeichen.

Eine Bestellung zeigt No ParcelShop was selected for this order: Die Bestellung wurde ohne einen ParcelShop des Lieferlandes aufgegeben. Der Grund wird im Protokoll festgehalten. Fragen Sie den Kunden nach dem ParcelShop und übergeben Sie ihn manuell an GLS.

Die Seite zeigt „Warning: You do not have permission to modify VibeFox GLS ParcelShop!“: Ihre Admin-Benutzergruppe darf die Einstellungen nur ansehen. Geben Sie der Gruppe die Berechtigung zum Ändern für extension/shipping/vfd_gls_parcelshop (OpenCart 3) oder extension/vfd_gls_parcelshop/shipping/vfd_gls_parcelshop (OpenCart 4) unter System > Users > User Groups.

Für Entwickler: Die Adresse des GLS-Kartenskripts kann mit der Einstellung vfd_glps_widget_url ersetzt werden; sie hat kein Feld auf der Einstellungsseite.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox GLS ParcelShop auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt Enable/Disable, Sort order, Tax status und Geo zone immer zurück. Die Erweiterung entfernt immer ihre Ereignisse. Ist Remove data on uninstall eingeschaltet, werden auch die übrigen Einstellungen und das Debug-Protokoll gelöscht. Ist die Option ausgeschaltet, bleiben sie erhalten und werden bei einer erneuten Installation wieder verwendet. Ein in einem offenen Warenkorb gewählter ParcelShop bleibt in der Sitzung des Kunden, bis er abläuft. Der in Bestellungen gespeicherte ParcelShop bleibt immer erhalten, und bestehende Bestellungen behalten ihre Versandart und ihre Kosten.

Um bei OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox GLS ParcelShop auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Mülleimer-Schaltfläche), um das hochgeladene Paket zu entfernen.

GLS ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist weder mit GLS verbunden noch wird sie von GLS unterstützt.