Sometimes the MemberMouse team may set you up with a new version of the MemberMouse plugin prior to its official release. Other times a quick manual upgrade of the software is necessary for troubleshooting issues. If either is the case, you'll need to manually upgrade your MemberMouse plugin to ensure you have all of the latest files.

If you're installing MemberMouse for the first time, click here for step-by-step instructions on installing MemberMouse.

IMPORTANT: If you have a cache plugin activated on your WordPress site, make sure that your clear the cache following the MemberMouse upgrade. Read this article to learn more about using cache plugins with MemberMouse.

Upgrade Best Practices

Upgrading software on your live production can be a daunting prospect. However, we encourage you not to let that stand in your way of taking advantage of the new features and bug fixes incorporated in our releases. We do our best to ensure the upgrade process will go as smoothly as possible by doing rigorous internal and beta testing.

With that said, it's impossible for us to cover all possible environments where MemberMouse can run -- we all use different themes, plugins and run on different server environments which introduces a huge amount of variables -- so it's generally a good practice to go through the following steps when making changes to a production environment:

  1. If you have a staging site that mirrors your live site, we recommend installing the latest version of MemberMouse there and running through some of the essential features of your site to ensure there are no conflicts between MemberMouse and any other plugins you're running.

  2. Prior to upgrading your live site, make a backup of your site so if necessary you can revert. If you need to, you can download a previous version of the MemberMouse plugin.

  3. Prior to upgrading make sure to review the release notes in case action is required by you in association with the upgrade.

Follow the steps below to manually upgrade your version of MemberMouse:

1. Deactivate and delete the current version.

  1. Go to the Plugins page in WordPress.

  2. Scroll down to the MemberMouse Platform plugin and click Deactivate.

  3. Now click Delete on the MemberMouse Platform plugin.

  4. On the following page, click the  button to confirm you want to delete the plugin. Don't worry, none of your MemberMouse settings will be lost when you do this.

2. Install the MemberMouse plugin.

  1. Download the latest version of the MemberMouse plugin and save it in a location on your computer that you can find later.

  2. Log into your WordPress site and go to the Plugins page.

  3. Click the Add New button at the top of the page.

  4. Click on the Upload link at the top of the page.

  5. Under where it says Install a plugin in .zip format, click the Browse button and navigate to the place where you saved the MemberMouse plugin.

  6. Click the  button.

  7. On most servers, clicking the Install Now button will start the process automatically. However, sometimes additional security is required by the server and WordPress will ask for your FTP credentials. Just fill out the form and click Proceed.

  8. After the installation has completed, click the Activate Plugin link to activate MemberMouse.

  9. After the plugin has been activated, you may see a yellow bar with a message that says that MemberMouse can't use the cache.

    MemberMouse utilizes a directory on your server to cache files in order to increase performance. When this message displays it means that MemberMouse can't write to that directory because of a permissions issue. To correct this and allow MemberMouse to utilize the cache directory, just click the Click here to correct this link. Depending on your server configuration, WordPress may ask you for your FTP credentials in order to proceed.