从搜索适配器迁移到PLP小组件

检查当前Live Search版本：

composer show magento/live-search | grep version

如果使用的是版本3.x或更低版本，请在升级之前启用AdvancedSearch模块：

bin/magento module:enable Magento_AdvancedSearch

更新composer.json以要求Live Search 4.0或更高版本：

"require": {
   "magento/live-search": "^4.0"
}

运行升级：

composer update magento/live-search --with-dependencies

运行安装程序升级并重新编译：

bin/magento setup:upgrade
bin/magento setup:di:compile

部署静态内容（如果需要）：

bin/magento setup:static-content:deploy

审核自定义项：

• 在主题中记录所有自定义布局XML文件。
• 查看对产品列表页面或相关文件所做的任何自定义模板修改。
• 标识用于样式设置的自定义CSS类。
• 记录自定义JavaScript交互。

迁移到基于CSS的自定义项：

• PLP构件使用特定的CSS类（请参阅PLP样式指南）。
• 使用PLP小组件CSS类重新创建可视化自定义项。
• 测试自定义样式是否正确应用。

删除冲突的自定义项：

• 删除修改产品清单结构的布局XML。
• 清理定位搜索适配器特定元素的JavaScript。
• 更新模板将覆盖与构件渲染的冲突。

全面测试：

• 验证所有可视化自定义是否均可用于PLP小组件。
• 确保没有布局冲突。
• 在所有断点和设备上测试。

识别受影响的属性：

• 查看用作Facet的产品属性。
• 确定使用自定义源模型的受众。
• 记录当前彩块化配置。

升级并启用PLP小组件：

• 执行标准迁移步骤。
• PLP小组件支持自定义源模型属性。

重新配置Facet：

• 转到​Marketing > SEO和搜索> Live Search。
• 查看受影响属性的方面配置。
• 测试Facet可与自定义源模型正常配合使用。

验证：

• 使用自定义源模型Facet测试筛选。
• 验证所有属性值是否正确显示。
• 确保性能可接受。

实施自定义事件集合：

• 使用店面活动SDK。
• 捕获搜索和产品交互事件。
• 手动将事件推送到GTM数据层。

完成以下步骤：

• 审核当前GTM跟踪要求。
• 将GTM事件映射到Storefront事件。
• 实施自定义事件侦听器。
• 测试数据流到GTM。
• 验证Analytics报表。

查看引用实施：

• 研究PLP小部件源代码。
• 查看Live Search GraphQL的API文档。
• 了解目录服务查询。

实施自定义用户界面：

• 使用Live Search GraphQL API进行查询。
• 构建自定义产品列表组件。
• 实施用于分面的UI。
• 处理分页和排序。

实施事件集合：

• 查看店面活动文档。

• 实施所需事件：

  • search-request-sent
  • search-response-received
  • search-results-view
  • product-page-view
  • add-to-cart

• 测试事件数据流向Adobe Commerce。

配置Facet排序：

• 对于Headless实施，Facet可以按计数排序。
• 在​Live Search > Facets​工作区中进行配置。
• 将​ Sort Type ​设置为​ Count ​以获得更好的UX。

测试和验证：

• 验证搜索结果的准确性。
• 测试彩块化功能。
• 确认正确跟踪了事件。
• 监控性能指标。
• 验证智能促销功能是否有效。

记录现有自定义项：

• 列出对搜索适配器所做的所有自定义设置。
• 确定推动每次自定义的业务需求。
• 确定是否仍需要自定义。

检查内置功能是否满足您的需求：

• 查看PLP小部件功能。
• 检查基于CSS的自定是否足够。
• 测试默认PLP构件行为。

如果仍需要自定义代码：

• 克隆PLP小部件存储库。
• 实施您的自定义项。
• 在您自己的CDN上托管。
• 更新Commerce配置以使用您的自定义构件。

全面测试：

• 测试所有自定义功能。
• 确认Commerce更新不会破坏自定义设置。
• 记录您的自定义实施。
• 规划日常维护。