VibeFox Econt 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.
Econt: Ein Econt-Vertrag oder API-Schlüssel ist nicht nötig. Die Filialliste ist ein öffentliches Econt-Verzeichnis. Nur der Ländercode wird an Econt gesendet, keine Kundendaten. Tragen Sie einen e-Econt-Benutzernamen und ein Passwort nur ein, wenn Econt von Ihrer Website eine Autorisierung verlangt. Der e-Econt-Login wird auf der Entwicklerseite von Econt beschrieben (econt.com/developers).
VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel gilt 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_econt per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Econt, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.
4. Tragen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Legen Sie die Preise je Land fest und prüfen Sie die übrigen Optionen (siehe Abschnitt Konfiguration). Klicken Sie auf Load offices from Econt now, um die Verbindung zu testen.
6. Fügen Sie VibeFox Econt in WooCommerce > Settings > Shipping > Shipping zones einer Versandzone mit Bulgarien und/oder Rumänien hinzu, oder aktivieren Sie Ignore zones und wählen Sie die Länder aus.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Econt. Preis und Bedingungen gelten für jede Versandzone. 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. Leer lassen, um den globalen Name zu verwenden.
Oben auf der Seite zeigt das Plugin Warnungen an: die Demo-API ist aktiviert, für Bulgarien oder Rumänien ist kein Preis festgelegt (die Methode wird dann nie angezeigt), oder die letzte Filialabfrage für ein Land ist fehlgeschlagen. Zahlenfelder akzeptieren ein Dezimalkomma, zum Beispiel 5,99. Ein Wert, der keine Zahl ist, wird ignoriert und beim Speichern gemeldet.
Allgemein
Enable/Disable: schaltet die Econt-Zustellung in allen Zonen gleichzeitig ein oder aus. Standard: aktiviert.
Name: der Name der Versandmethode an der Kasse. Ein in der Zone festgelegter Title überschreibt ihn. Standard: Econt Express.
Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht. Standard: Taxable.
Econt-Filialliste
Filialen und Econtomaten werden über die Econt-API geladen und 24 Stunden zwischengespeichert.
Demo API: verwendet die Econt-Demo-API mit Testdaten. Lassen Sie sie in einem Live-Shop ausgeschaltet. Demo-Filialen haben andere IDs als die echten. Im Demo-Modus wird das öffentliche Econt-Testkonto verwendet, wenn kein Login eingestellt ist.
Econt username: optional. Ihr e-Econt-Login für die HTTP-Basisautorisierung.
Econt password: optional. Wird in der WordPress-Datenbank gespeichert und nie in das Protokoll geschrieben.
Office list: zeigt, wie viele Filialen je Land zwischengespeichert sind und wann sie geladen wurden. Die Schaltfläche Load offices from Econt now lädt die Listen sofort neu und zeigt das Ergebnis an. Schlägt ein Ladevorgang fehl, bleiben die Filialen des letzten erfolgreichen Ladevorgangs erhalten. Ohne diese Schaltfläche wird die Liste beim ersten Aufruf der Kasse automatisch geladen. Wenn Sie Demo API, den Benutzernamen oder das Passwort ändern, werden die zwischengespeicherten Listen gelöscht.
Filialauswahl an der Kasse
Show: welche Punkte Kunden auswählen können.
City order: zeigt die größten Städte zuerst (Sofia, Plowdiw, Warna, Bukarest und andere). Wenn ausgeschaltet, werden die Städte alphabetisch sortiert. Standard: aktiviert.
City list width: die CSS-Breite der Städteliste an der klassischen Kasse, zum Beispiel 100% oder 300px. Standard: 100%.
Office list width: die CSS-Breite der Filialliste an der klassischen Kasse, zum Beispiel 100% oder 400px. Standard: 100%.
Preise (in Ihrer Shop-Währung)
Das Plugin fragt bei Econt keine aktuellen Tarife ab. Bulgarien verwendet seit dem 1. Januar 2026 den Euro, daher geben bulgarische Shops normalerweise Preise in EUR ein.
Price per country: ein Land pro Zeile (oder durch Kommas getrennt): Ländercode, Doppelpunkt, Preis, zum Beispiel BG:5.99 und RO:8.99 (das sind die Standardwerte). Ein Dezimalkomma ist auch möglich: BG:5,99. Ein Preis von 0 bedeutet kostenlose Zustellung. Einträge in einem anderen Format werden ignoriert und beim Speichern in einer Fehlermeldung aufgelistet.
Calculation: Per order berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl versandfähiger Artikel im Warenkorb.
Price for other countries: wird für ein Econt-Land (Bulgarien oder Rumänien) verwendet, das oben nicht aufgeführt ist. Leer oder 0 blendet die Methode dort aus.
Bedingungen
Free shipping from: der Warenkorb-Zwischensummenbetrag, ab dem die Zustellung kostenlos ist. Leer lassen, um nie kostenlose Zustellung anzubieten.
Minimum subtotal: zeigt die Methode nur an, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Minimum weight (kg): blendet die Methode für leichtere Warenkörbe aus. Produktgewichte werden von der Gewichtseinheit Ihres Shops in kg umgerechnet. Leer lassen für kein Limit.
Maximum weight (kg): blendet die Methode für schwerere Warenkörbe aus. Leer lassen für kein Limit.
Hide for shipping classes: blendet die Methode aus, wenn der Warenkorb ein Produkt einer dieser WooCommerce-Versandklassen enthält.
Verfügbarkeit ohne Versandzonen
Ignore zones: bietet Econt auch in den unten genannten Ländern an, wenn keine Zone es hinzufügt. Zonen, die die Methode enthalten, funktionieren wie gewohnt weiter.
Countries: Bulgarien und/oder Rumänien. Wird nur mit Ignore zones verwendet. Leer lassen für alle Econt-Länder, in die Ihr Shop liefert.
Erweitert
Debug log: schreibt Debug-Meldungen nach WooCommerce > Status > Logs, Quelle vfd-econt. API-Fehler werden immer protokolliert. Es werden keine Passwörter oder Kundendaten geschrieben.
Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins die Econt-Einstellungen und die Zonenmethoden. Das Deaktivieren des Plugins löscht nie Einstellungen. In Bestellungen gespeicherte Filialen bleiben immer erhalten.
So funktioniert es an der Kasse
Die Methode wird nur für Bulgarien und Rumänien angeboten. Sobald der Kunde eine Lieferadresse eingibt, prüft das Plugin das Warenkorbgewicht, die Mindestzwischensumme und die ausgeblendeten Versandklassen und übernimmt dann den Preis für das Land. Erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Preis 0. Ist für das Land keine Filialliste verfügbar, wird die Methode ausgeblendet, weil die Zustellung immer an eine Filiale erfolgt.
Wenn der Kunde Econt auswählt, erscheinen unter der Methode zwei Listen: City und Office / Econtomat. Die Filialliste wird einmal pro Seite geladen. Econtomaten sind in der Liste markiert. Die Auswahl wird während der Sitzung gespeichert. Kann die Filialliste nicht geladen werden, sieht der Kunde eine Meldung, es in ein paar Minuten erneut zu versuchen oder eine andere Versandmethode zu wählen.
Der Kunde kann die Bestellung nicht ohne Filialauswahl abschließen. Auf dem Server prüft das Plugin erneut, ob die Filiale in der Econt-Liste für das Versandland existiert. Der Filialname wird immer aus der Econt-Liste übernommen, nicht aus dem Browser. Dies funktioniert in der klassischen Kasse und im Kassen-Block. Das Plugin ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Die Filialliste wird 24 Stunden zwischengespeichert. Wenn Econt nicht erreichbar ist, wird die letzte funktionierende Liste verwendet, und Econt wird 10 Minuten lang nicht erneut angefragt. Das API-Timeout beträgt 15 Sekunden.
Das Plugin verwendet nur feste Preise. Es fragt bei Econt keine aktuellen Preise ab, erstellt keine Frachtbriefe oder Etiketten, bestellt keine Kuriere, verfolgt keine Sendungen, übernimmt keine Nachnahme und liefert nicht an eine Adresse. Nur Bulgarien und Rumänien haben eine Filialliste.
Abholpunkte
Die gewählte Filiale wird mit der Bestellung gespeichert: Stadt, Filialname und Adresse sowie der Econt-Filialcode. Verwenden Sie den Filialcode, wenn Sie die Sendung in e-Econt erstellen.
Bestellbildschirm im Admin-Bereich: Filiale und Filialcode werden unter der Lieferadresse angezeigt. Klicken Sie auf Change, um die Filialliste zu laden und eine andere Stadt und Filiale zu wählen. Die Änderung wird sofort gespeichert, und eine Bestellnotiz hält die alte und die neue Filiale fest.
Kunde: Die Filiale wird auf der Bestellseite des Kunden und der Dankeseite sowie in den Bestell-E-Mails (HTML und Nur-Text) angezeigt.
Filialnamen werden in der Landessprache angezeigt (kyrillisch für Bulgarien), wenn die Sprache der Website Bulgarisch oder Rumänisch ist, sonst auf Englisch.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Econt. 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 Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne einen aktiven Schlüssel wird Econt 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. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.
Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
Econt erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, das Lieferland Bulgarien oder Rumänien ist und die Methode der Zone dieses Landes hinzugefügt wurde (oder Ignore zones aktiv ist und das Land erlaubt ist). Prüfen Sie, ob ein Preis für das Land festgelegt ist, die Gewichtsgrenzen, Minimum subtotal und Hide for shipping classes. Prüfen Sie die Zeile Office list in den Einstellungen: Die Methode wird ausgeblendet, solange für das Land keine Filialliste verfügbar ist.
Die Filialliste lädt nicht: klicken Sie auf Load offices from Econt now und lesen Sie das Ergebnis oder die Warnung oben auf der Einstellungsseite. Fehler werden in WooCommerce > Status > Logs, Quelle vfd-econt, protokolliert. Wenn Econt eine Autorisierung für Ihre Website verlangt, tragen Sie Econt username und Econt password ein.
Kunden sehen Testfilialen: Demo API ist aktiviert. Schalten Sie sie in einem Live-Shop aus.
In welcher Währung sind die Preise? In Ihrer Shop-Währung.
Andere Länder: Entwickler können Länder mit dem Filter vfd_ecn_countries hinzufügen (zweistelliger Code, der einem dreistelligen Code zugeordnet wird).
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 und löscht nur den Filial-Cache. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die zwischengespeicherten Filiallisten werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Filialen bleiben immer erhalten, und bestehende Bestellungen behalten ihre Versandpositionen.
Econt ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin steht in keiner Verbindung zu Econt und wird nicht von Econt unterstützt.