VibeFox SmartPost 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, mit der Erweiterung SimpleXML (in den meisten PHP-Installationen enthalten).
SmartPost: Es ist kein API-Konto und kein Schlüssel nötig. Die Liste der Abholstellen stammt aus der offenen Ortsliste von SmartPost. SmartPost hat keine öffentliche Preis-API, daher geben Sie Ihre eigenen (vertraglichen) Preise ein. Erstellen Sie die Sendungen in Ihrem SmartPost-(SmartPosti-)Geschäftskonto.
Länder: SmartPost-Abholstellen gibt es in Estland, Lettland, Litauen und Finnland. Für andere Zielländer wird die Versandart nicht angezeigt.
VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. 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 und klicken Sie auf Install Now. Sie können auch den Ordner vfd_smartpost per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox SmartPost, 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. Prüfen Sie die Preistabelle (die Standardpreise sind bereits eingetragen), die Paketgrößen und den Status der Abholstellen oben auf der Seite.
6. Fügen Sie VibeFox SmartPost der Zone oder den Zonen mit Estland, Lettland, Litauen und/oder Finnland unter WooCommerce > Settings > Shipping > Shipping zones hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie die Länder aus.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox SmartPost. Sie gelten für alle Versandzonen. Wenn Sie die Versandart 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 die allgemeine Method title zu verwenden.
Oben auf der Seite zeigen Hinweise Probleme und den Status der Abholstellen. Ein roter Hinweis erscheint, wenn kein Preis festgelegt ist, da die Versandart dann an der Kasse nicht angezeigt wird. Der Block Pickup points available at checkout zeigt für jedes Land, wie viele Abholstellen in wie vielen Städten verfügbar sind. Er zeigt außerdem an, wenn eine gespeicherte Kopie der Liste verwendet wird, weil die SmartPost-Liste gerade nicht verfügbar ist, wenn ein Land gar nicht geladen werden konnte und wenn für ein Land keine Preise hinterlegt sind. Die Schaltfläche Refresh pickup point lists now lädt die Listen erneut herunter und zeigt die neuen Zahlen an.
Allgemein
Enable/Disable: schaltet SmartPost in allen Zonen gleichzeitig ein oder aus.
Method title: der Name der Versandart, den Kunden sehen. Der Title einer Zonenmethode überschreibt ihn. Standard: SmartPost parcel locker.
Tax status: Taxable fügt den WooCommerce-Steuern zu den Versandkosten hinzu, None nicht.
Preise (in Ihrer Shopwährung; Dezimalwerte können als 3.50 oder 3,50 geschrieben werden)
Price table: eine Zeile für jedes Land (Estland, Lettland, Litauen, Finnland) mit einem Preis für jede Paketgröße S, M, L und XL sowie einer Spalte Free from. 0 bedeutet kostenlos. Ein leeres Feld bedeutet, dass diese Paketgröße nicht angeboten wird: Die Versandart wird ausgeblendet, wenn das Paket diese Größe braucht. Ein Land, dessen Felder alle leer sind, wird nicht bedient. Free from ist der Warenkorbwert, ab dem SmartPost in diesem Land kostenlos ist; lassen Sie das Feld leer, wenn es keinen kostenlosen Versand gibt. Preise, die keine Zahlen sind, werden nach dem Speichern gemeldet und leer gelassen. Standardpreise: Estland 3.50, Lettland 4.00, Litauen 4.00, Finnland 5.00 für jede Paketgröße.
Box sizes (cm): die Innenmaße jeder Box, kleinste Seite zuerst (Side 1 (smallest), Side 2, Side 3 (largest)). Die Seiten des Produkts werden genauso sortiert und nebeneinander verglichen, und es wird die kleinste passende Box verwendet. Produkte ohne Maße passen in die Box S. Ein Paket, das in keine Box passt, blendet die Versandart aus. Produktmaße werden aus der Maßeinheit des Shops umgerechnet. Standardwerte: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Größen, die keine positiven Zahlen sind, werden nach dem Speichern gemeldet und nicht geändert.
Calculation: wie der Preis berechnet wird.
Verfügbarkeit
Minimum weight (kg): blendet die Versandart aus, wenn der Warenkorb leichter ist. Leer oder 0 bedeutet kein Limit.
Maximum weight (kg): blendet die Versandart aus, wenn der Warenkorb schwerer ist. Standard: 25. 0 bedeutet kein Limit.
Minimum cart total: zeigt die Versandart nur ab diesem Warenkorbwert an. Leer lassen, um sie immer anzuzeigen.
Excluded shipping classes: blendet die Versandart aus, wenn der Warenkorb Produkte dieser WooCommerce-Versandklassen enthält.
Ignore shipping zones: bietet SmartPost für die unten genannten Länder an, ohne es einer Zone hinzuzufügen. Ist es deaktiviert, werden die Länder durch die Versandzonen bestimmt, denen die Versandart hinzugefügt wurde. Das wird empfohlen.
Countries (without zones): die Zielländer für diesen Modus, aus Estland, Lettland, Litauen und Finnland. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist. Leer lassen, um die Versandart in allen vier Ländern anzubieten.
Abholstellen
Pickup point types: welche SmartPost-Abholstellen der Kunde wählen kann: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) und Posti post offices (Finland). Leer lassen, um Paketautomaten, Paketboxen und Paketshops anzubieten (Standard). Welche Typen es gibt, hängt vom Land ab: In Lettland gibt es zum Beispiel nur Paketboxen, und Postfilialen gibt es nur in Finnland.
City order: ist sie aktiviert, stehen große Städte zuerst (Tallinn, Riga, Vilnius, Helsinki und andere große Städte), danach der Rest alphabetisch. Ist sie deaktiviert, sind alle Städte alphabetisch sortiert.
Erweitert
Debug log: protokolliert Details zur Preisberechnung und zur Liste der Abholstellen unter WooCommerce > Status > Logs (Quelle vfd-smartpost). Fehler, etwa eine nicht verfügbare Liste der Abholstellen, werden immer protokolliert. Kundendaten werden nicht protokolliert.
Remove data on uninstall: ist es aktiviert, entfernt das Löschen des Plugins die Einstellungen, Zonenmethoden und zwischengespeicherten Abholstellen. Das Deaktivieren des Plugins löscht nie Einstellungen. Die in Bestellungen gespeicherte Abholstelle bleibt erhalten.
So funktioniert es an der Kasse
Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin arbeitet nur für Estland, Lettland, Litauen und Finnland. Es prüft das Warenkorbgewicht, den Mindestwarenkorbwert und die ausgeschlossenen Versandklassen, findet die Box für das Paket und übernimmt deren Preis aus der Zeile des Versandlandes. Hat die Box keinen Preis oder passt das Paket in keine Box, wird die Versandart ausgeblendet. Hat das Land keine Abholstellen (die Liste konnte nicht geladen werden und es gibt keine gespeicherte Kopie), wird die Versandart ebenfalls ausgeblendet, damit der Kunde nie eine Kasse sieht, die sich nicht abschließen lässt. Erreicht der Warenkorbwert den Free from-Betrag des Landes, beträgt der Preis 0.
Die Liste der Abholstellen jedes Landes wird 24 Stunden zwischengespeichert, und eine Kopie der letzten funktionierenden Liste bleibt erhalten. 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 15 Sekunden. Verschiedene Schreibweisen derselben Stadt (zum Beispiel Riga und Rīga) werden als eine Stadt angezeigt.
Die Versandart funktioniert an der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit dem High-Performance-Bestellspeicher (HPOS) von WooCommerce kompatibel. Preise gelten in Ihrer Shopwährung. Das Plugin rechnet keine Währungen um.
Das Plugin fragt keine SmartPost-Preise ab, erstellt keine Sendungen, druckt keine Etiketten, ruft keinen Kurier und verfolgt keine Pakete. Erstellen Sie die Sendungen in Ihrem SmartPost-(SmartPosti-)Geschäftskonto. Die Zustellung an die Haustür durch einen Kurier ist nicht Teil dieser Versandart, und es gibt keine Kartenansicht.
Abholstellen
Wenn der Kunde SmartPost auswählt, erscheinen unter der Versandart zwei Listen: -- Select city -- und -- Select pickup point --. Die Listen gehören immer zum Versandland. An der klassischen Kasse ist das das Land der Lieferadresse, oder das der Rechnungsadresse, wenn die Bestellung nicht an eine abweichende Adresse geliefert wird; die Listen werden neu aufgebaut, wenn sich das Land ändert. An der Blockkasse folgen die Listen dem Land der Lieferadresse. Die Stadt der Lieferadresse wird vorausgewählt, wenn sie einer Stadt in der Liste entspricht. Jede Abholstelle wird mit Name und Adresse angezeigt. Die Auswahl wird während des Checkouts gespeichert, damit sie nicht verloren geht, wenn die Kasse aktualisiert wird.
Eine Abholstelle ist Pflicht. An der klassischen Kasse sieht der Kunde Please select a SmartPost pickup point in the shipping country. An der Blockkasse ist Place order gesperrt, bis eine Abholstelle gewählt wurde. In beiden Kassen prüft der Server die Abholstelle erneut anhand der Liste des Versandlandes, daher werden eine gefälschte oder veraltete Abholstellen-ID oder eine Abholstelle eines anderen Landes abgelehnt. Ist die Liste des Landes vorübergehend nicht verfügbar, sieht der Kunde eine Meldung und kann eine andere Versandart wählen.
Die ID, der Name, die Stadt und das Land der Abholstelle werden in der Bestellung gespeichert. Sie werden auf dem Bestellbildschirm unter der Lieferadresse (mit der Orts-ID), auf der Bestellbestätigungsseite, unter My account > Orders und in den Bestell-E-Mails (HTML und Text) als SmartPost pickup point angezeigt.
Um die Abholstelle einer Bestellung zu ändern, öffnen Sie die Bestellung und klicken neben SmartPost pickup point auf Change. Wählen Sie eine Stadt und eine Abholstelle im Versandland der Bestellung. Die neue Abholstelle wird sofort gespeichert, und eine Bestellnotiz hält die alte und die neue Abholstelle fest.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox SmartPost. 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 SmartPost Kunden an der Kasse nicht angezeigt. Angemeldete Shopmanager 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. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. 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
SmartPost erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, das Land der Lieferadresse Estland, Lettland, Litauen oder Finnland ist und die Versandart der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiviert ist und das Land erlaubt ist). Öffnen Sie die Einstellungsseite: Ein Hinweis erklärt, ob kein Preis festgelegt ist, ob ein Land keine Preise oder ob ein Land keine Abholstellen hat. Prüfen Sie außerdem die Gewichtsgrenzen, Minimum cart total, Excluded shipping classes und die Paketgrößen: Ein Paket, das in keine Box passt, oder eine Box mit einem leeren Preisfeld blendet die Versandart aus. Ist Debug log aktiviert, zeigt WooCommerce > Status > Logs (Quelle vfd-smartpost), warum die Versandart ausgeblendet wurde.
Der Kunde sieht Abholstellen eines anderen Landes: Die Listen folgen der Lieferadresse. Prüfen Sie, welches Land in der Lieferadresse steht (oder in der Rechnungsadresse, wenn die Bestellung nicht an eine abweichende Adresse geliefert wird). Eine Abholstelle eines anderen Landes wird beim Abschluss der Bestellung abgelehnt.
Keine Abholstellen für ein Land: Die SmartPost-Liste konnte nicht geladen werden und es gibt keine gespeicherte Kopie. Das Plugin versucht es alle 15 Minuten erneut. Klicken Sie später auf Refresh pickup point lists now. Prüfen Sie außerdem, ob Pickup point types einen Typ enthält, der in diesem Land vorkommt.
Die Liste der Abholstellen ist veraltet: Klicken Sie auf der Einstellungsseite auf Refresh pickup point lists now. Die Listen werden außerdem alle 24 Stunden neu heruntergeladen.
Der Kunde kann die Bestellung nicht abschließen: Eine Abholstelle des Versandlandes muss gewählt werden. Sieht der Kunde die Meldung „The SmartPost pickup point list is temporarily unavailable“, sind im Moment keine Abholstellen dieses Landes verfügbar.
In welcher Währung sind die Preise: In Ihrer Shopwährung. Das Plugin rechnet keine Währungen um.
Für Entwickler: Der Filter vfd_smpt_places_url ändert die URL der Ortsliste für ein Land (Argumente: URL, Ländercode), zum Beispiel für einen Spiegel, der dieselbe XML liefert.
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 letzten bekannten Status weiter.
Deinstallation
Das Deaktivieren des Plugins behält alle Einstellungen. Nur die zwischengespeicherten Listen der Abholstellen werden geleert. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die Caches werden immer entfernt. Einstellungen, Zonenmethoden und gespeicherte Kopien der Listen der Abholstellen werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Die in Bestellungen gespeicherte Abholstelle wird nie gelöscht, und bestehende Bestellungen behalten ihre Versandpositionen.
SmartPost und SmartPosti sind Marken ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit SmartPost verbunden und wird von SmartPost nicht unterstützt.