VibeFox Econt for WooCommerce — Help

Requirements

WordPress: 5.8 or later.

WooCommerce: 7.0 or later, installed and active. The plugin refuses to activate without it.

PHP: 8.0 or later.

Econt: no contract or API key is needed. The office list is a public Econt nomenclature. Only the country code is sent to Econt, no customer data. Fill in an e-Econt username and password only if Econt asks your site for authorization. The e-Econt login is described on the Econt developers page (econt.com/developers).

VibeFox license key: bought on vibefox.net. One key works on one domain.

Installation

1. In WordPress go to Plugins > Add New > Upload Plugin, choose the plugin ZIP file and click Install Now. You can also upload the vfd_econt folder to /wp-content/plugins/ by FTP.

2. Click Activate.

3. Open the settings: WooCommerce > Settings > Shipping > VibeFox Econt, or click Settings under the plugin name on the Plugins page.

4. Enter your VibeFox license key in the license block at the top of the page and click Activate.

5. Set the prices per country and check the other options (see Configuration). Click Load offices from Econt now to test the connection.

6. Add VibeFox Econt to a shipping zone with Bulgaria and/or Romania in WooCommerce > Settings > Shipping > Shipping zones, or turn on Ignore zones and choose countries.

Configuration

All settings are on one page: WooCommerce > Settings > Shipping > VibeFox Econt. The price and conditions apply to every shipping zone. When you add the method to a zone, the zone window has only one field:

Title (zone): the name customers see for this zone. Leave it empty to use the global Name.

At the top of the page the plugin shows warnings: the demo API is on, no price is set for Bulgaria or Romania (the method is then never shown), or the last office request for a country failed. Number fields accept a decimal comma, for example 5,99. A value that is not a number is ignored and reported when you save.

General

Enable/Disable: turns Econt delivery on or off in all zones at once. Default: on.

Name: the shipping method name shown at checkout. A Title set in the zone overrides it. Default: Econt Express.

Tax status: Taxable adds WooCommerce tax to the shipping cost, None does not. Default: Taxable.

Econt office list

Offices and Econtomats are loaded from the Econt API and cached for 24 hours.

Demo API: use the Econt demo API with test data. Keep it off on a live shop. Demo offices have other IDs than the real ones. In demo mode the public Econt test account is used when no login is set.

Econt username: optional. Your e-Econt login for HTTP Basic authorization.

Econt password: optional. Stored in the WordPress database and never written to the log.

Office list: shows how many offices are cached per country and when they were loaded. The button Load offices from Econt now reloads the lists immediately and shows the result. If a load fails, the offices from the last successful load are kept. Without this button, the list is loaded automatically at the first checkout. Changing Demo API, the username or the password clears the cached lists.

Office selector at checkout

Show: which points customers can choose.

City order: show the largest cities first (Sofia, Plovdiv, Varna, Bucharest and others). When off, cities are sorted alphabetically. Default: on.

City list width: the CSS width of the city list on the classic checkout, for example 100% or 300px. Default: 100%.

Office list width: the CSS width of the office list on the classic checkout, for example 100% or 400px. Default: 100%.

Prices (in your store currency)

The plugin does not ask Econt for live rates. Bulgaria uses the euro since 1 January 2026, so a Bulgarian store normally enters EUR prices.

Price per country: one country per line (or comma separated): country code, colon, price, for example BG:5.99 and RO:8.99 (these are the defaults). A decimal comma is fine: BG:5,99. A price of 0 means free delivery. Entries in another format are ignored and listed in an error message when you save.

Calculation: Per order charges the price once. Per item (price x quantity) multiplies it by the number of shippable items in the cart.

Price for other countries: used for an Econt country (Bulgaria or Romania) that is not listed above. Empty or 0 hides the method there.

Conditions

Free shipping from: the cart subtotal from which delivery is free. Leave it empty to never give free delivery.

Minimum subtotal: show the method only when the cart subtotal is at least this amount. Leave it empty to always show it.

Minimum weight (kg): hide the method for lighter carts. Product weights are converted from your store unit to kg. Leave it empty for no limit.

Maximum weight (kg): hide the method for heavier carts. Leave it empty for no limit.

Hide for shipping classes: hide the method if the cart contains a product of one of these WooCommerce shipping classes.

Availability without shipping zones

Ignore zones: also offer Econt to the countries below when no zone adds it. Zones that contain the method keep working as usual.

Countries: Bulgaria and/or Romania. Used only with Ignore zones. Leave empty for all Econt countries your store ships to.

