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

From WHMCS Documentation
 
(2 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
==Configuring Sign-In with Twitter==
 
==Configuring Sign-In with Twitter==
  
−
<html><a href="https://vimeo.com/231458433" class="docs-video-tutorial"><em>Watch the video tutorial for this feature.</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
+
<div class="docs-alert-info">
 +
WHMCS uses Twitter API v1.1. Some Twitter accounts will require [https://developer.twitter.com/en/portal/products/elevated Elevated access] to use this version of the Twitter API.
 +
</div>
  
 
Twitter Sign In Integration requires a Twitter app and API credentials. You can create this using your existing Twitter account. Users will only see the app name you define.
 
Twitter Sign In Integration requires a Twitter app and API credentials. You can create this using your existing Twitter account. Users will only see the app name you define.
Line 11: Line 13:
 
To do this:
 
To do this:
  
−
# Go to <tt>https://developer.twitter.com/en/portal/dashboard</tt>.
+
# Log in to your Twitter account.  
−
# Log in to your Twitter account. <div class="docs-alert-warning">If you change the Twitter account under which you create the app, users must re-authenticate and re-link their accounts.</div>
+
#: <div class="docs-alert-warning">If you change the Twitter account under which you create the app, users must re-authenticate and re-link their accounts.</div>
−
# Click '''Create Project'''.
+
# Go to https://developer.twitter.com/en/portal/dashboard .
−
# Select a project name.
+
# Select '''Projects & Apps''' and then '''Overview''' from the left sidebar.
−
# Select an app name. [[File:Screenshot-3.png|thumb]]
+
# Click '''Create App'''.
−
# Save the '''API Key''' and '''API secret key'''.
+
# Enter an App name. [[File:Screenshot-3.png|thumb]]
−
# Go to app settings and click '''Edit''' in the '''Authentication Settings''' section.
+
# Save the '''API Key''' and API '''Secret Key'''.
−
# Enable '''3-legged OAuth'''.
+
# Go to '''app settings''' and click '''Set Up''' in the '''User Authentication Settings''' section.
 +
# Enable '''OAuth 2.0'''.
 +
# Set '''Type of App''' to '''Web App'''.
 
# Enter your WHMCS Client Area URL for the callback URLs and website URL.
 
# Enter your WHMCS Client Area URL for the callback URLs and website URL.
−
#* You '''must''' enter a valid callback URL.
+
#* You must enter a valid callback URL.
−
#* We recommend adding all three possible callback URLs, replacing <tt><nowiki>http://demo.whmcs.com/whmcs/</nowiki></tt> with your WHMCS installation URL:  
+
#*We recommend adding all three possible callback URLs, replacing http://example.com/whmcs/ with your WHMCS installation URL:
−
#** <tt><nowiki>http://demo.whmcs.com/whmcs/index.php</nowiki></tt>
+
#** http://example.com/whmcs/index.php
−
#** <tt><nowiki>http://demo.whmcs.com/whmcs/index.php/auth/provider/twitter_oauth/callback</nowiki></tt>
+
#** http://example.com/whmcs/index.php/auth/provider/twitter_oauth/callback
−
#** <tt><nowiki>http:///demo.whmcs.com/whmcs/auth/provider/twitter_oauth/callback</nowiki></tt> <div class="docs-alert-warning">Make sure that the '''WHMCS System URL''' in WHMCS and the Twitter '''Website''' and '''Callback URLs''' all include the same subdomain '''or''' all do not include a subdomain.</div>
+
#** http://example.com/whmcs/auth/provider/twitter_oauth/callback
 
# Click '''Save'''.
 
# Click '''Save'''.
 
# Log in to the WHMCS Admin Area.
 
# Log in to the WHMCS Admin Area.

Latest revision as of 13:38, 19 April 2023

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

Signinintegrationslogin.png

Configuring Sign-In with Twitter

WHMCS uses Twitter API v1.1. Some Twitter accounts will require Elevated access to use this version of the Twitter API.

Twitter Sign In Integration requires a Twitter app and API credentials. You can create this using your existing Twitter account. Users will only see the app name you define.

To do this:

  1. Log in to your Twitter account.
    If you change the Twitter account under which you create the app, users must re-authenticate and re-link their accounts.
  2. Go to https://developer.twitter.com/en/portal/dashboard .
  3. Select Projects & Apps and then Overview from the left sidebar.
  4. Click Create App.
  5. Enter an App name.
    Screenshot-3.png
  6. Save the API Key and API Secret Key.
  7. Go to app settings and click Set Up in the User Authentication Settings section.
  8. Enable OAuth 2.0.
  9. Set Type of App to Web App.
  10. Enter your WHMCS Client Area URL for the callback URLs and website URL.
  11. Click Save.
  12. Log in to the WHMCS Admin Area.
  13. Navigate to Configuration () > System Settings > Sign-In Integrations or, prior to WHMCS 8.0, Setup > Sign-In Integrations.
  14. Select Activate under the Twitter heading.
  15. Enter your Twitter API Key in the ConsumerKey field and the API Secret into the ConsumerSecret field.
  16. 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.

For troubleshooting help, see Troubleshooting Sign-In using Twitter.

Retrieved from "http://3.17.75.209/index.php?title=Configuring_Sign-In_using_Twitter&oldid=34052"