Overview

This repository contains a Magento 2 extension that connects Magento 2 with TurnTo's Social Commerce service. Compatible with Magento Community and Enterprise, versions 2.0.x - 2.2.x.

Installation Instructions

Install using Composer (recommended)

1. Run these commands in your root Magento installation directory:

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

2. If you are deploying the extension to a production environment, follow the devdocs.magento.com deployment instructions

Install by copying files

1. Create an app/code/TurnTo/SocialCommerce directory in your Magento installation.

2. Download the latest "Source code" from this page: https://github.com/turnto/magento2-turnto-socialcommerce/releases

3. Extract the file and copy the contents of the TurnTo_SocialCommerce-*** directory into the app/code/TurnTo/SocialCommerce directory.

4. Run following commands from your root Magento installation directory:

   bin/magento module:enable --clear-static-content TurnTo_SocialCommerce
   bin/magento setup:upgrade
   bin/magento cache:flush
   

5. If you are deploying the extension to a production environment, follow the devdocs.magento.com deployment instructions

Documentation

General Configuration

After installing the extension, login to the backend and configure the extension in STORES > Configuration > TURNTO SOCIAL COMMERCE > Configuration. Here is a screenshot of the extension as of version 1.0.3 (click to zoom):

CRON Configuration

This extension depends on the Magento CRON being configured in order to work properly. Reference the Magento DevDocs for details on how to configure the Magento CRON.

Catalog Feed Export to TurnTo

If the Enable Automated Feed Submission configuration option is set to Yes, on a nightly basis, Magento will export a feed of all products to TurnTo. This feed will include links to product images. In order for this link to be accurate, you will need to do the following:

1. Login to the backend.
2. Go to STORES > Configuration > GENERAL > Web
3. Do the following (if you have multiple store views, follow these steps for each "Store View" scope):
   1. For the Base URLS > Base URL for User Media Files field, ensure a value is entered. If the field is blank, enter this value: {{unsecure_base_url}}media/
   2. For the Base URLS (Secure) > Secure Base URL for User Media Files field, ensure a value is entered. If the field is blank, enter this value: {{secure_base_url}}media/

Here is a screenshot of an example configuration:

[image: Media Url Configuration]

Rating Import from TurnTo

If the Enable Reviews configuration option is set to Yes:

1. The reviews that display on product detail pages will be loaded directly from TurnTo. Exactly how the review data gets pull from TurnTo is determined by the Setup Type setting.

2. The reviews that display on product listing pages will be loaded from the "Review Count" and "Rating" product attributes. Those attributes get updated on a CRON job that runs hourly. The CRON job will request an XML feed from TurnTo and will update those product attributes. If you encounter issues where those attributes are not updated like you'd expect, you can manually review the contents of the XML feed that Magento is retrieving from TurnTo by creating a url that matches this pattern: http://www.turnto.com/static/export/<SITE KEY>/<AUTHORIZATION KEY>/turnto-skuaveragerating.xml where <SITE KEY> and <AUTHORIZATION KEY> are the values you entered into the corresponding fields in the TurnTo configuration fields in the admin. The XML file is generated by TurnTo twice daily (at 3AM EST and 11AM EST), so once you approve a new review for a product, you'll need to wait a while to see the changes reflected in the XML file.

Single Sign On

TurnTo requires that some user actions, such as answering a question, can only be done by a logged-in user. TurnTo has its own authentication system that will display a registration screen to the user of the widgets when appropriate. If you choose instead to use your site’s authentication / registration functionality so that users who are already logged into your site do not need to register again when using the TurnTo widgets, you can make use of the TurnTo single sign-on (SSO) features.

Custom Configuration

Note: This is an advanced configuration option and should only be configured by a developer.

If you'd to customize the turnToConfig JS object that gets output whenever TurnTo is used on the frontend, you can do so by adding a JS object to the STORES > Configuration > TURNTO SOCIAL COMMERCE > Configuration > Custom Configuration field. You must enter a valid JS object into this field, as the contents of the JS object that you enter will get merged with the contents of the existing turnToConfig object. Event Callbacks are one example of what you might want to add to this config field. Here is an example of a valid value that could be added to the Custom Configuration field:

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

These are the following locations where the turnToConfig object gets output on the frontend:

