VibeFox LP Express for OpenCart — 帮助

系统要求

OpenCart：3.0.x（已在 3.0.5.0 版本上测试）或 4.0.2 及更高版本（已在 4.1.0.3 上测试），使用默认主题和 OpenCart 标准结账流程。

PHP：8.0 或更高版本。

LP Express：无需 API 账户。LP Express 没有公开的运费 API，且本扩展不使用 Unisend API，因此您需要自行输入（合同）运费。请在您的 Unisend 账户（“Mano siuntos”）中创建包裹。

包裹终端列表：本扩展使用 LP Express 公开的终端列表（https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals）。无需密钥。如果该在线列表不可用，扩展会使用最后一次下载的副本（如有），否则使用您自己的列表。请准备好输入您自己的列表（参见“配置”）。

立陶宛：必须在 System > Localisation > Countries 中启用该国家。

VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。

安装

下载文件是一个 zip 压缩包，内含适用于两个 OpenCart 版本的安装包。请在您的电脑上解压。其中包含 README.txt、OpenCart 3 安装包 vfd_lp_express-oc3-(version).ocmod.zip 和 OpenCart 4 安装包 vfd_lp_express.ocmod.zip。只安装适用于您的 OpenCart 版本的安装包。两个版本的许可证密钥相同。

OpenCart 3

1. 在后台进入 Extensions > Installer，点击 Upload，然后选择文件 vfd_lp_express-oc3-(version).ocmod.zip。本扩展不添加任何 OCMOD 修改，因此无需刷新 Extensions > Modifications。您也可以不使用 Installer，而是将安装包中 upload 文件夹的内容复制到店铺的根目录。

2. 进入 Extensions > Extensions，选择扩展类型 Shipping。找到 VibeFox LP Express，点击 Install（绿色的 + 按钮）。

3. 点击 Edit（铅笔按钮）打开设置页面。

4. 在 Edit 页面顶部的许可证区块中，将 VibeFox 许可证密钥输入 License key 字段，然后点击 Activate（参见“许可证密钥”）。

5. 填写运费表格（至少一行；第一条新增行为立陶宛）或填写备用费用。检查页面顶部关于包裹终端的状态行；如果在线列表不可用，请添加您自己的终端列表。开启 Enable/Disable 并点击 Save。

OpenCart 4

1. 在后台进入 Extensions > Installer，点击 Upload，然后选择文件 vfd_lp_express.ocmod.zip。请勿重命名该文件：OpenCart 4 从文件名获取扩展代码，重命名后的安装包无法使用。

2. 该安装包会出现在同一页面的已安装扩展列表中。点击其旁边的 Install（绿色 + 按钮）。

3. 进入 Extensions > Extensions，选择扩展类型 Shipping。找到 VibeFox LP Express，点击 Install（绿色 + 按钮），然后点击 Edit（铅笔按钮）。

4. 按照 OpenCart 3 步骤 4 和 5 的方式输入许可证密钥和设置。两个版本的设置页面及其字段相同。

安装时，本扩展会创建两张小表（所选终端和终端列表缓存），并为结账页和订单页注册其 OpenCart 事件。在您开启 Enable/Disable 并保存之前，该配送方式处于关闭状态。如果您在卸载后重新安装本扩展，将重新使用您保留的设置。

配置

所有设置均位于扩展页面：Extensions > Extensions > Shipping > VibeFox LP Express > Edit。各分区列在左侧。页面底部的一个 Save 按钮可保存整个页面，无需重新加载。每次保存还会重新加载终端列表。只有拥有本扩展修改权限的管理员用户才能保存设置。

页面顶部的提示会显示问题和终端状态。当未设置任何运费或没有可用的包裹终端时会出现警告，因为此时该配送方式不会在结账时显示；当店铺没有单位为 kg 的重量等级时也会出现警告，因为此时商品重量将按其单位名称（kg、g、lb、oz）读取，其他任何单位都视为 kg。信息行会显示有多少个城市共有多少个可用包裹终端，以及数据来源：在线列表、在线列表的已保存副本（含日期）或您自己的列表。

