Difference between revisions of "Configuring Sign-In using Facebook"
(DOCS-6836) |
(→Activating within WHMCS) |
||
| Line 97: | Line 97: | ||
# Login to the WHMCS Admin Area | # Login to the WHMCS Admin Area | ||
| − | # Navigate to Setup > Sign-In Integrations | + | # Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Sign-In Integrations''' or, prior to WHMCS 8.0, '''Setup > Sign-In Integrations'''. |
# Select Activate under the Facebook heading | # Select Activate under the Facebook heading | ||
# Enter your Facebook App ID and your Facebook App Secret where requested | # Enter your Facebook App ID and your Facebook App Secret where requested | ||
Revision as of 19:11, 4 August 2020
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 Integration 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 "My Apps" and then 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 Scenario. Locate the Integrate Facebook Login option, select it and click Confirm
8. You are now presented with your app "Dashboard". Click Finish Quickstart.
9. Select Web when asked which Platform you require.
10. Provide the URL of your website. You must enter the full URL to the root domain of your website. In the example below, we have entered https://demo.whmcs.com/
11. Hit Save and then click Continue
12. Select the Settings menu. Select Basic.
13. Provide your "App Domain". This must be the same domain you provided in Step 10.
14. Provide a Privacy Policy URL.
15. Provide a Terms of Service URL.
16. Provide a Category. Typically, this would be Business and Pages.
17. Save the changes
18. Toggle the Off switch in the top right corner to On
19. Confirm you'd like to make your App public.
Permissions
The default process for creating an App at Facebook includes permissions for email, public profile and user friends list.
WHMCS only requires the email and public profile permissions. The user friends list permission is not requested and users will not be asked to grant this permission when associating their account with WHMCS.
Retrieving the App Credentials
To retrieve the credentials for the app you just created, follow the steps below.
1. Navigate to the Dashboard
2. Select the Settings menu and select Basic
3. The App ID and Secret are shown here. 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 Configuration () > System Settings > Sign-In Integrations or, prior to WHMCS 8.0, 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.
Troubleshooting
For troubleshooting help, please refer to Troubleshooting Sign-In using Facebook