VibeFox LP Express for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

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

Paketterminal-Liste: Das Modul verwendet die offene Terminalliste von LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Ein Schlüssel ist nicht nötig. Ist diese Online-Liste nicht verfügbar, verwendet das Modul die zuletzt heruntergeladene Kopie, sofern vorhanden, andernfalls 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 im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Klicken Sie nach Abschluss des Uploads auf Configure, oder suchen Sie VibeFox LP Express später in der Modulliste und klicken Sie auf Configure.

3. Fügen Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Füllen Sie die Preistabelle (mindestens eine Zeile) oder die Ausweichkosten aus. Prüfen Sie die Statuszeile zu den Paketterminals oben auf der Seite und fügen Sie bei Bedarf Ihre eigene Terminalliste hinzu, falls die Online-Liste nicht verfügbar ist. Klicken Sie auf Save.

Bei der Installation legt das Modul den Transporteur LP Express parcel terminal mit dem Lieferzeittext Delivery to an LP Express parcel terminal an. Der Transporteur wird der Zone Litauen und allen Kundengruppen zugeordnet. Zonen hinzufügen sowie Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen ändern Sie unter Shipping > Carriers. Setzen Sie dort keine Preise: Der Preis stammt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox LP Express > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern lädt außerdem die Terminalliste neu.

Oben auf der Seite zeigen Hinweise Probleme und den Terminalstatus an. Eine Warnung erscheint, wenn kein Preis festgelegt oder kein Paketterminal verfügbar ist, weil der Transporteur dann an der Kasse nicht angezeigt wird, wenn der Transporteur gelöscht wurde und wenn die Gewichtseinheit des Shops nicht eine ist, die das Modul kennt (kg, g, lb, oz), weil die Produktgewichte dann als kg gelesen werden. Eine Infozeile zeigt, wie viele Paketterminals in wie vielen Städten verfügbar sind und aus welcher Quelle sie stammen: der Online-Liste, einer gespeicherten Kopie der Online-Liste (mit Datum) oder Ihrer eigenen Liste.

Beim Speichern wird ein Methodentitel, der leer oder als Transporteurname nicht gültig ist, mit Enter a valid method title. abgelehnt; ein Titel mit mehr als 64 Zeichen wird ebenfalls abgelehnt. In beiden Fällen wird nichts gespeichert. Ein Betrag oder Gewicht, das keine Zahl ist (oder negativ ist), wird gemeldet, und der vorherige 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 der Transporteur dann nie angezeigt würde; beide Gewichte behalten ihre vorherigen Werte. Preise in der Tabelle, die keine Zahlen sind, werden gemeldet und leer gelassen.

Allgemein

Enable/Disable: schaltet LP Express ein oder aus. Dies ist derselbe Schalter wie der Status des Transporteurs unter Shipping > Carriers.

Method title: der Transporteurname, den Kunden im Warenkorb und an der Kasse sehen. Standard: LP Express parcel terminal. Pflichtfeld.

Tax status: None bedeutet, dass die folgenden Preise endgültig sind. Taxable mit einer Steuerregel (eine Option pro Steuerregel Ihres Shops) bedeutet, dass PrestaShop diese Versandsteuer auf die folgenden Preise aufschlägt. Dies ist die Steuerregel des Transporteurs.

Preise (in der Standardwährung Ihres Shops; 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 Papierkorb-Symbol, 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.

Fallback cost: wird verwendet, wenn die Preistabelle für das Zielland keine Zeile hat. Lassen Sie das Feld leer, um den Transporteur 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 berechnet und mit seiner Menge multipliziert; die Preise werden addiert.

Free shipping from: der Warenkorbwert (Produkte, die versendet werden müssen, nach Rabatten, ohne Steuern), ab dem LP Express kostenlos ist. Leer lassen, wenn es keinen kostenlosen Versand geben soll.

Verfügbarkeit

Minimum weight (kg): blendet den Transporteur aus, wenn der Warenkorb leichter ist. Leer oder 0 bedeutet keine Begrenzung.

Maximum weight (kg): blendet den Transporteur aus, wenn der Warenkorb schwerer ist. LP-Express-Terminals nehmen Pakete bis 30 kg an. Standard: 30. 0 bedeutet keine Begrenzung. Leer bedeutet 30 kg in den Zonen des Transporteurs, und keine Begrenzung nur für die Länder von Ignore shipping zones außerhalb dieser Zonen.

Minimum cart total: zeigt den Transporteur nur ab diesem Warenkorbwert an (Produkte, die versendet werden müssen, nach Rabatten, ohne Steuern). Leer lassen, um ihn immer anzuzeigen.

Ignore shipping zones: bietet LP Express für die unten genannten Länder an, ohne dass Sie selbst Zonen festlegen. Der Transporteur wird dann allen aktiven Zonen zugeordnet (auch später erstellten Zonen). Die Zonen, die der Transporteur vorher hatte, bleiben für alle ihre Länder erlaubt. Wenn Sie die Option wieder ausschalten, erhält der Transporteur die zuvor zugeordneten Zonen zurück. Ist sie ausgeschaltet, werden die Länder durch die Zonen des Transporteurs unter Shipping > Carriers bestimmt. Dies wird empfohlen.

Countries (without zones): die Zielländer für diesen Modus. Dieses Feld wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist. Leer lassen, um den Transporteur 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: es werden nur die Terminals angeboten, die Sie unten eingeben.

Erweitert

Debug log: schreibt Details zur Preisberechnung und zur Terminalliste in logs/vfd_lpex_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Fehler, etwa eine nicht verfügbare Terminalliste, werden immer protokolliert. Es werden keine Kundendaten protokolliert.

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

Remove data on uninstall: ist die Option eingeschaltet, löscht die Deinstallation des Moduls die Einstellungen, den Transporteur und die gespeicherte Terminalliste. Ist sie ausgeschaltet, wird bei der Deinstallation nur der Transporteur ausgeschaltet. Das in Bestellungen gespeicherte Terminal bleibt immer erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem LP-Express-Preis. Nur physische Produkte zählen: Virtuelle Produkte haben kein Gewicht und sind nicht im Warenkorbwert enthalten. Das Modul prüft die Länder von Ignore shipping zones, das Warenkorbgewicht und den Mindestwarenkorbwert. Gilt kostenloser Versand, beträgt der Preis 0. Andernfalls stammt der Preis aus der Zeile des Landes (oder der Zeile *): der Gewichtsspalte, sonst dem Basispreis, sonst den Ausweichkosten. Gibt es keinen Preis oder ist kein Paketterminal verfügbar, wird der Transporteur 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 dann in der Warenkorbwährung des Kunden angezeigt, umgerechnet mit dem Wechselkurs von PrestaShop.

Die Online-Terminalliste wird 24 Stunden lang zwischengespeichert. Ein fehlgeschlagener Download wird 15 Minuten lang gemerkt, damit die Kasse bei jedem Neuladen nicht auf die Liste warten muss. Das Zeitlimit für den Download beträgt 10 Sekunden. Es werden nur aktive Terminals aus der Liste angeboten.

Wenn Sie den Transporteur unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Transporteurs. Das Modul übernimmt die neue Version automatisch.

Das Modul 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“). Eine Kurierzustellung (Haustür) ist nicht Teil dieses Transporteurs.

