VibeFox SmartPost for WooCommerce — 帮助
要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。未安装 WooCommerce 时插件无法启用。
PHP：8.0 或更高版本，并启用 SimpleXML 扩展（大多数 PHP 安装都包含该扩展）。
SmartPost：无需 API 账户或密钥。取件点列表来自开放的 SmartPost 地点列表。SmartPost 没有公开的价格 API，因此您需要输入自己的（合同）运费。请在您的 SmartPost（SmartPosti）商业账户中创建包裹。
国家：SmartPost 取件点位于爱沙尼亚、拉脱维亚、立陶宛和芬兰。对于其他目的地国家，不会显示该配送方式。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_smartpost 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox SmartPost，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 在页面顶部检查价格表（默认价格已填好）、箱型尺寸和取件点状态。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox SmartPost 添加到包含爱沙尼亚、拉脱维亚、立陶宛和/或芬兰的一个或多个区域；或者开启 Ignore shipping zones 并选择国家。
配置
所有设置都在一个页面中：WooCommerce > Settings > Shipping > VibeFox SmartPost。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：顾客在该区域看到的名称。留空则使用全局的 Method title。
页面顶部的提示会显示问题和取件点状态。未设置任何价格时会出现红色提示，因为这种情况下结账时不会显示该方式。Pickup points available at checkout 区块会按国家显示有多少个取件点、分布在多少个城市中可用。它还会说明何时因 SmartPost 列表暂时不可用而使用已保存的副本、何时某个国家根本无法加载，以及何时某个国家没有价格。Refresh pickup point lists now 按钮会重新下载列表并显示新的数字。
常规
Enable/Disable：在所有区域同时启用或禁用 SmartPost。
Method title：显示给顾客的配送方式名称。区域方式中的 Title 会覆盖它。默认值：SmartPost parcel locker。
Tax status：Taxable 会将 WooCommerce 税费加到配送费用中，None 则不加。
价格（使用您商店的货币；小数可写作 3.50 或 3,50）
Price table：每个国家（爱沙尼亚、拉脱维亚、立陶宛、芬兰）一行，每个箱型 S、M、L 和 XL 各有一个价格，另有一列 Free from。0 表示免费。空单元格表示不提供该箱型：当包裹需要该箱型时，该方式会被隐藏。所有单元格都为空的国家不提供服务。Free from 是在该国家免运费的购物车金额门槛；若不提供免运费，请留空。不是数字的价格会在保存后提示，并保持为空。默认价格：爱沙尼亚 3.50、拉脱维亚 4.00、立陶宛 4.00、芬兰 5.00（每个箱型相同）。
Box sizes (cm)：每个箱子的内部尺寸，最短边在前（Side 1 (smallest)、Side 2、Side 3 (largest)）。商品的边长以同样方式排序后逐一比较，使用能装下的最小箱子。没有尺寸的商品放入 S 箱。无法装入任何箱子的包裹会隐藏该方式。商品尺寸会从商店的尺寸单位换算。默认值：S 12 x 36 x 60、M 20 x 36 x 60、L 36 x 38 x 60、XL 36 x 60 x 60。不是正数的尺寸会在保存后提示，且不会被更改。
Calculation：价格的计算方式。
可用性
Minimum weight (kg)：购物车低于该重量时隐藏该方式。留空或为 0 表示没有限制。
Maximum weight (kg)：购物车高于该重量时隐藏该方式。默认值：25。0 表示没有限制。
Minimum cart total：仅当购物车金额达到此值时才显示该方式。留空则始终显示。
Excluded shipping classes：购物车中包含这些 WooCommerce 配送类别的商品时，隐藏该方式。
Ignore shipping zones：不将 SmartPost 添加到区域，而是为下列国家提供该方式。关闭时，国家由添加了该方式的配送区域决定。推荐开启此选项。
Countries (without zones)：该模式下的目的地国家，可从爱沙尼亚、拉脱维亚、立陶宛和芬兰中选择。仅当 Ignore shipping zones 开启时才使用此字段。留空则在全部四个国家提供该方式。
取件点
Pickup point types：顾客可以选择的 SmartPost 取件点：Parcel lockers (APT)、Parcel boxes (IPB)、Parcel shops (PUDO) 和 Posti post offices (Finland)。留空则提供包裹柜、包裹箱和包裹店（默认）。可用类型取决于国家：例如，拉脱维亚只有包裹箱，而邮局仅存在于芬兰。
City order：开启时，主要城市排在前面（塔林、里加、维尔纽斯、赫尔辛基及其他大城市），其余城市按字母顺序排列。关闭时，所有城市按字母顺序排列。
高级
Debug log：将价格计算和取件点列表的详细信息记录到 WooCommerce > Status > Logs（来源 vfd-smartpost）。错误（例如取件点列表不可用）始终会被记录。不会记录任何顾客数据。
Remove data on uninstall：开启时，删除插件会移除设置、区域方式和缓存的取件点。停用插件绝不会删除设置。订单中保存的取件点会保留。
结账时的工作方式
顾客输入配送地址时，WooCommerce 会向插件请求费率。插件仅适用于爱沙尼亚、拉脱维亚、立陶宛和芬兰。它会检查购物车重量、最低购物车金额和排除的配送类别，为包裹找到箱子，并从收货国家所在的行中获取价格。如果箱子没有价格，或包裹无法装入任何箱子，该方式会被隐藏。如果该国家没有取件点（列表无法加载且没有已保存的副本），该方式同样会被隐藏，这样顾客就不会看到无法完成的结账页面。如果购物车金额达到该国家的 Free from，则价格为 0。
每个国家的取件点列表会缓存 24 小时，并保留最近一次成功列表的副本。下载失败会被记住 15 分钟，因此结账页面不会在每次刷新时都等待列表。下载超时时间为 15 秒。同一城市的不同写法（例如 Riga 和 Rīga）会显示为同一个城市。
该方式适用于经典结账页面以及“购物车”和“结账”区块。它兼容 WooCommerce 高性能订单存储（HPOS）。价格以您商店的货币为准。插件不进行货币换算。
插件不会查询 SmartPost 价格，不创建运单，不打印面单，不呼叫快递员，也不追踪包裹。请在您的 SmartPost（SmartPosti）商业账户中创建包裹。上门快递配送不属于此方式，也没有地图视图。
取件点
顾客选择 SmartPost 时，方式下方会出现两个列表：-- Select city -- 和 -- Select pickup point --。列表始终属于收货国家。在经典结账页面中，这是收货地址的国家；如果订单不寄往其他地址，则为账单地址的国家。国家变化时列表会重新生成。在区块结账页面中，列表跟随收货地址的国家。当收货地址中的城市与列表中的某个城市匹配时，会自动预选该城市。每个取件点都会显示名称和地址。该选择会在结账过程中保留，因此结账页面刷新时不会丢失。
取件点为必选项。在经典结账页面中，顾客会看到 Please select a SmartPost pickup point in the shipping country. 在区块结账页面中，在选择取件点之前 Place order 会被禁用。两种结账方式下，服务器都会再次根据收货国家的列表核对取件点，因此伪造或过期的取件点 ID，或其他国家的取件点，都会被拒绝。如果该国家的列表暂时不可用，顾客会看到提示，并可以选择其他配送方式。
取件点的 ID、名称、城市和国家会保存在订单中。它们会显示在订单页面的收货地址下方（包含地点 ID）、订单接收页面、My account > Orders 中，以及订单电子邮件（HTML 和纯文本）中，标签为 SmartPost pickup point。
要更改订单的取件点，请打开该订单并点击 SmartPost pickup point 旁边的 Change。选择订单收货国家中的一个城市和一个取件点。新取件点会立即保存，并且订单备注会记录旧取件点和新取件点。
许可证密钥
插件需要使用来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox SmartPost 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期至何时，以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，SmartPost 不会在结账时显示给顾客。已登录的店铺管理人员仍可看到它，并标有 (unlicensed — visible to admins only)，因此您可以在购买密钥之前设置并测试插件。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
SmartPost 没有出现在结账页面：请检查许可证是否有效、Enable/Disable 是否已开启、收货国家是否为爱沙尼亚、拉脱维亚、立陶宛或芬兰，以及该方式是否已添加到顾客所在国家的区域中（或已开启 Ignore shipping zones 且该国家被允许）。打开设置页面：提示会说明是否未设置任何价格、某个国家是否没有价格，或某个国家是否没有取件点。另请检查重量限制、Minimum cart total、Excluded shipping classes 和箱型尺寸：无法装入任何箱子的包裹，或价格单元格为空的箱子，都会隐藏该方式。开启 Debug log 后，WooCommerce > Status > Logs（来源 vfd-smartpost）会显示该方式被隐藏的原因。
顾客看到其他国家的取件点：列表跟随收货地址。请检查收货地址中填写的国家（如果订单不寄往其他地址，则检查账单地址）。下单时会拒绝其他国家的取件点。
某个国家没有取件点：SmartPost 列表无法加载，并且没有已保存的副本。插件每 15 分钟重试一次。稍后请点击 Refresh pickup point lists now。另请检查 Pickup point types 中是否包含该国家存在的类型。
取件点列表已过时：在设置页面点击 Refresh pickup point lists now。列表也会每 24 小时重新下载一次。
顾客无法下单：必须选择收货国家的取件点。如果顾客看到“The SmartPost pickup point list is temporarily unavailable”，说明该国家目前没有可用的取件点。
价格使用哪种货币：使用您商店的货币。插件不进行货币换算。
面向开发者：vfd_smpt_places_url 过滤器可更改某个国家的地点列表 URL（参数：URL、国家代码），例如改用返回相同 XML 的镜像站点。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件会继续使用最近一次已知的状态运行。
卸载
停用插件会保留所有设置，只清除缓存的取件点列表。要删除插件，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥、许可证状态和缓存始终会被删除。只有开启了 Remove data on uninstall 时，设置、区域方式以及取件点列表的已保存副本才会被删除；否则它们会保留，供以后重新安装时使用。订单中保存的取件点永远不会被删除，现有订单也会保留其配送项目。
SmartPost 和 SmartPosti 是其各自所有者的商标。本插件与 SmartPost 没有关联，也未获得 SmartPost 的认可。