VibeFox Econt for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。未安装 WooCommerce 时插件无法启用。
PHP：8.0 或更高版本。
Econt：无需 Econt 合同或 API 密钥。网点列表是 Econt 公开的名录。仅向 Econt 发送国家代码，不发送任何顾客数据。只有当 Econt 要求您的网站进行授权时，才需要填写 e-Econt 用户名和密码。e-Econt 登录方式详见 Econt 开发者页面（econt.com/developers）。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_econt 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置页面：WooCommerce > Settings > Shipping > VibeFox Econt，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 设置各国运费并检查其他选项（参见配置部分）。点击 Load offices from Econt now 测试连接。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Econt 添加到包含保加利亚和/或罗马尼亚的配送区域，或开启 Ignore zones 并选择国家。
配置
所有设置都在同一页面中：WooCommerce > Settings > Shipping > VibeFox Econt。运费和条件适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：顾客在此区域看到的名称。留空则使用全局的 Name。
插件会在页面顶部显示警告：演示 API 已开启，保加利亚或罗马尼亚未设置运费（此时该方式永远不会显示），或某个国家最近一次获取网点的请求失败。数字字段接受小数点，例如 5.99。非数字的值会被忽略，并在保存时提示。
常规
Enable/Disable：一次性在所有区域中开启或关闭 Econt 配送。默认：开启。
Name：结账时显示的配送方式名称。区域中设置的 Title 会覆盖它。默认：Econt Express。
Tax status：Taxable 会将 WooCommerce 税费计入运费，None 则不计入。默认：Taxable。
Econt 网点列表
网点和 Econtomat 从 Econt API 加载，并缓存 24 小时。
Demo API：使用带测试数据的 Econt 演示 API。在正式店铺中请保持关闭。演示网点的 ID 与真实网点不同。在演示模式下，如果未设置登录信息，则使用 Econt 公开的测试账户。
Econt username：可选。您的 e-Econt 登录用户名，用于 HTTP Basic 授权。
Econt password：可选。保存在 WordPress 数据库中，且绝不会写入日志。
Office list：显示每个国家已缓存的网点数量以及加载时间。点击 Load offices from Econt now 可立即重新加载列表并显示结果。如果加载失败，则保留上一次成功加载的网点。即使没有此按钮，列表也会在首次结账时自动加载。修改 Demo API、用户名或密码时，会清除已缓存的列表。
结账时的网点选择器
Show：顾客可以选择哪些网点。
City order：优先显示最大的城市（索非亚、普罗夫迪夫、瓦尔纳、布加勒斯特等）。关闭后，城市按字母顺序排列。默认：开启。
City list width：经典结账页面上城市列表的 CSS 宽度，例如 100% 或 300px。默认：100%。
Office list width：经典结账页面上网点列表的 CSS 宽度，例如 100% 或 400px。默认：100%。
运费（以店铺货币计价）
插件不会向 Econt 查询实时费率。保加利亚自 2026 年 1 月 1 日起使用欧元，因此保加利亚店铺通常应输入欧元价格。
Price per country：每行一个国家（或用逗号分隔）：国家代码、冒号和运费，例如 BG:5.99 和 RO:8.99（这是默认值）。也可以使用小数逗号：BG:5,99。运费为 0 表示免费配送。格式不正确的条目会被忽略，并在保存时列在错误消息中。
Calculation：Per order 只收取一次运费。Per item (price x quantity) 则按购物车中可配送商品的数量相乘。
Price for other countries：用于上面未列出的 Econt 国家（保加利亚或罗马尼亚）。留空或填 0 则在该国家隐藏此方式。
条件
Free shipping from：购物车小计达到此金额即免运费。留空则从不提供免运费。
Minimum subtotal：仅当购物车小计至少达到此金额时才显示该方式。留空则始终显示。
Minimum weight (kg)：对较轻的购物车隐藏该方式。商品重量会从店铺单位换算为千克。留空表示没有限制。
Maximum weight (kg)：对较重的购物车隐藏该方式。留空表示没有限制。
Hide for shipping classes：如果购物车中包含以下任一 WooCommerce 配送类别的商品，则隐藏该方式。
无配送区域时的可用性
Ignore zones：当没有任何区域添加 Econt 时，仍向以下国家提供 Econt。包含该方式的区域照常工作。
Countries：保加利亚和/或罗马尼亚。仅在开启 Ignore zones 时使用。留空则适用于您的店铺配送的所有 Econt 国家。
高级
Debug log：将调试信息写入 WooCommerce > Status > Logs，来源为 vfd-econt。API 错误始终会记录。不会写入密码或顾客数据。
Remove data on uninstall：开启后，删除插件时会移除 Econt 设置和区域配送方式。停用插件从不会删除设置。订单中保存的网点始终保留。
结账时的工作流程
该方式仅面向保加利亚和罗马尼亚提供。当顾客输入配送地址后，插件会检查购物车重量、最低小计和隐藏的配送类别，然后取该国家的运费。如果购物车小计达到 Free shipping from，运费为 0。如果该国家没有可用的网点列表，则隐藏该方式，因为配送始终送达网点。
当顾客选择 Econt 时，该方式下方会出现两个列表：City 和 Office / Econtomat。网点列表每个页面只加载一次。Econtomat 会在列表中做标记。顾客的选择在本次会话中会被记住。如果无法加载网点列表，顾客会看到提示，建议几分钟后再试或选择其他配送方式。
顾客必须选择网点才能下单。在服务器端，插件会再次检查该网点是否存在于配送国家的 Econt 列表中。网点名称始终取自 Econt 列表，而不是来自浏览器。该功能适用于经典结账和区块结账。本插件兼容 WooCommerce 高性能订单存储（HPOS）。
网点列表缓存 24 小时。如果无法连接 Econt，则使用最近一次成功获取的列表，并且 10 分钟内不会再次请求 Econt。API 超时时间为 15 秒。
插件仅使用固定运费。它不会向 Econt 查询实时运费，不会生成运单或标签，不会预约快递员，不会跟踪包裹，不处理货到付款，也不支持送货上门。只有保加利亚和罗马尼亚有网点列表。
取件点
所选网点会随订单一同保存：城市、网点名称和地址，以及 Econt 网点代码。在 e-Econt 中创建发货单时请使用网点代码。
管理员订单页面：网点和网点代码显示在配送地址下方。点击 Change 可加载网点列表并选择其他城市和网点。更改会立即保存，并且订单备注会记录原网点和新网点。
顾客：网点会显示在顾客的订单页面和感谢页面，以及订单电子邮件中（HTML 和纯文本格式）。
当网站语言为保加利亚语或罗马尼亚语时，网点名称以当地语言显示（保加利亚为西里尔字母）；其他情况下以英文显示。
许可证密钥
本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Econt 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期的截止日期以及您的域名。使用 Check now 可以再次检查状态，Change key 用于输入其他密钥，Remove key 用于将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效的密钥时，Econt 不会在顾客的结账页面中显示。已登录的店铺管理员仍能看到它，并标有 (unlicensed — visible to admins only)，以便您在购买密钥之前进行设置和测试。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
Econt 未出现在结账页面：请检查许可证是否有效、Enable/Disable 是否开启、配送国家是否为保加利亚或罗马尼亚，以及该方式是否已添加到该国家所在的区域（或 Ignore zones 已开启且允许该国家）。检查该国家是否设置了运费、重量限制、Minimum subtotal 和 Hide for shipping classes。查看设置中的 Office list 行：该国家没有可用的网点列表时，此方式会被隐藏。
网点列表无法加载：点击 Load offices from Econt now 并查看结果，或查看设置页面顶部的警告。错误会记录在 WooCommerce > Status > Logs 中，来源为 vfd-econt。如果 Econt 要求对您的站点进行授权，请填写 Econt username 和 Econt password。
顾客看到测试网点：Demo API 已开启。请在正式店铺中关闭它。
运费使用哪种货币？使用您的店铺货币。
其他国家：开发者可以使用 vfd_ecn_countries 过滤器添加国家（将 2 位字母代码映射为 3 位字母代码）。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件将继续使用最后一次已知的状态运行。
卸载
停用插件会保留所有设置，只清除网点缓存。要删除插件，请先停用，然后在 Plugins 页面中删除。本插件的许可证密钥、许可证状态以及缓存的网点列表始终会被删除。只有开启了 Remove data on uninstall 时，设置和区域配送方式才会被删除；否则它们会保留，以便之后重新安装时使用。订单中保存的网点始终保留，现有订单也会保留其配送行。
Econt 是其各自所有者的商标。本插件与 Econt 无关联，也未获得 Econt 的认可或背书。