Firefox user notice:
Please use another web browser to view this document.
Sorry for the inconvenience.
Magento 2 Social Login provides online shoppers with quick registration and authorization possibilities through social login buttons. A social login block can be added to login, register, cart, and checkout pages of a website. Add up to nine login options. Place a social login block in custom page positions as a widget. Define the display order of login options individually on each page. View all the linked social accounts from a single table.
Compatibility: Magento Open Source 2.3.X, Magento Commerce 2.3.X
Thank you for choosing Aheadworks!
Installing Social Login
Command Line Installation | Composer Installation |
---|---|
1. Backup your web directory and store database 2. Download the Social Login installation package 3. Upload contents of the Social Login installation package to your store root directory 4. In SSH console of your server navigate to your store root folder: cd path_to_the_store_root_folder run the following command: : php -f bin/magento module:enable Aheadworks_SocialLogin then: php -f bin/magento setup:upgrade after: php -f bin/magento setup:static-content:deploy 5. Flush store cache; log out from the backend and log in again Make sure the installation is done from the FTP Administrator account. Otherwise, set 775 permissions to the store root directory after the extension is deployed. | If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store: 1. Login to your ssh console and navigate to your store folder:
cd path_to_the_store_root_folder
Run the following command:
composer config repositories.aheadworks composer https://dist.aheadworks.com/
On successful execution of the command you will be able to use the composer to install the extensions. To install the extension: 2. Login to your ssh console and navigate to your store folder:
cd path_to_the_store_root_folder
3. Run the following command to install the latest version of the extension: composer require aheadworks/module-social-login
if you need to install a specific version, run this command: composer require aheadworks/module-social-login:<version>
Specify the version of the extension in <version> When prompted, enter Public Key (Username) and Private Key (Password): Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site: 4. Enable the extension: php -f bin/magento module:enable <Module_Name> Add the product name in <Module_Name> Next, register the extension: bin/magento setup:upgrade Recompile your Magento store if you are in the Production mode: bin/magento setup:di:compile To verify that the extension is enabled, run this command: bin/magento module:status Clean store cache, by running the following command: bin/magento cache:clean Log out and Log in the backend again. To upgrade the extension: 5. To update or upgrade an extension: Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root. If a composer package exists for the extension, run one of the following. Update per module name: composer update aheadworks/module-social-login Updater per version: composer require aheadworks/module-social-login:<version> Run the following commands to upgrade, deploy, and clean the cache. php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean
|
Configuring Social Network Applications
3. Set-up the Facebook Login product
4. Get the API Key and Secret
Since Instagram is now managed by Facebook, it is recommended you use the Facebook Login product as an authentication solution.
1. Create an account with Google
2. Create/Select a Google project
3. Set up OAuth2.0
4. Get the API Key and Secret
Odnoklassniki
1. Create an account on Odnoklassniki
2. Register an Odnoklassniki application
3. Get the API Key and Secret
Vkontakte
1. Create an account on Vkontakte
2. Register a Vkontakte application
3. Get the Application ID and Secret key
Pinterest (https stores only)
PayPal
1. Create an account on PayPal.
If you are new to PayPal, you will first need to create an account.
Make sure to fill in all the fields and follow the registration steps provided by PayPal.
2. Register a PayPal application
3. Get the API Key and Secret
Getting Around
The Social Login extension is ready for work right after installation. It comes with a set of social login blocks that can be enabled separately for register, login, shopping cart, and checkout pages.
The blocks can contain up to nine login buttons: PayPal, Odnoklassniki, Vk, Pinterest, Instagram, LinkedIn, Google, Facebook, and Twitter. With the social login buttons, customers can log in to a website with one click (provided that they are already logged into the corresponding social network).
How an account is created?
Whenever customers click a social login button, they get redirected to the corresponding social network page. At the social network page, they need to confirm that they want to use their social accounts to log in to the store.
Once confirmed, customer is taken back to the store. The account is created.
Extension Configuration
The extension introduces its settings section in Stores > Configuration > AHEADWORKS EXTENSIONS > Social Login.
Within this section, you can decide on which store pages social login blocks should be displayed. Additionally, you can include/exclude the required social networks from the social login block.
The section comes with the following settings:
- Enable Social Login - enables/disables the extension's output;
- Login Blocks - enables/disables the default login blocks and allows adding custom blocks;
- Twitter/Facebook/Google/LinkedIn/Instagram/Pinterest/Vk/Odnoklassniki/Paypal - these sections allow enabling/disabling particular social networks for logging-in purposes and store appropriate consumer keys and secrets.
Managing Social Accounts
Another section the extension introduces to the store backend is 'Social Accounts' found under Customers > Social Login by aheadWorks > Social Accounts.
Customer Area
At the frontend of the store, the Social Login extension introduces the 'My Social Accounts' customer account section.
In this section, customers can view and manage their social accounts (by linking new and unlinking current ones).
Having linked a social account, customers can log in to the store in one click and then proceed to the catalog.
Rich Banner Slider introduces its sections under Content > Rich Banner Slider by Aheadworks. The extension comes with three sections:
- Slides - allows store administrator create and manage slides;
- Banners - allows store administrator create and manage banners;
- Statistics - provides an overview of the banner and slides performance.
Adding a Social Login Widget
Widget Layout Update
New login blocks can be added to custom positions through the native Magento widget functionality.
To add a new widget, navigate to Content > Elements > Widgets and click .
Choose Social Login in the 'Type' dropdown and click .
On the widget options page, configure the widget as per your requirements:
- Define the widget's name;
- Store view;
- Position.
Once the widget is saved, new social login block will be displayed in the position set.
Adding the Widget to Website Pages
To add the widget to a particular CMS page of your store, the first thing you need to do is to create a new login block.Navigate to the extension settings in Stores > Configuration > AHEADWORKS EXTENSIONS > Social Login.In the 'Login Blocks' configuration section:- Click ;
- Name the new Login Block ('Page widget' as per illustration);
- Click .
- click ;
- Set Widget Type to Social Login;
- In the Widget Options, select the new Login Block you created ('Page widget' as per illustration);
- Click .
Now you can save the CMS page, and the Login Block will be displayed in the required position.
Uninstalling Social Login
Manual Removal
1. Disable the module by executing the following commands:
php bin/magento module:disable Aheadworks_SocialLogin php bin/magento setup:upgrade
2. Remove the extension files from the following folder:
app/code/Aheadworks/SocialLogin
Automatic Removal (via Composer)
1. Disable the module by executing the following commands:
php bin/magento module:uninstall Aheadworks_SocialLogin
Need Customization?
License agreement: https://aheadworks.com/end-user-license-agreement
Contact Us: https://aheadworks.com/contact
Copyright © 2021 Aheadworks Co. http://www.aheadworks.com