README

安装

使用 composer 安装包

composer require emico/tweakwise

这将安装 emico/tweakwise 和 emico/tweakwise-export

启用模块并运行安装程序

php bin/magento module:enable Emico_TweakwiseExport Emico_Tweakwise
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy

配置

当扩展安装后，默认情况下会禁用。有三个不同的部分可以分别启用。配置可以在“商店” -> “配置” -> “目录” -> “Tweakwise”中找到。

所有可能的设置概述

以下是所有配置选项的概述

通用

1. 身份验证密钥：用于与 tweakwise 通信并确定您的导航实例，应与导航下 连接性 > 终端 中找到的密钥相同。
2. 服务器 URL：Tweakwise 服务器的 URL。
3. 超时：如果 tweakwise 在此秒数后未能响应，则请求将被终止。

分层导航（所有设置都取决于已启用具有值 yes）

1. 已启用：使用 tweakwise 结果进行导航，如果禁用，则使用标准 Magento 导航。

2. 隐藏只有一个选项的属性：给定 tweakwise 的一个结果集，其中有一个筛选器只有一个选项，显示该筛选器还是不显示？

3. 使用默认 Magento 筛选器渲染器：使用 Magento 标准筛选器模板或使用模块捆绑的模板。如果您想充分利用此模块提供的功能，则应将其设置为 No（即使用 tweakwise 模板文件）。

4. 筛选器表单：这取决于“使用默认 Magento 筛选器渲染器”具有值 No。以带有筛选器按钮的表单的形式呈现所有筛选器，以便用户可以选择一组筛选器，然后导航到结果，而不是在点击筛选器时立即导航到结果。

5. 筛选器 URL 查询参数：Tweakwise 筛选器 URL 将包含页面上的所有查询参数，包括“cid”和 utm_source 参数（如果存在）。您可以确定以何种方式过滤这些参数（如果有的话）。

6. 筛选器 URL 查询参数：这取决于“筛选器 URL 查询参数”具有任何不等于“不筛选”的值。此字段指定应从 tweakwise 筛选器 URL 中删除哪些参数。

7. URL 策略：有两个选项：查询参数和 SEO 路径别名。如果选择查询参数，则 tweakwise 筛选器 URL（以及因此您的导航 URL）将构建为 www.example.com/example-category?color=red。

   如果选择 SEO 路径别名，则 URL 将构建为 www.example.com/example-category/color/red。

SEO（所有设置均依赖于已启用且值为“是”）

1. 已启用：使用SEO选项是或否。
2. 过滤白名单：应可索引的过滤列表（此处未选中的所有过滤均不可索引）。如果一个过滤被标记为不可索引，则其href属性将被设置为“#”，其原始URL将设置在data-seo-href属性中，该属性将由javascript用于导航。注意，类别过滤始终标记为可索引。这曾经是一个包含magento属性的多选字段，然而tweakwise简化了派生属性，这些属性与magento属性无关，因此这些过滤不可索引。该字段已更改为逗号分隔的文本字段，以便这些派生属性可以正确地列入白名单。
3. 允许的最大分面数：这与过滤白名单设置结合使用。只有当过滤在白名单中并且选定的过滤计数不超过max_allowed_facets时，过滤才是可索引的。这之所以是一个AND检查，是因为否则索引仍将在非白名单过滤上发生，并且不清楚哪个URL存在（可以选择任意数量的过滤）。假设最大允许分面数为1，并且只有“尺寸”在白名单中。那么带有值“红色”的“颜色”过滤不可索引（因为“颜色”不在白名单中）。如果我们现在允许尺寸过滤仍然可索引，则url example.com/category/color/red/size/M将是可索引的，而example.com/category/color/red不可索引，这是不正确的。这会导致对过滤URL的无限爬取，这是不希望发生的。

自动完成（所有设置均依赖于已启用且值为“是”）

1. 已启用：使用tweakwise自动完成结果或否。
2. 使用建议自动完成：使用新的建议API（是）或使用标准自动完成API（否）
3. 显示产品：在自动完成结果中显示产品建议。
4. 显示建议：在自动完成结果中显示搜索建议。
5. 保持分类：在获取自动完成结果时使用当前分类。
6. 最大结果数：最多显示这么多自动完成结果。

搜索（所有设置均依赖于已启用且值为“是”）

