VibeFox Instabee for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。未安装时插件无法激活。
PHP：8.0 或更高版本。
Budbee API 凭据（仅用于包裹柜选择）：API 密钥和 API 密码。Instabee 向签订配送协议的商家发放这些凭据。请咨询您的 Instabee 联系人，或使用 Instabee 商家门户。API 文档位于 developer.budbee.com。没有凭据时，该配送方式仍可按固定价格使用，但顾客无法选择包裹柜。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_instabee 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置页面：WooCommerce > Settings > Shipping > VibeFox Instabee，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 填写价格部分；如需使用包裹柜选择器，请填写您的 Budbee API key 和 API secret（参见“配置”）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Instabee 添加到您配送国家（例如瑞典）所在的配送区域；或者开启 Ignore shipping zones 并选择国家。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox Instabee。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title：该区域结账时此费率的名称。留空则使用全局的 Method name。
设置上方的警告会提示：仅填写了 API 凭据中的一项、完全没有 API 凭据、没有国家价格也没有备用费用，以及最近一次 Budbee API 请求失败（附日期、时间和原因）。每次保存设置时，缓存的包裹柜列表和最近一次 API 错误都会被清除。
常规
Enable/Disable：在所有地方启用或停用该方式，包括配送区域。默认：开启。
Method name：购物车和结账页面中显示的配送方式名称。区域可用其自身的 Title 覆盖。默认：Instabee parcel box。
Tax status：Taxable 会将 WooCommerce 税费加到运费上，None 则不加。
包裹柜选择器（Budbee API）
配置 API 凭据后，顾客在结账时会选择邮政编码附近的包裹柜，该包裹柜会保存到订单中。两个字段都必须填写。两者都填写之前，选择器保持关闭。
API key：您的 Budbee API 密钥（HTTP Basic 用户名）。
API secret：您的 Budbee API 密码（HTTP Basic 密码）。
Test environment：使用 Budbee 测试环境 API（api.staging.budbee.com）。仅在使用 Instabee 提供的测试凭据时开启。正式店铺请保持关闭（api.budbee.com）。默认：关闭。
价格（章节标题会显示您的店铺货币）
所有价格均以店铺货币计。小数逗号和小数点都可以使用（49,90 = 49.90）。非数字的值不会被保存，并会有错误提示指出对应字段。
Calculation type：价格的计算方式。
Country prices：包含以下列的表格：Country、Price、XS（不超过 1 kg）、S（不超过 2 kg）、M（不超过 3 kg）、L（不超过 5 kg）和 XL（超过 5 kg）。点击 + Add country 添加一行，点击叉号删除一行。选择 * Any other country 可设置适用于所有未单独设置行的国家的一行。区间留空或为 0 时，使用 Price 列。Price 为 0 表示免费配送。若国家所在行没有该购物车重量对应的价格，则使用 * 行，再不行则使用 Fallback cost。重量会从店铺重量单位换算为 kg。
Fallback cost：当目的国所在行和 * 行都无法给出价格时使用。留空则对这些国家隐藏该方式。
条件
Min weight (kg)：购物车重量低于此值时隐藏该方式。默认：0（无限制）。
Max weight (kg)：购物车重量高于此值时隐藏该方式。包裹柜最多可容纳约 20 kg。默认：20。0 表示无限制。
Minimum order amount：仅当购物车小计（折扣后、税前）达到此金额时才显示该方式。留空则始终显示。
Free shipping from：购物车小计（折扣后、税前）达到此金额时，该方式免费。留空则永不免费。
Excluded shipping classes：购物车中包含以下任一 WooCommerce 配送类别的商品时，隐藏该方式。
无配送区域时的可用性
通常您会把 VibeFox Instabee 添加到配送区域。此外，您也可以在这里为一组国家启用它。
Ignore shipping zones：即使没有任何配送区域包含该方式，也在下面列出的国家提供该方式。
Countries：该模式下的目的国。留空则使用您配送的所有国家。仅在开启 Ignore shipping zones 时使用此字段。
高级
Debug log：将调试信息写入 WooCommerce > Status > Logs（来源 vfd-instabee）。即使此选项关闭，API 错误也始终会被记录。API 密钥和顾客数据从不记录。
Remove data on uninstall：开启后，删除插件时会移除该方式的设置和区域费率。停用插件从不删除设置。保存在订单中的包裹柜会保留。
结账时的工作流程
顾客输入收货地址时，WooCommerce 会向插件请求费率。插件检查条件：购物车重量、最低订单金额和排除的配送类别。若购物车小计达到 Free shipping from，则费率为免费。否则，价格取自目的国的 Country prices 行、* 行或 Fallback cost。若没有价格，则隐藏该方式。
当顾客选择 Instabee 费率且已设置 API 凭据时，对于瑞典、芬兰、丹麦、荷兰和比利时，费率下方会出现 Parcel box 选择器。它会按距离排序列出收货地址邮政编码附近的包裹柜，并显示名称、地址和距离。顾客可以输入其他邮政编码并点击 Search。未输入邮政编码之前，选择器会要求输入。若未找到包裹柜，系统会提示顾客尝试其他邮政编码或选择其他配送方式。
包裹柜为必选项。下单时，插件会在服务器端检查所选包裹柜是否在该邮政编码的 Budbee 列表中。否则，顾客会看到 Please choose an Instabee parcel box. 包裹柜名称取自 Budbee 列表，而非浏览器。
插件仅向 Budbee 发送目的国和邮政编码，从不发送姓名、地址、电子邮件或订单数据。包裹柜列表按每个邮政编码缓存 12 小时，无包裹柜的邮政编码缓存 1 小时，失败的请求缓存 5 分钟，因此缓慢或故障的 API 不会拖慢每次结账页面刷新。API 超时时间为 10 秒。
若无法连接 Budbee API，系统会告知顾客可以不选择包裹柜直接下单。该订单随后会被标记，您可在预订运单时选择包裹柜。之前已选的包裹柜若当时无法核实，会被保留并标记为未验证。
该选择器适用于经典结账以及购物车和结账区块。插件兼容 WooCommerce 高性能订单存储（HPOS）。
插件不计算实时费率、不预订运单、不打印面单、不提供物流单号或追踪邮件、不提供 Budbee Home 配送时段，也不显示地图。请在您的 Instabee / Budbee 商家工具中为所选包裹柜预订包裹。
取件点
所选包裹柜会保存到订单中，并显示在以下位置：
后台订单页面：位于收货地址下方，显示为 Instabee parcel box，包含包裹柜名称、地址和 Box ID。若结账时无法核实包裹柜，则会标记为 not verified (Budbee API was unavailable at checkout)。若因 API 不可用而未选择包裹柜，页面会注明此情况，并提醒您在预订运单时选择包裹柜。
感谢页面和“我的账户”订单页面：包裹柜名称和地址。
订单邮件：HTML 和纯文本格式。发给店铺的邮件还会显示包裹柜 ID。若因 API 不可用而未选择包裹柜，只有发给店铺的邮件会提及此情况。
许可证密钥
插件需要使用从 vibefox.net 获取的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Instabee 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期至何时以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从某个站点移除密钥不会释放该域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，Instabee 不会在结账时向顾客显示。已登录的店铺管理员仍会看到它，并标注为 (unlicensed — visible to admins only)，以便您在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续运行，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
结账时不显示 Instabee：请检查许可证是否有效、Enable/Disable 是否开启、该方式是否已添加到顾客所在国家的配送区域（或已开启 Ignore shipping zones 且允许该国家）。检查该国家是否有价格，或是否存在 * 行或 Fallback cost。检查重量限制、Minimum order amount 和 Excluded shipping classes。设置上方的警告会提示未配置价格的情况。
顾客看不到包裹柜列表：只有在 API key 和 API secret 均已设置、目的国为瑞典、芬兰、丹麦、荷兰或比利时，并且已输入邮政编码后，列表才会显示。最近一次 API 错误会显示在设置上方。详细信息见 WooCommerce > Status > Logs（来源 vfd-instabee）。如需更多细节，请开启 Debug log。
日志中出现 HTTP 401 或 403：Budbee 拒绝了 API 密钥或密码。请检查这两项，并确认 Test environment 与您的凭据相符（仅在测试环境开启时使用测试凭据）。
某个邮政编码没有包裹柜：Budbee 不覆盖该邮政编码。顾客可以搜索其他邮政编码或选择其他配送方式。
更改后仍显示旧的包裹柜列表：保存设置页面即可清除缓存的包裹柜列表。
包裹柜查询的其他国家：开发者可以通过 vfd_ibee_box_countries 过滤器修改国家列表。
许可证区块显示错误：请按照区块中的提示操作。例如，若密钥已在其他域名上使用，请在 vibefox.net 账户中释放一个名额，然后点击 Check now。若站点地址已更改，请点击 Check now，为新域名激活密钥。若无法连接许可证服务器，插件会沿用上次已知的状态继续运行。
卸载
停用插件只会清除缓存的包裹柜列表。要移除插件，请停用后在 Plugins 页面将其删除。该插件的许可证密钥和许可证状态、缓存的包裹柜列表以及最近一次 API 错误始终会被删除。设置、区域配送方式和版本数据仅在 Remove data on uninstall 开启时才会删除；否则保留，供以后重新安装使用。保存在订单中的包裹柜始终保留，现有订单也会保留其配送项目。
Instabee 和 Budbee 是各自所有者的商标。本插件与 Instabee 或 Budbee 没有关联，也未获得其认可或背书。