Introduction


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


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


Overview


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


  • The 'Pull Additional Data from Social Account' feature is not working for profile photos when using Facebook social login.


Pop-up Box

  • App ID

  • App Secret


Create the Facebook App

  1. Navigate to https://developers.facebook.com/apps/

  2. Log in with your Facebook credentials and click the "Create App" button

  3. Fill in the "Add an app name", and "App contact email" fields. The specified app name will appear on your Consent screen. Then click Next. 

  4. For Use Cases, select Authenticate and Request data from users with Facebook Login. Click Next. 

  5. Select which Business profile you want to connect to this app then click Next. 

  6. Click Go to Dashboard.

Customize Use Case

  1. From your App Dashboard, click Use Cases

  2. Click the "Use cases" tab on the left side, and then click the "Customize" button next to the "Authentication and account creation" item

  3. Under Permissions, click Add next to Email

  4. Click Settings below Permissions on the left sidebar

  5. Add the following URL to the "Valid OAuth redirect URIs" field:

https://sitename.com/wp-login.php?bb_social_login=facebook

  1. Click the "Save changes" button
        Note: If you receive a blank page after you press the "Save changes" button, try to refresh the page

Configure the App

  1. On the left side, click the "App settings" tab, then click "Basic"

  2. Enter your domain name in the "App Domains" field.

  3. Fill in the "Privacy Policy URL" field. 
    Provide a publicly available and easily accessible Privacy Policy that explains what data you are collecting and how you will use that data.

  4. At the "User Data Deletion", choose the "Data Deletion Instructions URL" option, and enter the URL of your page* with the instructions on how users can delete their accounts on your site.

To comply with GDPR, you should already offer the possibility to delete accounts on your site, either by the user or by the admin.

If each user has an option to delete the account, the URL should point to a guide
    showing the way users can delete their accounts.

If the accounts are deleted by an admin, then you should have a section with the contact details, where users can send their account erasure requests (e.g. Privacy Policy). 

In this case, the URL should point to this section of the document.

  1. Select a "Category" for your App. 

  2. Upload an App icon. It should be 1024x1024.

  3. Click the "+ Add platform" button at the bottom of the page

  4. Select "Website" as the platform, then press "Next"

  5. Enter your site URL

  6. Click "Save changes".

    By default, your application only has Standard Access for the "public_profile" and "email" permissions, which means that only you can log in with it. 

    To get Advanced Access you will need to go through the Business Verification, and you can start on the "Verification" tab on the left side.

Prepare the App for Verification

  1. On the left menu, navigate to Review > App Review

  2. Click Edit on your current request

  3. Answer Data handling questions then click Submit

  4. Complete the app verification process

    1. Provide Verification details

    2. How will your app use the Advanced Access Email permission

    3. How will your app use the Advanced Access public_profile permission

  5. Click Submit for Review. 

Publish App

  1. On the left menu, click Publish then click Publish at the bottom

  2. Go to the Required Actions tab on the left menu

  3. Click Get Started on the Annual Data Use Checkup. Complete the following tabs:

    1. Verification

    2. Data Handling

    3. Usage Check

    4. Testing Instructions

    5. Terms & Policies

  4. Click Submit. 


Once all are done, click on the "App settings" tab, then click "Basic"

At the top of the page, you can find your "App ID" and you can see your "App secret" if you click on the Show button. 

Copy your keys and paste it to the App ID and App Secret field for Facebook. 


  1. Paste these keys back to your site to complete the setup for Facebook Social Login.

  2. You can now enable the Apple Social Login checkbox and click Save Settings


Add iOS and Android Platforms for the BuddyBoss App

To enable Facebook Social Login in the BuddyBoss App, follow these steps:

For iOS

  1. From your App Dashboard, go to App Settings > Basic

  2. Scroll down to the bottom of the screen then click + Add Platform

  3. From the pop-up, select iOS then click Next

  4. Enter your Release and Test App Bundle IDs

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

For Android

  1. From your App Dashboard, go to App Settings > Basic

  2. Scroll down to the bottom of the screen and click Add Platform

  3. Select Android then click Next

  4. From the Android Store pop up, select Google Play, then click Next

  5. Add Key Hashes

    1. Go to https://tomeko.net/online_tools/hex_to_base64.php

    2. Under the Hex String field, enter your SHA-1 Certificate Fingerprint then click Convert

      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. 


    3. Copy the Output (base64)


  6. For the Package Names, enter your Release and Test App Application ID

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

  7. For the Class Name, enter: com.bbapp.MainActivity

  8. Once everything is configured, click Save Changes. 


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