Turnkey Plugins \ Social Login for WordPress

The Social Login Plugin for WordPress is a professional though free plugin that allows your visitors to comment, login and register with social networks like Twitter, Facebook, LinkedIn, Hyves, Google and Yahoo. An easy and straightforward plugin to increase your user engagement. Download Social Login for WordPress

  1. Installation
  2. Setup
  3. Troubleshooting

1. Installation - How to install Social Login for WordPress?

1.1. Automatic Installation:

  1. Login to your WordPress blog as administrator,
  2. Click on Plugins in the left navigation panel,
  3. Click on Add New at the top of the page,
  4. Enter oneall social login in the search box and click on Search Plugins,
  5. Look for Social Login and click on Install Plugin.

1.2. Manual Installation:

  1. Download the latest version of the Social Login Plugin here: WordPress Social Login,
  2. Upload the plugin folder to the /wp-content/plugins/ directory of your WordPress website,
  3. Login to your WordPress blog as administrator,
  4. Click on Plugins in the left navigation panel,
  5. Activate the plugin.

2. Setup - How to setup Social Login for WordPress?

After having installed Social Login on your WordPress blog you have to enter your API credentials and you must setup the social networks that you would like to use.

2.1. How to obtain your API Credentials?

  1. Login to your existing OneAll account or alternatively create a new account.
  2. Click on Site Configuration in the top navigation bar,
  3. Click on the name of your site (If you do not have a site yet, please create a new site first),
  4. Copy & paste the values at API Access Credentials into the Social Login plugin settings in your WordPress account.

2.2. How to setup the Social Networks?

Many social networks require that the webmasters register their websites before being able to use more advanced features. To be able to use some of the social networks (i.e. Facebook & Twitter), you will therefore have to register your blog.

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, and on the dashboard click on Social Networks in the QuickLinks of your Site.

3. Troubleshooting - How to fix common issues?

3.1. The Social Login buttons are not being displayed in my comments area!

The plugin uses existing WordPress hooks to seamlessly integrate into your blog. If your theme does not support these hooks, the plugin will not be displayed correctly. You can add the Social Login features manually by inserting the following code into your template:

<?php do_action('oa_social_login'); ?>

This code has be added at the location where Social Login should be displayed, i.e. above the comments form.

  1. Login to your blog as administrator,
  2. Click on Appearance and then Editor,
  3. Click on Comments (comments.php) in the file list to your right,
  4. Look for <h3><?php comment_form_title( 'Leave us your thoughts', 'Leave a Reply to %s' ); ?></h3>
  5. Add the code <?php do_action('oa_social_login'); ?> below.

Your theme might look slightly different. Try adding <?php do_action('oa_social_login'); ?> to another place in the code and check if the Social Login options are displayed. Please note that the buttons will not be displayed while you are logged in. If you are not sure where to add the tag, feel free to contact us, we will help you set it up.

3.2. I get an error 403 when logging in with a social network!

If you have installed the Bad Behavior plugin you might encounter the following error:

Error 403

We're sorry, but we could not fulfill your request for /?oa_social_login_source=widget on this server.
You do not have permission to access this server. Data may not be posted from offsite forms.
Your technical support key is: 4466-1157-cd36-1abb

You can use this key to fix this problem yourself.
If you are unable to fix the problem yourself, please contact XXX at gmail.com and be sure to provide the technical support key shown above.

To fix this issue you must open the Bad Behavior settings in your WordPress administration area and Enable Offsite Forms. More information about this restriction is available in the Bad Behavior documentation.

3.3. 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
	Connected to ping.api.oneall.com.
	Escape character is '^]'.