1. 已启用：使用tweakwise搜索或默认magento搜索结果
2. tweakwise搜索模板：用于搜索结果的tweakwise模板（这决定了哪些过滤是可见的）
3. 搜索语言：这决定了商店使用的语言，并将其传递给tweakwise。tweakwise使用此信息来确定词形变化，并在考虑向用户显示哪些结果时纠正拼写错误。例如：如果语言设置为“荷兰语”，并且用户输入“Bed”（这在英语中相同，即人们睡觉的地方），那么tweakwise可能会建议“Bedden”（这是“Beds”的复数）。如果语言设置为英语，那么在上面的例子中，tweakwise可能会建议“Beds”。

个性化营销

1. 已启用：使用个性化营销（是/否）这仅在您使用ajax过滤时才可用。
2. Cookie名称：包含tweakwise配置文件ID的cookie，此cookie通常由跟踪脚本设置。此cookie的值将被添加到tweakwise请求中，响应将包含特定客户的个性化排序顺序。

请注意，启用这些设置会对性能产生影响。使用此功能意味着所有类别页面都有个性化内容。因此，不再可能缓存使用此配置文件cookie名称的导航响应。如果类别页面在varnish中缓存（这通常是情况），则仍然会提供varnish版本，但我们通过ajax重新加载产品列表以获取个性化排序。我们不会将配置文件cookie添加到非ajax导航请求中，这样做是为了使普通请求仍然可以被varnish缓存。这意味着用户会看到一个加载器。只有当以下条件满足时，产品列表才会重新加载：

1. 已启用个性化营销设置
2. cookie名称设置具有值
3. 用户具有指定的非空值的cookie。

产品列表重新加载在每个类别访问时仅发生一次。这意味着如果用户没有指定的cookie，将提供正常的（已缓存的）结果。以这种方式重新加载产品列表时，结果将无法缓存。这会影响服务器负载，请记住这一点。

推荐

1. 启用交叉销售：用tweakwise交叉销售和促销推荐替换magento原生的相关产品。术语容易混淆，因为这与magento相关产品相关，而不是与magento交叉销售产品相关
2. 默认交叉销售模板：用于相关产品的tweakwise推荐模板。仅在启用交叉销售时相关。这也可以在产品和类别上配置。使用的模板如下确定：首先检查产品配置的模板，如果没有，然后检查产品类别配置的模板。如果类别没有配置模板，则使用默认模板。
3. 默认交叉销售组代码：仅在默认交叉销售模板具有值“- Group Code -”时可见。使用此来指定推荐组
4. 启用促销：用tweakwise交叉销售和促销推荐替换magento原生的促销结果。
5. 默认促销模板：用于促销产品的模板推荐模板。仅在启用促销时相关。这也可以在产品和类别上配置。使用的模板如下确定：首先检查产品配置的模板，如果没有，然后检查产品类别配置的模板。如果类别没有配置模板，则使用默认模板。
6. 默认促销组代码：仅在默认促销模板具有值“- Group Code -”时可见。使用此来指定推荐组
7. 启用特色产品：如果选择“是”，则tweakwise可以在类别页面上显示特色产品。
8. 默认特色产品模板：渲染特色产品时要使用的默认模板。模板也可以按类别设置，如果没有在类别中找到，则回退到此设置。

支持

有关配置和tweakwise提供的所有选项的深入支持，请使用以下链接。

1. Tweakwise支持：https://www.tweakwise.com/support/
2. Tweakwise API文档：http://developers.tweakwise.com/
3. 一般问题：https://www.tweakwise.com/contact/

有关功能请求，请参考上面的链接。对于技术问题，请使用github。如果您发现技术问题，请创建一个github问题，并通过上述链接通知tweakwise。如果您也恰好有该问题的解决方案，请随时创建一个合并请求。

兼容性

我们努力保持与所有 Magento 2.X 版本以及最新的 2.X-1 版本兼容，其中 X 是最高官方 '子' 发布版本。目前 X=3，因此我们应该与所有 2.3 版本以及最新的 2.2 版本（写作时为 2.2.10）兼容。我们不会主动放弃对低于此范围的版本的支持，如果这意味着我们可以保持与低于此范围的版本兼容，我们将实施 小版本 更改。但话说回来，如果我们可以通过放弃对版本 2.1.Y 的支持来大幅简化代码，我们将会这样做。我们还参考了 Magento 软件生命周期：[https://magento.com/sites/default/files/magento-software-lifecycle-policy.pdf](https://magento.com/sites/default/files/magento-software-lifecycle-policy.pdf)。请注意，2.2 已达到生命周期的结束。