README

使用这个 Magento 2 扩展连接到 Emplifi 的 Pixlee TurnTo 评分和评论服务。兼容 Magento Open Source 和 Adobe Commerce，版本 2.3.x - 2.4.6。

安装说明

使用 Composer 安装（推荐）

遵循 Adobe 文档中的说明 安装扩展

Composer 包 turnto/social-commerce

1. 在您的根 Magento 安装目录中运行以下命令以进行 composer 安装

   composer require turnto/social-commerce
   bin/magento module:enable TurnTo_SocialCommerce --clear-static-content
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:clean
   

2. 配置模块以连接到您的 TurnTo 账户。请参阅下面的“常规配置”部分。

通过复制文件进行安装

1. 在您的 Magento 安装目录的 app 目录中创建一个 code/TurnTo/SocialCommerce 目录。

2. 从以下页面下载最新的“源代码”： https://github.com/turnto/magento2-turnto-socialcommerce/releases

3. 解压文件并将 TurnTo_SocialCommerce-*** 目录的内容复制到 app/code/TurnTo/SocialCommerce 目录。

4. 从您的根 Magento 安装目录运行以下命令

   bin/magento module:enable TurnTo_SocialCommerce --clear-static-content
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:clean
   

5. 配置模块以连接到您的 TurnTo 账户。请参阅下面的“常规配置”部分。

文档

常规配置

您必须添加您的 TurnTo 网站密钥和授权密钥。TurnTo 网站密钥允许 Magento 扩展连接到您的 TurnTo 账户。您可以在 TurnTo 门户 中找到您的网站密钥和授权密钥，或者通过联系您的 Emplifi 客户成功团队。

安装扩展后，登录到后端，在 STORES > Configuration > TURNTO SOCIAL COMMERCE > Configuration 中配置扩展。以下是版本 3.2.2 的扩展截图（点击放大）

CRON 配置

此扩展需要配置 Magento CRON 才能正常工作。有关如何配置 Magento CRON 的详细信息，请参阅 Adobe 文档。

目录 Feed 导出到 TurnTo

如果将“启用自动 Feed 提交”配置选项设置为“是”，则每晚，Magento 将导出所有产品的 Feed 到 TurnTo。此 Feed 将包含产品图片的链接。为了确保此链接准确，您需要执行以下操作

1. 登录到后端。
2. 转到 STORES > Configuration > GENERAL > Web
3. 执行以下操作（如果您有多个商店视图，请为每个“商店视图”范围执行以下步骤）
   1. 对于 Base URLS > Base URL for User Media Files 字段，确保已输入值。如果该字段为空，请输入此值：{{unsecure_base_url}}media/
   2. 对于 Base URLS (Secure) > Secure Base URL for User Media Files 字段，确保已输入值。如果该字段为空，请输入此值：{{secure_base_url}}media/ 以下是示例配置的截图

如果您的目录中有 10,000 个或更多的项目

如果您的目录有10,000个或更多项目，导出文件的尺寸可能会超过6MB。请检查您的php.ini或htaccess文件，以确保upload_max_filesize和post_max_size已设置为足够大的值。我们建议将它们都设置为10M。

从TurnTo导入评分

如果启用评论配置选项设置为是

1. 产品详细页面显示的评论将直接从TurnTo加载。评论数据如何从TurnTo提取由设置类型设置确定。

2. 产品列表页面显示的评论将从“评论数量”和“评分”产品属性加载。这些属性由每小时运行一次的CRON作业更新。CRON作业将从TurnTo请求XML源，并更新这些产品属性。如果您遇到这些属性未按预期更新的问题，可以通过创建一个匹配此模式的url来手动检查Magento从TurnTo检索的XML源的内容：https://export.turnto.com/<SITE_KEY>/<AUTHORIZATION_KEY>/turnto-skuaveragerating.xml其中<SITE_KEY>和<AUTHORIZATION_KEY>是您在管理员TurnTo配置字段中输入的值。XML文件由TurnTo每天生成两次（美国东部时间凌晨3点和上午11点），因此，您批准产品的新评论后，需要等待一段时间才能看到XML文件中的更改。

自定义配置

注意：这是一个高级配置选项，应由开发人员配置。

如果您要自定义在TurnTo在前端使用时输出的turnToConfig JS对象，您可以在STORES > 配置 > TURNTO 社交商务 > 配置 > 自定义配置字段中添加一个JS对象。您必须输入一个有效的JS对象到这个字段，因为您输入的JS对象的内容将被与现有turnToConfig对象的内容合并。以下是可添加到自定义配置字段的示例值

{
    reviewTitleInstruction: 'Summary for your review',
    eventHandlers: {
         reviewSubmit: function(evt) {
            // your code here
         }
    }
}

以下是在前端输出turnToConfig对象的位置

• 产品详细页面（评论、问答、结账评论显示小部件、视觉画廊小部件）
• 结账确认页面上的结账评论
• 磁贴板小部件
• 移动着陆页面

当您向此配置字段添加值时，您必须输入一个有效的JS对象，并测试以确保您没有造成任何JS错误。

视觉内容和结账评论磁贴板

TurnTo扩展实现了一个自定义小部件，允许管理员插入“视觉内容”磁贴板或“结账评论”磁贴板。要插入此小部件，编辑一个CMS页面或CMS块，然后单击“插入小部件…”按钮并选择“TurnTo SpeedFlex”。然后您可以使用这些选项配置和插入小部件

视觉内容画廊行小部件

TurnTo扩展实现了一个自定义小部件，允许用户在产品页面上切换用户提交的图像的画廊行。要启用此小部件，转到“店铺 -> 配置 -> TurnTo 社交商务 -> 配置 -> 视觉内容 -> 启用PDP画廊行”，并将值设置为“是”。

故障排除

• 一般 - 如果您遇到扩展问题，请检查var/log/turnto.log文件中的错误，因为所有TurnTo错误都记录在此。
• 启用“最小化JavaScript文件”时的问题 - 如果您正在使用Magento的“最小化JavaScript文件”功能，请参阅此页面以获取有关如何使用此扩展工作的详细信息。
• 如何审查发送给TurnTo的产品源 - 请参阅此Github问题：#27

关于Emplifi的Pixlee TurnTo社交商务

Emplifi的Pixlee TurnTo是顶级商家和品牌的首选客户内容解决方案提供商。它提供一套独特的4个创新产品，这些产品协同工作得非常出色——评分与评论、社区问答、视觉评论和结账评论——Pixlee TurnTo能够生成更多不同类型的优质内容，从而带来更高的转化率提升、更好的搜索引擎优化和更深入的营销洞察。

Pixlee TurnTo的客户享受世界一流的评分与评论平台、一个旨在最大化客户互动并帮助购物者快速从多种来源获得答案的问答系统、通过结账评论提供的实时且极具吸引力的客户内容，以及通过视觉评论提供的经过许可的客户照片和视频。Pixlee TurnTo与主要电子商务平台集成，专为新世界设计，重新构想以适应移动设备、视觉内容和消息传递。Saks Fifth Avenue、Newegg、Sur La Table和GNC等电子商务领导者，以及Cole Haan、Jockey和Clarins等品牌都依赖Pixlee TurnTo的客户之声项目。

许可

本项目采用《开源软件许可》（OSL 3.0）许可——请参阅LICENSE.txt以获取OSL 3.0许可证的完整文本。