README

功能

Algolia 扩展将 Magento Open Source 和 Adobe Commerce 的默认搜索替换为一个强大的自动完成搜索菜单和即时搜索结果页面。

此扩展替换了 Magento 的默认搜索，提供了一个容错、快速且相关的搜索体验，由 Algolia 支持。它基于 algoliasearch-client-php、autocomplete.js 和 instantsearch.js。

• 自动完成菜单：通过下拉菜单立即向最终用户提供整个目录，无论其中包含多少类别或属性。

• 即时搜索结果页面：每次键入后，实时更新搜索结果页面、导航和分页。

• 推荐：Algolia Recommend 允许您在产品详情页面上显示“经常一起购买”和“相关产品”等推荐功能。

更多详情请访问我们的 官方网站 Adobe Commerce / Magento

演示

在我们的 实时演示 中尝试自动完成和即时搜索结果页面。

兼容性及版本到期

Algolia 扩展不再支持 Magento 2.3 及更早版本。

我们扩展的 3.x 版本与 Magento 2.4 兼容。请查阅 定制 部分，了解更多关于我们扩展版本之间差异的信息。

文档

• 快速入门和安装
• 常见问题解答
• 技术故障排除指南
• 索引队列
• 前端自定义事件
• 后端事件

安装

安装扩展的最简单方法是使用 Composer 并遵循我们的 入门指南。

如果您想保持次要版本，请将您的 composer 升级到仅接受次要版本。以下示例将保持您在次要版本，并自动更新补丁。

"algolia/algoliasearch-magento-2": "~3.14.2"

定制

该扩展使用库来协助实现自动完成、即时搜索和洞察功能的前端。它还使用 Algolia PHP 客户端利用后端索引和搜索方法。当您对其中任何一个进行定制时，您必须了解您正在定制实现本身，而不是其基于的组件。

这些库旨在帮助您进行定制，但由于扩展已经初始化了这些组件，您应使用扩展和库之间的区域钩子。请参阅我们的 自定义扩展 以获取参考。

扩展 JS 包

了解库的版本将帮助您了解可用于定制的库中有什么。此表将帮助您确定开始定制时应参考哪些文档。

自动补全和即时搜索库可在全局的algoliaBundle中使用。这个包是一个预打包的JavaScript文件，其中包含了它的依赖项。这个包中包含的内容可以在此处查看

v3.x最新包：https://github.com/algolia/algoliasearch-extensions-bundle/blob/ISv4/package.json

search-insights.js库是独立的。

当您自定义Algolia Magento扩展的前端功能时，请参考这些文档

• 自动补全
• 即时搜索
• 前端自定义事件

Algolia PHP API客户端

在收集和准备需要索引到Algolia的数据方面，此扩展做了大部分繁重的工作。在交互Algolia搜索API方面，该扩展利用PHP API客户端进行后端方法，包括索引、配置和搜索查询。

根据您使用的扩展版本，您可能有一个不同的PHP API客户端版本来支持扩展的后端功能。

当您自定义Algolia Magento扩展的后端时，请参考这些文档

• 索引
• 后端事件

支持

对于扩展的反馈、错误报告或未解决的问题，请访问我们的支持中心，您可以在知识库中搜索并联系支持团队。请包括您的Magento版本、扩展版本、应用ID以及重现您问题的步骤。添加额外的信息，如截图、屏幕录制和错误消息，以帮助我们的团队更好地调试您的问题。

贡献

要开始对扩展进行贡献，请遵循贡献指南。