BuddyBoss Social Login

Introduction

The BuddyBoss Social Login feature allows users to log in and/or register to your BuddyBoss Web and App using Google, Facebook, X (formerly known as Twitter), LinkedIn, and Apple social accounts.

Overview

To use the BuddyBoss Social Login feature during login and registration, enable and configure the functionality, add the required details in each Social Login app, and activate each, all from the BuddyBoss Plugin Settings.

Key Considerations for the BuddyBoss App: – If Social Login is enabled in the BuddyBoss App, Google and Apple Social Logins are required for app publishing, even if only one social login provider (Facebook, X, LinkedIn) is used. This ensures users can sign in with device-associated accounts. – Google and Apple Social Logins are not required if the BuddyBoss App exclusively uses your company’s account sign-in system.Any changes to Social Login settings require new iOS and Android app builds. – Any changes here will require new builds for your iOS and Android apps to ensure they are updated.

Enable Social Login

1. In your WordPress admin dashboard, navigate to BuddyBoss Plugin > Settings > General > Registration.

2. Click the checkbox for Enable Social Login

3. Click the Save Settings button

4. Click the pen icon next to each Social Login icon to open the configuration pop-up box

Social Login options and the required details (Pop-Up Box)

The following table outlines the required details for each Social Login provider:

• Facebook
  • App ID
  • App Secret
    
• Google
  • Web
    • Client ID
    • Client Secret
      
  • Android and iOS App
    • Client ID
    • Test Build Client ID
      
• X (formerly Twitter)
  • Client ID (V2)
  • Client Secret (V2)
    
• LinkedIn
  • Client ID
  • Client Secret
    
• Apple
  • Private Key ID
  • Private Key
  • Team Identifier
  • Service identifier

Note: The checkbox of the Social Login apps will not be accessible until the required keys are added in the pop-up box and saved to each social platform.

5. Enter the required API keys in the pop-up box for each provider then click the Save Changes button.

• Key Configuration Notes:
  
  • Success: Correct keys enable the Social Login checkbox.
  • Failure: Incorrect keys trigger a red error message with an exclamation point: “Error: Please check and try again.”

Example:

6. Pull Additional Data from Social Account

• This option will be visible after you click Enable Social Login, then Save Settings. It allows you to sync the name and profile picture during registration.
  
  • You can enable or disable the following data based on your needs.
    
    • Name
    • Profile Picture

7. Click the Save Settings button

If the Pull Additional Data from Social Account feature for Profile Picture is not working, check using the below Settings: BuddyBoss > Settings > Profiles. Then set Profile Images > Default Profile Avatar > Select BuddyBoss option. Social Login app Profile Picture only works when the Default Profile Avatar is selected with BuddyBoss.

8. Registration Option

• You have the options to Enable the use of WordPress and Social Login, or Disable registration but allow sign in from those who already have an account.
  
  Once done, click the Save Settings button.

Create the Social Login App/s

Create the Social Login apps to generate the details required in the pop-up box field or settings. Refer to each platform’s developer documentation for instructions.

1. Google
2. Facebook
3. X (formerly known as Twitter)
4. LinkedIn
5. Apple

Screenshots:

Login page

Registration page

Handling Feature Disable/Enable Scenarios: Disabled: if specific Social Login options are enabled but the admin disabled the social login feature, then the data is saved but the feature remains disabled. Enabled: if the admin re-enables the Social Login feature, then the configuration will be restored. Customization of Social Icon Display: Admins can adjust the order of social icons, and these changes will dynamically reflect on the front end. Custom Profile Fields With Custom Fields: users signing up via Social Login are redirected to complete any required Custom Profile Fields. Pre-existing fields will be pre-filled by the social platform. Without Custom Fields: users are redirected to the default login homepage. Connect/Disconnect Social Accounts Automatic Linking: Social login automatically links existing profiles if the email addresses match. Manual Management: to manage or connect social accounts to a logged-in user, go to Profile dropdown menu > Accounts > Social Accounts. You can Connect or Disconnect your profile from your Social Accounts from here. This is also the process for any users using the BuddyBoss App.