To use Single Sign-on feature, navigate to WCAP > Advanced Settings > SSO Settings (tab)
This feature comes in handy, if you want your WordPress users to able to login to WHMCS and make purchases or if you need your WHMCS users to comment on WordPress blog posts or for example, use support forum bbpress without additional login to WordPress.
This is achieved by synchronizing the user profiles & passwords between WHMCS and WordPress.
Enable WHMCS-WP SSO: Check to let users log in to both WordPress and WordPress.
Hide WP Admin bar: WordPress shows admin bar at the top for logged in users, check this option if you want to hide it. Since most of the time users will be using a logout link in menu page provided with “WHMCS Client Area”, you can check this option to hide admin bar.
Exclude WP roles from SSO: Check the roles to exclude from SSO process.
Sync Address / Profile Fields: By default, WHMCS requires address fields for user creation, while WordPress doesn’t. WCAP create these fields in WP. Check to create WHMCS profile fields (address, phone number etc), in WordPress.
WHMCS-WP profile fields mapping: Users who are already using address/profile fields from another plugin can map those fields with WHMCS fields
SSO Sync Settings
SSO works by synchronizing user profiles and passwords in WHMCS and WP. Following options are related to how new users are created and existing are synced in between WHMCS and WordPress when SSO is enabled
Settings to create users in WordPress
These settings come into play, when a new user signup in WHMCS, and it is synced to WordPress.
Role for the new user: A WordPress role for the new user.
Username for the new user: In WHMCS email is used as user-id, while in WordPress uses the username. You have two options here to make usernames.
- First Name + Last Name
- Use email as username (recommended)
Settings to create users in WHMCS
These settings come into play, when a new user signup in WordPress, and it is synced to WHMCS.
WordPress has fewer profile fields than WHMCS, settings in this section handle how to fill WHMCS fields.
By default, WHMCS requires Client Address and Phone Number for user creation, while by default WordPress does not collect this information.
You can handle this situation in two ways.
- Allow Sync to add dummy data to the WHMCS Client Area Address & Phone numbers fields.
- Leave empty fields as its
One Time Sync
When SSO has enabled, new users and profiles changes are tracked and syncs users between WHMCS and WordPress. For the existing users (those are created before SSO is activated), you need to run sync process below. This is a one time task and is needed for a smooth SSO experience.
Sync.Direction: You can run sync users from WHMCS to WP or from WP to WHMCS, or both ways to suit your needs.