How to Set Up Social Login for BuddyBoss

Introduction

The BuddyBoss Social Login feature allows users to log in and register on your BuddyBoss Platform (Web and App) using their social accounts, including Google, Facebook, X (formerly Twitter), LinkedIn, and Apple. Enabling Social Login enhances user convenience, boosts engagement, and simplifies account management.

Key Considerations for the BuddyBoss App

Mandatory Social Logins for App Publishing

If Social Login is enabled in the BuddyBoss App, Google, and Apple Social Logins are mandatory for publishing on app stores. Even if you use other providers (Facebook, X, LinkedIn), Google and Apple must be configured to ensure compatibility with device-associated accounts.

Optional Use of Google and Apple

Google and Apple Social Logins are optional only if your BuddyBoss App exclusively relies on your company’s account sign-in system.

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

Tutorial Video

Enabling Social Login

1. Access Social Login Settings

• Navigate to your WordPress Dashboard.
• Go to BuddyBoss Plugin > Settings > General > Registration.

2. Enable Social Login

• Check the box next to Enable Social Login.
• Click Save Settings to activate the feature.

3. Configure Social Login Providers

• After enabling Social Login, click the pen icon next to each provider to open the configuration pop-up.

• Enter the required API details for each provider:

Social Platform	Required Details
Facebook	App ID, App Secret
Google	Client ID, Client Secret
Google (App)	Client ID, Test Build Client ID
X (Twitter)	Client ID (V2), Client Secret (V2)
LinkedIn	Client ID, Client Secret
Apple	Private Key ID, Private Key, Team Identifier, Service Identifier

• Important: The Social Login checkboxes remain disabled until the required keys are saved.
• Click Save Changes to apply the configurations.

4. Pull Additional Data from Social Accounts

• Once Social Login is enabled and settings are saved, the Pull Additional Data from Social Account option appears.
• This feature allows user data synchronization during registration, including:
  • Name
  • Profile Picture
• Enable or disable data sync options based on your requirements.
• Click Save Settings to finalize changes.

5. Ensure Profile Picture Sync

• If the Profile Picture is not syncing:
  • Go to BuddyBoss > Settings > Profiles.
  • Ensure Profile Images > Default Profile Avatar is set to BuddyBoss.
• Note: Social Login profile pictures work only when BuddyBoss is selected as the default avatar.

6. Registration Options

• Choose from the following:
  • Enable both WordPress and Social Login registration.
  • Disable new registrations while allowing existing users to sign in using Social Login.
• Click Save Settings after configuring the options.

Creating Social Login Apps

To obtain the required API details, you must create Social Login Apps on each provider’s developer platform. Refer to their official documentation:

• Google Social Login Setup
• Facebook Social Login Setup
• X (Twitter) Social Login Setup
• LinkedIn Social Login Setup
• Apple Social Login Setup

Managing Social Login Features

Handling Enable/Disable Scenarios

• Disabled: If Social Login is disabled, configured settings are saved but inactive.
• Enabled: Previously saved settings are automatically restored when re-enabled.

Customizing Social Login Icons

• You can reorder social login icons from the Settings panel.
• Changes will dynamically reflect on the front end.

Custom Profile Fields Integration

• With Custom Fields: Users registering via Social Login are redirected to complete the required fields. If social account data is available, fields will be pre-filled.
• Without Custom Fields: Users are redirected to the default login homepage.

Connecting/Disconnecting Social Accounts

• Automatic Linking: If the social account’s email matches an existing profile, it is automatically linked.
• Manual Management: Users can manually connect or disconnect accounts:
  • Navigate to Profile Dropdown Menu > Accounts > Social Accounts.
  • Select Connect or Disconnect for the respective account.

This feature is available for both Web and BuddyBoss App users.

Troubleshooting & FAQs

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

A: Ensure Enable Social Login is checked. Verify all required API keys are correctly entered and saved.

Q: Why am I seeing an error message when logging in?

A: Double-check the API keys and secret credentials. Ensure Client IDs are correctly configured for both Web and App settings.

Q: Why is the Profile Picture not syncing?

A: Confirm Default Profile Avatar is set to BuddyBoss under BuddyBoss > Settings > Profiles. Social Login profile pictures work only with the BuddyBoss avatar setting.