Logging In with Facebook

Facebook login is only for writing comments. For regular users, see Managing Users.

Prerequisites

When you set up Facebook, you need the URLs of the following documents.

We recommend creating a blog in ManualWorks, writing each document as a post, publishing it, and using its URL.

Setting the Base URL

To log in with Facebook, you must set the base URL in General Settings. If the base URL is not set, the Facebook login button is not shown.

Setting Up Facebook

1

Log In to Meta for Developers

Log in to the following site.

https://developers.facebook.com/

You need a Facebook account.

2

Create an App

  1. Click the <1My Apps> menu at the top right of the screen.

  1. Click the <2Create App> button.

  1. Select <3Consumer> as the app type. Then click the <4Next> button.

  1. Enter the 5app name and 6app contact email. Then click the <7Create App> button.

After you click <Create App>, you are asked to confirm your Facebook password.

3

Basic Settings

  1. Select the 1app you created, and click the <2Basic> settings menu.

  1. Enter the 3privacy policy URL and the 4user data deletion URL you prepared in Prerequisites, and click the <5Save changes> button.

The terms of service URL is optional.

4

Set Up Facebook Login

  1. Click the <1Add Product> link.

  1. Click the <2Set Up> button for Facebook Login.

  1. Select Web as the platform for the app.

  1. Enter the base URL of ManualWorks in “4Site URL”, click the <5Save> button, and then click the <6Continue> button.

Skip “Set Up the Facebook SDK for JavaScript”, “Check Login Status”, and “Add the Facebook Login Button” by clicking the <Next> button.

5

Set <Valid OAuth Redirect URIs>.

  1. Click the <1Settings> menu.

  1. Enter the “2Valid OAuth Redirect URIs”, and click the <Save changes> button.

Replace https://dimdol.com with the base URL set in the <Admin | Preferences | General> menu of ManualWorks. Enter /r/oauth/auth as is.

6

App Review

By default, only the administrator accounts of the app (the Facebook account that created the app) can log in. After app review, all accounts can log in.

  1. Click the <1Permissions and Features> menu.

  1. Click the <3Get Advanced Access> button for the 2public_profile item.

    • Agree to use all data received through public_profile in accordance with the allowed usage.

    • Confirm your password.

  1. Click the <5Get Advanced Access> button for the 4email item.

    • Agree to use all data received through email in accordance with the allowed usage.

    • Confirm your password.

public_profile and email are provided by Facebook by default. ManualWorks uses only the user's name and email address from Facebook, so you can use them right away without additional review.

7

Switch the App Mode to Live

Regular Facebook accounts can log in only when the app mode is Live. Switch the app mode to Live.

You can switch to Live only after you set the privacy policy URL and the data deletion instructions URL.

In this process, you must complete the data use checkup and certify compliance with the Platform Terms and Developer Policies, and then submit.

Setting Up ManualWorks

Set up ManualWorks so that users can log in with Facebook.

  1. Go to the <Admin | Preferences | API> menu.

  2. Click the <Change> link in the <Log in with Facebook> panel.

  3. Enter the App ID and App Secret.

You can find the App ID and App Secret in the <1Basic> settings menu of Meta for Developers.

Click the <2Show> button to see the app secret.

Notes

Data Use Checkup

Facebook requires an annual check of your use of the login API. The app administrator must check Facebook's notifications and complete this every year.

If you do not complete this within the deadline, Facebook login stops working.