Advanced

Debug log: writes debug messages to WooCommerce > Status > Logs, source vfd-econt. API errors are always logged. No passwords or customer data are written.

Remove data on uninstall: when on, deleting the plugin removes the Econt settings and zone methods. Deactivating the plugin never deletes settings. Offices saved in orders are always kept.

How it works at checkout

The method is offered only for Bulgaria and Romania. When the customer enters a delivery address, the plugin checks the cart weight, the minimum subtotal and the hidden shipping classes, then takes the price for the country. If the cart subtotal reaches Free shipping from, the price is 0. If no office list is available for the country, the method is hidden, because delivery always goes to an office.

When the customer selects Econt, two lists appear under the method: City and Office / Econtomat. The office list is loaded once per page. Econtomats are marked in the list. The choice is remembered during the session. If the office list cannot be loaded, the customer sees a message to try again in a few minutes or choose another shipping method.

The customer cannot place the order without choosing an office. On the server the plugin checks again that the office exists in the Econt list for the shipping country. The office name is always taken from the Econt list, not from the browser. This works on the classic checkout and on the block checkout. The plugin is compatible with WooCommerce High-Performance Order Storage (HPOS).

The office list is cached for 24 hours. If Econt cannot be reached, the last good list is used and Econt is not asked again for 10 minutes. The API timeout is 15 seconds.

The plugin uses fixed prices only. It does not ask Econt for live prices, create waybills or labels, order couriers, track parcels, handle cash on delivery or deliver to an address. Only Bulgaria and Romania have an office list.

Pickup points

The chosen office is saved with the order: the city, the office name and address, and the Econt office code. Use the office code when you create the shipment in e-Econt.

Admin order screen: the office and the office code are shown under the shipping address. Click Change to load the office list and choose another city and office. The change is saved at once and an order note records the old and the new office.

Customer: the office is shown on the customer's order page and the thank-you page, and in the order e-mails (HTML and plain text).

Office names are shown in the local language (Cyrillic for Bulgaria) when the site language is Bulgarian or Romanian, and in English otherwise.

License key

The plugin works with a VibeFox license key from vibefox.net. The license block is at the top of WooCommerce > Settings > Shipping > VibeFox Econt. Paste the key into License key and click Activate. The block shows the status, for example the date the license is active until and your domain. Use Check now to check the status again, Change key to enter another key and Remove key to remove it from this site. The link Manage licenses and domains in your account opens your vibefox.net account.

One key works on one domain. Removing the key from a site does not free its domain slot. Free the slot in your vibefox.net account.

Without an active key, Econt is not shown to customers at checkout. Logged-in store managers still see it, marked (unlicensed — visible to admins only), so you can set up and test the plugin before you buy a key. A reminder appears on the Plugins page and on WooCommerce pages. Existing orders are not affected.

When a license expires, the plugin keeps working, but updates and support need a renewal. The status is checked again automatically in the background.

Troubleshooting

Econt does not appear at checkout: check that the license is active, Enable/Disable is on, the delivery country is Bulgaria or Romania, and the method is added to the zone of that country (or Ignore zones is on and the country is allowed). Check that a price is set for the country, the weight limits, Minimum subtotal and Hide for shipping classes. Check the Office list line in the settings: the method is hidden while no office list is available for the country.

The office list does not load: click Load offices from Econt now and read the result, or the warning at the top of the settings page. Errors are written to WooCommerce > Status > Logs, source vfd-econt. If Econt requires authorization for your site, fill in Econt username and Econt password.

Customers see test offices: Demo API is on. Turn it off on a live shop.

Which currency are the prices in? In your store currency.

Other countries: developers can add countries with the vfd_ecn_countries filter (2-letter code mapped to 3-letter code).

The license block shows an error: follow the message in the block. For example, if the key is already used on another domain, free a slot in your vibefox.net account and click Check now. If the site address changed, click Check now to activate the key for the new domain. If the license server cannot be reached, the plugin keeps working on the last known status.

Uninstall

Deactivating the plugin keeps all settings and only clears the office cache. To remove it, deactivate and delete it on the Plugins page. The license key and license status of this plugin and the cached office lists are always removed. Settings and zone methods are removed only if Remove data on uninstall was on. Otherwise they stay for a later re-install. Offices saved in orders are always kept, and existing orders keep their shipping lines.

Econt is a trademark of its respective owner. This plugin is not affiliated with or endorsed by Econt.