# turnto/social-commerce

> Social commerce platform to collect, manage, and display ratings and reviews to enhance your Magento store

`composer require turnto/social-commerce`

Canonical URL: https://packagento.com/turnto/social-commerce

## At a glance

- **Vendor**: turnto (https://packagento.com/turnto.md)
- **Latest version**: 3.9.1 — released 2026-06-05
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/turnto/social-commerce and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require turnto/social-commerce:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Social commerce platform to collect, manage, and display ratings and reviews to enhance your Magento store

## README

**(Formerly TurnTo Social Commerce)**

Use this Magento 2 extension to connect to [Emplifi Ratings & Reviews](https://emplifi.io/product/online-customer-reviews). Compatible with Magento Open Source and Adobe Commerce, versions 2.3–2.4.

The Emplifi Ratings & Reviews extension integrates Adobe Commerce and
Magento Open Source with Emplifi's Ratings & Reviews user-generated content platform. This
extension enables merchants to:

- Display customer reviews and ratings for products
- Display visual reviews and user-generated image galleries
- Capture user comments during checkout
- Provide CMS widgets for pinboards and landing pages
- Syndicate user-generated content through Emplifi widgets
- Configure widget behavior from the Adobe Commerce Admin
- Synchronize product and order data with Emplifi services

### Overview

Emplifi is a premier provider of customer content solutions to top merchants and brands. With a unique suite of four 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.

### Installation Instructions

#### Install using Composer (recommended)

Follow the Adobe documentation to [Install an extension](https://experienceleague.adobe.com/docs/commerce-operations/installation-guide/tutorials/extensions.html?lang=en)

Composer Package [turnto/social-commerce](https://packagist.org/packages/turnto/social-commerce)

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

    ```
    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. Configure the module to connect to your Emplifi account. Please see the [Configuration](#configuration) section below.

#### Install by copying files

1. Create a `code/TurnTo/SocialCommerce` directory in the `app` directory of your Magento installation.
2. Download the latest "Source code" from this page: [https://github.com/turnto/magento2-turnto-socialcommerce/releases](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 the following commands from your root Magento installation directory:

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

5. Configure the module to connect to your Emplifi account. Please see the [Configuration](#configuration) section below.

### Configuration

After installing the extension, configure it in the Admin:

**Stores > Configuration > Emplifi Ratings & Reviews > Configuration**

#### Enable the extension
To enable the extension, you need to set **Enable Social Commerce** to **Yes** and enter your Emplifi **Site Key** and **Auth
Key** under **General Settings**. These credentials are required for the extension to connect to Emplifi services.

You can retrieve your Site Key and Auth Key from the [Emplifi portal](https://emplifi.io/login).

* **Use child SKU**
    * **No:** Configurable parent SKUs are used, and the catalog feed exports visible catalog products.
    * **Yes:** Child/simple SKUs are used where applicable. For the catalog feed, simple child products may be exported so variant SKUs are included, with parent data used for grouping/URLs where needed.

Enable the following features as desired:
* **Enable Reviews** – Enables the display of product reviews and ratings.
* **Enable Q&A** – Enables the display of Question & Answer content.
* **Enable PDP Gallery Row** – Enables the display of Gallery Row on product detail pages.

#### Teaser
**Teaser Type** is used to select how the teaser is added to product detail pages.
* **Use Teaser Widget** – Using the Teaser Widget is recommended as this provides the latest features and can be fully managed and customized through your Emplifi account.
* **Use Local Teaser Code** – This is a legacy implementation and should only be used for sites already using this implementation.

#### Checkout Comments
When enabled, the extension will add the required code to capture user comments during checkout and display the comments.
This feature requires enabling JavaScript to capture order data in real-time.
* **Enable JavaScript Order Feed** – Enable the JavaScript that captures order data in real-time (required for comment capture).
* **Enable Checkout Comment Capture** – Enable the comment capture form on the checkout success page.
* **Enable Comments Display** – Enable the comments display on the product details page.
* **Enable Top Comments Display** – Enable the top comments display on the product details page.
* **Enable Comments Pinboard Teaser** – Enable the comments pinboard teaser when the widget is added to a page.
* **Customer Name Fallback** – Select which address to retrieve the customer's name from if the customer does not have an account.

#### Product Feed Export to Emplifi

_(README truncated for .md surface. Full README on https://packagento.com/turnto/social-commerce.)_

## Changelog

See GitHub [releases](https://github.com/turnto/magento2-turnto-socialcommerce/releases) for current changelog.

### 3.1.1 (2019-12-17)
* Fixed bug that caused setup:di:compile to fail 

### 3.1.0 (2019-12-17)
* Added checkout comment pinboards ([documentation](https://docs.turnto.com/en/ecommerce-platforms/magento.html#al_UUID-e25540c2-ef56-12c7-f40d-597ebd2bc751_section-idm13153034345814))
* Added visual content pinboards ([documentation](https://docs.turnto.com/en/ecommerce-platforms/magento.html#al_UUID-e25540c2-ef56-12c7-f40d-597ebd2bc751_section-idm13153034343116))
* Added the Magento and TurnTo module version to turnToConfig object ([documentation](https://docs.turnto.com/en/ecommerce-platforms/magento.html#al_UUID-e25540c2-ef56-12c7-f40d-597ebd2bc751_section-idm4650205841459231530342733983))

### 3.0.4 (2019-10-16)
* Module now searches for Magento 2 root and appends it to export file paths. This fixes some read/write errors for servers running in a non-standard configuration. 
  
### 3.0.3 (2019-10-10)
* Added version to composer.json

### 3.0.2 (2019-08-02)
* Fixed historical order feed cron job upload.

### 3.0.1 (2019-05-14)
* Added Magento 2.3 Compatibility

### 3.0.0 (2019-05-07)
* New version release for compatibility with JS widget v5

### 2.1.3 (2019-04-18)
* Updated README and made new version number for Magento Marketplace Release

### 2.1.2 (2018-10-24)

* Fix issue with catalog export when stock item could not be found

### 2.1.1 (2018-07-02)

* Fix issue with custom configuration default value

### 2.1.0 (2018-06-08)

* Handle special characters not supported by turnto ([#44](https://github.com/turnto/magento2-turnto-socialcommerce/issues/44))

### 2.0.0 (2018-04-13)

* Improve HttpClient logging for debugging errors during retrieval of embedded content ([#38](https://github.com/turnto/magento2-turnto-socialcommerce/issues/38))
* Add support for using child SKU instead of parent SKU option in 2.2.x ([#29](https://github.com/turnto/magento2-turnto-socialcommerce/issues/29))
* Fix order export failing due to sorting on incorrect order column ([#33](https://github.com/turnto/magento2-turnto-socialcommerce/issues/33))
* Fix stock availability status not being set for catalog export ([#39](https://github.com/turnto/magento2-turnto-socialcommerce/issues/39))
* Fix issue where admin configured "Custom Configuration" was not getting output on product detail pages ([#41](https://github.com/turnto/magento2-turnto-socialcommerce/issues/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](https://github.com/turnto/magento2-turnto-socialcommerce#rating-import-from-turnto) 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](https://github.com/turnto/magento2-turnto-socialcommerce/issues/31)) and ([#23](https://github.com/turnto/magento2-turnto-socialcommerce/issues/23))
* Increase frequency of importing reviews from TurnTo ([#30](https://github.com/turnto/magento2-turnto-socialcommerce/issues/30))
* Fixed DI compilation error on Magento 2.2.x ([#30](https://github.com/turnto/magento2-turnto-socialcommerce/issues/26))

### 1.2.0 (2017-12-12)
* Add Single Sign On functionality to the mobile landing page ([#24](https://github.com/turnto/magento2-turnto-socialcommerce/pull/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](https://github.com/turnto/magento2-turnto-socialcommerce/issues/20))
* Misc bug fix ([#21](https://github.com/turnto/magento2-turnto-socialcommerce/issues/21))

_(Changelog truncated for .md surface. Full history on https://packagento.com/turnto/social-commerce.)_

## Recent Versions

| Version | Released |
|---|---|
| 3.9.1 | 2026-06-05 |
| 3.9.0 | 2026-05-18 |
| 3.8.8 | 2025-10-09 |
| 3.8.7 | 2025-05-07 |
| 3.8.6 | 2024-06-18 |
| 3.8.5 | 2024-05-07 |
| 3.8.4 | 2024-01-25 |
| 3.8.3 | 2023-07-13 |
| 3.8.2 | 2023-03-16 |
| 3.8.1 | 2021-11-18 |

Showing 10 of 73 versions. Full release history on https://packagento.com/turnto/social-commerce.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| ext-simplexml | * |
| magento/framework | 102.0.*\|\|103.0.* |
| magento/module-backend | 101.0.*\|\|102.0.* |
| magento/module-catalog | 103.0.*\|\|104.0.* |
| magento/module-checkout | 100.3.*\|\|100.4.* |
| magento/module-config | 101.1.*\|\|101.2.* |
| magento/module-configurable-product | 100.3.*\|\|100.4.* |
| magento/module-cron | 100.3.*\|\|100.4.* |
| magento/module-customer | 102.0.*\|\|103.0.* |
| magento/module-eav | 102.0.*\|\|102.1.* |
| magento/module-review | 100.3.*\|\|100.4.* |
| magento/module-rule | 100.3.*\|\|100.4.* |
| magento/module-sales | 102.0.*\|\|103.0.* |
| magento/module-store | 101.0.*\|\|101.1.* |
| magento/module-swatches | 100.3.*\|\|100.4.* |
| magento/module-ui | 101.1.*\|\|101.2.* |
| magento/module-url-rewrite | 101.1.*\|\|102.0.* |
| magento/module-widget | 101.1.*\|\|101.2.* |
| php | ^7.1\|\|~8.0.0\|\|~8.1.0\|\|~8.2.0\|\|~8.3.0\|\|~8.4.0\|\|~8.5.0 |

## Quality

Latest release (3.9.1) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 222 | 222 warnings (ruleset: Magento2) — 68 auto-fixable with phpcbf |
| PHPMD | Warning | 49 | 49 rule violations (UnusedFormalParameter:12, UndefinedVariable:8, CyclomaticComplexity:6, NPathComplexity:5, ExcessiveMethodLength:5) |
| Cpd | Warning | 13 | 13 duplicated chunks spanning 354 total lines (min-lines=5, min-tokens=70) |
| Composer validate | Info | 1 | valid; 1 advisory note (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 53 | 53 | – | – |
| 2.4.8 | – | 54 | 54 | – |
| 2.4.9 | – | – | 51 | 51 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["turnto/social-commerce"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

turnto is a Magento 2 vendor on Packagento. See https://packagento.com/turnto.md for their full catalogue.