Download the PHP package turnto/social-commerce without Composer

Emplifi Ratings & Reviews plugin for Magento 2

Formerly TurnTo Social Commerce

Use this Magento 2 extension to connects to Emplifi Ratings & Reviews. Compatible with Magento Open Source and Adobe Commerce, versions 2.3 - 2.4.

Installation Instructions

Install using Composer (recommended)

Follow the Adobe documentation to Install an extension

Composer Package turnto/social-commerce

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

2. Configure the module to connect to your Emplifi account. Please see the General Configuration section below.

   Install by copying files

3. Create a code/TurnTo/SocialCommerce directory in the app directory of your Magento installation.
4. Download the latest "Source code" from this page: https://github.com/turnto/magento2-turnto-socialcommerce/releases
5. Extract the file and copy the contents of the TurnTo_SocialCommerce-*** directory into the app/code/TurnTo/SocialCommerce directory.

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

7. Configure the module to connect to your TurnTo account. Please see the General Configuration section below.

Documentation

General Configuration

It is imperative that you add your Emplifi Ratings & Reviews site key and auth key. Emplifi Ratings & Reviews site keys allow the Magento extension to connect to your Emplifi account. You can find your Site Key and Auth Key in the Emplifi portal or by contacting your Emplifi Customer Success team.

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 3.2.2 (click to zoom):

CRON Configuration

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

Catalog Feed Export to Emplifi

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 Emplifi. 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:

If your store has 10,000 or more items in the catalog:

If your catalog has 10,000 or more items, the size of the export file can reach over 6Mb. Please check your php.ini or your htaccess files to ensure that upload_max_filesize and post_max_size are set to a large enough value. We recommend setting them both to 10M.

Rating Import from Emplifi

If the Enable Reviews configuration option is set to Yes:

1. The reviews that display on product detail pages will be loaded directly from Emplifi. Exactly how the review data gets pull from Emplifi 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 Emplifi 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 Emplifi by creating a url that matches this pattern: https://export.turnto.com/<SITE_KEY>/<AUTHORIZATION_KEY>/turnto-skuaveragerating.xml where <SITE_KEY> and <AUTHORIZATION_KEY> are the values you entered into the corresponding fields in the extension configuration fields in the Magento admin. The XML file is generated by Emplifi three times daily (at 3AM, 11AM, and 6PM EST/EDT). 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.

Custom Configuration

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

If you need to customize the turnToConfig JS object which used by the extension to display content 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. Here is an example of a valid value that could be added to the Custom Configuration field:

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

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 Emplifi 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 "TurnTo SpeedFlex". You'll then be able to configure and insert the widget using these options:

Visual Content Gallery Row Widget

The Emplifi extension implements a custom widget that allows a user to toggle a gallery row of user submitted images on the product page. To enable this widget, go to Stores -> Configuration -> TurnTo SocialCommerce -> Configuration -> Visual Content -> Enable PDP Gallery Row and set the value to "Yes."

Troubleshooting

• General - If you experience issues with the extension, review the errors in the var/log/turnto.log file, as that is where all extension errors are logged.
• 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.
• How to review product feed that is sent to Emplifi - See this Github issue: #27

About Emplifi's Rating & Reviews

Emplifi is a premier 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 - Emplifi produces more content of more different types, delivering greater conversion lift, better SEO, and deeper merchandising insights.

Emplifi 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. Emplifi offers integrations with major eCommerce platforms and is built for the new world, reimagined for mobile, visual content, and messaging.

License

This project is licensed under the Open Software License (OSL 3.0) – Please see LICENSE.txt for the full text of the OSL 3.0 license.