Skip to main content

General Options

AMS Connect for WP offers the following options that are plugin wide and agnostic of the AMS connection.

Default Session Length​

Choose the session length that you would like to limit SSO enable sessions to. Since the WordPress site treats the AMS as the source of truth, this should be configured to be less than the session length on the AMS. Best practice is to limit this to the length of a typical singular session. User's AMS data is refreshed every time the SSO reauthenticates with the AMS, so resetting the WordPress sessions semi-frequently is advised to ensure that the user's AMS data, especially with regards to protectec content, is frequently refreshed.

The best practice is to make this session no longer than 24 hours. Some may choose to keep this session as short as 30 minutes.

Role to Apply to all SSO Users​

If you wish to have a particular role that is applied to all SSO users, choose it here. This role will be added to every single SSO authenticated user. This can be useful to give SSO users a baseline set of capabilities or to keep track of which users are connected to the AMS. This role is purely optional and is not needed in most cases.

Show AMS Login Button on the WP Login Page​

If you would like users to be able to login via the SSO from the default /wp-login.php page, checking this option will add an SSO login button to that form. This can be useful when staff or website administrator members are also SSO users so that they don't have to create and manage a password to the WordPress site.

Manage WP Roles by AMS​

If you will be mapping AMS SSO users to default WordPress administrator roles such as Administrator, Editor, or Author and would like to be able to add and remove these capabilities from the AMS side, check this box. Most configurations do not require this and will find that it is easier to grant or remove core WordPress roles to existing users directly from the WordPress interface. If this option is left unchecked, then these roles will remain on the designated user even when they reauthenticate with the AMS via the SSO and even if their assigned roles from the AMS change.

Redirect WP Login to AMS​

Check this box if you would like for the default WordPress login page to redirect the user to the AMS login page. This is particularly useful when you are using a block or page builder like Beaver Builder, Elementor, or Gutenberg. The default login link blocks will then forward the login request to the AMS login.

Force WP Login Query Var​

If you have chosen to use the Redirect WP Login to AMS option, but would like some users to still be able to access the default WordPress login page, you can set the query variable that you would like to use here. By default, this is set to wle. This means that navigating to /wp-login.php?wle will not redirect to the AMS login even with the previous option selected. This is useful to give dedicated administrator access to the WordPress site even when most users will be logging in via the AMS SSO.

SSO New User Prefix​

If you would like for usernames created by an SSO login to have a consistent prefix, add it here. This can be convenient to quickly identify the users who have been created by the SSO integration. Users created in other ways, even if they are matched by the SSO, will not have this prefix.

Delete All Plugin Data​

If you would like to delete all plugin data, you can do so with this button. All options and user meta fields related to the AMS Connect for WP plugin will be deleted, so be careful with this button.