This document provides instructions for properly setting up a Facebook application to enable user login/registration via Facebook on your site.

Creating a New App

You need to create a Facebook app to allow users to log in to your site with their Facebook account. To create a new Facebook app, please follow these steps:

1. Go to the Facebook Developers site.

2. If you are not logged in, log in using your Facebook account details.

3. Once logged in, navigate to ‘My Apps‘.

4. Click on the ‘Create App’ button. It will lead you to the app creations page.

After clicking My Apps, click the Create App button to start creating a new Facebook App.

Configure App

1. Enter App Details

On the App details screen:

• Enter your App Name.
• Enter your App Contact Email.

The contact email will be used by Meta to contact you regarding your app, including important notifications about policies, restrictions, or account recovery.

After entering the required details, click Next.

2. Select the Use Case

On the Use cases screen, select:

Authenticate and request data from users with Facebook Login

This use case allows your application to authenticate Facebook users and request the required permissions.

After selecting the use case, click Next.

3. Select a Business Portfolio

On the Business screen, select the business portfolio that you want to connect to the app.

If you do not want to connect a business portfolio at this stage, you can select:

I don’t want to connect a business portfolio yet.

You can also create a new business portfolio from this screen if required.

After making your selection, click Next.

4. Review Publishing Requirements

Meta will display the Publishing requirements for your app.

Depending on the selected use case, you may be required to complete:

• Business Verification
• App Review

These requirements must be completed before you can obtain the required access to user and business data through Meta’s APIs.

Click Next to continue.

5. Review Your App Details

The Overview screen will display the information you entered, including:

• App Name
• App Email
• Selected Use Case
• Connected Business Portfolio
• Publishing Requirements

Review the information carefully.

If everything is correct, click Create app.

6. Upon successful creation, a message window will appear that your app has been created. Click the ‘Go to Dashboard’ button to proceed to the dashboard.

Customize and Publish App

1. In the dashboard, click on the ‘Customize adding a Facebook Login button’ to set up your product.

2. Scroll down to the Permissions section and add ‘public_profile’ and ’email’ permissions by clicking on the ‘Add’ button.

3. After you have added the permissions, go to settings by clicking on the ‘Go to settings’ button.

4. In the Client OAuth Settings, you need to enter “Valid OAuth redirect URIs” from our plugin settings.

See the example below: https://yourdomain.com/woocommerce-social-login/?wooslg=facebook

5. After you have saved the changes, go back to Customize and click on ‘Go to quickstart’

6. Click on “Web” to select the web platform for your Facebook App.

Then add your Site URL, and click the “Save” button.

Prepare and Submit for App Review

Note: Additional steps may be required depending on your app configuration. Make sure you complete any required business verification, data handling questions, and other requirements before submitting your app for App Review.

If you do not have a Facebook Business account, follow the instructions provided here.

1. In the Prepare and Submit for App Review option, click on ‘Review and complete testing requirements‘, it will redirect you to Graph API Explorer.

2. Click on open Graph API Explorer

3.On the right side of the Graph API Explorer, add the public_profile and email permissions. To add a permission, go to Permissions → User Data Permissions → email.

4. Once the permissions are added, click Generate Access Token and then click Submit.

5. Go back to your App’s Dashboard, and click on Business Verification, it will redirect you to the verification page. This is where you can add your business account.

6. This step is necessary to obtain access to user data, commonly referred to as advanced access in certain applications. Completion of this process is restricted to individuals with full control of a Business Account. For further information on business verification, please refer to this article.

7. Once you have successfully added a verified business account, return to the App Dashboard from the side menu, click on Review → App Review. This will redirect you to data handling questions where you need to provide answers related to the app review.

Publish

1. Go to the Publish tab from the side navigation menu. Then click on the ‘Go to app settings‘.

2. You must fill in the following information: Privacy Policy URL, Terms of Service URL, User data deletion and you can also include an app icon to make the app appear more professional. Then click the ‘Save changes‘ button.

For the “Data Deletion Instruction URL,” you can use a URL similar to the following example.

E.g https://www.wpwebelite.com/facebook-privacy-policy/#deletion-request

Additionally, your page should include a description of the “User data deletion request” as shown in the image below:

3. To begin, select “Answer questions about data handling,” and a window will promptly appear. Within the Usage Check tab, carefully review and confirm the data usage permissions and features you have added. Use the checkboxes to indicate your confirmation and agreement, and then click the confirm button to proceed.

4. Now, in the Data Handling tab, provide information regarding your data handling practices to obtain access to permissions. This is a mandatory step for App Review and the subsequent launch of your app. Answer the questions and click the Submit button.

