1С-Битрикс · vinalfa.catalog / 1С-Битрикс · vinalfa:catalog
安装指南 · 1.0.0-rc1
此版本为候选发布版。正式上线前，请在测试站点上使用您的 CMS 版本、主题和项目公开令牌进行验证。本版本不宣称获得应用市场认证。
下载 ZIP — 1С-Битрикс · vinalfa.catalog · 下载 ZIP — 1С-Битрикс · vinalfa:catalog
安装前
创建 Vinalfa 项目，激活 Trial 或订阅，并为公开 widget 令牌授权站点域名。此处不可使用服务器 Bearer 令牌。
安装与放置
- 模块方式：将 local/modules/vinalfa.catalog/ 解压到站点根目录，再通过 Bitrix 模块列表安装。
- 也可仅复制 local/components/vinalfa/catalog/，不安装模块。在独立页面放置 vinalfa:catalog 并填写组件参数。两种方式选其一。
填写 CONFIG_ID、public widget token、语言及含 {article} 的商店 HTTPS 搜索地址。在 Vinalfa 项目中设置相同地址：项目设置可能覆盖适配器参数。请验证商店支持 OEM/SKU 搜索。
<?php
$APPLICATION->IncludeComponent('vinalfa:catalog', '', [
'config_id' => 'YOUR_CONFIG_ID',
'public_token' => 'YOUR_PUBLIC_WIDGET_TOKEN',
'search_url' => 'https://YOUR-STORE.example/search/?q={article}',
'language' => 'zh',
'CACHE_TYPE' => 'N'
]);安装后
测试 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 配额。