WPCloudDeploy Documentation

One-click Login (AKA Passwordless Logins)

If you’re an administrator you’ll see an option in the site list that allow you to login to the site without entering a user name or password.

 

You will also see a similar login link for at the top of the SITE DETAILS screen:


Login as Any User

The login links described above will search the site users and login as the first administrator account it encounters. However, there are times where you might want to login as a particular user.  In this case you can do so under the site USERS tab.

 

This function is particularly useful if you are troubleshooting an issue that only presents for a particular user or user role.  With it, you no longer need to take the separate step of adding a user-switching plugin to the site.


Disabling The Login Links

You can remove the passwordless login links with an option in the settings area:

  • Go to WPCLOUDDEPLOYSETTINGSAPP: WORDPRESSSETTINGSSITES
  • Scroll down to the MISC section
  • Turn on the DISABLE THE ONE-CLICK LOGIN BUTTONS option.
  • Click the SAVE SETTINGS button.

If you like you can delete the WP CLI Login Command Server plugin before you log out of the site.  If you need to use the one-click login function again for that site it will be automatically installed.


Notes

Here are some things to keep in mind about how that works:

  1. The first time you use a passwordless login link it will take about 30 seconds to connect to the server, install the dependencies and inject the login plugin into the site.  This is important to understand because it adds a plugin to the site.
  2. The next time you use the link it will take 10 – 15 seconds to connect to the server, get the one-time login token and redirect to it.
  3. The site will open in a NEW browser tab – because of this, you might have to approve pop-ups before you see the site.
  4. If you have multiple users in the Administrator group, you will be logged in as one of them.  No admin users are ever added to your site.
  5. If you have removed the Administrator role for some reason, you will not be able to use this function (though you can customize the script to pick a different role or force it to always use the same user id, email address or user name.)
  6. Only WPCD administrators will see this login option.

Troubleshooting

Check your PHP CLI Version

You can check the SSH logs (WPCloudDeploy → SSH Logs) to see if WP-CLI is throwing errors.  If it is you might want to make sure that your WordPress plugins and themes for the site is compatible with the version of the PHP CLI active on the server.

Take a look at the WPCloudDeploy → TOOLS screen ( SET SERVER PHP CLI VERSION section) to see what version of the server PHP CLI is currently active.

If the site is currently running, say PHP 7.4 but the server PHP CLI Is set to 8.1, it is possible that an error could be thrown because WP CLI is trying to run some PHP 7.4 plugin / theme code from the site under the server’s PHP 8.1 CLI.

The solution is to make sure that the server PHP CLI version is set to the same version as the site (or, at least a more compatible version).


Known Issues

  • If you use a 2FA plugin for your site administrators, this function will not work at all.

 

Share: