Introduction


The 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 Social Login feature during login and registration, enable and configure the functionality, add the required details in each Social Login apps, and activate each, all from the BuddyBoss Plugin Settings.


  • 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



  1. Enable Social Login


1. From your WordPress admin dashboard, go to BuddyBoss Plugin, click the Settings menu option > 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 for the pop-up box to appear

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.


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

  • 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






5. Add the required API keys in the pop-up box, then click the Save Changes button.



Note:

  • Key Configuration:

    • If the keys are correct and saved successfully, the Social Login checkbox can be checked.

    • If the keys are incorrect, an error message will appear with the following details:

      • Icon: Exclamation mark

      • Error Notice: Displayed in red for emphasis.

      • Message: "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 solely works when the Default Profile Avatar is selected with BuddyBoss.


  1. Create the Social Login App/s


Create the Social Login apps to generate the details required in the pop-up box field or settings.

  1. Google

  2. Facebook

  3. X (formerly known as Twitter)

  4. LinkedIn

  5. Apple


Screenshots:


Login page



Registration page

    


Profile > Account Settings > Social Accounts



Handling Feature Disable/Enable Scenarios:

  • If specific Social Login options were enabled and the admin disables the Social Login feature:

    • The data is saved but the feature remains disabled.

  • If the admin re-enables the social login feature:

    • The previously configured Social Login options are restored to their original state.


Customization of Social Icon Display:

  • Admins can adjust the priority/order of social icons, and these changes will dynamically reflect on the front end.


Custom Profile Fields

  • If you create a new account and have Custom Profile Fields on Sign Up, you will be redirected to the registration form, with the profile fields awaiting completion, while the social platform fills in what it can.

  • If you don’t have Custom Registration Fields, the new user will be redirected to the default Login Homepage.



Connect/Disconnect Social Accounts


  • If you have a profile on the site, logging in using Social Login will automatically link your profile, provided the email address matches.

  • 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.