Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Simplify your member login experience by allowing them to sign in using their WordPress account. This integration enhances user convenience and can lead to higher engagement.
Navigate: App Station > Settings > Integrations > WordPress SSO
Quick Start
Install an OAuth plugin on your WordPress site (e.g., WP OAuth Server).
Create an OAuth client in the plugin settings with the required details.
Gather the OAuth endpoints from your WordPress plugin.
In your Member Kitchens dashboard, go to App Station > Settings > Integrations > WordPress SSO and configure the settings.
Test the integration by logging out and using the "Sign in with WordPress" button.
Detailed Setup Instructions
Step 1: Install an OAuth Plugin on WordPress
To enable Single Sign-On (SSO), you need to install an OAuth plugin on your WordPress site. Here are two recommended options:
Option A: WP OAuth Server (Recommended)
In WordPress, navigate to Plugins > Add New.
Search for "WP OAuth Server".
Install and activate the plugin.
Go to OAuth Server in your WordPress admin menu.
Option B: miniOrange OAuth Server
In WordPress, navigate to Plugins > Add New.
Search for "miniOrange OAuth Server".
Install and activate the plugin.
Go to miniOrange OAuth in your WordPress admin menu.
Step 2: Create an OAuth Client
You need to create an OAuth client in your chosen plugin. Follow the steps for your selected plugin:
For WP OAuth Server:
Go to OAuth Server > Clients.
Click Add New Client.
Enter the following settings:
Client Name: Member Kitchens (or your app name)
Redirect URI: Use the URL shown in App Station > Settings > Integrations > WordPress SSO.
Grant Types: Check "Authorization Code".
Scope: Select "openid", "email", and "profile" if available.
Click Save.
Note down the Client ID and Client Secret.
For miniOrange OAuth Server:
Go to miniOrange OAuth > OAuth Clients.
Click Add Client.
Enter the following settings:
Client Name: Member Kitchens.
Redirect URI: Use the URL shown in App Station > Settings > Integrations > WordPress SSO.
Grant Type: Authorization Code.
Click Save.
Copy the Client ID and Client Secret.
Step 3: Get OAuth Endpoints
You will need the following URLs from your WordPress OAuth plugin:
Authorization URL: This is used to initiate the login.
Token URL: This is used to exchange the authorization code for an access token.
User Info URL: This is used to fetch user details.
The exact URLs depend on your plugin and WordPress permalink settings. Here are common patterns:
WP OAuth Server:
Authorization:
https://yourblog.com/oauth/authorizeToken:
https://yourblog.com/oauth/tokenUser Info:
https://yourblog.com/oauth/me
miniOrange:
Authorization:
https://yourblog.com/?option=oauthserver&auth_type=authorizeToken:
https://yourblog.com/?option=oauthserver&auth_type=token
Step 4: Configure in Member Kitchens
In your Member Kitchens dashboard, go to App Station > Settings > Integrations > WordPress SSO.
Click Configure WordPress SSO.
Fill in the form:
Display Name: (Optional) Custom button text, e.g., "Sign in with My Blog".
Client ID: Paste from Step 2.
Client Secret: Paste from Step 2.
Authorization URL: From Step 3.
Token URL: From Step 3.
User Info URL: From Step 3 (required to fetch user details).
Scopes: (Optional) Leave blank or enter
openid email profile.
Click Save Configuration.
Step 5: Test the Integration
Log out of your Member Kitchens site.
Go to the login page.
You should see a "Sign in with WordPress" button (or your custom display name).
Click the button and authorize the connection.
You should be redirected back and logged in.
Troubleshooting
"Invalid OAuth State" Error: This usually means the login request expired. Try again.
"Token Exchange Failed" Error: Verify your Client ID and Client Secret, and ensure the Redirect URI matches exactly.
"User Info Failed" Error: Ensure the User Info URL is configured correctly and accessible.
Members Can't Sign In: Ensure WordPress SSO is enabled and that the member has an account on your WordPress site.
Security Considerations
Keep secrets safe: Never share your Client Secret publicly.
Use HTTPS: Ensure both your WordPress site and Member Kitchens site use HTTPS.
Account Linking
When a member signs in with WordPress:
If their WordPress email matches an existing Member Kitchens account, accounts are automatically linked.
If no matching account exists, a new member account is created.