Skip to content

Instantly share code, notes, and snippets.

@ashishdasnurkar

ashishdasnurkar/upgrade-auth-wp-plugin-to-v4.md

Last active March 19, 2020 14:27
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save ashishdasnurkar/c062253b547506ff7b800cf124e871fd to your computer and use it in GitHub Desktop.
Save ashishdasnurkar/c062253b547506ff7b800cf124e871fd to your computer and use it in GitHub Desktop.
Download ZIP
Step by step instructions to manually upgrade Login with Auth0 wordpress plugin to v4
Raw
upgrade-auth-wp-plugin-to-v4.md

Upgrading Login with Auth0 WordPress Plugin Manually

Prerequisites

  1. It is extremely important that you first read our migration guide from v3 to v4
  2. Please consider putting your wordpress site in maintenance mode while you perform the upgrade.
  3. Backup your WordPress site if you haven’t already.

Upgrade step by step process

  1. Download a ZIP file of the Login with Auth0 wordpress plugin v4.0.0-beta on to your local machine. login-by-auth0-4.0.0-beta.zip.
  2. Unzip the plugin file. This will create a directory called login-by-auth0-4.0.0-beta with all the requied plugin files under it.
  3. Access your Wordpress site files using sFTP or SSH.
  4. Create a new directory named auth0-v4 under wp-content/plugins/ and copy contents of your local login-by-auth0-4.0.0-beta folder into this new auth0-v4 directory.
  5. Rename the existing plugin directory named auth0 to auth0-v3. Please note that doing this will stop logins from working until you perform the next step.
  6. Rename auth0-v4 directory to auth0 (By doing this you are activating Login by Auth0 plugin v4.0.0-beta.
  7. Sign in to your WordPress site administration panel. Go to the Plugins > Installed Plugins and verify that the plugin you upgraded is at the newest version i.e. 4.0.0-beta. If something is not working as expected, you can revet to earlier plugin version by switching plugin directory names back and review if you missed any other changes required from our migration guide from v3 to v4

What if I can't access my wordpress site admin panel?

  • You can add wle parameter to your site login url for eg. https://yoursite.com/wp-login.php?wle and access wordpress default login form
  • Also refer to our migration guide from v3 to v4 to make sure you have made the relevant changes that plugin v4 requires
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment