VibeFox LP Express for OpenCart — Hilfe

Anforderungen

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 der Standardkasse von OpenCart.

PHP: 8.0 oder neuer.

LP Express: Ein API-Konto ist nicht nötig. LP Express hat keine öffentliche Preis-API, und die Erweiterung nutzt nicht die Unisend-API. Daher geben Sie Ihre eigenen (vertraglichen) Preise ein. Erstellen Sie die Pakete in Ihrem Unisend-Konto („Mano siuntos“).

Paketterminal-Liste: Die Erweiterung nutzt die offene LP-Express-Terminalliste (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Ein Schlüssel wird nicht benötigt. Ist diese Online-Liste nicht verfügbar, verwendet die Erweiterung die zuletzt heruntergeladene Kopie, sofern vorhanden, andernfalls Ihre eigene Liste. Halten Sie bereit, Ihre eigene Liste einzugeben (siehe Konfiguration).

Litauen: Das Land muss unter System > Localisation > Countries aktiviert sein.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket vfd_lp_express-oc3-(version).ocmod.zip und das OpenCart-4-Paket vfd_lp_express.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_lp_express-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 dem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox LP Express 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 das Feld License key im Lizenzblock oben auf der Seite Edit ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

5. Füllen Sie die Preistabelle aus (mindestens eine Zeile; die erste neue Zeile ist Litauen) oder geben Sie Ersatzkosten an. Prüfen Sie die Statuszeile zu den Paketterminals oben auf der Seite und fügen Sie Ihre eigene Terminalliste hinzu, falls die Online-Liste nicht verfügbar ist. 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_lp_express.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 und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox LP Express, 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.

Bei der Installation legt die Erweiterung zwei kleine Tabellen an (die gewählten Terminals und die zwischengespeicherte Terminalliste) und registriert ihre OpenCart-Events für die Kasse und die Bestellseite. Die Methode bleibt aus, bis Sie Enable/Disable einschalten und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die aufbewahrten Einstellungen wieder verwendet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Shipping > VibeFox LP Express > Edit. Die Abschnitte sind links aufgelistet. Ein Button Save unten speichert die gesamte Seite ohne Neuladen. Jedes Speichern lädt außerdem die Terminalliste neu. Nur Admin-Benutzer mit der Änderungsberechtigung für diese Erweiterung können die Einstellungen speichern.

Oben auf der Seite zeigen Hinweise Probleme und den Terminalstatus an. Eine Warnung erscheint, wenn kein Preis festgelegt oder kein Paketterminal verfügbar ist, da die Methode dann nicht an der Kasse angezeigt wird. Sie erscheint auch, wenn der Shop keine Gewichtsklasse mit der Einheit kg hat: Dann werden Produktgewichte anhand ihres Einheitennamens (kg, g, lb, oz) gelesen, und jede andere Einheit wird als kg behandelt. Eine Infozeile zeigt, wie viele Paketterminals in wie vielen Städten und aus welcher Quelle verfügbar sind: der Online-Liste, einer gespeicherten Kopie der Online-Liste (mit Datum) oder Ihrer eigenen Liste.

Beim Speichern wird ein Methodentitel, der leer ist oder eines der Zeichen < > ; = # { } enthält, mit Enter a valid method title. abgelehnt. Ein Titel mit mehr als 64 Zeichen wird ebenfalls abgelehnt. Eine Sortierreihenfolge, die keine ganze Zahl ist, wird ebenso abgelehnt. In diesen Fällen wird nichts gespeichert. Ein Betrag oder Gewicht, das keine Zahl (oder negativ) ist, wird gemeldet, und der bisherige Wert bleibt erhalten. Ein Minimum weight (kg), das größer ist als Maximum weight (kg) (30 kg, wenn das Maximum leer ist), wird ebenfalls gemeldet, weil die Methode dann nie angezeigt würde; beide Gewichte behalten ihre bisherigen Werte. Preise in der Tabelle, die keine Zahlen sind, werden gemeldet und leer gelassen. Die übrigen Werte werden gespeichert.

Allgemein

Enable/Disable: blendet LP Express an der Kasse ein oder aus (der Status dieser Erweiterung). Standard: off.

Method title: der Name der Versandart, den Kunden im Warenkorb und an der Kasse sehen. Standard: LP Express parcel terminal. Pflichtfeld, höchstens 64 Zeichen.

Tax class: --- None --- (Standard) bedeutet, dass die unten stehenden Preise endgültig sind. Mit einer Steuerklasse fügt OpenCart die Versandsteuer zu den unten stehenden Preisen hinzu.

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

Preise (in der Standardwährung Ihres Shops, im Titel des Abschnitts angezeigt; Dezimalzahlen können als 2.99 oder 2,99 geschrieben werden)

Price table: eine Zeile pro Zielland. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf die Entfernen-Schaltfläche, um eine Zeile zu löschen. Wählen Sie * Any other country für alle Länder ohne eigene Zeile. Jede Zeile hat einen Base price und Gewichtsspalten: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg und XL über 5 kg. Das Gewicht ist das Warenkorbgewicht oder bei Per item das Gewicht eines Artikels. Eine leere Spalte verwendet den Grundpreis der Zeile. 0 bedeutet kostenlos. Eine Zeile ohne Preis wird nicht gespeichert.

Fallback cost: wird verwendet, wenn die Preistabelle für das Zielland keine Zeile (oder keinen Preis) hat. Lassen Sie das Feld leer, um die Methode für solche Länder auszublenden.

Calculation: wie der Preis berechnet wird.

Per order (tier by total cart weight): ein Preis für den Warenkorb, wobei die Gewichtsspalte nach dem Gesamtgewicht des Warenkorbs gewählt wird. Dies ist die Standardeinstellung.

Per item (each item priced by its own weight x quantity): jedes Produkt wird nach seinem eigenen Gewicht multipliziert mit seiner Menge berechnet, und die Preise werden addiert.

Free shipping from: der Warenkorbbetrag (Produkte, die einen Versand benötigen, nach Rabatten, ohne Steuer), ab dem LP Express kostenlos ist. Er gilt vor der Preistabelle und deckt daher auch Länder ohne eigene Zeile ab. Lassen Sie das Feld leer, wenn es keinen kostenlosen Versand gibt.

Verfügbarkeit

Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb leichter ist. Leer oder 0 bedeutet kein Limit.

Maximum weight (kg): blendet die Methode aus, wenn der Warenkorb schwerer ist. LP-Express-Terminals nehmen Pakete bis 30 kg an. Standard: 30. 0 bedeutet kein Limit. Leer bedeutet 30 kg oder kein Limit, wenn Ignore shipping zones aktiviert ist.

Minimum cart total: zeigt die Methode nur ab diesem Warenkorbbetrag an (Produkte, die einen Versand benötigen, nach Rabatten, ohne Steuer). Lassen Sie das Feld leer, um die Methode immer anzuzeigen.

Geo zone: die Methode wird nur für Adressen in dieser Geo-Zone angeboten. All Zones (Standard) bedeutet überall. Geo-Zonen werden unter System > Localisation > Geo Zones verwaltet. Die Geo-Zone wird nicht geprüft, wenn Ignore shipping zones aktiviert ist.

Ignore shipping zones: bietet LP Express für die unten aufgeführten Länder an, unabhängig von der Geo-Zone. In diesem Modus wird die Geo-Zone nicht geprüft. Ist es deaktiviert, werden die Länder über die Geo-Zone festgelegt. Dies wird empfohlen. Standard: off.

Countries (without zones): die Zielländer für diesen Modus. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist. Lassen Sie es leer, um die Methode für alle Länder anzubieten.

Paketterminals

Terminal list: woher die Terminals stammen.

LP Express online list: die Online-Liste wird einmal täglich heruntergeladen. Kann sie nicht geladen werden, wird die zuletzt heruntergeladene Kopie verwendet, danach Ihre eigene Liste unten. Dies ist die Standardeinstellung.

Only my own list: nur die Terminals, die Sie unten eingeben, werden angeboten.

Erweitert

Debug log: schreibt Details zur Preisberechnung und zur Terminalliste in storage/logs/vfd_lpex_debug.log.php (auf OpenCart 4 system/storage/logs/vfd_lpex_debug.log.php). Die Datei ist aus dem Web nicht lesbar. Fehler, etwa eine nicht verfügbare Terminalliste oder eine Bestellung ohne Terminal, werden immer protokolliert. Es werden keine Kundendaten protokolliert. Erreicht die Datei 5 MB, wird ein neues Protokoll begonnen.

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

Remove data on uninstall: ist es aktiviert, löscht die Deinstallation der Erweiterung die Einstellungen, die gespeicherte Terminalliste, das Protokoll und die Terminals unvollständiger Kassenvorgänge. Ist es deaktiviert (Standard), bleiben die Einstellungen für eine erneute Installation erhalten. Das in Bestellungen gespeicherte Terminal 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. Die Werte werden wie bei einem normalen Speichern geprüft.

So funktioniert es an der Kasse

Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem Preis von LP Express. Ist eine Geo zone gesetzt und die Adresse liegt außerhalb, wird LP Express nicht angeboten. Mit Ignore shipping zones wird die Geo-Zone nicht geprüft: LP Express wird nur für die aufgeführten Länder angeboten (alle Länder, wenn die Liste leer ist). Nur Produkte, bei denen Requires Shipping auf Yes steht, zählen: Andere Produkte fügen kein Gewicht hinzu und sind nicht im Warenkorbbetrag enthalten. Der Warenkorbbetrag ist der Preis dieser Produkte nach dem Gutscheinrabatt und vor der Steuer. Geschenkzertifikate, Bonuspunkte und Shop-Guthaben werden nicht berücksichtigt.

Die Erweiterung prüft das Warenkorbgewicht und den Mindestbetrag des Warenkorbs. Gilt kostenloser Versand, beträgt der Preis 0. Andernfalls stammt der Preis aus der Zeile des Landes (oder der Zeile *): der Gewichtsspalte, sonst dem Grundpreis, sonst den Ersatzkosten. Gibt es keinen Preis oder kein Paketterminal, wird die Methode ausgeblendet, sodass der Kunde nie eine Kasse sieht, die nicht abgeschlossen werden kann.

Preise und Beträge sind in der Standardwährung Ihres Shops angegeben. Der Preis wird auf seine Dezimalstellen gerundet und dem Kunden in seiner Währung mit der Steuer der gewählten Tax class angezeigt.

Die Online-Terminalliste wird 24 Stunden zwischengespeichert. Ein fehlgeschlagener Download wird 15 Minuten lang gemerkt, damit die Kasse bei jeder Aktualisierung nicht auf die Liste warten muss. Das Zeitlimit für den Download beträgt 10 Sekunden. Nur aktive Terminals aus der Liste werden angeboten. Terminals ohne Stadt erscheinen unter Other.

Auf OpenCart 4 klickt der Kunde im Versandart-Block der Kassenseite auf Choose und wählt LP Express im Fenster Shipping method options. Die Preise sind dieselben wie bei OpenCart 3.

Die Erweiterung fragt keine Preise bei LP Express oder Unisend ab, erstellt keine Sendungen, druckt keine Etiketten, ruft keinen Kurier und verfolgt keine Pakete. Erstellen Sie die Pakete in Ihrem Unisend-Konto („Mano siuntos“). Die Haus-zu-Haus-Lieferung per Kurier gehört nicht zu dieser Methode.

Abholstellen

Wenn der Kunde im Schritt der Versandart LP Express wählt, erscheint darunter der Block LP Express parcel terminal mit zwei Listen: -- Select city -- und -- Select parcel terminal --. Die Terminalliste wird nur geladen, wenn LP Express ausgewählt ist. Die Stadt der Lieferadresse ist vorausgewählt, wenn sie einer Stadt in der Liste entspricht. Jedes Terminal wird mit Name, Adresse und PLZ angezeigt. Die Auswahl wird sofort für die Kasse gespeichert, sodass sie beim Aktualisieren der Kasse nicht verloren geht.

Ein Terminal ist erforderlich. Klickt der Kunde auf Continue, prüft der Server das Terminal erneut anhand der Liste. Ohne Terminal zeigt die Kasse Please select an LP Express parcel terminal. Eine gefälschte oder veraltete Terminal-ID wird mit The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. abgelehnt. Können keine Terminals geladen werden, sieht der Kunde The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.

Auf OpenCart 4 erscheint der Block LP Express parcel terminal mit den beiden Listen im Fenster Shipping method options unter der Option LP Express, sobald der Kunde sie auswählt. Die Schaltfläche Continue des Fensters geht nur mit einem gültigen Terminal weiter, mit denselben Meldungen.

Terminal-ID, Name und Stadt werden mit der Bestellung gespeichert. Der Bereich LP Express parcel terminal auf der Bestellseite im Admin (Sales > Orders, Bestellinformationen) zeigt die Stadt, das Terminal und dessen Terminal ID. Die Versandart der Bestellung zeigt den Methodentitel, einen Doppelpunkt, die Stadt und das Terminal (zum Beispiel LP Express parcel terminal: Kaunas, …), sodass es in den Bestelldetails des Kunden, in den Bestell-E-Mails und auf der Rechnung erscheint. Hat eine Bestellung kein Terminal, zeigt die Bestellseite im Admin No parcel terminal was chosen for this order. an. Der Bereich wird auch für aufgegebene Bestellungen angezeigt, während die Erweiterung deaktiviert ist. Auf OpenCart 4 wird er über History angezeigt. OpenCart 4 behält für die Kasse eine einzige Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt; das Terminal der Bestellung wird dabei mit aktualisiert. Wechselt der Kunde diese Bestellung auf eine andere Versandart, wird ihr Terminal entfernt.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox LP Express ist der erste Block auf Extensions > Extensions > Shipping > VibeFox LP Express > 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-shipping-lp-express und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung Modify 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. Nach einer Änderung der Shop-Adresse 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 aktiven Schlüssel wird die Versandart LP Express Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Admin-Benutzer, der im selben Browser im Admin angemeldet ist, sieht die Methode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Methode 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 für 7 Tage auszublenden. Bestehende Bestellungen bleiben unberührt.

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

Fehlerbehebung

LP Express erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Prüfen Sie die Geo zone (oder ob Ignore shipping zones aktiviert ist und das Land erlaubt ist). Öffnen Sie die Seite der Erweiterung: Eine Warnung erklärt, ob kein Preis festgelegt oder kein Paketterminal verfügbar ist. Prüfen Sie außerdem die Gewichtsgrenzen und die Minimum cart total, und ob die Produkte Requires Shipping auf Yes gesetzt haben. Ist Debug log eingeschaltet, zeigt das Feld Log auf der Seite der Erweiterung, warum die Methode ausgeblendet wurde.

Keine Paketterminals: Die Online-Liste konnte nicht geladen werden, und es gibt weder eine gespeicherte Kopie noch eine eigene Liste. Die Erweiterung versucht es alle 15 Minuten erneut. Geben Sie Ihre eigene Liste unter Own terminal list ein oder wählen Sie Only my own list.

Die Terminalliste ist veraltet: Klicken Sie auf der Seite der Erweiterung auf Save. Dies lädt die Terminalliste neu. Bei Ihrer eigenen Liste aktualisieren Sie die Zeilen selbst.

Der Kunde kann nicht weitermachen: Ein Paketterminal muss gewählt werden. Sieht der Kunde die Meldung, dass die Terminalliste vorübergehend nicht verfügbar ist, sind im Moment keine Terminals verfügbar. Fügen Sie Ihre eigene Liste hinzu.

Die Terminalauswahl erscheint nicht: Die Auswahl wird im Schritt der Versandart der Standardkasse von OpenCart (auf OpenCart 4 im Fenster Shipping method options) eingefügt und wurde mit dem Standard-Theme getestet. Ein stark geändertes Theme oder eine Kassen-Erweiterung eines Drittanbieters zeigt sie möglicherweise nicht an.

In welcher Währung sind die Preise: In der Standardwährung Ihres Shops. Kunden, die in einer anderen Währung bezahlen, sehen den Preis mit dem Wechselkurs von OpenCart umgerechnet.

Die Seite zeigt "Warning: You do not have permission to modify VibeFox LP Express!": Ihre Admin-Benutzergruppe darf die Einstellungen nur ansehen. Geben Sie der Gruppe die Änderungsberechtigung für extension/shipping/vfd_lp_express (OpenCart 3) oder extension/vfd_lp_express/shipping/vfd_lp_express (OpenCart 4) unter System > Users > User Groups.

Für Entwickler: Die Adresse der Terminalliste kann mit der Einstellung vfd_lpex_feed_url (für Tests) 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 LP Express auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt Enable/Disable, Sort order, Tax class und Geo zone immer zurück. Die Ereignisse der Erweiterung werden immer entfernt, und die zwischengespeicherte Terminalliste wird gelöscht. Ist Remove data on uninstall aktiviert, werden außerdem die Einstellungen, das Protokoll, die gespeicherte Kopie der Terminalliste und die Terminals unvollständiger Kassenvorgänge entfernt. Ist es deaktiviert, bleiben die übrigen Einstellungen und die gespeicherte Kopie erhalten und werden wieder verwendet, wenn Sie die Erweiterung erneut installieren. Das in Bestellungen gespeicherte Terminal wird nie gelöscht, und bestehende Bestellungen behalten das Terminal in ihrer Versandart.

Auf OpenCart 4 entfernen Sie zusätzlich die Dateien der Erweiterung, indem Sie nach der Deinstallation zu Extensions > Installer gehen, neben VibeFox LP Express in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) klicken und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

LP Express ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit LP Express verbunden und wird von LP Express nicht unterstützt.