保存时，如果方式标题为空或包含字符 < > ; = # { }，将被拒绝并显示 Enter a valid method title.；超过 64 个字符的标题同样会被拒绝。不是整数的排序值也会被拒绝。在这些情况下不会保存任何内容。不是数字（或为负数）的金额或重量会被提示，并保留其原值。大于 Maximum weight (kg) 的 Minimum weight (kg)（最大值为空时按 30 kg 计算）同样会被提示，因为该方式将永远不会显示；两个重量均保留原值。运费表中不是数字的价格会被提示并留空。其他值正常保存。

常规

Enable/Disable：在结账时显示或隐藏 LP Express（即本扩展的状态）。默认：off。

Method title：顾客在购物车和结账时看到的配送方式名称。默认：LP Express parcel terminal。必填，最多 64 个字符。

Tax class：--- None ---（默认）表示下列运费为最终价格。选择税类后，OpenCart 会在下列运费之上加收配送税。

Sort order：LP Express 在结账页配送方式中的位置。整数。

运费（以您店铺的默认货币计价，货币显示在分区标题中；小数可写作 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：运费的计算方式。

Per order (tier by total cart weight):整个购物车一个运费，根据购物车总重量选择重量列。这是默认设置。

Per item (each item priced by its own weight x quantity):每件商品按其自身重量乘以数量计价，然后将各项相加。

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：仅在达到该购物车金额时显示该方式（需要配送的商品，扣除折扣后，不含税）。留空则始终显示。

Geo zone：该方式仅对此地理区域内的地址提供。All Zones（默认）表示所有地区。地理区域在 System > Localisation > Geo Zones 中管理。当 Ignore shipping zones 开启时，不检查地理区域。

Ignore shipping zones：无论地理区域如何，都为下方列出的国家提供 LP Express。在此模式下不检查地理区域。关闭时，国家由地理区域决定。建议开启此项。默认：off。

Countries (without zones)：该模式下的目的国家。仅当 Ignore shipping zones 开启时使用此字段。留空则在所有国家提供该方式。

包裹终端

Terminal list：终端的来源。

LP Express online list：在线列表每天下载一次。无法加载时，使用最后一次下载的副本，然后使用下方您自己的列表。这是默认设置。

Only my own list：仅提供您在下方输入的终端。

高级

Debug log：将运费计算和终端列表的详细信息写入 storage/logs/vfd_lpex_debug.log.php（OpenCart 4 为 system/storage/logs/vfd_lpex_debug.log.php）。该文件无法通过网页读取。错误信息（例如终端列表不可用或订单没有终端）始终会被记录。不记录任何顾客数据。当文件达到 5 MB 时，将开始一个新的日志。

Log：显示日志的大小和最新条目。点击 Clear log 可清空日志。

Remove data on uninstall：开启时，卸载本扩展会删除设置、已保存的终端列表、日志以及未完成结账的终端。关闭（默认）时，设置会保留，以便重新安装。订单中保存的终端始终保留。

导入 / 导出

Export：点击 Download JSON 将设置保存为 JSON 文件。

Import：粘贴之前导出的 JSON，然后点击 Import 恢复设置，例如在另一家店铺中使用。这些值会像普通保存一样进行校验。

结账时的工作方式

OpenCart 显示配送方式时，会向本扩展请求 LP Express 的运费。如果设置了 Geo zone 且地址不在该区域内，则不提供 LP Express。开启 Ignore shipping zones 时不检查地理区域：LP Express 仅提供给列出的国家（列表为空时提供给所有国家）。只有 Requires Shipping 设为 Yes 的商品才计入：其他商品不增加重量，也不计入购物车金额。购物车金额是这些商品在优惠券折扣之后、税费之前的价格。礼品卡、奖励积分和店铺余额不计入在内。

本扩展会检查购物车重量和最低购物车金额。如适用免运费，则运费为 0。否则，运费取自该国家的行（或 * 行）：重量列；若无，则取基础运费；若仍无，则取备用费用。如果没有运费，或没有可用的包裹终端，该方式将被隐藏，以确保顾客不会看到无法完成的结账流程。

运费和金额以您店铺的默认货币计算。运费按其小数位数取整，并以顾客的货币显示，同时包含所选 Tax class 的税费。

在线终端列表缓存 24 小时。下载失败的情况会记住 15 分钟，因此结账页不会在每次刷新时都等待列表。下载超时时间为 10 秒。仅提供列表中处于活动状态的终端。没有城市的终端会列在 Other 下。

在 OpenCart 4 上，顾客在结账页的配送方式区块中点击 Choose，并在 Shipping method options 窗口中选择 LP Express。运费与 OpenCart 3 相同。

本扩展不会向 LP Express 或 Unisend 查询运费，不创建发货单，不打印面单，不呼叫快递员，也不追踪包裹。请在您的 Unisend 账户（“Mano siuntos”）中创建包裹。上门快递配送不属于此配送方式。

取件点

当顾客在配送方式步骤中选择 LP Express 时，其下方会显示 LP Express parcel terminal 区块，包含两个列表：-- Select city -- 和 -- Select parcel terminal --。仅在选择 LP Express 时才会加载终端列表。如果收货地址中的城市与列表中的某个城市匹配，则会预先选中该城市。每个终端均显示其名称、地址和邮编。所选结果会立即保存用于结账，因此在结账页刷新时不会丢失。

必须选择终端。顾客点击 Continue 时，服务器会再次对照列表检查终端。如果没有选择终端，结账页会显示 Please select an LP Express parcel terminal. 伪造或过期的终端 ID 会被拒绝，并显示 The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. 如果无法加载任何终端，顾客会看到 The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.

在 OpenCart 4 上，当顾客在 Shipping method options 窗口中选择 LP Express 时，LP Express 选项下方会出现包含两个列表的 LP Express parcel terminal 区块。该窗口的 Continue 按钮在未选择有效终端时不会继续，并显示相同的提示。

终端 ID、名称和城市会与订单一起保存。后台订单页面（Sales > Orders，订单信息）中的 LP Express parcel terminal 面板会显示城市、终端及其 Terminal ID。订单的配送方式会显示方式标题、冒号、城市和终端（例如 LP Express parcel terminal: Kaunas, …），因此会出现在顾客的订单详情、订单邮件和发票中。如果订单没有终端，后台订单页面会显示 No parcel terminal was chosen for this order. 在扩展被禁用期间下的订单，该面板同样会显示。在 OpenCart 4 上，该面板显示在 History 上方。OpenCart 4 对结账保留一个订单，并在顾客每次重新确认时更新它，订单的终端也会随之更新。如果顾客将该订单改用其他配送方式，其终端将被移除。

许可证密钥

本扩展需要一个来自 vibefox.net 的 VibeFox 许可证密钥。License — VibeFox LP Express 许可证区块是 Extensions > Extensions > Shipping > VibeFox LP Express > Edit 页面中位于设置上方的第一个区块。将密钥粘贴到 License key 中，然后点击 Activate。之后，该区块会以掩码形式显示密钥、状态（例如许可证的有效截止日期和您的域名），并提供 Check now（重新检查状态）、Change key（输入其他密钥）和 Remove key（从本店铺移除密钥）按钮。其下方是 Product: opencart-shipping-lp-express 一行，以及打开您 vibefox.net 账户的 Manage licenses and domains in your account 链接。只有拥有本扩展 Modify 权限的管理员用户才能更改密钥。该区块的文字跟随后台语言显示（包含英文和俄文）。

如果密钥未被接受，区块会说明原因，例如 Key not found、This key belongs to another product、Domain limit reached 或 License expired on 加上日期。更改店铺地址后，或在您的账户中释放一个域名名额后，请点击 Check now。如果无法连接许可证服务器，扩展会继续使用最后已知的状态运行。

