OpenCart 4
安装指南 · 1.0.0-rc1
此版本为候选发布版。正式上线前，请在测试站点上使用您的 CMS 版本、主题和项目公开令牌进行验证。本版本不宣称获得应用市场认证。
安装前
创建 Vinalfa 项目，激活 Trial 或订阅，并为公开 widget 令牌授权站点域名。此处不可使用服务器 Bearer 令牌。
安装与放置
- OpenCart 4.1：上传 vinalfa.ocmod.zip，安装扩展包，再在扩展列表中安装模块。
- 配置并启用实例，放入独立页面的全宽内容区。安装路径为 extension/vinalfa/，此包不适用于 OpenCart 3。
填写 CONFIG_ID、public widget token、语言及含 {article} 的商店 HTTPS 搜索地址。在 Vinalfa 项目中设置相同地址：项目设置可能覆盖适配器参数。请验证商店支持 OEM/SKU 搜索。
安装后
测试 VIN/FRAME → 车辆 → 零件图 → OEM 编号 → 商店搜索，并检查刷新、访问错误与配额限制。在宽度 320 px 起的手机上验证完整流程，同时检查缓存、CSP 和 JavaScript 优化工具。
原生适配器采用 hash 路由，无需额外服务器规则。主题、建站工具及 React/Vue 组件使用 iframe：目录内部位置不会保存在父页面地址中。
集成范围
提供目录、VIN/FRAME、零件图及商店搜索链接。价格、库存、购物车和订单仍由商店处理；不包含商品导入或价格同步。
移除
先移除页面中的目录及菜单链接，然后使用 CMS 的标准方式停用和卸载，或备份后仅删除新增文件。卸载 Bitrix 模块会保留组件与页面，完整清理需另行进行。
版本验证
插件已在使用 SQLite 的 WordPress 6.8.3 上验证激活、设置、短代码及卸载。其他 CMS 仅检查代码与独立适配场景，未完整安装 CMS。React/Vue 组件和安装器使用模拟 API 测试，未消耗 VIN 配额。