Overview
You can integrate content from your WildApricot site with your WordPress site and provide single sign-on (SSO) service for your users.
You can also restrict access to some content on your WordPress site, such as member directories and members-only events, based on your WildApricot membership levels.
Important note: Custom domains without SSL certificates can encounter problems when integrating WildApricot with other sites. To learn more, view Securing custom domains.
An Important Note about Cookies
Recent changes in the way common browsers handle third-party cookies might cause errors with WordPress integrations if users have third-party cookies disabled in their browser settings.
Due to these recent changes, third-party cookies may be newly disabled by default. You may have to change your browser settings to avoid experiencing limited functionality in WildApricot's websites and widgets.
Google has provided the following information for Chrome users:
As you browse the web, third-party cookies will be restricted by default, limiting the ability to track you across different websites.
If a site doesn’t work without third-party cookies and Chrome notices you’re having issues — like if you refresh a page multiple times — we’ll prompt you with an option to temporarily re-enable third-party cookies for that website from the eye icon on the right side of your address bar.
For a deeper dive on Google's recent changes to how Chrome handles third-party cookies, please view Google's article, Phasing out Third-Party Cookies in Chrome.
Developers may be interested in also viewing Google's Privacy Sandbox Timeline.
How to enable third-party cookies
To enable third-party cookies in Safari, view Enable cookies in Safari on mac.
In Chrome, you can re-enable third-party cookies by clicking the eye icon in the right side of your browser's address bar.
Important Note: If you embed WildApricot widgets on another website, visitors to that site must enable third-party cookies for the widgets to work.
Integrating with WordPress: At a Glance
Integrating your WordPress site and WildApricot account requires the following:
1. Authorize WordPress to access your WildApricot account
2. Install the WildApricot plugin on your WordPress site
3. Integrate your WildApricot content with your WordPress site
Part 1: Authorize WordPress to access WildApricot
To authorize WordPress to access your WildApricot account, follow these steps:
1. Select Apps from the sidebar menu in your WildApricot site.
2. Select Authorized applications. 
3. Click the Authorize application button at the top of the screen.
4. Select WordPress and Continue.
5. In the Application details screen, make note of the following unique values (for use when you install the WildApricot plugin within your WordPress site):
- API key
- Client ID
- Client secret
Important note: You must complete all authorization steps and Save (Step #9, below) before you can enter these values in your WordPress plugin settings. Entering these values in WordPress prior to authorizing the application in WildApricot will result in an error.
You'll need these values when you install the WildApricot plugin in WordPress 6. Next, under Authorization page settings, select the option to authorize users via WildApricot's single sign-on (SSO) service. Enter the organization name and any introductory text that you want to be displayed on the SSO screen.
7. Select Allow login via social networks if you want to provide Facebook and Google buttons as login options on the SSO screen (optional).
8. Enter the full URL (including the https: ) for your WordPress site in the Trusted redirect domains field.
Important note: The full URL for your WordPress site is required in the Trusted redirect domains field and is not related to the option to allow login via social networks.
9. Click the Save button at the top of the screen.
Part 2: Install the WildApricot plugin on WordPress
After you have set up WordPress as an authorized application within your WildApricot account, you need to install and set up the WildApricot Login plugin on your WordPress site.
Automatic installation method
1. Log in to your WordPress site.
2. From your WordPress dashboard, hover over Plugins in the sidebar menu and select Add New.
3. In the Search field, enter Wild Apricot.
4. On the page displaying WildApricot's plugin, click Install Now.
5. Click OK when prompted to confirm the installation.
6. After the plugin is installed, click the Activate Plugin link. 
7. In your dashboard, hover over Settings in the sidebar menu, and select WildApricot Login.
8. On the WildApricot Login Settings screen, enter the following unique values that were provided during authorization:
- API key
- Client ID
- Client secret
Important note: Entering these values in your WordPress plugin settings prior to authorizing the application in WildApricot (see Part 1 above) will result in an error.
9. Select Save.
10. Click the Update button to update your WordPress roles with your WildApricot membership levels.
No existing roles will be removed from your WordPress account.
Manual installation method
To install the plugin manually, follow these steps:
1. Download the zip file containing the WildApricot plugin files.
2. In your WordPress dashboard, hover over the Plugins menu and choose the Add New option.
3. Click the Upload Plugin button.
4. Click the Browse or Choose File button and locate the zip file you downloaded.
5. Click the Install Now button. 
6. After the plugin is installed, click the Activate Plugin link. 
7. In the dashboard, hover over the Settings menu and select WildApricot Login.
8. On the WildApricot Login Settings screen, enter the following unique values that were provided during authorization:
- API key
- Client ID
- Client secret
Important note: Entering these values in your WordPress plugin settings prior to authorizing the application in WildApricot (see Part 1 above) will result in an error.
9. Select Save Changes.
The API key, Client ID, and Client secret fields should now appear as set.
10. Click the Update button to update your WordPress roles with your WildApricot membership levels.
No existing roles will be removed from your WordPress account.
Part 3: Integrate WildApricot content with your WordPress site
Once you have installed the WildApricot plugin on your WordPress site, you can use the plugin to:
- customize a login button for single sign-on (SSO) to both WordPress and WildApricot
- add WildApricot widgets to pages and blogs on your WordPress site
- restrict WordPress content to certain WildApricot membership levels
Important Note: If you embed WildApricot widgets on another website, visitors to that site must accept third-party cookies for the widgets to work. For details, please view Cookies.
Note: The WildApricot Login plugin cannot restrict access to an entire page or blog by role/membership level, but one of our partners does offer a plugin that allows you to restrict access to an entire page or blog by membership level and membership group.
For more information, view the WildApricot plugins on WordPress.org.
Display a login button for single sign-on
You can display a login button for single sign-on by adding a widget – installed along with the WildApricot Login plugin – to the header of your WordPress theme layout, or by inserting a shortcode in your page or blog content.
Note: The login button automatically appears when you use the wa_restricted shortcode to restrict WordPress content to WildApricot members.
Display the login button in a WordPress theme header
To display the login button within your WordPress theme header – which can appear as a sidebar for some themes – follow these steps:
1. In your WordPress dashboard, hover over Appearance and select Themes.
O
2. On the Themes screen, click the Customize button for your current theme.
3. Click the > button next to Widgets.
4. Select Add a widget.
5. Search for the Wild Apricot Login widget, and select. 
6. Next, you can customize some login settings:
- Change the text in the Login button label field if you want the text on the button to say something other than "Login."
- In the Redirect page field, you can specify the WordPress page you want users to land on after they log in. You can leave this field blank if you want users to remain on the current page.
Display the login button on a WordPress page or blog
To display the login button for single sign-on (SSO) on a WordPress page or blog, add the following shortcode in either visual or HTML mode:
[wa_login login_label="Log in" redirect_page="/"]where the following attributes are optional:
login_label
The text to appear on the login button. The default is taken from the WildApricot Login plugin settings.
redirect_page
The WordPress page where users land after they log in.
In visual mode, you can insert the shortcode by clicking the insert icon. In the dialog that appears, you can specify the login label and redirect page.
Restrict WordPress content to WildApricot members
With the WildApricot Login plugin installed, you can restrict access to WordPress content using WildApricot membership levels.
Only members with a status of Active or Pending - Renewal will be able to access member-restricted WordPress content.
To restrict WordPress content using WildApricot membership levels, add the following shortcode to a page or custom menu in either visual mode or text mode:
[wa_restricted roles="Gold, Silver" login_label="Log in" message="Log on to view restricted content."] Restricted content [/wa_restricted]
where the following attributes are available:
roles
WordPress roles correspond to the WildApricot membership levels for which you want the content restricted. To include all roles, set the roles attribute to All.
Multiple roles must be separated by a comma. If the name of your membership level includes a comma, you must use %2C in place of the comma. For example, if the level name is "Students, 1st class" then the shortcode would be:
[wa_restricted roles="Students%2C 1st class"]
Note: If the name of a membership level changes, the shortcodes must be manually updated even if the corresponding roles are updated.
You can add a not:operator at the start of the roles attribute to specify all roles other than those listed:
[wa_restricted roles="not:Bronze" message="Log on to view restricted content."]Restricted content[/wa_restricted]
login_label
The text to appear on the login button. The default is taken from the WildApricot Login plugin settings.
message
A message that you want to appear in place of the restricted content. A login button will appear below the message.
The content between the wa_restricted tags will only appear to authorized users. Restricted content can include other WordPress shortcodes or WildApricot widgets.
In visual mode, you can insert the shortcode by clicking the lock icon. Within the dialog that appears, you can specify the roles, the login label, and the restricted content message.
Testing your WordPress integration
Important note: You cannot log in through the single sign-on (SSO) screen with a WildApricot admin account that uses the same email address as your WordPress admin account.
If your WildApricot administrator account uses the same email as your WordPress administrator account, you might want to create a test member in your WildApricot account so you can test your WordPress integration.
Troubleshooting
Below is a list of common issues and possible solutions.
I can't see a Plugins option within my WordPress dashboard.
If you use WordPress.com rather than WordPress.org, you will need to upgrade your WordPress.com account before you can use custom plugins.
Note: WildApricot plugins are optimized for use with WordPress.org accounts.
I'm trying to test my WordPress integration but I can't log into the single sign-on screen.
You cannot log in through the single sign-on (SSO) screen with a WildApricot admin account that uses the same email address as your WordPress admin account.
I've made updates to user profiles in WordPress but the changes aren't showing up in the WildApricot contact details.
Changes can only be made in one direction: from WildApricot to WordPress.
I've deactivated and deleted the WildApricot Login plugin on WordPress, but the roles and users it added are still in my account.
Deactivation or deletion of the WildApricot Login plugin will not remove the WildApricot users and roles from your WordPress account. They must be removed manually.
I've updated a WordPress user profile, but my changes were overwritten when the user logged in using single sign-on (SSO).
WordPress user profiles will be updated with information from the WildApricot contact details when users log in through SSO.
Recommended best practice: If you integrate your WildApricot site with WordPress, make all user profile updates within your WildApricot site rather than in the WordPress site.
Can I restrict access to an entire page or blog by role/membership level?
Yes, but not using the WildApricot plugin. There are other plugins that allow you to restrict page access by role, but these will not verify a user's membership status.
After I save the plugin settings, the fields go blank, and a message says they are empty or invalid.
This might be caused by a conflict with another WordPress plugin. To solve this problem, deactivate the WildApricot plugin from the WordPress Plugins screen, then activate it again.
Important note: WildApricot's plugins are not compatible with any Cloudflare plugins or with the Taggbox widget.
