Introduction


The Social Login feature allows users to log in and/or register to your BuddyBoss Web and App using X (formerly Twitter) Social Login. 


Start by following the Social Login article to enable and configure this feature.


Overview


Create the X app and insert the required details in the pop-up box of X Social Login to enable and use it during log-in and/or user registration. 



  • Any changes here will require new builds for your iOS and Android apps to ensure they are updated.


  • If you have the BuddyBoss App and you enable Social Login, then Google and Apple Social Login:

    • Are required if you enable at least one Social Login (i.e. Google sign-in, Facebook login, X sign-in, or LinkedIn sign-in). 

      • It is a publishing requirement, as well as it ensures that any app users have the option to log in using their device-associated accounts when third-party login systems are present in your app.

    • Not required if your BuddyBoss App exclusively uses the account sign-in and set up systems of your company


  • Due to limitations with X's v2 API, users cannot register using their X account. However, they can connect their X account after logging in. To do so, navigate to Profile > Account Settings > Social Accounts. Provider - X (formerly Twitter).


Pop-up Box

  • Client ID (V2)

  • Client Secret (V2)




Create the X App

  1. Log in with your X credentials

  2. Navigate to Developer Portal https://developer.twitter.com/en/portal/projects-and-apps

  3. You will need a Developer account.

    • If you don't have a developer account, apply for one by filling in all the required details. This is required to proceed with the setup.

  4. From the Dashboard, click the "+ Create Project" button


 


  1. From the Projects & Apps page > “Project name” tab, name your project, enter it in the text field and click the Next button



  1. In the “Use case” tab, click the dropdown menu, choose which best describes how you intend to use the X Developer Platform, and then click the Next button


        7. In the “Project description” tab, describe your new Project in the text field and click Next


 


        After clicking the Next button, your Project will become a sub-page under Projects & Apps page

  1. In the "App name" tab, enter a name for your app, then press "Next"



The next tab, Keys & Tokens, will contain your API Key, API Key Secret, and Bearer Token.


  1. To obtain the Client ID and Client Secret, click the “App settings” button and complete the setup




You will be directed to Projects & Apps > name of your app > Settings tab.

  1. At the “User authentication settings”, click the “Set up” button



  1. In the “User authentication settings" page, configure each section

    • For App permissions, choose the "Read" option

If you want to access the user’s email address, make sure to enable the "Request email from users" toggle button. In this case, you will also need to fill in the "Terms of Service" and "Privacy Policy" fields with the corresponding URLs


  • For Type of App, select the "Web App, Automated App or Bot" option


 

  • For the Callback URI / Redirect URL field in the App info

    1. You can add this URL to the field: https://sitename.com/wp-login.php

    2. You can also obtain the URL from your WordPress admin dashboard, go to BuddyBoss Plugin, click the Settings menu option > General > Registration > click the pencil icon for X, copy the Callback URI / Redirect URL, and enter in the text field.



    Then, add the Website URL and other app information before you click Save

    



  1. You will be directed to the page for your OAuth 2.0 Client ID and Client Secret. Make sure to copy the details before you click Done


  1. Add the credentials to the X Social Login pop-up box

    • From WordPress admin dashboard > go to BuddyBoss Plugin, click the Settings menu option > General > Registration > click the pencil icon for X > and click Save Changes.


After clicking the Save Changes button, there will be a pop-up of the Login to X page.

  1. Sign in using the available options, or add your credentials in the text field and click Next


Once signed in, you may be directed to your X homepage. You can close the page and go back to the X Social Login pop-up box, then click the Verify Settings Again button.

  1. In the X pop-up page, click the “Authorize app” button



  1. Once done, there will be a notice in your X Social Login pop-up box: “Settings have been verified. Please wait while we redirect you.” before it closes.




  2. You can now enable the X Social Login checkbox and click Save Settings


If the checkbox for the X social login remains greyed out after clicking Save Changes, click the pencil icon again and then select Verify Settings.