Turnkey Plugins \ Social Login for vBulletin 4

1. Installation

The installation is very easy and takes only a few minutes. Please follow the instructions carefully and do not skip any steps.

a. Download the add-on

Download Social Login for vBulletin 4.0+

b. Upload the add-on files

Copy the contents of the /upload/ folder included in the downloaded .ZIP file to the root directory of your vBulletin installation. If you have renamed your admincp folder, then you have to copy the files included in the admincp folder of the .ZIP file to that new folder.

Copy Social Login Files

c. Import the product

Login to your admin control panel, navigate to Plugin & Products \ Manage Products and then click on the Add/Import Product link.

Import vBulletin Product

Enter the value ./includes/xml/product-oneallsociallogin.xml into the field OR import the XML file from your server and then click on the Import button beneath.

Upload Social Login XML

2. Configuration

a. Open the configuration panel

Login to your vBulletin administration area, open the group OneAll in the left navigation bar and click on Social Login.

b. Setup the API connection handler

Click on the Autodetect 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 (from your server to ours) on either port 80 or 443.

Autodetect vBulletin Connection

c. Enter your API credentials

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

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

Verify vBulletin Connection

d. Setup the social networks

Select the social networks that you would like to use by ticking the corresponding checkboxes in the Social Login setup in your vBulletin administration area.

Please note that many social networks require that the webmasters register their websites before being able to use their services. To be able to use Social Login you therefore have to 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. Troubleshooting

a. Social Login is not displayed at all

The plugin uses the vBulletin hook system to integrate into your forum. The icons might not be displayed correctly if your theme does not support these hooks or if it does not use the default vBulletin classes. In this case you can add the Social Login icons manually by using this code in your templates:

		{vb:raw vboptions.oneallsociallogin}
	

You can edit the templates in your vBulletin administration area under Styles & Templates \ Style Manager \ Edit Templates.

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

4. Fork on Github

Feel free to fork our vBulletin GitHub repository to contribute to the development of this product.

User Contributed Notes