VibeFox J&T Express for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：5.0 或更高版本，已安装并启用。没有 WooCommerce 时，插件无法启用。
PHP：8.0 或更高版本。
J&T Express Malaysia API 访问权限（仅用于实时报价）：实时报价仅适用于 J&T Express Malaysia，且仅针对马来西亚的配送地址。您需要四个值。请在 J&T Express Malaysia 网站上申请 J&T VIP 账户（设置页面上有链接）：J&T 会提供 VIP 客户代码和 VIP API 密钥。API 账户以及用于签署请求的私钥由 J&T 为 API 集成而签发。请向您的 J&T 客户经理索取。J&T 菲律宾、印度尼西亚及其他国家没有公开的报价 API，因此这些国家请使用价格表。如果您只使用价格表和备用运费，则无需 J&T API 访问权限。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_jt_express 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox J&T Express，或在插件列表页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 填写价格表和/或备用运费。如需马来西亚实时报价，还需填写 J&T API 凭据、发件邮编；如果店铺货币不是 MYR，还需填写汇率换算（参见配置）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox J&T Express 添加到某个配送区域，或开启 Ignore shipping zones 并选择国家。
配置
所有设置都在同一个页面中：WooCommerce > Settings > Shipping > VibeFox J&T Express。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：顾客在该区域看到的名称。留空则使用全局的 Method title。
每次保存设置时，已缓存的 J&T 报价都会被清除。如果实时报价只配置了一部分，设置页面顶部的警告会列出缺少的设置，或提示缺少货币换算汇率。
常规
Enable/Disable：一次性在所有区域中启用或禁用该方式。默认：on。
Method title：购物车和结账页面中显示的配送方式名称。某个区域可以覆盖它。默认：J&T Express。
Tax status：Taxable 会在费用之上加上您店铺的运费税，None 则不加。如果 J&T 价格已包含您想收取的全部费用，请选择 None。
J&T Express Malaysia API（实时报价）（可选，适用于马来西亚的配送地址；四项凭据均为必填）
VIP customer code：您的 J&T Express VIP 客户代码。
VIP API key：J&T Express 与 VIP 代码一起提供的 API 密钥（密码）。它绝不会写入日志。
API account：您的 J&T Express API 账户名称。
API private key：API 账户的私钥。仅用于签署请求（SHA-256）。它绝不会发送给 J&T，也绝不会写入日志。
Sender postcode：包裹发出地的马来西亚邮编。如果店铺位于马来西亚，可留空以使用 WooCommerce > Settings > General 中的店铺邮编。保存时会自动删除空格。
Currency conversion rate：J&T Express Malaysia 的报价以 MYR 计价。如果您的店铺货币不是 MYR，请填写 1 MYR 等于多少您的货币单位（1 MYR = X）。没有此值时，不使用实时报价，而是使用价格表或备用运费。如果店铺货币是 MYR，请留空：报价将按原样使用。小数点和逗号都可作为小数分隔符。
价格表与备用（用于马来西亚以外的国家，在未配置实时报价或 J&T 未返回报价时使用；价格以您店铺的货币计）
Country prices：每个国家一行的表格。点击 Add country 添加一行，点击叉号删除。选择 * Any other country 可用于所有没有单独一行的国家。每行包含一个 Base price 和五个重量区间：XS 为 1 kg 及以内，S 为 2 kg 及以内，M 为 3 kg 及以内，L 为 5 kg 及以内，XL 为 5 kg 以上。某区间的价格大于 0 时，会替代该区间购物车的基础价格。区间价格为 0 时使用基础价格。基础价格为 0 表示免运费，留空的基础价格会保存为 0。没有对应行的国家（在没有 * 行的情况下）不会获得价格表中的价格。
Fallback cost：J&T 和价格表都无法提供价格时使用的价格。留空则在这种情况下隐藏该方式。
Table / fallback price is：Per order 只收取一次价格。Per item (multiplied by the number of items) 将价格乘以购物车中的商品数量。J&T 实时报价始终针对整个订单。
条件
Free shipping from：达到此购物车小计（折扣后、税前）即免运费。留空则不提供免运费。
Minimum subtotal：只有当购物车小计达到此金额时才显示该方式。留空则始终显示。
Min weight (kg)：购物车重量低于此值时隐藏该方式。商品重量按店铺的重量单位换算。0 表示不设上限。
Max weight (kg)：购物车重量高于此值时隐藏该方式。默认：50。0 表示不设上限。
Excluded shipping classes：购物车中包含以下任一 WooCommerce 配送类别的商品时，隐藏该方式。
不使用配送区域时的可用性
Ignore shipping zones：即使该方式未添加到任何配送区域，也为下方列出的国家提供该方式。关闭时，该方式只会出现在已添加它的区域中。
Countries：该模式下的目的国家。留空则使用您所有发货的国家。此字段仅在 Ignore shipping zones 开启时使用。
高级
Debug log：将价格计算写入 WooCommerce > Status > Logs，来源为 vfd-jt-express。即使此选项关闭，J&T API 错误也始终会被记录。不会写入密钥、密码或顾客邮编。使用完毕后请关闭日志。
Remove data on uninstall：开启时，删除插件会移除其设置、区域方式和已缓存的报价。仅停用插件不会删除任何内容。
结账时的工作方式
顾客输入配送地址后，WooCommerce 会向插件请求运费。插件首先检查条件：配送国家、购物车重量、最低小计和排除的配送类别。如果购物车小计达到 Free shipping from，则以 0 元显示该方式，但前提是该国家有价格：Country prices 中的一行、Fallback cost，或 J&T 实时报价。只有在价格表和备用运费都无法提供价格时，才会查询 J&T。
否则，运费取自第一个能提供价格的来源：
1. J&T 实时报价：仅当四项 API 凭据和发件邮编均已填写、配送国家为马来西亚、顾客输入了 5 位邮编，并且对于非 MYR 店铺已设置汇率时。插件会向 J&T 发送发件人和收件人邮编以及购物车重量（至少 0.1 kg），请求标准服务 EZ、一个包裹，并将返回的 MYR 价格换算为您店铺的货币。
2. Country prices：配送国家的行或 * 行，取购物车重量区间的价格。
3. Fallback cost。
如果以上来源都无法提供价格，则隐藏该方式。Per item 仅适用于价格表和备用价格。
每个 J&T 响应缓存 1 小时，因此同一购物车不会重复发起请求。失败的请求缓存 10 分钟，因此结账页面不会在每次刷新时都等待 J&T。请求超时时间为 10 秒。如果 J&T 返回错误、零价格或没有响应，顾客不会看到任何错误。系统将使用价格表或备用运费，并将原因写入日志。
该方式适用于经典结账以及购物车和结账区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。
插件只计算运费。它不会生成运单、托运单或面单，不预约取件，不取消或跟踪货件，也不允许顾客选择自提点。请像平时一样在您的 J&T 账户中创建和跟踪货件。本插件是依据官方 J&T Express Malaysia 插件的请求格式开发的。正式上线前，请与您的 J&T 账户核实价格。
许可证密钥
本插件需要一个在 vibefox.net 获取的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox J&T Express 页面顶部。将密钥粘贴到 License key 中并点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，J&T Express 不会在结账时向顾客显示。已登录的店铺管理员仍能看到它，并标有 (unlicensed — visible to admins only)，以便您在购买密钥之前设置和测试插件。插件列表页面和 WooCommerce 页面上会出现提醒。现有订单不受影响。
许可证过期后，插件仍可继续运行，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时没有显示 J&T Express：请检查许可证是否有效、Enable/Disable 是否开启，以及该方式是否已添加到客户所在国家的区域（或 Ignore shipping zones 已开启且该国家被允许）。检查重量限制、Minimum subtotal 和 Excluded shipping classes。检查 Country prices 中是否有该国家的行或 * 行，或者是否设置了 Fallback cost。开启 Debug log 并查看 WooCommerce > Status > Logs。
价格来自价格表，而非 J&T：实时报价需要四项 API 凭据、一个发件邮编、一个带 5 位邮编的马来西亚配送地址，以及对于非 MYR 店铺的 Currency conversion rate。请检查设置页面顶部的警告。如果 J&T 拒绝请求或没有响应，错误会被记录，并使用价格表或备用运费。失败的请求会在 10 分钟后重试。
菲律宾或印度尼西亚没有实时报价：J&T 不为这些国家提供公开的报价 API。请对这些国家使用价格表和备用运费。
某个国家错误地获得了免运费：其行的基础价格为 0（留空的基础价格会保存为 0）。请输入基础价格或删除该行。
修改后报价看起来过时：保存设置页面即可清除已缓存的 J&T 报价。
开发者钩子：vfd_jtex_quote_request 过滤器可修改报价请求的内容（例如服务类型），vfd_jtex_api_url 可修改报价端点，标准过滤器 woocommerce_shipping_vfd_jt_express_is_available 则用于控制可用性。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件将按最后一次已知的状态继续运行。
卸载
停用插件会保留所有数据。要彻底删除，请先停用，然后在 Plugins 页面删除。本插件的许可证密钥和许可证状态始终会被删除。只有在开启了 Remove data on uninstall 的情况下，设置、区域方式和已缓存的报价才会被删除；否则会保留，以便以后重新安装时使用。现有订单会保留其运费明细行。
J&T Express 是其各自所有者的商标。本插件与 J&T Express 无关联，也未获得其认可。