algoliasearch magento 2

Magento 2 的 Algolia 搜索和发现扩展

---

特征

Algolia 扩展使用强大的自动完成搜索菜单和即时搜索结果页面取代了 Magento Open Source 和 Adob​​e Commerce 中的默认搜索。

此扩展用 Algolia 支持的容错、快速且相关的搜索体验取代了 Magento 的默认搜索。它基于 algoliasearch-client-php、autocomplete.js 和 instantsearch.js。

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

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

• 推荐： Algolia Recommend 可让您在产品详细信息页面上显示推荐，例如“经常一起购买”和“相关产品”功能。

请访问我们的官方网站 Adob​​e Commerce / Magento 了解更多信息

演示

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

Magento 2.4 兼容性和扩展版本生命周期终止

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

我们的扩展版本 3.x 与 Magento 2.4 兼容。查看自定义部分以了解有关我们的扩展版本之间的差异的更多信息。

扩展版本	生命终结	马根托	PHP
v3.7.x	10/10/2023	~2.3.7||~2.4.5||~2.4.6	~7.3.0||~7.4.0||~8.1.0||~8.2.0
v3.8.x	2023 年 3 月 8 日	~2.4.5||~2.4.6	~7.4.0||~8.1.0||~8.2.0
v3.9.x	2023年10月13日	~2.4.5||~2.4.6	~7.4.0||~8.1.0||~8.2.0
v3.10.x	12/12/2023	~2.4.6	~8.1.0||~8.2.0
v3.11.x	2024 年 1 月 26 日	~2.4.6	~8.1.0||~8.2.0
v3.12.x	2024 年 8 月 2 日	~2.4.6	~8.1.0||~8.2.0
v3.13.x	不适用	~2.4.6	~8.1.0||~8.2.0
v3.14.x	不适用	~2.4.6||~2.4.7	~8.1.0||~8.2.0||~8.3.0

文档

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

安装

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

如果您想保留次要版本，请升级您的作曲家以仅接受次要版本。以下示例将使您保持次要版本并自动更新补丁。

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

定制化

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

这些库可以帮助添加到您的自定义中，但由于扩展已经初始化了这些组件，因此您应该在扩展和库之间的区域中使用挂钩。请查看我们的自定义扩展以供参考

JS 扩展包

了解库的版本将帮助您了解这些库中的可用内容供您在自定义方面利用。此表将帮助您确定在开始进行定制时要参考哪些文档。

扩展版本	自动完成.js	即时搜索.js	搜索-insights.js	推荐.js
v3.x	0.38.0	4.15.0	1.7.1	不适用
v3.9.1	1.6.3	4.41.0	1.7.1	1.5.0
v3.10.x	1.6.3	4.41.0	1.7.1	1.8.0
v3.11.0	1.6.3	4.41.0	2.6.0	1.8.0
v3.13.0	1.6.3	4.63.0	2.6.0	1.8.0
>=v3.14.x	1.6.3	4.63.0	2.6.0	1.15.0

自动完成和即时搜索库可以在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 Search API 交互方面，该扩展利用 PHP API 客户端实现后端方法，包括索引、配置和搜索查询。

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

扩展版本	API客户端版本
v3.x	2.5.1
v3.6.x	3.2.0
v3.11.0	3.3.2
>=v3.14.x	4.0.x

自定义 Algolia Magento 扩展后端时请参阅以下文档：

• 索引
• 调度后端事件

支持

有关扩展程序的反馈、错误报告或未解决的问题，请访问我们的支持中心，您可以在其中搜索知识库并联系支持团队。请提供您的 Magento 版本、扩展版本、应用程序 ID 以及重现问题的步骤。添加屏幕截图、截屏视频和错误消息等其他信息，以帮助我们的团队更好地解决您的问题。

贡献

要开始为扩展做出贡献，请遵循贡献指南。