How to Set Up X (formerly Twitter) Social Login for BuddyBoss

Introduction

X Social Login (formerly known as Twitter) allows users to seamlessly log in or register on your BuddyBoss Platform (Web and App) using their X accounts.

This guide provides step-by-step instructions on enabling and configuring X Social Login, enhancing user convenience while simplifying account management.

Prerequisites and Key Considerations

App Publishing Requirements

• If you enable Social Login in the BuddyBoss App, both Google and Apple Social Logins are required for publishing on app stores. This is mandatory even if other social providers (e.g., X, Facebook, LinkedIn) are used, ensuring compatibility with device-associated accounts.
• Google and Apple Social Logins are optional only if the BuddyBoss App exclusively uses your company’s account sign-in system.

Important:
Due to limitations with X’s v2 API, users cannot sign up using their X account. However, after logging in, they can connect their X account by going to:
Profile > Account Settings > Social Accounts and selecting X (formerly Twitter) as the provider.

Note: Any changes to the Social Login settings require new builds for both iOS and Android apps. Ensure to regenerate and publish updated app versions after making any modifications.

Required Information for X Social Login

To enable X Social Login, you need the following details:

• Client ID (V2)
• Client Secret (V2)

Creating an X App for Social Login

Follow the steps below to create an X App and obtain the required Client ID and Client Secret for integrating X Social Login with your BuddyBoss Platform.

Step 1: Access X Developer Portal

1. Navigate to the X Developer Portal.
2. Log in using your X credentials.

Step 2: Apply for Developer Account

• If you don’t have a Developer Account:
  1. Apply for one by filling in all the required details.
  2. Approval is required before proceeding with the setup.

Step 3: Create a New Project

1. From the Dashboard, click on the + Create Project button.

2. In the Project Name tab:
   • Enter a name for your project in the text field.
   • Click Next.

3. In the Use Case tab:
   • Select the option that best describes how you intend to use the X Developer Platform.
   • Click Next.

4. In the Project Description tab:
   • Describe your project in the text field.
   • Click Next.

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

Step 4: Create a New App

1. In the App Name tab:
   • Enter a name for your app.
   • Click Next.

2. In the Keys & Tokens tab, you will find:
   • API Key
   • API Key Secret
   • Bearer Token

Step 5: Obtain Client ID and Client Secret

1. Click the App Settings button to complete the setup.

2. You will be redirected to Projects & Apps > [Your App Name] > Settings.
3. Under User Authentication Settings, click Set Up.

Step 6: Configure User Authentication Settings

1. In the User Authentication Settings page, configure the following sections:
   • App Permissions:
     • Select Read to grant read-only permissions.
     • To access the user’s email address, enable Request email from users.
     • If enabled, you must also provide Terms of Service and Privacy Policy URLs.
   • Type of App:
     • Select Web App, Automated App or Bot.

• Callback URI / Redirect URL:
  • Enter the following URL:
    https://yourdomain.com/wp-login.php
  • Alternatively, navigate to:
    • WordPress Dashboard > BuddyBoss Plugin > Settings > General > Registration.
    • Click the pencil icon for X.
    • Copy the Callback URI / Redirect URL and paste it here.

• Website URL:
  • Enter your website’s URL.

2. Click Save to complete the setup.

Step 7: Obtain OAuth 2.0 Client ID and Client Secret

1. After saving, you will be redirected to the page displaying your OAuth 2.0 Client ID and Client Secret.
2. Copy the details before clicking Done.

Step 8: Complete Setup in BuddyBoss Platform

1. Go to your WordPress Dashboard.
2. Navigate to BuddyBoss Plugin > Settings > General > Registration.
3. Click the pen icon next to X Social Login.
4. Paste the copied Client ID and Client Secret into the respective fields.
5. Click Save Changes.

Step 9: Verify and Enable X Social Login

1. After clicking Save Changes, a pop-up for Login to X will appear.

2. Sign in using your X credentials.
3. In the X pop-up, click Authorize App.

Once verified, a message will appear: Settings have been verified. Please wait while we redirect you.

4. You can now enable the X Social Login checkbox.
5. Click Save Settings to finalize.

Note: If the checkbox for X Social Login remains greyed out, click the pencil icon again and select Verify Settings.

Troubleshooting and FAQs

Q: Why is the X Social Login not appearing on my site?

A: Ensure Enable Social Login is checked in BuddyBoss Settings. Verify that the Client ID and Client Secret are correctly entered and saved.

Q: Why can’t users register using X Social Login?

A: Due to limitations with X’s v2 API, registration using X accounts is not supported. Users can only connect their X account after logging in.

Q: Why is the X Social Login checkbox greyed out?A: Click the pencil icon next to X Social Login and select Verify Settings to ensure all configurations are correct.