一个密钥只能用于一个域名：即 OpenCart 配置中的店铺地址。从店铺中移除密钥不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。

没有有效的密钥时，LP Express 配送方式不会在结账时显示给顾客，也不会计算任何运费。在同一浏览器中登录后台的管理员用户仍可在店铺中看到该方式，并标注 (unlicensed — visible to admins only)，因此您可以在购买密钥之前进行设置和测试。在 OpenCart 4 上此预览不可用：店铺看不到后台登录状态，因此没有有效密钥时，该方式对所有人都隐藏。打开一次 Edit 页面后，后台 Dashboard 上会出现提醒。点击 × 可将其隐藏 7 天。现有订单不受影响。

许可证过期后，扩展仍会继续工作，但更新和支持需要续费。每次打开后台 Dashboard 或 Edit 页面时都会自动重新检查状态：输入密钥后的前 14 天每天一次，之后每周一次。无需 cron 任务。卸载扩展时，始终会删除许可证密钥和许可证状态。

故障排除

结账时没有显示 LP Express：检查许可证是否有效，并且 Enable/Disable 已开启。检查 Geo zone（或确认 Ignore shipping zones 已开启且该国家已被允许）。打开扩展页面：警告会说明是否未设置运费或没有可用的包裹终端。另外还要检查重量限制和 Minimum cart total，以及商品的 Requires Shipping 是否设为 Yes。开启 Debug log 后，扩展页面上的 Log 字段会显示该方式被隐藏的原因。

没有包裹终端：在线列表无法加载，且既没有已保存的副本，也没有您自己的列表。扩展每 15 分钟重试一次。请在 Own terminal list 中输入您自己的列表，或选择 Only my own list。

终端列表已过时：在扩展页面点击 Save，这会重新加载终端列表。如果使用您自己的列表，请自行更新各行。

顾客无法继续：必须选择一个包裹终端。如果顾客看到终端列表暂时不可用的提示，说明当前没有可用的终端。请添加您自己的列表。

终端选择器没有出现：该选择器添加在 OpenCart 标准结账页的配送方式步骤中（OpenCart 4 上位于 Shipping method options 窗口），并已在默认主题上测试。经过大幅修改的主题或第三方结账扩展可能不会显示它。

运费使用哪种货币：以您店铺的默认货币计价。以其他货币付款的顾客会看到按 OpenCart 汇率换算后的价格。

页面显示 "Warning: You do not have permission to modify VibeFox LP Express!"：您的管理员用户组只能查看设置。请在 System > Users > User Groups 中为该用户组授予 extension/shipping/vfd_lp_express（OpenCart 3）或 extension/vfd_lp_express/shipping/vfd_lp_express（OpenCart 4）的修改权限。

开发者说明：终端列表的地址可以通过设置 vfd_lpex_feed_url（用于测试）进行替换；该设置在设置页面中没有对应的字段。

卸载

进入 Extensions > Extensions，选择 Shipping 类型，然后点击 VibeFox LP Express 旁边的 Uninstall（红色的 − 按钮）。本扩展的许可证密钥和许可证状态始终会被删除。OpenCart 总会重置 Enable/Disable、Sort order、Tax class 和 Geo zone。扩展的事件总会被移除，缓存的终端列表也会被清除。如果 Remove data on uninstall 已开启，设置、日志、已保存的终端列表副本以及未完成结账的终端也会被删除。如果已关闭，其他设置和已保存的副本会被保留，并在您重新安装本扩展时再次使用。订单中保存的终端永远不会被删除，现有订单会在其配送方式中保留该终端。

在 OpenCart 4 上，如需同时删除扩展文件，请在卸载后进入 Extensions > Installer，在已安装扩展列表中点击 VibeFox LP Express 旁边的 Uninstall（橙色 − 按钮），然后点击 Delete（红色垃圾桶按钮）删除已上传的安装包。

LP Express 是其各自所有者的商标。本扩展与 LP Express 没有关联，也未获得 LP Express 的认可。