- Please consider putting your WordPress site in maintenance mode while you perform the upgrade.
- Backup your WordPress site if you haven’t already.
- Download the WordPress.Plugin.4.zip file to your local machine.
- 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}}
- Unzip the downloaded file using the password shared with you. It will create a directory called
WordPress.Plugin.4
. - Go inside the newly created
WordPress.Plugin.4
folder - Unzip the
login-by-auth0-4.0.0-beta.zip
file
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.
- Access your WordPress site files using sFTP or SSH.
- Create a new directory named
auth0-v4
underwp-content/plugins/
and copy the content of your locallogin-by-auth0-4.0.0-beta
folder into this newauth0-v4
directory. - For backup purposes, rename the existing plugin directory named
auth0
toauth0-v3
. Please note that doing this will stop logins from working until you perform the next step. - Rename the
auth0-v4
directory toauth0
. By doing this you are activating Login by Auth0 plugin v4.0.0-beta. - 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 theWordPress.Plugin.4.zip
file.
- 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