• Product detail pages (reviews, Q&A, checkout comment display widget, visual gallery widget)
• Checkout comments on checkout confirmation page
• Pinboard widget
• Mobile landing page

When you add values to this configuration field, it is critical that you enter a valid JS object and that you test to ensure you didn't cause any JS errors.

Visual Content and Checkout Comment Pinboards

The TurnTo extension implements a custom widget that allows an admin to insert "Visual Content" pinboards or "Checkout Comment" pinboards. To insert this widget, edit a CMS page or CMS block and click the "Insert Widget…" button and select "Social Commerce Pinboards". You'll then be able to configure and insert the widget using these options:

Troubleshooting

If you experience issues with the extension, review the errors in the var/log/turnto.log file, as that is where all TurnTo errors are logged.

Troubleshooting issue when "Minify JavaScript Files" is enabled

If you're using Magento's "Minify JavaScript Files" feature, see this page for details on how to get it working with this extension.

About TurnTo Social Commerce

TurnTo is the fastest-growing provider of customer content solutions to top merchants and brands. With a unique suite of 4 innovative products that work beautifully together - Ratings & Reviews, Community Q&A, Visual Reviews, and Checkout Comments - TurnTo produces more content of more different types, delivering greater conversion lift, better SEO, and deeper merchandising insights.

TurnTo clients enjoy a world-class Ratings & Reviews platform, a Q&A system designed to maximize customer engagement and help shoppers find fast answers from a variety of sources, a highly engaging source of real-time customer content with Checkout Comments, and a permissions-cleared source of customer photos and videos through Visual Reviews. TurnTo offers integrations with major eCommerce platforms and is built for the new world, reimagined for mobile, visual content, and messaging. ECommerce leaders like Saks Fifth Avenue, Newegg, Sur La Table, and GNC, and brands like Cole Haan, Jockey, and Clarins rely on TurnTo for their customer-voice programs.

License

This project is licensed under the Open Software License 3.0 (OSL-3.0). See included LICENSE file for full text of OSL-3.0

2.0.0 (2018-04-13)

• Improve HttpClient logging for debugging errors during retrieval of embedded content (#38)
• Add support for using child SKU instead of parent SKU option in 2.2.x (#29)
• Fix order export failing due to sorting on incorrect order column (#33)
• Fix stock availability status not being set for catalog export (#39)
• Fix issue where admin configured "Custom Configuration" was not getting output on product detail pages (#41)
  • Refactored TurnTo javascript config generation to centralized Block
  • Developers can now intercept config generation through Magento plugins to customize functionality

1.3.0 (2018-01-19)

• Added documentation explaining how reviews are pulled from TurnTo
• Fixed issue where category pages don't display proper review count/rating until manual reindex is performed (#31) and (#23)
• Increase frequency of importing reviews from TurnTo (#30)
• Fixed DI compilation error on Magento 2.2.x (#30)

1.2.0 (2017-12-12)

• Add Single Sign On functionality to the mobile landing page (#24)

1.1.2 (2017-10-18)

• Add option to include/exclude order items from historical feed based on whether they've been shipped (#20)
• Misc bug fix (#21)

1.1.1 (2017-10-04)

• Add option have a "from" date when exporting historical orders (#18)
• Make it possible for a developer to group reviews for similar products by modifying g:item_group_id value in the catalog feed (#17)
• Fix catalog/order feed export issue (#16)
• Misc bug fixes

1.1.0 (2017-09-24)

• Add SSO (Single Sign On) feature (#14)
• Add support for using child/variant SKUs instead of parent SKUs (#8)

1.0.4 (2017-07-28)

• Add user-supplied turnToConfig JS to all places it is used (#5)
• Fix errors when attempting to import ratings (#4)
• Fix error when historical orders are exported with products that have been deleted (#3)
• Increase CRON history lifetime to provide more robust debugging information

1.0.3 (2017-06-29)

• Allow admins to add custom values to the turnToConfig object (see docs)
• Fix issue where reviews were not showing on product listing or search result pages (#7)

1.0.2 (2017-06-13)

• Fix product image url in catalog feed export

1.0.1 (2016-08-24)

• Fixed composer install for Magento 2.0. Works on 2.0 and 2.1 now.

1.0.0 (2016-08-09)

• Initial Release