README

Tooso 是一个基于云的多语言电子商务搜索工具。

此扩展用 Tooso（Tooso）提供的 typo-tolerant、快速和相关的搜索体验替换了 Magento 的默认搜索。

描述

此扩展用基于 Tooso API 的搜索引擎替换了默认的 Magento 搜索引擎。它提供以下功能

• 对目录产品进行全文搜索（目前不支持高级搜索）
• 目录产品计划索引
• 自动拼写纠正
• 搜索关键字建议

要求

此模块的唯一要求是默认的 Magento cronjob 正确配置。以下是一个好的配置示例

*/5 * * * * php -f /absolute/path/to/magento/cron.sh > /dev/null 2>&1

这将每5分钟运行一次 Magento 作业计划。 注意： Tooso 索引流程每15分钟启动一次。

以下是一些关于如何使用 Cpanel 和 Plesk 添加 cron 作业的额外信息，它们是最受欢迎的 Web 控制面板之一

• CPanel - 添加 cron 作业
• Plesk - 如何设置 cron 作业

如果您无法访问服务器配置，请要求您的托管服务提供商为您配置 crontab。

外部依赖

Mobile Detect

它位于 lib/Bitbull/Mobile 目录下，主类文件已从 Mobile_Detect 重命名为 Detect.php，类名已重命名为 Bitbull_Mobile_Detect。这通过防止与其他模块的兼容性问题。Mobile Detect 类可以通过 Bitbull_Mobile_Detect 全局访问。

安装说明

您可以使用以下方法安装此扩展

手动复制文件

从 src 目录递归地复制所有文件和目录到您的文档根目录。

使用 Composer

如果您使用 Composer 来管理模块依赖项，您可以通过将此存储库添加到您的 composer.json 文件来安装模块

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/bitbull-team/Bitbull_Tooso"
        }
    ]
}

然后，您可以将模块依赖项添加到

{
    "require": {
        "magento-hackathon/magento-composer-installer": "*",
        "bitbull/magento-tooso-search": "1.0.*"
    }
}

最后，您可以在项目根目录内启动命令 composer update。

无论您选择哪种方法，安装后您都需要清除缓存并从管理面板注销，然后再次登录。

自定义重新索引流程

默认情况下，目录重新索引过程每15分钟启动一次。这是通过标准 Magento cron 框架完成的（更多信息 这里）。您可以编辑 app/code/community/Bitbull/Tooso/etc/config.xml 文件来自定义重新索引计划的频率

    <crontab>
        <jobs>
            <tooso_reindex>
                <schedule>
                    <cron_expr>*/15 * * * *</cron_expr>
                </schedule>
                <run>
                    <model>tooso/observer::rebuildIndex</model>
                </run>
            </tooso_reindex>
        </jobs>
    </crontab>

您可以使用任何标准的 cron 表达式 来更改 <cron_expr> 节点的值。

模块配置

请求您的 API 密钥

发送电子邮件到 info@tooso.ai 请求您的 APIKEY

设置您的 API 密钥

1. 在 API 配置 下方

• 将您的 API 密钥插入 API 密钥 字段
• 将 http://v{apiVersionWithNoDot}.api.tooso.ai 插入到 API基本URL 字段。当前支持的版本是1，因此占位符 {apiVersionWithNoDot} 应该替换为1。
• 发送报告：当API发生错误时，选择 是 以发送报告到Tooso。
• 强制记录：选择 是 以在启用记录的情况下强制记录到 {{base_dir}}/var/log/tooso_search.log。
• 调试模式：选择 是 以启用更详细的日志记录，以便进行调试。

1. 保存配置

• 如果您处于早期采用者阶段，强烈建议在 API配置 下启用 发送报告 和 强制记录 配置。这将使Tooso支持团队拥有更多信息，以便在发生错误时帮助您进行故障排除。请注意：要能够向Tooso发送报告，您的Magento安装需要能够发送电子邮件。

集成您的目录

1. 在系统 -> 配置 -> Tooso搜索引擎下访问扩展配置。
2. 在 激活Tooso 下设置以下参数

• 启用搜索：否
• 启用索引：是
• 启用跟踪：否

1. 保存配置

激活搜索栏和跟踪

一旦您的目录与Tooso集成，您将收到Tooso团队成员的通知，您可以选择启用搜索和跟踪

1. 在系统 -> 配置 -> Tooso搜索引擎下访问扩展配置。
2. 在 激活Tooso 下设置以下参数

• 启用搜索：是
• 启用索引：是
• 启用跟踪：是

1. 保存配置

重要：关于我们的早期采用者计划有任何问题，请随时联系我们的CCO mattia.pavoni@tooso.ai；对于技术问题，直接联系我们的CTO jacopo.tagliabue@tooso.ai。

技巧与窍门

如果您在Magento前面使用代理，例如负载均衡器、HA代理或Varnish实例，请将以下配置添加到Magento的 local.xml 文件中

<global>
    <remote_addr_headers>
        <header1><![CDATA[HTTP_X_REAL_IP]]></header1>
        <header2><![CDATA[HTTP_X_FORWARDED_FOR]]></header2>
    </remote_addr_headers>
</global>

以便使用 X-Forwarded-For 或 X-Real-IP HTTP头识别正确的用户IP。