# mageplaza/module-social-share

> Magento 2 Social Share Extension

`composer require mageplaza/module-social-share`

Canonical URL: https://packagento.com/mageplaza/module-social-share

## At a glance

- **Vendor**: mageplaza (https://packagento.com/mageplaza.md)
- **Latest version**: 4.0.4 — released 2024-10-21
- **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/mageplaza/module-social-share 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 mageplaza/module-social-share:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Magento 2 Social Share Extension

## README

[Magento 2 Social Share by Mageplaza](http://www.mageplaza.com/magento-2-social-share/) is a helpful extension which supports customers to share their shopping experience quickly to their social channels right from the current shopping page. This is also a proper solution to increase traffic to a shopping site, promote store brand and improve site ranking effectively.   


### 1. Social Share Documentation
- [Installation guide](https://www.mageplaza.com/install-magento-2-extension/)
- [User guide](https://docs.mageplaza.com/social-share/index.html)
- [Introduction page](http://www.mageplaza.com/magento-2-social-share/)
- [Contribute on Github](https://github.com/mageplaza/magento-2-social-share)
- [Get Support](https://github.com/mageplaza/magento-2-social-share/issues)


### 2. FAQ

**Q: I got error: Mageplaza_Core has been already defined**

A: Read solution [here](https://github.com/mageplaza/module-core/issues/3)

**Q: How many sharing button can I place on the page?**

A: There is no limitation. Because the button “+” is supported to allow displaying a list of up to 230 services.

**Q: Which position on a page can I place the sharing button block?**

A: You can place it with Floating type (on the left/ right of the page), Inline type (on the top/ at the bottom of page content)

**Q: How can I design the appearance of sharing button?**

A: From the admin backend, you can select the color for icon, button, and block background easily. Besides, you can upload the image as a button icon

**Q: How can I know the number of shares?**

A: Kindly enable the share counter from admin backend. The number of shares will appear. 

**Q: I would like a thank you or success message appearing after a customer shares a link?**

A: Kindly enable Thank-you popup from the admin backend. 
 

### 3. How to install Magento 2 Social Share extension 

Install via composer (recommend): Run the following command in Magento 2 root folder:

With Marketing Automation (recommend):
```
composer require mageplaza/module-social-share mageplaza/module-smtp
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```
Without Marketing Automation:
```
composer require mageplaza/module-social-share
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```


### 4. Highlight Features 

#### Integrate multiple social channels on shopping site

##### Encourage customers to share on unlimited social channels

**Multiple social sharing buttons** are placed vividly on shopping sites which motivate customers to click for sharing their shopping experience with friends anytime. 

The popular icons of famous channels like **Facebook, Twitter, Google+, LinkedIn** will appear right on Home Page, Category Page and Product Page


##### Market your products easily via customers

Your friends share a Tshirt with a link from a store on Facebook, and you and the others can instantly know about this product as well as the store site. This is an effective way in which Social Share is used to expose the brand as well as products indirectly via customers’ sharing. 

![Magento 2 Social Share](https://i.imgur.com/32TeRc4.png)

#### Floating and Inline display styles

The display style of sharing buttons can be selected with various choices including 2 Inline styles and 2 Floating styles. 

In Floating styles, sharing buttons can be placed to the left or to the right of the selected pages. In Inline styles, sharing buttons will appear on the top/ at the bottom of the content, or under Add-to-Cart button. 

![magento 2 social share extension free](https://i.imgur.com/MQlBOjE.png)

#### Beautify sharing buttons with ease

##### Customizable social sharing buttons

The appearance of social sharing button can be beautifully customized with the selection of icon color, button color, background color, button size and border radius. Let’s make sharing buttons eye-catching to appeal to customers with ease! 

##### Easy to upload your own sharing button icon

Also, with just one click, admins can upload an image to set as the icon for a sharing button easily. Sharing buttons now not only match store themes but also are attractive than ever!

![magento 2 social share module free](https://i.imgur.com/9VE4T8r.gif)


#### Display Share buttons on any pages (coming soon)
Placing sharing buttons easily on any positions on any pages with the support of snippet. Three snippet types including widget, block and PHP code will help to sharing buttons to be displayed flexibly for specific purposes. 

### 5. More Features

#### Share counter

Display the number of sharing 

#### Thank-you popup

Display the thank-you message after customers’ sharing 

#### Mobile friendly 

Be well responsive with mobiles, desktop, tablets, and other screen sizes.

### 6. Full Magento 2 Social Share Feature

#### For admins

##### General Configuration

- Enable/ Disable the module
- Choose icon/button/background color of sharing buttons
- Input percent for border radius
- Enable/ Disable share counter
- Enable Thank-you Popup after share action
- Upload icons for buttons

##### Floating configuration
- Choose pages to apply floating types
- Choose floating styles: Horizontal or Vertical 
- Set margin top 
- Set button size 

##### Inline Configuration
- Choose pages to apply inline types for sharing buttons
- Select inline styles: Top content and Bottom content Allow showing sharing buttons under Add-to-Cart button on Product Page 
- Set button size


#### For customers

- Share favorite pages or favored products quickly during on shopping site
- Easy to know recommended shopping pages/ items via social channels   
- Be more trusted on products thanks to the other ’s social sharing
- Have better shopping experience

### 7. Social Share User Guide

#### How to configure Social Share in Magento 2

##### 7.1. Configuration

Login to the **Magento Admin**, choose `Store > Configuration > Mageplaza > Social Share`.

_(README truncated for .md surface. Full README on https://packagento.com/mageplaza/module-social-share.)_

## Changelog

CHANGELOG: https://www.mageplaza.com/releases/social-share/

## Recent Versions

| Version | Released |
|---|---|
| 4.0.4 | 2024-10-21 |
| 4.0.3 | 2023-06-29 |
| 4.0.2 | 2022-11-08 |
| 4.0.1 | 2021-08-22 |
| 4.0.0 | 2021-03-23 |
| 1.0.3 | 2020-12-31 |
| 1.0.2 | 2020-07-16 |
| 1.0.1 | 2020-06-17 |
| 1.0.0 | 2019-01-28 |

## Dependencies

### Require

| Package | Constraint |
|---|---|
| mageplaza/module-core | ^1.5.3 |

## Quality

Latest release (4.0.4) 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 | 76 | 76 warnings (ruleset: Magento2) — 29 auto-fixable with phpcbf |
| PHPMD | Warning | 3 | 3 rule violations (ExcessiveClassComplexity:1, CyclomaticComplexity:1, NPathComplexity:1) |
| Cpd | Pass | 0 |  |
| 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 | 58 | 58 | – | – |
| 2.4.8 | – | 58 | 58 | – |
| 2.4.9 | – | – | 56 | 56 |


### 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=["mageplaza/module-social-share"],
  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

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