Skip to content

Instantly share code, notes, and snippets.

@mauricioschneider

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

Forked from ashishdasnurkar/upgrade-auth-wp-plugin-to-v4.md
Last active March 27, 2020 15:01
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save mauricioschneider/6587af7967269e3b94433164953009ab to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save mauricioschneider/6587af7967269e3b94433164953009ab 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

Recommended Previous Steps

  1. Please consider putting your WordPress site in maintenance mode while you perform the upgrade.
  2. Backup your WordPress site if you haven’t already.

Upgrade Process

Prerequisites

  1. Download the WordPress.Plugin.4.zip file to your local machine.
  2. This file contains the Auth0 WordPress Plugin v4.0.0-beta source code, the changelog file, an a migration guide. The ZIP file is securely encrypted. In order to unzip it, you will need the password that can be found here: {{INSERT SHARELOCK LINK}}
  3. Unzip the downloaded file using the password shared with you. It will create a directory called WordPress.Plugin.4.
  4. Go inside the newly created WordPress.Plugin.4 folder
  5. Unzip the login-by-auth0-4.0.0-beta.zip file

Upgrading the Plugin

While manually upgrading the plugin, your users may experience issues logging in. That's why we advise setting your WordPress site into maintenance mode while you execute the following steps.

  1. Access your WordPress site files using sFTP or SSH.
  2. Create a new directory named auth0-v4 under wp-content/plugins/ and copy the content of your local login-by-auth0-4.0.0-beta folder into this new auth0-v4 directory.
  3. For backup purposes, 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.
  4. Rename the auth0-v4 directory to auth0. By doing this you are activating Login by Auth0 plugin v4.0.0-beta.
  5. 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 included in the WordPress.Plugin.4.zip file.

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