Step 1: Backup
- Before proceeding, ensure your server meets the latest system requirements.
- Download a backup of all files to your local computer using an FTP program.
- Export a backup of your database using the Manual Database Backup tutorial.
- Make a note of any customizations you have made that you wish to reapply after upgrading.
Step 2: Downloading and Uploading the Files
Download the full download or the incremental download.
If an incremental download is not available for your current version, the full download will need to be used.
- If you wish to preserve any customizations you have made please see our tips below. If you do not have any customizations to preserve, continue to step 3.
- Upload all files from the new version download except defaults.php to your current files overwriting them.
Admin Folder Name
If you have renamed the administrator folder from its original "cp" name, make sure to upload the contents of the "cp" folder from the .zip download to your custom named admin folder.
Step 3: Running the Upgrade Process
Disable any plugins that are not compatible with the version being upgraded to.
- Run the upgrade process by loading the /install/index.php file in your browser (example: http://www.domain.com/install/index.php).
- Select the "Upgrade" option and you will be walked through the upgrade process.
- Once the upgrade process is complete delete the /install/ folder.
Reapplying Customizations (Optional)
If customizations were made to the code or the template and the files that these changes were made to were overwritten during the upgrade, you may need to reapply your custom changes.
We suggest keeping track of the files and approximate line numbers of any changes you make. This will be beneficial information when reapplying customizations.
Template changes between releases may be viewed and compared using our template repository.
A good way to accomplish reapplying custom code is to use a compare and merge tool to merge your current files with the new version files you are upgrading to.
- Download your current files into a folder on your home computer.
- Extract the new version .zip file into a separate folder.
- User the compare and merge tool to compare the two folders.
- The tool will determine the differences and you may reviews these to make the needed changes.
- Re-upload the merged files and continue with the upgrade process as normal.
Compare and Merge Tools
- Some users have found it necessary to copy the php.ini file into the install directory.
- Also, some users have found they needed to add "AddType x-mapp-php5 .php" in .htaccess for various reasons. Sometimes the host machine may support php5, but run in php4 by default. While older versions of phpMyDirectory may have ran on php4, it is a requirement to have php 5.2.1+ for PMD 1.3.4+ as noted System Requirements.
- If you are having problems with the paging system when looking at multiple pages of category results. I.E. yourpage.com/category/some-category/?page=2 you might need to add QSA to your .htaccess files.
Example: RewriteRule ^category\/(.+)$ browse_categories.php?id=$1 [L,NC,QSA]