Turnkey Plugins \ Social Login for vBulletin 4
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
b. Upload the add-on files
Copy the contents of 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 to the renamed folder.
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.
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.
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
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.
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.
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:
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
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 220.127.116.11... 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.