Getting Started

Welcome to the Social Login documentation. Whether you are a new or an advanced user, you can find some useful information here.

First of all, we recommend to check the following link:

  • How to install extension

How to install the extension

  1. Backup your store's database and web directory.
  2. Login to the SSH console of your server and navigate to the root directory of the Magento 2 store.
  3. Copy the installation instructions from the page My Downloadable Products to the SSH console and press ENTER.
  4. Run command php -f bin/magento module:enable Mirasvit_Core Mirasvit_SocialLogin to enable the extension.
  5. Run command php -f bin/magento setup:upgrade to install the extension.
  6. Run command php -f bin/magento cache:clean to clean the cache.
  7. Deploy static view files

    rm -rf pub/static/*; rm -rf var/view_preprocessed/*; php -f bin/magento setup:static-content:deploy

If the extension was installed by directly uploading files, you must also run the command composer require hybridauth/hybridauth:^v3.11.0 to install the required libraries.

Quick Start

Once we began designing our Social Login, we realized a social login platform would suit our audience perfectly.
In our scenario, via Google, Facebook, LinkedIn or Twitter, etc almost half of our customers have any form of the media network.

When you want to make things super-simple for users to use your network to create profiles, why not just add social logins?
Here are a few steps that should be tuned on:

  1. Enable the addon at Magento backend;
  2. Turn-up Social Accounts.

Configuration

This settings are located at Stores > Configuration > Mirasvit extensions > Social Login

General

Option Description
Enabled Enable/Disable the extension in the admin panel. Set to Yes to enable the extension.
Display Mode Display options - buttons or icons.
Show on Preferable page to display Social Login accounts, there are next options: Customer Login Page (before form), Customer Login Page (after form), Customer Create Page (before form), Customer Create Page (after form), Customer Login Popup.
Enable Redirect after login Set Yes to add the link to a particular page where customers will be forwarded once they've logged via any Social Login account.
Set No to
Redirect URL Field for the link to a particular page where customers will be forwarded, available if Enable Redirect after login enabled.

Social Accounts

There is a list of diversity of supported services and Internal statistics for each of the active services. If Social account service enabled there will be an identifier with a number of logged Users through the particular service.
Each Social Service requires to fulfill special data:

Option Description
Enabled Enable/Disable the service. Set to Yes to enable.
Consumer Key (API Key) An encrypted string that can be used when calling certain APIs, can be found in your project of each social service.
Consumer Secret (API Secret) A client secret credentials, will be generated automatically with Consumer Key (API Key).
Redirect URI For use with requests from a web server. This is a path from your application that users are redirected to after they have authenticated. The path will be appended with the authorization code for access. Must have a protocol. Cannot contain URL fragments or relative paths. Cannot be a public IP address.
Position Predefines a display order privilege for each Social Login service on the login page.

Google

To fulfill all necessary data, create a Google App Project here, more details here.

Facebook

To fulfill all necessary data, create a Facebook App Project here and choose Web, more details here.

Twitter

To fulfill all necessary data, create a Twitter App Project here, more details here.

LinkedIn

To fulfill all necessary data, create a Twitter App Project here.

PayPal

To fulfill all necessary data, create a PayPal App Project here.

Instagram

To fulfill all necessary data, register a New Client at Manage Clients tab here.

Amazon

To fulfill all necessary data, create an Amazon App Project here.

Yahoo

To fulfill all necessary data, create a Yahoo App Project here.

How to upgrade extension

To upgrade the extension follow these steps:

  1. Backup your store's database and web directory.
  2. Login to the SSH console of your server and navigate to the root directory of the Magento 2 store.
  3. Run command composer require mirasvit/module-social-login:* --update-with-dependencies to update current extension with all dependencies.

    Note

    In some cases the command above is not applicable, it's not possible to update just current module, or you just need to upgrade all Mirasvit modules in a bundle. In this case command above will have no effect.

    Run instead composer update mirasvit/* command. It will update all Mirasvit modules, installed on your store.

  4. Run command php -f bin/magento setup:upgrade to install updates.
  5. Run command php -f bin/magento cache:clean to clean the cache.
  6. Deploy static view files

    rm -rf pub/static/*; rm -rf var/view_preprocessed/*; php -f bin/magento setup:static-content:deploy

Disabling the Extension

Temporarily Disable

To temporarily disable the extension please follow these steps:

  1. Login to the SSH console of your server and navigate to the root directory of the Magento 2 store.
  2. Run command php -f bin/magento module:disable Mirasvit_SocialLogin to disable the extension.
  3. Login in to the Magento back-end and refresh the store cache (if enabled).

Removing the Extension

To uninstall the extension please follow these steps:

  1. Login to the SSH console of your server and navigate to the root directory of the Magento 2 store.
  2. Run the command composer remove mirasvit/module-social-login to remove the extension.
  3. Login in to the Magento back-end and refresh the store cache (if enabled).

1.2.1

(2024-07-05)

Improvements

  • Email status is automatically set to “Confirmed” if the customer registers via a social network

1.2.0

(2024-06-25)

Fixed

  • Added dependency on hybridauth/hybridauth package

1.1.5

(2023-12-13)

Fixed

  • Deprecated creation of dynamic property in OAuthConsumer.php

1.1.4

(2023-06-12)

Improvements

  • Additional checks when linking a social account with a customer

1.1.3

(2023-02-27)

Improvements

  • Added support of Magento 2.4.6

Fixed

  • Сompatibility with php8.1

1.1.2

(2022-08-19)

Fixed

  • Instagram icon

1.1.1

(2022-06-20)

Improvements

  • remove db_schema_whitelist.json

1.1.0

(2022-06-06)

Improvements

  • Migrate to declarative schema

1.0.12

(2022-03-24)


1.0.11

(2022-02-18)

Fixed

  • Issue with multistore

1.0.10

(2022-01-24)

Fixed

  • Compatibility with php8

1.0.9

(2021-01-12)

Fixed

  • Fixed the issue with the error during login when the customer has been deleted
  • Welcome email after creating acount with social login
  • Fixed the issue with social login related to required JS not loaded yet

1.0.8

(2020-10-22)

Fixed

  • Label for Client ID (Google) ([#12]())

1.0.7

(2020-09-11)

Improvements

  • Small spelling fixes

1.0.6

(2020-08-25)

Fixed

  • Magento 2.4 compatibility ([#8]())

1.0.5

(2020-08-05)

Improvements

  • Added social login block to the checkout

1.0.4

(2020-07-30)

Improvements

  • Support of Magento 2.4

1.0.3

(2020-06-17)

Fixed

  • Session clear issue

1.0.2

(2020-06-01)

Fixed

  • Reloading page on postMessage
  • Cache issue

1.0.0

(2020-04-13)

Features

  • Initial release