Skip to content
WP PowerSuiteWP PowerSuite Docs

Quick navigation

Popular modules

Browse by category

Security19/19Login & UserssoonAdminsoonContentsoonMediasoonSEO & VisibilitysoonSpeedsoonSite Toolssoon
↑↓ navigate↵ openesc close154 guides · 155 modules

Facebook Sign In

Facebook Sign In adds Continue with Facebook so visitors can use their Meta account instead of another password - on the login screen, via shortcode, or on WooCommerce forms.

Requires an active WP PowerSuite license.

What it does

Section titled “What it does”
  • Uses Facebook Login OAuth (email, public_profile) once App ID and App Secret are saved.
  • Shows a Facebook button on the login screen (and optionally WooCommerce).
  • Supports shortcodes [facebook_sign_in] and [social_login providers="facebook"].
  • Callback URL uses ?wpps_auth=facebook on your site home (register this URI in the Facebook App).
  • Optional new-user registration, default role, redirect after login, and button style/display.
  • Warns when the site is not on HTTPS - Meta expects a secure callback.

Until App ID and App Secret are both set, the module does not boot the sign-in UI or callback handling.

When to use it

Section titled “When to use it”
  • You want password-light sign-in for members or customers who already use Facebook.
  • You’re combining providers with [social_login].
  • Shoppers should sign in with Facebook on WooCommerce My Account / checkout.

When not to use it

Section titled “When not to use it”

Settings

Section titled “Settings”

Open the module’s advanced settings (gear icon):

Setting Key Notes
App ID app_id Required. From developers.facebook.com.
App Secret app_secret Required.
Button style button_style default (Filled), outline, or minimal.
Label & icon button_display label (text + icon) or icon.
Inline row button_label_inline Optional layout for text + icon.
Allow New User Registration allow_registration Create a WP user on first Facebook sign-in.
Bypass “Anyone can register” bypass_registration_setting Allow registration even when WP registration is off.
Default role default_role subscriber (default), contributor, author, or editor.
Redirect after login redirect_after_login Optional destination; blank = homepage.
WooCommerce woo_login Show on WooCommerce login, registration, and checkout (when WooCommerce is active).

Copy the Valid OAuth Redirect URI shown in settings into Facebook App -> Facebook Login -> Settings. Public callback form: https://your-site.com/?wpps_auth=facebook.

Request email and public_profile (included by default with the Facebook Login product).

Shortcodes

Section titled “Shortcodes”
  • [facebook_sign_in] - Facebook-only button.
  • [facebook_sign_in style="outline"] - style override.
  • [social_login providers="facebook"] - unified social shortcode.

How to enable it

Section titled “How to enable it”
  1. Create a Facebook App at developers.facebook.com, add the Facebook Login product, and note App ID / Secret.
  2. In WordPress: WP PowerSuite -> Modules -> Facebook Sign In - turn on (license required).
  3. Open settings, paste App ID and App Secret, add the redirect URI in Meta’s console, then save.
  4. (Optional) Enable registration, WooCommerce login, and button styling.

How to test it

Section titled “How to test it”
  1. Log out and open wp-login.php (or a page with [facebook_sign_in]).
  2. Click Continue with Facebook and complete Meta’s consent screen. ✅ Existing linked user: signed in.
  3. ✅ New user with registration on: account created with the default role.
  4. ❌ Error / no button: confirm credentials, HTTPS callback URI, App mode / testers, and that both ID and secret are saved.

Troubleshooting

Section titled “Troubleshooting”
  • No Facebook button. App ID/secret missing - module won’t boot social hooks until both are set. Confirm license is active.
  • redirect_uri / OAuth error. The URI in Facebook must exactly match settings (?wpps_auth=facebook).
  • Works on HTTPS staging but not HTTP local. Use HTTPS (or a tunnel).
  • New users not created. Turn on Allow New User Registration (and bypass WP registration if needed).
  • Wrong landing page. Set Redirect after login, or use Redirect After Login.

FAQ

Section titled “FAQ”
What Facebook credentials do I need?

A Facebook App ID and App Secret, plus the module redirect URI added under Facebook Login -> Valid OAuth Redirect URIs. HTTPS is strongly recommended.

What shortcodes are available?

Use [facebook_sign_in] for Facebook alone, or [social_login providers="facebook"] for the unified social login shortcode.

Does Facebook Sign In create new WordPress users?

Only when Allow New User Registration is enabled. New users get the Default role you choose.

What is the OAuth callback URL?

https://your-site.com/?wpps_auth=facebook - copy the exact URL from module settings into your Facebook App.

Developer notes (hooks & filters)

Source: modules/facebook-sign-in/module.php, Provider.php, Config.php, admin.php. Boot: critical. Uses SocialSignInModuleTrait. License required.

  • Scopes: email,public_profile.
  • Callback query param: wpps_auth=facebook (UrlHelper::AUTH_QUERY_PARAM - not wpps_oauth).
  • Public callback: home_url('/?wpps_auth=facebook').
  • User meta: facebook_sign_in_id.
  • Error query arg: wpps_facebook_error.
  • Shortcodes: legacy facebook_sign_in; unified social_login.
  • Does not register social hooks until both app_id and app_secret are non-empty.
  • HTTPS notice via SettingsUiHelper::renderHttpsNotice().
Section titled “Related modules”