Difference between revisions of "Configuring Sign-In using Facebook"
(→Creating a Facebook App) |
|||
| Line 17: | Line 17: | ||
Facebook Sign In Integrations requires a Facebook App. You can create this using your existing Facebook account. Users will only see the App Name you define and not see anything relating to the account you use to create the app. | Facebook Sign In Integrations requires a Facebook App. You can create this using your existing Facebook account. Users will only see the App Name you define and not see anything relating to the account you use to create the app. | ||
| − | 1. Visit https://developers.facebook.com/apps/ | + | 1. Visit https://developers.facebook.com/apps/ <br> |
| − | 2. If not logged in, login to your Facebook account | + | 2. If not logged in, login to your Facebook account <br> |
| + | |||
| + | [[File:Facebooksignin1.png]] | ||
| + | |||
3. Click '''Add a New App''' | 3. Click '''Add a New App''' | ||
| − | 4. Enter a Display Name - this is the name people will see when authorizing your app - we recommend using your Company Name here | + | |
| − | 5. Enter a Contact Email - this email will be used for important communication about your app | + | [[File:Facebooksignin2.png]] |
| + | |||
| + | 4. Enter a Display Name - this is the name people will see when authorizing your app - we recommend using your Company Name here<br> | ||
| + | 5. Enter a Contact Email - this email will be used for important communication about your app<br> | ||
6. Click '''Create App ID''' | 6. Click '''Create App ID''' | ||
| − | 7. | + | |
| + | [[File:Facebooksignin3.png]] | ||
| + | |||
| + | 7. Next you will be asked to '''Select a product'''. Locate the '''Facebook Login''' product and click '''Set Up''' | ||
| + | |||
| + | [[File:Facebooksignin4.png]] | ||
| + | |||
8. On the '''Platform''' screen choose '''Web''' | 8. On the '''Platform''' screen choose '''Web''' | ||
| − | 9. | + | |
| + | [[File:Facebooksignin5.png]] | ||
| + | |||
| + | 9. Now you will be asked to provide the URL of your website. Here you should enter the full URL to the root domain of your website. In the example above, we have entered https://demo.whmcs.com/ <br> | ||
| + | |||
10. Hit Save and then click Continue | 10. Hit Save and then click Continue | ||
Revision as of 13:30, 22 August 2017
This article is part of the Sign-in Integrations feature.
Contents
Purpose
Enabling the Facebook Sign In Integration enables visitors and customers to register, sign in and connect their Facebook accounts with your WHMCS installation for faster sign-up and automatic sign-in.
Configuring Sign-In with Facebook
There are 3 steps required to setup Sign-In with Facebook:
- Create a Facebook App
- Retrieve the App Credentials
- Activate within WHMCS
Creating a Facebook App
Facebook Sign In Integrations requires a Facebook App. You can create this using your existing Facebook account. Users will only see the App Name you define and not see anything relating to the account you use to create the app.
1. Visit https://developers.facebook.com/apps/
2. If not logged in, login to your Facebook account
3. Click Add a New App
4. Enter a Display Name - this is the name people will see when authorizing your app - we recommend using your Company Name here
5. Enter a Contact Email - this email will be used for important communication about your app
6. Click Create App ID
7. Next you will be asked to Select a product. Locate the Facebook Login product and click Set Up
8. On the Platform screen choose Web
9. Now you will be asked to provide the URL of your website. Here you should enter the full URL to the root domain of your website. In the example above, we have entered https://demo.whmcs.com/
10. Hit Save and then click Continue
The remaining steps provide information intended for developers who are integrating Facebook Login for the first time. We've done the integration work so you can skip all of this.
Retrieving the App Credentials
To retrieve the credentials for the app you just created, follow the steps below.
1. Navigate to the Dashboard 2. The App ID is displayed here 3. The App Secret is masked by default. Click the Show button to reveal it.
Activating within WHMCS
- Login to the WHMCS Admin Area
- Navigate to Setup > Sign-In Integrations
- Select Activate under the Facebook heading
- Enter your Facebook App ID and your Facebook App Secret where requested
- Click Save & Activate
WHMCS will attempt to validate and test the details you have entered. Assuming the App ID and Secret are valid and successfully authenticate with the Facebook API, the values will be saved and the modal will close.
Congratulations! Facebook Sign In is now enabled.