Introduction


The Social Login feature allows users to log in and/or register to your BuddyBoss Web and App using Google Social Login. 


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


Overview


Create the Google app and insert the required details in the pop-up box of Google 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


Pop-up Box

  • Web

    • Client ID

    • Client Secret

  • Android and iOS App

    • Client ID

    • Test Build Client ID


Create the Google App

  1. Navigate to https://console.developers.google.com/apis/

  2. Log in using your Google credentials

  3. You will need a project.

    • If you don't have a project, then you need to create one. Proceed by clicking the blue "Create Project" text on the right.

    • If you already have a project then navigate to the top bar and click the name of the project, which will bring up a modal. Proceed by clicking "New Project".

      Name your project and then click on the "      Create" button again.

    • Once you have a project, you will end up in the dashboard.

If you already have a Project, make sure you select the created project in the top bar.


  1. Click the “OAuth consent screen” button on the left-hand side

  2. Choose a User Type according to your needs and press "Create".

    • If you want to enable the Google Social Login for any users with a Google account, pick the "External" option.

  1. In the "App name" field, enter a name for your app. This will appear as the name of the app asking for consent.


  1. For the "User support email" field, select an email address that users can use to contact you with questions about their consent.

  2. Fill in the "Application home page" field with the URL of your homepage (e.g. https://sitename.com)

  3. Enter your Privacy Policy and Terms of Service links into the "Application privacy policy link" and "Application terms of service link" fields

  4. Under the "Authorized domains" section, click the "Add Domain" button and enter your domain name without subdomains (e.g. bbplatform.ddev.site)

  5. At the "Developer contact information" section, enter an email address that Google can use to notify you about any changes to your project.

  6. Click the "Save and Continue". Click this again on the "Scopes", and "Test users" pages.

  7. On the left side, click on the "Credentials" menu point, then click the "+ Create Credentials" button on the top bar

  8. Choose the "OAuth client ID" option



  9. Select the "Web application" under Application type

  10. Enter a "Name" for your OAuth client ID

  11. Under the "Authorized redirect URIs" section, click "Add URI" and add the below URL:

  12. Click on the "Create" button

  13. A modal should pop up with your credentials

    • If this doesn't happen, go to the Credentials in the left-hand menu and select your app by clicking on its name. You can copy and paste the "Client ID" and "Client Secret" from there

  14. At this point, your app is in Testing mode, so only a limited number of people can use it. To allow this app for any user with a Google account:

    • Click on the "OAuth consent screen" option on the left side

    • Then click the "PUBLISH APP" button under the "Publishing status" section

    •  Lastly, click the "Confirm" button


Enable Google Social Login for the BuddyBoss App


Follow these steps to configure Google Social Login for the BuddyBoss App on Android and iOS


Make sure to repeat the same process for your Test app


For Android

  • From the Credentials tab, click on +Create Credentials

  • Select OAuth Client ID

  • Select Android for the Application Type

  • Enter a Name for this Client ID

  • For the Package Name, enter your Release App Application ID

    1. Navigate to BuddyBoss App Plugin > Configure > Android Settings > App Configuration

  • Enter your SHA-1 Certificate Fingerprint

    Here's how to get your SHA-1 Certificate Fingerprint:

    • Login to your Google Console account

    • Click on your App from the list

    • From the sidebar menu, navigate to Test & Release > Setup > App Signing

    • Copy your SHA-1 certificate fingerprint

    • Note: For Release app or Test app, navigate to WordPress admin dashboard > BuddyBoss App > Build > click Install on Android Device button to download your SHA-1 Certificate Fingerprint. 



  • Click Create

  • Copy your Client ID and paste it to the Client ID field for Android App


Note:

Repeat these steps for your Test app by using its specific Application ID and SHA-1 Certificate Fingerprint.

This ensures that both your main app and test app are configured correctly for Google Social Login.



For iOS

  1. From the Credentials tab, click on +Create Credentials

  2. Select OAuth Client ID

  3. Select iOS for the Application Type

  4. Enter a Name for this Client ID

  5. Enter your Release App Bundle ID 

    1. Navigate to BuddyBoss App > Configure > iOS Settings > App Configuration to get your app Bundle ID

  6. Enter your App Store ID

    1. Log in to App Store Connect
       

    2. Click on your app from the list

    3. Click on App Information under General on the left side menu

    4. Copy your Apple ID

  7. Enter your Team ID

    1. Log in to the Apple Developer account

    2. Scroll down to the Membership Details section to get your Team ID

  8. Click Create
     

  9. Copy your Client ID and paste it to the Client ID field for iOS App



Note:

Repeat these steps for your Test app by using its specific App Bundle ID. 

This ensures that both your main app and test app are configured correctly for Google Social Login.

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