WordPress Plugin

Open Source

Official EngagePlus plugin for WordPress. Add social login with Google, Facebook, GitHub, Microsoft, and more to your WordPress site in minutes—no custom code required.

View on GitHub Download Plugin

Features

Universal OAuth Support

Works with any OIDC-compliant provider including Google, Facebook, GitHub, Microsoft, LinkedIn, Twitter, Apple, and custom providers.

Lightweight

Minimal performance impact on your site. The plugin is optimized for speed and only loads assets when needed.

Auto User Management

Automatic WordPress account creation when users authenticate. Configure default roles, username patterns, and more.

Responsive Design

Works seamlessly on all devices. Customizable themes, button text, and placement options to match your site.

Secure Authentication

Uses OAuth 2.0 with PKCE flow for secure authentication. HTTPS required for production use.

WooCommerce Compatible

Seamlessly integrates with WooCommerce for customer authentication on checkout and account pages.

Installation

Prerequisites

WordPress 5.0 or higher
PHP 7.4 or higher
EngagePlus account (free tier available at engageplus.id)
At least one OAuth provider configured in EngagePlus dashboard

Step 1: Download the Plugin

Download the plugin from GitHub:

# Download from GitHub
wget https://github.com/engageplus-id/wordpress/archive/refs/heads/main.zip
unzip main.zip
mv wordpress-main/engageplus wp-content/plugins/engageplus

Or download the ZIP file directly from GitHub and upload via Plugins → Add New → Upload Plugin.

Step 2: Activate the Plugin

1.Go to Plugins → Installed Plugins in your WordPress admin
2.Find "EngagePlus" and click Activate

Step 3: Configure EngagePlus

Get your Client ID:
- • Go to EngagePlus Dashboard → Widget
- • Copy your Client ID
Configure the plugin:
- • Go to Settings → EngagePlus in WordPress admin
- • Paste your Client ID
- • Set your redirect URI (default: https://yoursite.com/engageplus-callback/)
- • Click "Save Changes"
Add redirect URI to EngagePlus:
- • Go to EngagePlus Dashboard → Widget
- • Add your WordPress callback URL to the allowed redirect URIs

Step 4: Add Widget to Your Site

You can add the EngagePlus widget in several ways:

Option 1: Shortcode (Recommended)
```
[engageplus]
```
Add this shortcode to any page, post, or widget area.
Option 2: Widget
- • Go to Appearance → Widgets
- • Find "EngagePlus Login Widget"
- • Drag to your desired widget area (sidebar, footer, etc.)

Option 3: PHP Template

<?php echo do_shortcode('[engageplus]'); ?>

Option 4: Auto-inject on Login Page
- • Enable "Show on Login Page" in plugin settings
- • The widget will automatically appear on /wp-login.php

Configuration Options

Basic Settings

Available at Settings → EngagePlus

Client ID

Your EngagePlus Client ID from the dashboard.

Redirect URI

OAuth callback URL. Must match the URL configured in your EngagePlus dashboard. Default: https://yoursite.com/engageplus-callback/

API Base URL

Default: https://engageplus.id

User Settings

Automatically Create Users

When enabled, new WordPress users are automatically created when they authenticate.

Default Role

Role assigned to newly created users (default: Subscriber). Choose from WordPress roles like Subscriber, Contributor, Author, etc.

Username Pattern

Pattern for generating usernames:
• [email] - Use email prefix (before @)
• [name] - Use display name from OAuth
• [uuid] - Use unique identifier

Redirect After Login

URL to redirect users after successful authentication (default: home page).

Appearance Settings

Button Text

Customize the login button text (default: "Login").

Theme

Light or dark theme to match your site design.

Show Labels

Display provider names alongside icons.

Show on Login Page

Automatically inject the widget on the WordPress login page (wp-login.php).

Shortcode Options

Customize the widget using shortcode attributes:

[engageplus 
  theme="dark" 
  button_text="Sign in with" 
  show_labels="true"
  redirect="/dashboard/"
]

Available attributes:

• theme - "light" or "dark"
• button_text - Custom button text
• show_labels - "true" or "false"
• redirect - Custom redirect URL
• container_id - Custom container ID

WooCommerce Integration

EngagePlus seamlessly integrates with WooCommerce. Enable social login on:

Checkout page - Allow guests to quickly create an account
My Account page - Alternative login for returning customers
Login/Register forms - Social login buttons alongside traditional forms

Tip: Enable "Show on WooCommerce Pages" in plugin settings to automatically add social login to WooCommerce forms.

Troubleshooting

Widget Not Appearing?

• Verify Client ID is entered correctly in plugin settings
• Check that the shortcode is properly placed: [engageplus]
• Clear WordPress cache and any caching plugins
• Check browser console for JavaScript errors
• Ensure the plugin is activated

Authentication Fails?

• Verify redirect URI matches in both WordPress and EngagePlus dashboard
• Check that OAuth providers are configured in EngagePlus
• Ensure your site uses HTTPS (required for OAuth)
• Enable debug mode in plugin settings to see detailed logs
• Check wp-content/debug.log for errors

Users Not Created?

• Ensure "Automatically create users" is enabled in settings
• Check that WordPress allows user registration (Settings → General)
• Verify the user doesn't already exist with that email
• Check if a security plugin is blocking user creation

Redirect Issues?

• Check permalink settings (Settings → Permalinks → Save Changes)
• Verify .htaccess file has proper rewrite rules
• Try flushing rewrite rules by saving permalinks
• Check for plugin conflicts with other authentication plugins

Need Help?

For issues, feature requests, or contributions:

GitHub Issues Email Support View All Docs