Difference between revisions of "Configuring Sign-In using Twitter"

Revision as of 14:34, 4 June 2018

This article is part of the Sign-In Integrations feature.

Purpose

Enabling the Twitter Sign In Integration enables visitors and customers to register, sign in and connect their Twitter accounts with your WHMCS installation for faster sign-up and automatic sign-in.

Configuring Sign-In with Twitter

There are 2 steps required to setup Sign-In with Twitter:

Create a Twitter App and Retrieve API Credentials
Activate Twitter Sign In within WHMCS

Create a Twitter App and Retrieve API Credentials

Twitter Sign In Integration requires a Twitter App and API Credential Set. You can create this using your existing Twitter account. Users will only see the App Name you define and not see anything relating to the account you use to create the project.

Be aware that the Twitter account under which you create the app can not be changed without requiring users to re-authenticate and re-link their accounts so it is important to set the app up under an account that you will always have access to.

1. Visit https://apps.twitter.com/
2. If not logged in, login to your Twitter account
3. Click the Create New App button

4. Enter a Name, Description and Website URL for your App. You must also enter a valid URL in the Callback URL. The URL you enter here is not used, but a URL must be defined to enable WHMCS to utilise callbacks.

5. If you do not yet have a phone number defined inside your Twitter account, you will see the following error upon submitting. To create an App, Twitter requires that you have a valid phone number registered in your account with them. You must do this before continuing.

6. After submitting the App Creation form, you should see a success confirmation page that looks as follows.

7. Select the Settings tab. In the Application Details section, ensure that the Enable Callback Locking option is disabled.

8. Select the Permissions tab. WHMCS only requires Read permissions so you can change the default Access permission level to Read only. Then hit Update Settings

9. Now select the Keys and Access Tokens tab. Your API Key and Secret will then be displayed. These are the values you will need to activate Twitter Sign In within WHMCS so store these in a safe place.

You can now proceed to Activate Twitter Sign In within WHMCS.

Activate Twitter Sign In within WHMCS

Login to the WHMCS Admin Area
Navigate to Setup > Sign-In Integrations
Select Activate under the Twitter heading
Enter your Twitter API Key and API Secret where requested
Click Save & Activate

WHMCS will attempt to validate and test the details you have entered. If the API Key and Secret are valid and successfully authenticate with the Twitter API, the values will be saved and the modal will close.

Congratulations! Twitter Sign In is now enabled.

Troubleshooting

For troubleshooting help, please refer to Troubleshooting Sign-In using Twitter

@@ Line 40: / Line 40: @@
 [[File:Twittersign4.png]]
-. Select the '''Permissions''' tab.  WHMCS only requires Read permissions so you can change the default Access permission level to ''Read only''. Then hit '''Update Settings'''
+. Select the '''Settings''' tab. In the Application Details section, ensure that the ''Enable Callback Locking'' option is disabled.
+[[File:Twittersign7.png]]
+. Select the '''Permissions''' tab.  WHMCS only requires Read permissions so you can change the default Access permission level to ''Read only''. Then hit '''Update Settings'''
 [[File:Twittersign5.png]]
 . Now select the '''Keys and Access Tokens''' tab. Your API Key and Secret will then be displayed. These are the values you will need to activate Twitter Sign In within WHMCS so store these in a safe place.
 [[File:Twittersign6.png]]

Documentation