5. Ensure all required settings are completed and use cases are reviewed before you click on the ‘Publish’ button, the app can’t be published if the requirements are incomplete.

1. After clicking the ‘Publish‘ button, you may be presented with a security check.
2. After successfully publishing your app, a confirmation message will be displayed indicating that it is now available for the public to use. To proceed to the next step, simply click the ‘Done‘ button.

App ID & App Secret

With your app successfully published, the next step is to integrate Facebook with WooCommerce Social Login. To achieve this, you’ll need both the App ID and App Secret.

In the side navigation menu, navigate to App Settings → Basic. Here, you’ll find both the App ID and App Secret.

Copy the App ID and App Secret, then proceed to wp-admin → WooCommerce Social Login → Settings → Facebook tab. Paste the copied values into the respective fields and finalize the process by clicking the ‘Save Changes‘ button.

Show Social Login Button on Login & Registration Form.

To create a Facebook App, go to the Facebook Developers site.

Step 1: From the dashboard, Click on the “Create App” button.

Note: You need to use a personal Facebook Account for creating an App. A business account won’t work. Your personal account needs to be a verified Facebook account. If your account isn’t verified yet, you’ll receive a text message from Facebook to verify your account. So make sure, that you have a mobile number set within your account, otherwise you won’t be able to create an App.

Step 2: Enter the App Display Name and the contact email and click the “Create App ID”.

Step 3: Now it will redirect to the “Add Product” page and in this page click the “Set Up” button in “Facebook Login”.

Step 4: Click the “Web” button.

Step 5: In the “Site URL” section add your site url and save it.

Note: If the “Quickstart” page is blank and you cannot enter the domain url, please go to “Settings → Basic” section, just below the Dashboard and then click the “Add Platform” as shown below.

Then select the “website” as given below.

In this page you can add the site url and save it.

Step 6: Click on the “Facebook Settings” as shown below.
Here enter the “Valid OAuth redirect URIs”.

Note: You can see the OAuth redirect URI in the Facebook settings in the plugin.

Please use this OAuth redirect URI in the facebook settings.

After entering the OAuth redirect URI and enable the “Client OAuth Login and Web OAuth Login”, please save the changes.

Step 7: The app is ready now. Click the “Settings → Basic” link in the menu to see the app id and secret.

In the “Settings → Basic” we can see the App ID and App Secret.

The App ID and App Secret are now ready. Click the “Show”button to see the App Secret. (The app secret is in alphanumeric and DON’T use ******* as App Secret.)

Step 8: Here the app is in development mode. Only the developer can view the posts now.

We need to “submit the app for approval” and after the app get approved, we can make the app public and the users can see the posts in the facebook.

The App Review Process Submission is given below.

1: First of all, individual OR business verification is necessary to got app approval. As you are an end user of the plugin, you have to do individual verification for the app. Simple steps you can found here.

Once individual verification done, you will receive verified badge like the screenshot below:

2: Go to “App Review → Permission and Features” menu

3: Find ( business_management, pages_show_list, pages_read_user_content, pages_manage_metadata, pages_read_engagement, pages_manage_posts ) permissions and click the “Request” button in front of each one.

4. Click the “Continue the Request” button. Fill the form for each permission, and send your App to review. You need to wait up to 5 days. A random Facebook worker will review it. If that worker does not have knowledge about plugins or WordPress, he does not review your request properly and declines it. Please try to re-submit the same request again. Eventually, your request will be accepted. Use this text for review form:

Step 9: After reviewed by Facebook, they will ask for enter the business details. (At the time of app submission this option is not available. We can see this after the review of Facebook)

Once the app get approved, you can see the permissions approved with a green bubble under the “Approved Items”.

Now make the app “Live”

To make the app ‘Live/Public’, please go to the ‘App Review‘ page.

In this page please select the ‘Live/Public’ mode by selecting the ‘YES’ button and a ‘green indicator’ will display next to the app name as in the below image.

You can now use the facebook app keys in the plugin.
Now enter these keys in the plugin settings in your site.
After entering the keys in the facebook settings page, you need to “Authorize” the account. (The authorization section is present in the wordpress plugin section).
You can see the FB pages in the settings page only after authorizing FB account.
When you click on the “Authorize” button, it will redirect to a facebook popup dialog box.

Step 1: There are some warnings but you can ignore those and click the “OK” button.

Step 2: Select the “Public” option and click OK.

Step 3: Click OK and the authorization is complete.

Now you can see all your fb pages and you can select the fb page to auto publish.

Note: If you are doing group posting, you have to add your Facebook app within that group on which you are posting. Follow the steps mentioned in the link here.