Social Logins

Before We Start

Social logins require a little bit of preparation, but it's really worth it. We've worked hard to shoehorn both Google and Facebook social logins and to do it in a way that maintains all the normal UserSpice goodness.

What makes the UserSpice implementation so unique is that it allows your users to use all 3 methods (traditional, Facebook, and Google) without winding up with 3 accounts. If your user has a traditional account, they can choose to use either of the social options at any time and it will make zero difference in their experience. If the first time they user creates an account using one of the social options to begin with, they can simply click the "forgot password" link to make themselves a password and can use all 3 methods. If that doesn't make sense, you'll just have to keep going and it will soon.

PLEASE NOTE: It can take a few minutes to 1 hour for those callback URLs you setup to be active in Google/Facebook's system. Give it a little time.

Setting up Google

Note: It seems as if FB and Google change these settings weekly. If these instructions are wrong, please let us know in the forums! Step 1: Visit https://console.developers.google.com(You may have to create an account)
Step 2: On the left side, click "Credentials"
Step 3: Click "Create Credentials-->OAuth Client ID-->Web Application"
Step 4: Give it a name.
Step 5: For "Authorized Redirect URI's, add the complete path to the oauth_success.php file. If you are on localhost in a subfolder called userspice, use
http://localhost/userspice/users/oauth_success.php
If you are on mydomain.com, use
http://mydomain.com/users/oauth_success.php
Step 6: Click Create.
Step 7: Copy your Client ID and Client Secret and put them in the UserSpice Admin Dashboard.
Step 8: On the UserSpice Admin Dashboard, put the full url of your website (including subfolder if necessary)
Step 9: Put the full path to your oauth_success.php file (should be the same as the one you put in the Google console).
Step 10: Change Enable Google Login to "Enabled"
Step 11: Save your settings.
Step 12: Give it a whirl!
Step 13: Visit the forums if you have any issues.

Setting up Facebook

Note: It seems as if FB and Google change these settings weekly. If these instructions are wrong, please let us know in the forums! Step 1: Visit https://developers.facebook.com/(You may have to create an account)
Step 2: Under My Apps (Upper right corner) click Add App.
Step 3: Choose website (www).
Step 4: Type a name for your App, give it a category, and click "Create App ID"
Step 5: Fill in captcha if necessary
Step 6: Click Facebook Login->Set up -> www/web
Step 7: Put the URL for your site, click save & continue
Step 8: Keep clicking continue until you get through all the steps
Step 9: On the left, click App Review and change Make Public to yes
Step 10: On the left, click settings. Copy your App ID and App Secret into your UserSpice dashboard
Step 11: On UserSpice dashboard Enable Facebook Login Step 12: Enter the proper path for the Facebook callback URL. Step 13: Go on the left side and under Products->Facebook Login->settings, paste your full callback url (https://yoursite.com/users/fb-callback.php) in the valid OAuth redirect URIs box. Step 14: Give it a whirl!
Step 15: Visit the forums if you have any issues.
Step 16: Yell at facebook for changing this garbage on a weekly basis.