VibeFox Omniva for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。未安装 WooCommerce 时插件无法启用。
PHP：8.0 或更高版本。
Omniva：无需 API 账户。Omniva 没有公开的价格 API。Omniva OMX API 仅向签约客户开放，本插件不使用该 API，因此您需要输入自己（合同）的价格。请在 Omniva 商业账户中登记包裹。
Parcel machine list：插件从 omniva.ee 下载 Omniva 公开的网点文件（无需密钥或合同）。您的服务器必须能够向 www.omniva.ee 发出外部 HTTPS 请求。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_omniva 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox Omniva，或在插件页面的插件名称下方点击 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate（参见许可证密钥）。
5. 检查按国家和包裹尺寸设置的价格、包裹尺寸以及 Parcel machine list 状态行。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Omniva 添加到爱沙尼亚、拉脱维亚和/或立陶宛的配送区域；或者开启 Ignore shipping zones 并选择国家。
配置
所有设置都位于同一页面：WooCommerce > Settings > Shipping > VibeFox Omniva。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口只有一个字段：
Title (zone)：顾客在此区域看到的名称。留空则使用全局的 Method title。
页面顶部的提示会显示问题。当未设置任何价格，或无法下载包裹自提柜列表且没有已保存的副本时，会出现红色提示，此时该配送方式不会在结账页面显示。当列表暂时无法更新、正在使用已保存的副本时，会出现黄色提示。无法识别的数字会在保存后提示，且不会被保存。
常规
Enable/Disable：同时在所有区域启用或停用 Omniva。
Method title：显示给顾客的配送方式名称。配送区域方式中的 Title 会覆盖此名称。默认值：Omniva parcel machine。
Tax status：Taxable 会将 WooCommerce 税费加到运费上，None 则不加。
价格（以商店货币计价；小数可写作 3.50 或 3,50）
Price by parcel size：爱沙尼亚、拉脱维亚和立陶宛各占一行，列为 S、M、L、XL 和 Free from。请输入目标国家各 Omniva 包裹尺寸的价格。空单元格表示该国不提供此尺寸：当包裹需要该尺寸时，此配送方式会被隐藏。0 表示免费。Free from 是购物车金额（折扣后，以购物车显示为准），达到该金额后配送到该国即免费；如不提供免运费，请留空。在您保存自己的价格之前，表格默认值为爱沙尼亚 3.50，拉脱维亚和立陶宛 4.00。启用 WooCommerce 税费后，每个价格旁边的小按钮 -% 会从您输入的价格中扣除商店所在国家的增值税（适用于您已知含增值税的价格）。
Calculation：包裹尺寸和价格的计算方式。
Parcel sizes (cm)：每种尺寸的最大尺寸，分为 Smallest side、Middle side 和 Largest side。商品尺寸按相同方式排序，并逐项比较；保存时对数值进行排序。商品尺寸会从商店单位换算为 cm。没有尺寸的商品适用 S 号。如果没有任何尺寸合适，则隐藏此配送方式。默认值：S 9 x 38 x 64、M 19 x 38 x 64、L 38 x 39 x 64、XL 39 x 64 x 64。请对照 Omniva 当前的包裹尺寸进行核对。
可用性
Minimum weight (kg)：购物车低于此重量时隐藏该配送方式。留空或为 0 表示无限制。
Maximum weight (kg)：购物车（若使用 Per item，则指单件商品）超过此重量时隐藏该配送方式。Omniva 包裹自提柜可接受最多 30 kg 的包裹。默认值：30。0 表示无限制。商店的重量单位会换算为 kg。
Minimum cart total：仅在购物车金额达到此值时显示该配送方式。留空则始终显示。
Excluded shipping classes：购物车中包含这些 WooCommerce 配送类别的商品时，隐藏该配送方式。
Ignore shipping zones：不将 Omniva 添加到配送区域，而是为下方指定的国家提供。关闭时，国家由添加了该方式的配送区域决定。建议保持关闭。
Countries (without zones)：此模式下的目的地国家。仅当 Ignore shipping zones 开启时才使用此字段。留空则适用于所有配送国家。在任何模式下，Omniva 都只会在有包裹自提柜的地区提供：爱沙尼亚、拉脱维亚和立陶宛。
包裹自提柜
Post offices：在同一列表中同时提供 Omniva 邮局。Omniva 提供爱沙尼亚的邮局。默认关闭。
City order：先显示最大的城市（塔林、里加、维尔纽斯等），然后按字母顺序显示其余城市。默认开启。关闭时，城市按字母顺序排列。
Parcel machine list：状态行，显示各国包裹自提柜的数量（若已启用，还包括邮局数量）以及上次从 omniva.ee 下载的时间。点击 Update the list now 可立即下载列表；如果 omniva.ee 无响应，则保留已保存的副本。
高级
Debug log：将价格计算和包裹自提柜列表的详细信息记录到 WooCommerce > Status > Logs（来源 vfd-omniva）。错误（例如包裹自提柜列表不可用）始终会被记录。不记录任何顾客数据。
Remove data on uninstall：开启后，删除插件会移除设置、配送区域方式以及已保存的包裹自提柜列表。停用插件从不会删除设置。订单中保存的包裹自提柜会保留。
结账时的工作流程
当顾客输入爱沙尼亚、拉脱维亚或立陶宛的收货地址时，WooCommerce 会向插件请求运费。插件会检查购物车重量、最低购物车金额和排除的配送类别，然后根据商品尺寸确定包裹尺寸。如果包裹不适合任何尺寸，或该尺寸在该国没有价格，或没有可用的包裹自提柜，则隐藏该配送方式，这样顾客就不会看到无法完成的结账页面。如果购物车金额达到该国的 Free from，价格为 0。包裹尺寸会以 Omniva parcel size 的名称保存在订单的配送行中。
包裹自提柜列表每天从 omniva.ee 下载一次，并存储在 WordPress 数据库中，而非插件文件夹内。如果下载失败，仍会使用已保存的副本，并在 15 分钟后再次尝试，因此结账页面不会在每次刷新时都等待 omniva.ee。下载超时时间为 15 秒。
该配送方式适用于经典结账以及购物车和结账区块。它兼容 WooCommerce 高性能订单存储（HPOS）。价格以商店货币计算。插件不进行货币换算。
插件不会查询 Omniva 价格、不登记发货、不打印面单、不呼叫快递员、不追踪包裹。请在您的 Omniva 商业账户中登记包裹。快递上门配送不属于此配送方式。
取件点
当顾客选择 Omniva 时，该方式下方会出现两个列表：-- Select city -- 和 -- Select parcel machine --。仅显示收货国家的城市和包裹自提柜；顾客更改国家时，列表也会随之变化。在爱沙尼亚，城市按县划分，塔林、塔尔图和帕尔努会单独列出；在拉脱维亚和立陶宛，列出的是城市和市镇。当收货地址中的城市与列表中的某个城市匹配时，会自动预选该城市。每个包裹自提柜都会显示其名称和地址。结账过程中会记住顾客的选择，因此在结账页面刷新时不会丢失。
必须选择包裹自提柜。在经典结账中，顾客会看到 Please select an Omniva parcel machine. 在区块结账中，未选择包裹自提柜之前，Place order 按钮会被禁用。在两种结账方式中，服务器都会再次对照列表校验包裹自提柜，因此伪造的 ID 或其他国家的包裹自提柜会被拒绝。
包裹自提柜的 ID、名称、城市和国家会保存在订单中。它们会显示在订单页面的收货地址下方（含包裹自提柜 ID）、订单完成页面、My account > Orders，以及订单邮件（HTML 和纯文本）中，标签为 Omniva parcel machine。
要更改订单的包裹自提柜，请在 WooCommerce > Orders 中打开该订单，点击包裹自提柜旁的 Change，选择订单收货国家的城市和包裹自提柜，然后点击 Save parcel machine。订单备注会记录旧的和新的包裹自提柜。
许可证密钥
本插件需要使用在 vibefox.net 获取的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Omniva 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将密钥从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，Omniva 不会在结账页面向顾客显示。已登录的商店管理员仍可看到，并标有 (unlicensed — visible to admins only)，以便您在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
Omniva 未出现在结账页面：请检查许可证是否有效、Enable/Disable 是否开启、收货国家是否为爱沙尼亚、拉脱维亚或立陶宛，以及该方式是否已添加到顾客所在国家的配送区域（或已开启 Ignore shipping zones 且允许该国家）。打开设置页面：红色提示会说明是否未设置价格或没有可用的包裹自提柜列表。另请检查商品尺寸（超过 XL 尺寸的包裹，或价格单元格为空的尺寸，都会隐藏该方式）、重量限制、Minimum cart total 和 Excluded shipping classes。开启 Debug log 后，WooCommerce > Status > Logs（来源 vfd-omniva）会显示该方式被隐藏的原因。
没有包裹自提柜：无法从 omniva.ee 下载列表，也没有已保存的副本。插件每 15 分钟重试一次。请点击 Update the list now；如果仍然失败，请检查您的服务器能否访问 www.omniva.ee，并在 WooCommerce > Status > Logs 中查看错误信息。
新的包裹自提柜缺失：列表每天更新一次。请点击 Update the list now 立即下载。
收取了错误的价格：价格取决于根据商品尺寸确定的包裹尺寸。请检查商品尺寸、Calculation 和 Parcel sizes (cm)。开启 Debug log 后，日志会显示所选的尺寸和价格。
顾客无法提交订单：必须选择一个包裹自提柜。如果顾客看到“The Omniva parcel machine list is temporarily unavailable”，表示目前没有可用的包裹自提柜；请参阅“没有包裹自提柜”。
价格使用的货币：以您的商店货币计价。插件不进行货币换算。
面向开发者：vfd_omniva_locations_url 过滤器用于更改网点文件的地址（Omniva 格式的 CSV），vfd_omniva_countries 过滤器用于更改目的地国家列表（默认为 EE、LV、LT）。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活该密钥。如果无法连接许可证服务器，插件将继续使用最后一次已知的状态运行。
卸载
停用插件会保留所有设置和已保存的包裹自提柜列表。要删除插件，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥、许可证状态和缓存始终会被删除。只有在 Remove data on uninstall 开启时，设置、配送区域方式和已保存的包裹自提柜列表才会被删除；否则它们会保留，以便日后重新安装。订单中保存的包裹自提柜永远不会被删除，现有订单也会保留其配送行。
Omniva 是其各自所有者的商标。本插件与 Omniva 无关联，也未获得 Omniva 的认可。