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:
- 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.
- Prior to upgrading your live site, make a backup so you can revert if necessary.
- Prior to upgrading, make sure to review the release notes in case you need to take action in connection with the upgrade.
Follow the steps below to manually upgrade your version of MemberMouse
A. Deactivate and delete the current version.
- Go to the Plugins page in WordPress.
- Scroll down to the MemberMouse Platform plugin and click Deactivate. The page will refresh, and you will note the plugin now displays the Activate or Delete options.
- Now click Delete on the inactive MemberMouse Platform plugin.
- The browser will prompt you to be sure you are aware that you are deleting the MemberMouse Platform. Click the OK button to confirm you want to delete the plugin. WordPress will delete the plugin over a few seconds, and you will see “MemberMouse Platform was successfully deleted” in place of where the plugin was previously located in your plugin list.
Don't worry; none of your MemberMouse settings will be lost when you do this. All of your previous configurations will return when you reinstall it in the next steps.
B. Reinstall the MemberMouse plugin.
- Download the latest version of the MemberMouse plugin and save it in a location on your computer that you can find later.
- Log into your WordPress site and go to the Plugins page.
- Click the Add New button at the top of the page.
- Once on the Add Plugins page, click on the Upload Plugin button at the top of the page, and the upload area will appear.
- Once the upload area appears, click the Choose File button and navigate to the place where you saved the MemberMouse plugin, and choose the membermouse.zip file.
- Once the membermouse.zip file has been chosen, you can then click the Install Now button.
- On most servers, clicking the Install Now button will start the process automatically. However, in some circumstances, additional security is required by the server to upload plugins, and WordPress will ask for your FTP credentials. Just fill out the required fields with your FTP information and click the Proceed button.
- Once you click Install or Proceed, the upload and install procedure will begin. After a few seconds, the process will complete. To finish the process, click the Activate Plugin button to activate MemberMouse.
- After the plugin has been activated, the page will redirect you to the WordPress plugins page, where you can verify if the installation was successful and see all of your other plugins.
- Lastly, be sure to clear your cache from plugins, or any server cache you may have. This will ensure your server releases any old versions of your files and brings in new ones.
In some cases, 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, 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.