Abholstellen

Wenn der Kunde LP Express auswählt, erscheint unter dem Transporteur der Block LP Express parcel terminal mit zwei Listen: -- Select city -- und -- Select parcel terminal --. Die Stadt der Lieferadresse wird vorausgewählt, wenn sie mit einer Stadt der Liste übereinstimmt. Jedes Terminal wird mit Name, Adresse und PLZ angezeigt. Die Auswahl wird sofort im Warenkorb gespeichert, sodass sie nicht verloren geht, wenn die Kasse neu lädt. Sie funktioniert mit den Themes Classic und Hummingbird.

Ein Terminal ist erforderlich. Ohne Auswahl zeigen Continue im Versandschritt und Place order die Meldung Please select an LP Express parcel terminal. an. Wenn der Kunde auf Continue klickt, prüft der Server das Terminal erneut gegen die Liste, daher wird eine gefälschte oder veraltete Terminal-ID mit The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. abgelehnt.

Terminal-ID, Name und Stadt werden mit der Bestellung gespeichert. Sie werden im Block LP Express parcel terminal auf der Bestellseite im Back Office (mit Terminal ID), auf der Bestellbestätigungsseite und in den Bestelldetails des Kunden angezeigt. In der Bestellbestätigungs-E-Mail und in der E-Mail über neue Bestellungen an den Händler werden sie dem Transporteurnamen als LP Express parcel terminal: gefolgt vom Terminal hinzugefügt. Hat eine Bestellung kein Terminal, zeigt die Bestellseite im Back Office No parcel terminal was chosen for this order. an.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox LP Express ist der erste Block auf Modules > Module Manager > VibeFox LP Express > Configure, über den Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, 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: presta-shipping-lp-express und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Ist der Schlüssel nicht gültig, 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 das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Installation. 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 der Transporteur LP Express den Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Das PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Transporteur auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

LP Express erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Transporteur die Zone des Landes des Kunden und die Kundengruppe abdeckt (oder ob Ignore shipping zones eingeschaltet ist und das Land erlaubt ist). Öffnen Sie die Modulseite: Eine Warnung erklärt, ob kein Preis festgelegt oder kein Paketterminal verfügbar ist. Prüfen Sie außerdem die Gewichtsgrenzen und den Minimum cart total. Produkte können auf der Produktseite auch auf bestimmte Transporteure beschränkt sein. Ist das Debug log eingeschaltet, zeigt das Feld Log auf der Modulseite, warum der Transporteur ausgeblendet wurde.

Keine Paketterminals: Die Online-Liste konnte nicht geladen werden, und es gibt weder eine gespeicherte Kopie noch eine eigene Liste. Das Modul 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 Modulseite auf Save. Dadurch wird die Terminalliste neu geladen. Bei Ihrer eigenen Liste aktualisieren Sie die Zeilen selbst.

Der Kunde kann nicht fortfahren: Ein Paketterminal muss ausgewählt werden. Sieht der Kunde The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method., sind derzeit keine Terminals verfügbar. Fügen Sie Ihre eigene Liste hinzu.

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

Die Seite meldet, dass der Transporteur LP Express nicht gefunden wurde: Der Transporteur wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn neu anzulegen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox LP Express und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die zwischengespeicherte Terminalliste wird immer gelöscht. Ist Remove data on uninstall eingeschaltet, wird der Transporteur gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Protokoll und die gespeicherte Kopie der Terminalliste werden entfernt. Ist die Option ausgeschaltet, wird der Transporteur nur ausgeschaltet, und alle Einstellungen und die gespeicherte Kopie bleiben erhalten. Wenn Sie das Modul erneut installieren, erhält der gespeicherte Transporteur den Status zurück, den er hatte. Das in Bestellungen gespeicherte Terminal wird nie gelöscht.

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