Turnkey Plugins \ Social Login for PrestaShop

1. Installation

The installation is not very complicated and should only take a couple of minutes. Please follow the instructions carefully and do not skip any steps.

a. Download the module that corresponds to your PrestaShop version

b. Add the module to your PrestaShop

First login to your PrestaShop administration area and navigate to the Modules page. Then click on the link Add a new module and upload the .ZIP file that you have downloaded in the previous step.

PrestaShop Social Login Upload

c. Install the uploaded module

First navigate to the Modules page in your PrestaShop administration area. Then search for the module OneAll Social Login and click on the Install button.

PrestaShop Social Login Install

2. Configuration

a. Open the configuration panel

Login to your PrestaShop administration area, navigate to the Modules pages. Search for OneAll Social Login and click on the Configure link or button.

Setup Social Login for PrestaShop

b. Setup the API Connection Handler

Click on the Autodetect the best API Connection Settings button. You should receive a green success message if your server is able to communicate with our API. Your firewall must allow outbound requests on either port 80 or 443.

AutoDetect API Settings PrestaShop

c. Enter your API Settings

To obtain your API credentials, please login to your OneAll account and open the page Site Settings \ API Settings & Credentials of a Site. If you do not have a Site yet, please create a new Site now.

Fill out the API Settings and click on the Verify the API Settings button. You should receive a green success message if your credentials are correct.

Verify Social Login API Settings in PrestaShop

d. Choose the Social Networks that you would like to enable

Please note that many social networks require that the webmasters register their website before being able to use their services. To be able to use the plugin, you must therefore register your website. This process is straightforward and takes only a couple of minutes.

It has to be done only once for each provider and we will guide you through this process. To setup your providers, please login to your OneAll account, select a Site and click on Social Networks.

3. Additional Information

The module supports translation through the Administration backend.

4. Help & Troubleshooting

a. The Social Login icons are not being displayed

Per default Social Login will be displayed in the sidebar of your PrestaShop. If your shop does not have a sidebar, then the plugin might not be displayed correctly. In this case you can add Social Login manually by copy/pasting the following code into your template (*.tpl files):

{$HOOK_OASL_CUSTOM}

b. Class 'OneAllSocialLoginController' not found

If you get an error like PHP Fatal error: Class 'OneAllSocialLoginController' not found then you might have to refresh the PrestaShop class cache. Simply delete the file /cache/class_index.php from your PrestaShop folder. PrestaShop will automatically create a new, updated version of that file.

c. I get a blank page after connecting with a social network

Please start by refreshing the PrestaShop class cache. Simply delete the file /cache/class_index.php from your PrestaShop folder. PrestaShop will automatically create a new, updated version of that file.

If this does not fix the error, then please verify your API settings in the Social Login setup in your PrestaShop administration menu.

d. The API Communication does not seem to work correctly

Please make sure that your firewall does not block outbound requests on both ports 80 and 443. One of these ports must allow outgoing requests (from your server to ours) so that the plugin can establish a communication with our API.

If you have access to the console of your server you can test if outbound requests are allowed by using this command: telnet ping.api.oneall.com 443. If the port is open then you should obtain a result like this:

		~$ telnet ping.api.oneall.com 443
		Trying 136.243.63.184...
		Connected to ping.api.oneall.com.
		Escape character is '^]'.
	

e. Social icons do show on the authentication page

The social icons are displayed below the "Authentication" H1 element with class page-heading or heading. If your theme does not use these classes on the authentication page, the icons will not be added. Either change the class used by the theme, or change the modules/oneallsociallogin/views/js/oneallsociallogin.js.

5. Fork on Github

Feel free to fork our Prestashop GitHub repository to contribute to the development of this module.

User Contributed Notes