Turnkey Plugins \ Social Login for WHMCS Fork on Github

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 addon that corresponds to your WHMCS version

b. Upload the downloaded addon to your WHMCS directoy

Copy the folder oneall_social_login included in the .ZIP file to the folder /modules/addons/ of your WHMCS. After having copied the files you should have the folder /modules/addons/oneall_social_login/ in your WHMCS directory.

c. Activate the addon in your WHMCS admin area (from version 8.0)

First login to your WHMCS administration area and navigate to the Configuration > System Settings page. Then go to Addon Modules page and look for OneAll Social Login and click on Activate.

d. Activate the addon in your WHMCS admin area (version prior to 8.0)

First login to your WHMCS administration area and navigate to the Setup \ Addon Modules page. Then look for OneAll Social Login and click on Activate.

WHMCS Social Login Activate

2. Configuration

a. Open the configuration panel

Login to your WHMCS administration area and navigate to Setup \ Addon Modules. For versions superior to 8.0, go to Configuration > System Settings > Addon Modules. Then look for OneAll Social Login and click on Configure.

WHMCS Social Login Configure

b. 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 select the API Handler and API Port. These settings depend upon your server configuration.

WHMCS Social Login API Settings

c. 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.

d. Add the plugin to your templates

To display Social Login in your shop, simply add the code {$oneall_social_login_embedded} to your templates. To add the icons to the login page, add the code to the login.tpl template. For the registration page, add the code to the clientregister.tpl template.

3. Help & Troubleshooting

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

Please check the Social Login API Settings and make sure that your server supports the chosen API Handler. Try switching the API Handler and check if that fixes the issue. If that does not fix the error, then please have a look at your PHP error logs for more details.

b. 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 '^]'.
	

5. Fork on Github

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

User Contributed Notes