Pressable OnePress Login

OnePress Login allows you to quickly and easily log in to your WordPress environments through the MyPressable Control Panel with just one press. You will no longer be required to remember credentials for each of your WordPress websites on Pressable anymore. Just click on the OnePress Login button and securely access the dashboard of your website.

The steps on how to enable and set this up on your Pressable account are outlined below.

Setting up your Pressable account to use OnePress

From the MyPressable Control Panel (MPCP) go to Account Settings and select the Sites tab, you can access this by directly going to: https://my.pressable.com/settings/sites. The toggle switch allows you to activate the feature for your account.

Once the toggle is switched to Activate our Pressable OnePress Login plugin will be installed on all active sites under your account (sites in a disabled state will be excluded).

The plugin is symlinked on the sites but can be disabled, or removed, from any WordPress instance either via the site’s WP Admin dashboard, or SFTP/SSH if needed.

Logging In To WordPress using OnePress

Once you activate the OnePress Login feature on your Pressable account, you will notice a new button in the control panel on the site’s information page to use OnePress Login on the site.

This will appear on all active sites on your Account.

Please note that you must have a WordPress user associated with the email used for the Pressable account for the OnePress Login to validate the login attempt. If the user is not found on the site, they will be redirected to MPCP and see an error.

If the user data is successfully verified, you will be logged in and redirected to the site’s WP Admin.

We have several checks to ensure this is a secure connection. The session and user are both verified before a successful login occurs. If a user fails any of the verifications, they will be redirected to the site in MPCP and a relevant error message will be displayed. There is also a message set in PHP error logs explaining the error in a bit more detail.

Disabling OnePress Login

Disabling OnePress at the Account-Level

To disable OnePress Login from your Pressable account, visit the Account Settings and select the Sites tab, you can access this by directly by going here: https://my.pressable.com/settings/sites. The toggle switch allows you to deactivate the feature for your account. Once this is deactivated the OnePress Login button will be removed from all the sites.

Disabling OnePress at the Site-Level

To remove the OnePress Login from a single site on your Pressable account, you can simply deactivate the plugin within the WP Admin dashboard.

The OnePress login checks the plugin status on the site and if found disabled, the OnePress button will also be disabled on the site with the message “OnePress Login plugin is not active on site“. This allows you to remove the OnePress login from an individual site without having to deactivate the program on your account.

Customize Redirect Behavior

The OnePress Login plugin includes the ability for customers to customize the redirect behavior of the plugin using filters. These filters enable customers to define allowed hosts and establish custom redirect URLs to handle plugin errors. Detailed instructions on implementing these filters have been included in the plugin’s GitHub Repository.

As specified in the documentation, the filter code should be incorporated into a Must-Use (MU) plugin.

Troubleshooting Connection

If the OnePress Login functionality isn’t working on a site, please check the following:

• Check if there is an Administrator user on the site with login issues that has the same email as the my.pressable.com user account that you are logged into and trying to access the site via OnePress Login from. The email addresses MUST match (example: my.pressable.com email of [email protected] needs to have a corresponding Administrator user with the [email protected] email on the site). If not, one needs to be created.
• Check if the OnePress Login plugin is both installed and activated on the site. If not, you can uninstall/reinstall on all sites via my.presssable.com here: https://my.pressable.com/settings/sites or contact Pressable support to install the plugin on a single site.
• Check to see if you are using an incompatible 2FA plugin (details in section below).
• Check if the plugin is network-activated, as it will not work in that state. Currently, the plugin needs to be activated on a per-site basis.

2FA Compatibility

OnePress Login should work alongside most 2FA plugins, but some 2FA plugins do not force the 2FA authorization unless the login is happening on the /wp-login page with an actual login and password.

• The WP White Security (WP 2FA) and Two-Factor plugins work as expected and their 2FA is NOT bypassed by OnePress.
• WPMU DEV / WP Defender will not work, as its 2FA is bypassed when using OnePress login. The plugin’s own SSO also currently bypasses its own 2FA due to how the plugin is coded.

Frequently Asked Questions

Will OnePress Login work with plugins that modify the WP Admin login URL?

Yes, OnePress Login should work with plugins that modify the WP Admin login URL (example: changing /wp-admin to /backend).

Is OnePress functionality included in the API?

Yes, please see the section here for more details: https://my.pressable.com/documentation/api/v1#one-press-login

Is it possible to White Label the OnePress Login plugin?

This is not an option within the plugin’s settings at this time. However, the plugin can be forked and then the Pressable API can be used to install the forked plugin on desired sites. However, currently if using with the My.Pressable.com Dashboard, the plugin’s name must remain pressable-onepress-login or My.Pressable.com will not know that it exists.