VibeFox LP Express for PrestaShop — 帮助
系统要求
PrestaShop：8.0 至 9.x。
PHP：8.0 或更高版本。模块拒绝在较旧的 PHP 版本上安装。
LP Express：无需 API 账户。LP Express 没有公开的价格 API，模块也不使用 Unisend API，因此您需要输入自己的（合同）价格。请在您的 Unisend（“Mano siuntos”）账户中创建包裹。
包裹终端列表：模块使用 LP Express 公开的终端列表（https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals）。无需密钥。如果此在线列表不可用，模块会使用最近下载的副本（如有），否则使用您自己的列表。请准备好输入您自己的列表（参见“配置”）。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在后台进入 Modules > Module Manager，点击 Upload a module。选择模块的 ZIP 文件。
2. 上传完成后，点击 Configure；或者稍后在模块列表中找到 VibeFox LP Express，然后点击 Configure。
3. 在 Configure 页面顶部的许可证区块中的 License key 处粘贴您的 VibeFox 许可证密钥，然后点击 Activate（参见“许可证密钥”）。
4. 填写价格表（至少一行）或备用费用。查看页面顶部关于包裹终端的状态行；如果在线列表不可用，请添加您自己的终端列表。点击 Save。
安装时，模块会创建 LP Express parcel terminal 承运商，配送时间文字为 Delivery to an LP Express parcel terminal。该承运商被分配到立陶宛区域和所有客户群组。您可以在 Shipping > Carriers 中添加区域，并更改客户群组、配送时间、徽标和尺寸限制。请勿在那里设置价格：价格始终来自模块。
配置
所有设置都在模块页面中：Modules > Module Manager > VibeFox LP Express > Configure。每个部分都有自己的 Save 按钮，它会保存整个页面。每次保存也会重新加载终端列表。
页面顶部的提示会显示问题和终端状态。当未设置任何价格或没有可用的包裹终端时会出现警告，因为此时承运商不会在结账时显示；承运商被删除时也会出现警告；店铺的重量单位不是模块支持的单位（kg、g、lb、oz）时同样会警告，因为此时商品重量会被当作 kg 读取。信息行会显示有多少个城市、多少个包裹终端可用，以及来源：在线列表、在线列表的已保存副本（含日期）或您自己的列表。
保存时，如果方式标题为空或不适合作为承运商名称，将被拒绝并提示 Enter a valid method title.；超过 64 个字符的标题同样会被拒绝。在这两种情况下都不会保存任何内容。不是数字（或为负数）的金额或重量会被提示，并保留其先前的值。大于 Maximum weight (kg)（最大值为空时为 30 kg）的 Minimum weight (kg) 也会被提示，因为承运商将永远不会显示；两个重量都保留其先前的值。表格中不是数字的价格会被提示并留空。
常规
Enable/Disable：开启或关闭 LP Express。这与 Shipping > Carriers 中承运商的状态是同一个开关。
Method title：客户在购物车和结账时看到的承运商名称。默认值：LP Express parcel terminal。必填。
Tax status：None 表示下方价格为最终价格。Taxable 加上税务规则（店铺的每个税务规则对应一个选项）表示 PrestaShop 会在下方价格之上加上该配送税。这是承运商的税务规则。
价格（以店铺默认货币计；小数可写作 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 表示无限制。留空表示在承运商的区域中为 30 kg，仅对 Ignore shipping zones 中不在这些区域内的国家不设限制。
Minimum cart total：仅当购物车总额达到此金额时才显示承运商（需要配送的商品，扣除折扣后，不含税）。留空则始终显示。
Ignore shipping zones：无需您自行设置区域，即可为下方所列国家提供 LP Express。此时承运商会关联到每个启用的区域（包括之后创建的区域）。承运商之前已有的区域对其所有国家仍然有效。当您再次关闭该选项时，承运商会恢复之前的区域。关闭时，国家由 Shipping > Carriers 中承运商的区域决定。建议使用此方式。
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：将价格计算和终端列表的详细信息写入模块文件夹中的 logs/vfd_lpex_debug.log.php。该文件无法通过网页打开。错误（例如终端列表不可用）始终会被记录。不记录任何客户数据。
Log：显示日志的大小和最新条目。点击 Clear log 可将其清空。
Remove data on uninstall：开启时，卸载模块会删除设置、承运商和已保存的终端列表。关闭时，卸载只会关闭承运商。订单中保存的终端始终会保留。
结账时的工作方式
在配送步骤中，PrestaShop 会向模块请求 LP Express 的价格。只有实物商品计入：虚拟商品不增加重量，也不计入购物车总额。模块会检查 Ignore shipping zones 中的国家、购物车重量和最低购物车总额。如果适用免运费，价格为 0。否则，价格来自该国家的行（或 * 行）：重量列；若无，则为基础价格；若仍无，则为备用费用。如果没有价格，或没有可用的包裹终端，承运商将被隐藏，因此客户永远不会看到无法完成的结账流程。
价格和金额以店铺默认货币计算。随后，价格会使用 PrestaShop 汇率，以客户的购物车货币显示。
在线终端列表会缓存 24 小时。下载失败会被记住 15 分钟，因此结账不会在每次刷新时都等待列表。下载超时时间为 10 秒。仅提供列表中的活动终端。
如果您在订单产生后于 Shipping > Carriers 中编辑承运商，PrestaShop 会将其保存为承运商的新版本。模块会自动跟随新版本。
模块不会查询 LP Express 或 Unisend 的价格，不创建运单，不打印面单，不呼叫快递员，也不跟踪包裹。请在您的 Unisend（“Mano siuntos”）账户中创建包裹。上门快递配送不属于此承运商。
取件点
当客户选择 LP Express 时，承运商下方会出现 LP Express parcel terminal 区块，其中包含两个列表：-- Select city -- 和 -- Select parcel terminal --。如果收货地址的城市与列表中的某个城市匹配，则会预先选中该城市。每个终端都会显示其名称、地址和邮编。所选终端会立即保存到购物车中，因此在结账刷新时不会丢失。它适用于 Classic 和 Hummingbird 主题。
必须选择一个终端。未选择时，配送步骤中的 Continue 和 Place order 会显示 Please select an LP Express parcel terminal. 当客户点击 Continue 时，服务器会再次对照列表检查终端，因此伪造或过期的终端 ID 会被拒绝，并显示 The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.
终端 ID、名称和城市会与订单一起保存。它们会显示在后台订单页面的 LP Express parcel terminal 区块中（含 Terminal ID）、订单确认页面以及客户的订单详情中。在订单确认邮件和发给商家的新订单邮件中，它们会以 LP Express parcel terminal: 的形式附加到承运商名称之后，后面跟随终端信息。如果订单没有终端，后台订单页面会显示 No parcel terminal was chosen for this order.
许可证密钥
模块需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块 License — VibeFox LP Express 是 Modules > Module Manager > VibeFox LP Express > Configure 页面中的第一个区块，位于设置上方。将密钥粘贴到 License key 中，然后点击 Activate。此后，该区块会显示隐藏部分字符的密钥、状态（例如许可证有效期截止日期和您的域名），以及以下按钮：Check now（重新检查状态）、Change key（输入其他密钥）和 Remove key（从本店铺中移除密钥）。它们下方是 Product: presta-shipping-lp-express 一行和 Manage licenses and domains in your account 链接，后者会打开您的 vibefox.net 账户。只有拥有该模块 Configure 权限的员工才能更改密钥。区块中的文字遵循后台语言（包括英语和俄语）。
如果密钥未被接受，该区块会说明原因，例如 Key not found、This key belongs to another product、Domain limit reached，或带日期的 License expired on。在店铺地址变更后，或在您的账户中释放了一个域名名额后，请点击 Check now。如果无法连接许可证服务器，模块会继续使用最后已知的状态运行。
一个密钥只能用于一个域名：主店铺的域名，多店铺配置中也是如此。从店铺中移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，结账时不会向客户显示 LP Express 承运商，也不会计算费率。PrestaShop 前台不知道您已登录后台，因此该承运商对您也会被隐藏：您可以在购买密钥之前设置模块，但无法在结账时测试。Modules > Module Manager 中的 Alerts 选项卡会显示提醒。现有订单不受影响。
许可证过期后，模块仍会继续运行，但更新和支持需要续期。您在后台工作时会自动重新检查状态：输入密钥后的前 14 天每天一次，之后每周一次。无需 cron 任务。卸载或重置模块时，始终会删除许可证密钥和许可证状态。
故障排除
结账时没有显示 LP Express：请检查许可证是否有效，以及 Enable/Disable 是否已开启。在 Shipping > Carriers 中，检查承运商是否覆盖客户所在国家的区域以及客户的群组（或者 Ignore shipping zones 已开启且该国家被允许）。打开模块页面：警告会说明是否未设置价格或没有可用的包裹终端。还要检查重量限制和 Minimum cart total。商品详情页也可能将商品限制为特定承运商。开启 Debug log 后，模块页面上的 Log 字段会显示承运商被隐藏的原因。
没有包裹终端：无法加载在线列表，而且没有已保存的副本或您自己的列表。模块每 15 分钟重试一次。请在 Own terminal list 中输入您自己的列表，或选择 Only my own list。
终端列表已过时：在模块页面点击 Save，这会重新加载终端列表。使用您自己的列表时，请自行更新各行。
客户无法继续：必须选择一个包裹终端。如果客户看到 The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.，说明目前没有可用的终端。请添加您自己的列表。
价格使用哪种货币：使用店铺的默认货币。使用其他货币付款的客户会看到按 PrestaShop 汇率换算后的价格。
页面提示未找到 LP Express 承运商：承运商已在 Shipping > Carriers 中被删除。请在 Modules > Module Manager 中重置模块以重新创建它。
卸载
进入 Modules > Module Manager，打开 VibeFox LP Express 旁边的菜单，然后选择 Uninstall。许可证密钥和许可证状态总会被删除。缓存的终端列表总会被清除。如果 Remove data on uninstall 已开启，承运商会被删除（订单保留其历史记录），设置、日志以及已保存的终端列表副本也会被删除。如果已关闭，承运商只会被关闭，所有设置和已保存的副本都会保留。重新安装模块会使已保存的承运商恢复其原有状态。订单中保存的终端永远不会被删除。
LP Express 是其各自所有者的商标。本模块与 LP Express 没有关联，也未获得 LP Express 的认可。