1. Preparing your Magento
1.1. Backup your files and database
It is recommended to backup your server files and database before installing any module. It is also recommended you install on a test server firstly.
1.2. Disable Magento Compilation
Magento compilation needs to be disabled each time you install any extension. Please follow the steps listed below:
- Check if you have your Compilation enabled in your backend: System >> Tools >> Compilation
- Disable, if it is enabled
- Go to FTP and delete all files inside directory /includes/src/
2. Manual Installation
- Extract MT_ExtensionName-x.x.x.tgz archive
- Move file to your web server. You should not need to change any existing files
- Clear your store’s cache. System >> Cache Storage Management >> Flush Cache Storage. If you are using advanced cache like "Varnish" or "FPC", you need to clear this cache too.
- Logout and login again in Magento admin panel.
3. Installation with Magento Downloader
- Go to http://YOUR_STORE_URL/downloader
- Login using admin username and password.
- Find the section: Direct package file upload >> Upload package file. Choose extension archive (MT_ExtensionName-x.x.x.tgz) and press upload button.
- Clear your store’s cache. Go to admin panel. System >> Cache Storage Management >> Flush Cache Storage . If you are using advanced cache like "Varnish" or "FPC", you need to clear this cache too.
- Logout and login again in Magento admin panel.
4. Troubleshooting
4.1. 404 Error - Page not found
If you get this error, you need to logout and login again in Magento admin panel.
4.2. Blank System >> Configuration page
If you get this error, you need to run magento compilation process.
Please go to: System >> Tools >> Compilation, and press the button "Run Compilation Process"