X hide

Magento 2 Social Login Pro v2.x Installation

From Plumrocket Documentation

You are viewing:  Social-login-pro-icon-32.png  Social Login Pro

Installation Service
Installation Service


Contents

Installation

Here you will learn how to correctly install the Social Login Pro Extension for Magento 2.


Attention green.png Important Information:

First of all make sure your system requirements meet the ones necessary for the correct functioning of our Magento 2 social login extension. For more details on system requirements read Magento system requirements


Disabling Free Twitter & Facebook Login Module

In order to avoid conflicts, if you have previously installed our free Twitter & Facebook Login - you will need to remove this free extension. Please follow the instructions below.

Attention green.png Important information!
Make sure to follow these steps only if Plumrocket Twitter & Facebook Extension has been previously installed:
  1. Navigate to Twitter & Facebook Extension Configuration section.
  2. Disable extension in Twitter & Facebook Configuration section.
  3. Disable Twitter & Facebook Extension via "app/etc/config.php" (by setting 'Plumrocket_SocialLoginFree' => 0). Make sure to flush Magento Cache.
  4. Navigate back to Plumrocket section and verify you no longer see Twitter & Facebook Extension - only Social Login Pro Extension should remain.


Uploading Magento 2 extension files

Download and unzip the magento 2 social login extension's files as shown below:

Description.png Detailed description:
  1. This is the original archive to be unpacked.
  2. This is the unpacked catalog of files.


1-social login pro magento2 2.0.0.jpg


To upload the files to the server, you may use any FTP-client (To show you how it works we used the FileZilla FTP-client.)


Description.png Detailed description:
  1. This is your client side. You will see the unpacked catalog containing the Social Login Pro Extension for Magento 2.
  2. This is your root directory on server side. This is where the files should be uploaded.
  3. All the files must be uploaded to the server. Select files and press the right mouse button.
  4. Select the "Upload" option for these files.


2-social login pro magento2 2.0.0.jpg


The screenshot below depicts possible difficulties that can occur when you upload the files. In case there are identical files on the server, they should be overwritten. Below you will find detailed tips on how to overwrite files (when using the FileZilla FTP-client):


Information Sign sm.png Step-by-Step action:
  1. If you receive the notification "Target file already exists" from your FTP-client, please, follow the tips described below.
  2. Select the "Overwrite" radio button in order to overwrite files.
  3. Tick the "Apply to current queue only" —Āheckbox in order to save these settings for all similar cases of current queue configuration in the future.
  4. Press "OK".


3-social login pro magento2 2.0.0.jpg


Once uploaded, please select one of the 3 installation methods described below:


SSH Installation (requires SSH access to your webserver)

1. In terminal, switch to your Magento 2 root directory using command:

Command:
  1. cd /FULL_PATH_TO_YOUR_MAGENTO2

where "FULL_PATH_TO_YOUR_MAGENTO2" is the path to your Magento 2 folder on your server.


2. Run the Magento 2 upgrade command:

Command:
  1. php bin/magento setup:upgrade


3. Run the single-tenant compiler command:

Command:
  1. php bin/magento setup:di:compile


4. Deploy static view files command:

Command:
  1. php bin/magento setup:static-content:deploy


Web Installation (using native Magento 2 Component Manager)

Information Sign sm.png Step-by-Step action:
  1. Login to your Magento 2 Admin Panel.
  2. Go to the "System" tab.
  3. Choose the "Web Setup Wizard" option.


3b social login Magento 2 Installation v1.jpg


Information Sign sm.png Step-by-Step action:
  1. When in the Setup Wizard - navigate to the "Home" tab.
  2. Press the "Component Manager" option.


4-social login pro magento2 2.0.0.jpg


Step 1 - Base extension installation


Before you proceed with Magento 2 Social Login Pro module installation - please make sure to install Plumrocket Base extension. This is a system extension required for proper functioning of all Plumrocket Inc extensions. Note: You may skip Step "1" and proceed with "Step 2" if you've already installed Base extension by Plumrocket Inc before.


Information Sign sm.png Step-by-Step action:
  1. In the Component Manager, please find the "Plumrocket_Base" extension.
  2. From the list of actions please select "Enable".


5-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. On the next page, please press the "Start Readiness Check" button.


6-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. Make sure you've got all the green checkmarks. This means that your system is ready to move forward with Magento 2 Base module installation
  2. If the check was successful - please move on to the "Next" step.


7-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. It is essential to create the backup. Select at least the "Code" and "Database" backup options.
  2. Press the "Create Backup" button. For your safety, this will put your website into the "Maintenance" mode until the Base extension is installed.


8-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. Please wait until the backup is finished and you see the "Completed" notification.
  2. Click the "Next" button.


9-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. Press the "Enable" button to active this magento 2 Base extension.


10-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. The "Update pending" notification means that extension activation is currently in progress. Please wait until it is finished.


11-social login pro magento2 2.0.0.jpg


Information Sign sm.png Step-by-Step action:
  1. Once you see the "Success" notification - this means that Plumrocket Base Magento 2 extension has been installed successfully. At this point your website is in "Live" mode again.
  2. You can now get back to "Component Manager" setup tool and install the Social Login Pro extension for Magento 2.


12-social login pro magento2 2.0.0.jpg


Step 2 - Social Login Pro Magento 2 extension installation


At this point, please navigate back to Component Manager, and active the Social Login Pro extension for Magento 2 the same way, as you did with the base extension:


Information Sign sm.png Step-by-Step action:
  1. In Component Manager, please find the "Plumrocket_SocialLoginPro" extension.
  2. From the list of actions please select "Enable".


144-social login pro magento2 2.0.0.jpg


Proceed with the social login extension activation the same way as with Base extension above. Once social login pro is activated too - please follow the final steps below:


Information Sign sm.png Step-by-Step action:
  1. Navigate to your Magento 2 Admin Panel.
  2. Click on "Plumrocket" tab.
  3. If there is "Social Login Pro" tab in the list, it means that the magento 2 extension for social login from Plumrocket Inc. has been successfully installed.


13-social login pro magento2 2.0.0.jpg


Next Step > Magento 2 Social Login Pro v2.x Configuration

Social Login Pro Extension for Magento 2 Social Login Pro Extension for Magento 2

Navigation