README

Luigi's Box 是一个获奖的电子商务搜索解决方案，提供搜索分析和搜索即服务。

此仓库包含 Shopware 5 插件的 composer 包，提供 Shopware 商店与 Luigi's Box 服务的集成。要使用它，您需要在 Luigi's Box 平台上有一个账户。如果没有，请创建一个。

!!! 此解决方案并非旨在用于生产环境。将其用作实现 Luigi's Box 与 Shopware5 之间同步的灵感的参考。

基本信息

插件使用 Guzzle Http 5。

• plugin.xml - 描述插件元数据和与其他插件的依赖关系。目前，仅需要 Cron 插件来运行计划任务。
• LuigisBoxSearchSuite.php - 包含主要事件处理器，确保产品目录的任何更改都传播到 Luigi's Box 后端。更多信息请参见实现。

辅助工具

• Models\Helper.php - 包含检查是否需要执行计划任务的辅助函数。

资源

• config.xml - 描述用户界面，并由 ShopWare 选取以构建插件的设置表单。
• cronjob.xml - 安排夜间计划任务事件，同步所有产品到 Luigi's Box 后端。插件已订阅。
• menu.xml - 手动运行索引的菜单项
• views - 包含覆盖的模板文件。

安装

• 请确保 Shopware 中已启用 Cron 插件。打开插件管理器（Ctrl+Alt+P），然后检查“Cron”是否由“Shopware AG”安装在已安装且启用的插件中。
• 从 composer 需求插件 composer require luigisbox/search-suite-shopware5
• 刷新插件列表并通过命令行或从后端激活。

$ php ./bin/console sw:plugin:refresh
Successfully refreshed

$ php ./bin/console sw:plugin:install --activate luigisbox/search-suite-shopware5

完成这些步骤后，安装就完成了。现在请通过插件管理器转到插件的配置，并在那里进行配置。

配置完成后，您可以继续以下操作：

• 清除缓存 配置 > 缓存 / 性能 > 清除商店缓存 或从命令行 php bin/console sw:cache:clear
• 手动通过 php bin/console sw:cron:run Shopware_CronJob_SendToLuigisBoxApi 或通过营销 > Luigi's Box Search Suite 索引菜单调用操作来运行目录的初始同步。

!!! 清除缓存步骤非常重要。确保在更改插件配置后清除缓存。否则，配置更改将无法被选中。

最后，您必须确保在您的 Shopware 实例上定期执行计划任务。如果您使用 cron 执行其他任务，则您的 Shopware 实例可能已经设置了此设置。有关更多详细信息，请参阅 Shopware 在线文档。

作为快速参考，我们建议通过调整 crontab 每隔 5 分钟运行计划任务如下

*/5 * * * * cd /path/to/your/shopware-installation && php bin/console sw:cron:run

请确保此设置为与运行 Shopware 的同一用户（例如，www-data）相同。

手动索引和计划任务调整

您可以通过在营销 > Luigi's Box Search Suite 索引菜单项后点击“立即重新索引”按钮来始终触发手动重新索引。

如果您想调整每日全索引重置的时间，您可以在配置 > 基本设置 > 系统 > Cron任务中进行设置。您要查找的任务名称为 Shopware_CronJob_SendToLuigisBoxApi。

如果您想更改默认的5分钟窗口，您可以通过编辑第二个cron任务的属性，即 Shopware_CronJob_UpdateLuigisBoxApi 来完成。