VibeFox LP Express for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有它插件无法启用。
PHP：8.0 或更高版本。
LP Express：无需 API 账户。LP Express 没有公开的价格 API。Unisend API 仅向签约客户开放，本插件不使用它，因此您需要输入自己的（合同）价格。请在您的 Unisend（"Mano siuntos"）账户中创建包裹。
包裹终端列表：插件使用公开的 LP Express 终端列表，即旧版 LP Express 插件所使用的同一列表。在 1.1.0 版本发布时，该在线列表不可用。在其不可用期间，如果有已下载的副本，插件将使用该副本，否则使用您自己的列表。请准备好输入您自己的列表（参见配置）。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥对应一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_lp_express 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox LP Express，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 填写价格表（至少一行）或备用费用。查看页面顶部关于包裹终端的状态行；如果在线列表不可用，请添加您自己的终端列表。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中将 VibeFox LP Express 添加到您的立陶宛区域，或者开启 Ignore shipping zones 并选择国家。
配置
所有设置都在一个页面上：WooCommerce > Settings > Shipping > VibeFox LP Express。它们适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：客户在该区域看到的名称。留空则使用全局的 Method title。
页面顶部的通知会显示问题和终端状态。当未设置任何价格或没有可用的包裹终端时，会出现红色通知，因为此时该方式不会在结账时显示。信息行会显示有多少个城市、多少个包裹终端可用，以及来源：在线列表、在线列表的已保存副本（带日期）或您自己的列表。
常规
Enable/Disable：一次性在所有区域中启用或禁用 LP Express。
Method title：显示给客户的配送方式名称。区域方式的标题会覆盖它。默认：LP Express parcel terminal。
Tax status：Taxable 会将 WooCommerce 税费加到配送费用中，None 则不加。
价格（以商店货币计；小数可写作 2.99 或 2,99）
Price table：每个目的国家一行。点击 + Add country 添加一行，点击叉号（×）删除一行。对于没有单独行的国家，选择 * Any other country。每行都有 Base price 和重量列：XS (≤1 kg)、S (≤2 kg)、M (≤3 kg)、L (≤5 kg) 和 XL (>5 kg)。重量是购物车重量，或在 Per item 模式下单个商品的重量。空列使用该行的基础价格。0 表示免费。非数字价格会在保存后提示，并保持为空。
Fallback cost：价格表中没有目的国家的行时使用。留空则在这些国家隐藏该方式。
Calculation：价格的计算方式。
Free shipping from：购物车总额（折扣后，与购物车中显示的一致）达到该金额起，LP Express 免费。留空则没有免运费。
可用性
Minimum weight (kg)：购物车比该重量轻时隐藏该方式。留空或 0 表示无限制。
Maximum weight (kg)：购物车比该重量重时隐藏该方式。LP Express 终端接受最多 30 kg 的包裹。默认：30。0 表示无限制。
Minimum cart total：仅当购物车总额达到此金额时才显示该方式。留空则始终显示。
Excluded shipping classes：购物车中包含这些 WooCommerce 配送类别的商品时隐藏该方式。
Ignore shipping zones：无需将其添加到区域，即可为下方指定的国家提供 LP Express。关闭时，国家由添加了该方式的配送区域决定。建议这样设置。
Countries (without zones)：该模式下的目的国家。仅当 Ignore shipping zones 开启时才使用此字段。留空则对所有目的地提供该方式。
包裹终端
Terminal list：终端的来源。
Own terminal list：每行一个终端，格式为 ID | Name | City | Address | ZIP，例如 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150。ID 和 City 为必填项。以 # 开头的行会被忽略。请使用您的 Unisend 账户要求的终端 ID。
保存设置会重新加载终端列表。
高级
Debug log：将价格计算和终端列表详情记录到 WooCommerce > Status > Logs（来源 vfd-lp-express）。错误（例如终端列表不可用）始终会被记录。不记录任何客户数据。
Remove data on uninstall：开启后，删除插件会移除设置、区域方式和缓存的终端。停用插件永远不会删除设置。订单中保存的终端会被保留。
结账时的工作方式
当顾客输入收货地址时，WooCommerce 会向插件请求费率。插件检查购物车重量、最低购物车总额和排除的配送类别。如果没有可用的包裹终端，该方式会被隐藏，因此顾客永远不会看到无法完成的结账页面。如果适用免运费，价格为 0。否则，价格来自该国家的行（或 * 行）：先取重量列，若无则取基础价格，若无则取备用费用。如果没有价格，该方式会被隐藏。
在线终端列表缓存 24 小时。下载失败会记住 15 分钟，因此结账页面不会在每次刷新时都等待列表。下载超时时间为 10 秒。仅提供列表中有效的终端。
该方式适用于经典结账以及“购物车”和“结账”区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。价格以您的商店货币显示。插件不进行货币转换。
插件不查询 LP Express 或 Unisend 的价格，不创建运单，不打印面单，不呼叫快递员，也不跟踪包裹。请在您的 Unisend（"Mano siuntos"）账户中创建包裹。上门快递（送货到门）不属于本配送方式。
取件点
当顾客选择 LP Express 时，方式下方会出现两个列表：-- Select city -- 和 -- Select parcel terminal --。当收货地址的城市与列表中的某个城市匹配时，会预先选中该城市。每个终端都会显示名称、地址和邮政编码。选择会在结账过程中保留，因此结账页面刷新时不会丢失。
必须选择终端。在经典结账中，顾客会看到 Please select an LP Express parcel terminal. 在区块结账中，在选择终端之前 Place order 按钮会被禁用。两种结账方式下，服务器都会再次根据列表校验终端，因此伪造或过期的终端 ID 会被拒绝。
终端 ID、名称和城市会保存在订单中。它们会显示在订单页面的收货地址下方（含终端 ID）、订单接收页面、My account > Orders 中，以及订单电子邮件（HTML 和纯文本）中，标签为 LP Express parcel terminal。
许可证密钥
插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox LP Express 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥对应一个域名。从某个站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效的密钥时，LP Express 不会在结账时向顾客显示。已登录的商店管理人员仍然可以看到它，并标有 (unlicensed — visible to admins only)，以便您在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面上会出现提醒。现有订单不受影响。
许可证过期后，插件仍可继续工作，但更新和支持需要续订。状态会在后台自动重新检查。
故障排除
LP Express 未出现在结账页面：请检查许可证是否有效、Enable/Disable 是否已开启、该方式是否已添加到顾客所在国家的区域中（或已开启 Ignore shipping zones 且该国家被允许）。打开设置页面：红色通知会说明是否未设置价格或没有可用的包裹终端。另请检查重量限制、Minimum cart total 和 Excluded shipping classes。开启 Debug log 后，WooCommerce > Status > Logs（来源 vfd-lp-express）会显示该方式被隐藏的原因。
没有包裹终端：在线列表无法加载，且没有已保存的副本或您自己的列表。插件每 15 分钟重试一次。请在 Own terminal list 中输入您自己的列表，或选择 Only my own list。
终端列表已过期：保存设置页面。这会重新加载终端列表。使用您自己的列表时，请自行更新各行。
顾客无法下单：必须选择一个包裹终端。如果顾客看到 "The LP Express parcel terminal list is temporarily unavailable"，说明当前没有可用的终端。请添加您自己的列表。
价格使用哪种货币：以您的商店货币为准。插件不进行货币转换。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件会继续使用最后已知的状态工作。
卸载
停用插件会保留所有设置，仅清除缓存的终端列表。要完全移除，请先停用，然后在 Plugins 页面删除。本插件的许可证密钥、许可证状态和缓存始终会被删除。设置、区域方式以及终端列表的已保存副本仅在 Remove data on uninstall 开启时才会被删除；否则它们会保留，以便日后重新安装。订单中保存的终端永远不会被删除，现有订单也会保留其配送项。
LP Express 是其各自所有者的商标。本插件与 LP Express 没有关联，也未获得 LP Express 的认可。