Step by step instructions to manually upgrade Login with Auth0 wordpress plugin to v4

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