VibeFox LP Express 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.

LP Express: Ein API-Konto ist nicht nötig. LP Express hat keine öffentliche Preis-API. Die Unisend-API steht nur Vertragskunden zur Verfügung und wird von diesem Plugin nicht verwendet, daher geben Sie Ihre eigenen (Vertrags-)Preise ein. Erstellen Sie die Pakete in Ihrem Unisend-Konto („Mano siuntos“).

Paketterminal-Liste: Das Plugin verwendet die offene LP-Express-Terminalliste, dieselbe, die ältere LP-Express-Plugins genutzt haben. Zum Zeitpunkt der Version 1.1.0 war diese Online-Liste nicht verfügbar. Solange sie nicht verfügbar ist, verwendet das Plugin die zuletzt heruntergeladene Kopie, falls vorhanden, sonst Ihre eigene Liste. Halten Sie sich bereit, Ihre eigene Liste einzugeben (siehe Konfiguration).

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die Plugin-ZIP-Datei aus und klicken Sie auf Install Now. Sie können den Ordner vfd_lp_express auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox LP Express oder klicken Sie auf der Plugins-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. Füllen Sie die Preistabelle (mindestens eine Zeile) oder die Ausweichkosten aus. Prüfen Sie oben auf der Seite die Statuszeile zu den Paketterminals und fügen Sie Ihre eigene Terminalliste hinzu, falls die Online-Liste nicht verfügbar ist.

6. Fügen Sie VibeFox LP Express Ihrer Zone für Litauen unter WooCommerce > Settings > Shipping > Shipping zones 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 LP Express. 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. Lassen Sie das Feld leer, um den globalen Method title zu verwenden.

Oben auf der Seite zeigen Hinweise Probleme und den Terminalstatus an. Ein roter Hinweis erscheint, wenn kein Preis festgelegt ist oder kein Paketterminal verfügbar ist, weil die Methode dann an der Kasse nicht angezeigt wird. Eine Infozeile zeigt, wie viele Paketterminals in wie vielen Städten verfügbar sind und aus welcher Quelle: der Online-Liste, einer gespeicherten Kopie der Online-Liste (mit Datum) oder Ihrer eigenen Liste.

Allgemein

Enable/Disable: schaltet LP Express in allen Zonen gleichzeitig ein oder aus.

Method title: der Name der Versandmethode, den Kunden sehen. Der Titel einer Zonenmethode überschreibt ihn. Standard: LP Express parcel terminal.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht.

Preise (in Ihrer Shop-Währung; Dezimalzahlen dürfen 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 das Kreuz (×), um eine zu entfernen. Wählen Sie * Any other country für alle Länder ohne eigene Zeile. Jede Zeile hat einen Base price und Gewichtsspalten: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) und XL (>5 kg). Das Gewicht ist das Warenkorbgewicht oder das Gewicht eines Artikels bei Per item. Eine leere Spalte verwendet den Basispreis der Zeile. 0 bedeutet kostenlos. Ungültige Preise (keine Zahlen) werden nach dem Speichern gemeldet und leer gelassen.

Fallback cost: wird verwendet, wenn die Preistabelle für das Zielland keine Zeile 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. Das ist der Standard.

Per item (each item priced by its own weight x quantity): jeder Artikel wird nach seinem eigenen Gewicht mal Menge berechnet, und die Preise werden addiert.

Free shipping from: der Warenkorbwert (nach Rabatten, wie im Warenkorb angezeigt), ab dem LP Express kostenlos ist. Leer lassen für keinen kostenlosen Versand.

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.

Minimum cart total: zeigt die Methode nur ab diesem Warenkorbwert an. Leer lassen, um sie immer anzuzeigen.

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

Ignore shipping zones: bietet LP Express für die unten angegebenen Länder an, ohne es einer Zone hinzuzufügen. Ist es aus, werden die Länder durch die Versandzonen bestimmt, denen die Methode hinzugefügt wurde. Das wird empfohlen.

Countries (without zones): die Zielländer für diesen Modus. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist. Leer lassen, um die Methode für jedes Ziel anzubieten.

Paketterminals

Terminal list: woher die Terminals stammen.

LP Express online list: die Online-Liste wird einmal täglich geladen. Kann sie nicht geladen werden, wird die zuletzt heruntergeladene Kopie verwendet, dann Ihre eigene Liste unten. Das ist der Standard.

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

Beim Speichern der Einstellungen wird die Terminalliste neu geladen.

Erweitert

Debug log: protokolliert die Preisberechnung und Details der Terminalliste in WooCommerce > Status > Logs (Quelle vfd-lp-express). Fehler, etwa eine nicht verfügbare Terminalliste, werden immer protokolliert. Es werden keine Kundendaten protokolliert.

Remove data on uninstall: wenn aktiv, entfernt das Löschen des Plugins die Einstellungen, Zonenmethoden und zwischengespeicherten Terminals. Das Deaktivieren des Plugins löscht nie Einstellungen. Das in Bestellungen gespeicherte Terminal bleibt erhalten.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft das Warenkorbgewicht, den Mindestwarenkorbwert und die ausgeschlossenen Versandklassen. Ist kein Paketterminal verfügbar, wird die Methode ausgeblendet, sodass der Kunde nie eine Kasse sieht, die nicht abgeschlossen werden kann. Gilt kostenloser Versand, beträgt der Preis 0. Andernfalls stammt der Preis aus der Zeile des Landes (oder der Zeile *): die Gewichtsspalte, sonst der Basispreis, sonst die Ausweichkosten. Gibt es keinen Preis, wird die Methode ausgeblendet.

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 wartet. Das Download-Timeout beträgt 10 Sekunden. Es werden nur aktive Terminals aus der Liste angeboten.

Die Methode funktioniert an der klassischen Kasse sowie in den Blöcken „Warenkorb“ und „Kasse“. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel. Preise gelten in Ihrer Shop-Währung. Das Plugin rechnet keine Währungen um.

Das Plugin fragt keine Preise bei LP Express oder Unisend ab, erstellt keine Sendungen, druckt keine Etiketten, beauftragt keinen Kurier und verfolgt keine Pakete. Erstellen Sie die Pakete in Ihrem Unisend-Konto („Mano siuntos“). Kurierzustellung (Haustür) ist nicht Teil dieser Methode.

Abholpunkte

Wenn der Kunde LP Express wählt, erscheinen unter der Methode zwei Listen: -- Select city -- und -- Select parcel terminal --. Die Stadt der Lieferadresse wird vorausgewählt, wenn sie einer Stadt in der Liste entspricht. Jedes Terminal wird mit Name, Adresse und PLZ angezeigt. Die Auswahl wird während des Kaufvorgangs gespeichert, sodass sie bei einer Aktualisierung der Kasse nicht verloren geht.

Ein Terminal ist erforderlich. An der klassischen Kasse sieht der Kunde Please select an LP Express parcel terminal. Im Kassen-Block ist Place order gesperrt, bis ein Terminal gewählt wird. In beiden Kassen prüft der Server das Terminal erneut anhand der Liste, sodass eine gefälschte oder veraltete Terminal-ID abgelehnt wird.

Terminal-ID, Name und Stadt werden in der Bestellung gespeichert. Sie werden auf dem Bestellbildschirm unter der Lieferadresse (mit der Terminal-ID), auf der Bestellbestätigungsseite, unter My account > Orders und in den Bestell-E-Mails (HTML und Nur-Text) als LP Express parcel terminal angezeigt.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox LP Express. 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 gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird LP Express Kunden an 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. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

LP Express wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Öffnen Sie die Einstellungsseite: Ein roter Hinweis erklärt, ob kein Preis festgelegt ist oder kein Paketterminal verfügbar ist. Prüfen Sie außerdem die Gewichtsgrenzen, den Minimum cart total und die Excluded shipping classes. Ist Debug log aktiv, zeigt WooCommerce > Status > Logs (Quelle vfd-lp-express), 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. Das Plugin 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: Speichern Sie die Einstellungsseite. Dadurch wird die Terminalliste neu geladen. Bei Ihrer eigenen Liste aktualisieren Sie die Zeilen selbst.

Der Kunde kann die Bestellung nicht abschließen: Es muss ein Paketterminal gewählt werden. Sieht der Kunde „The LP Express parcel terminal list is temporarily unavailable“, sind gerade keine Terminals verfügbar. Fügen Sie Ihre eigene Liste hinzu.

Währung der Preise: Ihre Shop-Währung. Das Plugin rechnet keine Währungen um.

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 einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Wurde 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 Einstellungen. Nur die zwischengespeicherte Terminalliste wird gelöscht. Zum Entfernen deaktivieren Sie das Plugin und löschen es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die Caches werden immer entfernt. Einstellungen, Zonenmethoden und die gespeicherte Kopie der Terminalliste werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Das in Bestellungen gespeicherte Terminal wird nie gelöscht, und bestehende Bestellungen behalten ihre Versandpositionen.

LP Express ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit LP Express verbunden noch von LP Express unterstützt.