The latest version of the module distribution can always be found on its website, http://dev.ceon.net/web/zen-cart/uri-mapping/downloads.
Simply follow the instructions for the version of Ceon URI Mapping already installed..
It's simple to upgrade to version 4.0.3 from 4.0.x.
These are the updated files which make up this module. Copy them all into their respective folders in the Zen Cart installation, overwriting the files from the previously installed version.
Most files are used by all Zen Cart versions, however there are some files which are used only by Zen Cart 1.3.x and some which are used only by Zen Cart 1.5.x - be sure to copy all the files for the store's version of Zen Cart.
This means copying the files from the shared folder and the folder for the version of Zen Cart the store uses.
Most Zen Cart stores have their admin directory renamed from the default of “admin”.
Copy all of the folders and files from the files/admin folder into the store's “admin” directory, whatever it is called.
The files are already in the correct directory structure, so a single drag-and-drop of the folders/files in the files/admin folder into the “admin” directory for the store will put the files in the correct locations.
Please do not copy the files individually - there's simply no need - doing so often results in files being missed out!
Copy the file from the files/additional_file_for_1.3.x/admin folder into the store's “admin” directory, whatever it is called.
Copy the files from the files/additional_files_for_1.5.x/admin folder into the store's “admin” directory, whatever it is called.
Copy the includes folder from the files folder into the store's main directory.
The files are already in the correct directory structure, so a single drag-and-drop of the folder into the root directory for the store will put the files in the correct locations.
Please do not copy the files individually - there's simply no need - doing so often results in files being missed out!
Warning: Be careful NOT to copy the files from the files/includes folder into the store's admin/includes directory, they go in the includes directory which is alongside, not inside the store's admin directory.
This software comes with some intelligent upgrade and error checking functionality which makes it easy to keep the database and configuration up to date.
Go to Modules > Ceon URI Mapping (SEO) Config in the Zen Cart Admin and the module will be updated automagically!
Told you it was simple to upgrade!
Ceon URI Mapping 4.x is a complete rewrite of the software.
Upgrading from an earlier version to 4.0.3 will take a little bit of time, but is easy to do.
The great thing is that once you've upgraded, not only will the software be better, but version 4.0.3 has a completely new file structure, and auto-upgrading functionality, which means that any subsequent upgrades (to 4.0.4, 4.0.5 etc.) will take just a few seconds!
So once v4.0.3 is installed, it'll be simple to keep up to date and to keep getting all the extra features new versions provide!
Since the module has been rewritten to use a new class based structure, many of the old files are no longer used and need to be removed.
Several of the files for any previous version of Ceon URI Mapping will cause a bit of a performance hit on the server, as they will be opened and parsed automatically by Zen Cart even though they'll never be used again, so it is recommended that all the files specified below are deleted.
Please Note: The list below is exhaustive.. it may well be that several of these files are not present in the store's folders.. that's not a problem, some files only came with very specific versions of the software and may simply never have been part of the version of the software installed on the store's website.
Most Zen Cart stores have their admin directory renamed from the default of “admin”.
Delete any of the following files that exist in the store's “admin” directory, whatever it is called.
These are the new and updated files which make up this module. Copy them all into their respective folders in the Zen Cart installation, overwriting any which remain from the previously installed version.
Most files are used by all Zen Cart versions, however there are some files which are used only by Zen Cart 1.3.x and some which are used only by Zen Cart 1.5.x - be sure to copy all the files for the store's version of Zen Cart.
This means copying the files from the shared folder and the folder for the version of Zen Cart the store uses.
Most Zen Cart stores have their admin directory renamed from the default of “admin”.
Copy all of the folders and files from the files/admin folder into the store's “admin” directory, whatever it is called.
The files are already in the correct directory structure, so a single drag-and-drop of the folders/files in the files/admin folder into the “admin” directory for the store will put the files in the correct locations.
Please do not copy the files individually - there's simply no need - doing so often results in files being missed out!
Copy the file from the files/additional_file_for_1.3.x/admin folder into the store's “admin” directory, whatever it is called.
Copy the files from the files/additional_files_for_1.5.x/admin folder into the store's “admin” directory, whatever it is called.
Copy the includes folder from the files folder into the store's main directory.
The files are already in the correct directory structure, so a single drag-and-drop of the folder into the root directory for the store will put the files in the correct locations.
Please do not copy the files individually - there's simply no need - doing so often results in files being missed out!
Warning: Be careful NOT to copy the files from the files/includes folder into the store's admin/includes directory, they go in the includes directory which is alongside, not inside the store's admin directory.
All of the core Zen Cart files that were modified for the previously installed version must be updated to work with the new version.
There are also some additional files which need to be modified.
As is mentioned above, this will take a little time, but subsequent versions of the software (4.0.3, 4.0.4) are unlikely to require further core file modifications so it's important to “get this step over and done with”.
If these files were only modified when installing a previous version of Ceon URI Mapping, then it should be possible to simply back up each file and then simply overwrite the file with the pre-modified sample file from this distribution, for the version of Zen Cart being used by the store.
However, if any of these core files have also been modified for the store for other third party modules, the changes within the sample files included in this distribution must be applied carefully to the core files.
The changes are clearly marked within the sample files in the distribution and should be easy enough to copy across, especially if a “diff” software package (such as the free WinMerge or the excellent, commercial, Beyond Compare) is used.
Most of the changes between earlier versions are made at the exact same place as they were previously, so it should be quite easy to “merge” the updated code.
Don't forget though that some of the files to be modified were not modified for previous verions, so no existing Ceon URI Mapping code will be present in those files.
Also, take care to note the numbers in the “marker comments” (1 of X) - for some files there are now fewer modifications than there were previously, so some modifications will also have to be removed when adding the updated modifications.
Instructions on how to copy across the modifications necessary for this module - to version of the respective core files which have previously been modified - can be found in this FAQ.
Please Note: If copying the files across, and the admin folder for the store is not named “admin”, then care must be taken to place the files from within the modified_core_files/ZC-version/admin folder into the store's admin folder. Simply copying across the modified_core_files/ZC-version/admin folder won't work!
If any of the “Product Types” (e.g. Document General or Product Book) aren't used by the store, there's no real need to copy/modify the files in the respective directories (e.g. document_general or product_book). However, error messages will be displayed in the “Installation Check” if it detects unmodified files, so it is best to just take a minute or two and make the modifications now anyway.
Some versions of Zen Cart require modifications that others don't. Just apply the modifications to files that are present in the modified_core_files folder for the version of Zen Cart the store uses.
If a file doesn't exist in the overrides directory, simply copy the pre-modified sample file from this distribution, for the version of Zen Cart being used by the store, into the overrides folder.
If the store is upgrading from version prior to 3.8.0 then there are some Zen Cart core files which will have been modified for the previous version but which no longer require any modifications.
It is advised that these modifications are removed:
The files admin/includes/modules/delete_product_confirm.php and admin/includes/modules/product_music/delete_product_confirm.php no longer need to be modified.
The modifications can be removed by editing these files and removing all the code including and between the // BEGIN CEON URI MAPPING 1 of 1
markers, or, if the files have not been modified for any other third party module, by copying over the files with “fresh” versions from the original Zen Cart distribution for the version of Zen Cart the store uses.
This upgrade step doesn't apply for stores already using version 3.6.0 or later.
A few of the standard Zen Cart template files require modifications to work with this module as they weren't built in a way that supports static URIs.
Modifications to existing template files, for static URIs to be able to be used by some of the standard Zen Cart sideboxes and by the product listing filter forms, have been made to “clean” copies of the template files from a “fresh” installation of Zen Cart and are included as “sample” files in this distribution.
If any of these template files haven't already been modified for the store, the sample files included in this distribution can be copied into the store's template directory and will then override the standard versions of the files included in the Zen Cart distribution.
If any of these template files have already been modified for the store, then the changes necessary to support the use of static URIs must be made to the store's modified file(s). The changes are clearly marked within the sample files in the distribution and should be easy enough to copy across, especially if a “diff” software package (such as the free WinMerge or the excellent, commercial, Beyond Compare) is used.
Instructions on how to copy across the modifications necessary for this module - to template files which have previously been modified - can be found in this FAQ.
The sample template files can be found within the template_override_files folder in the distribution. They are:
This upgrade step doesn't apply for stores using Zen Cart version 1.3.9 or 1.5.0.
Canonical URI support is an absolutely essential feature of this module, so it must be enabled properly.
If it isn't, search engines will penalise the site and it may well drop down in its rankings!
Zen Cart versions 1.3.9 and 1.5.0 have the necessary canonical code built into them already but previous versions of Zen Cart must have a file modified to add this support.
The file includes/templates/STORE-TEMPLATE/common/html_header.php must be modified.
If the template file includes/templates/STORE-TEMPLATE/common/html_header.php does not yet exist, then simply copy across the file from the template_override_files folder for the version of Zen Cart the store is using.
If the template file includes/templates/STORE-TEMPLATE/common/html_header.php does exist for the store, then the simple change necessary for canonical URI support must be made to the store's html_header.php.
The change is clearly marked within the sample file in the distribution and should be easy enough to copy across, especially if a “diff” software package (such as the free WinMerge or the excellent, commercial, Beyond Compare) is used.
Instructions on how to copy across the modifications necessary for this module - to existing template files - can be found in this FAQ.
This software comes with some intelligent upgrade and error checking functionality which makes it easy to keep the database and configuration up to date.
Go to Modules > Ceon URI Mapping (SEO) Config in the Zen Cart Admin and the module will be updated automagically!
This new version of the software has completely rewritten functionality for managing the URI mappings of “Product Related Pages”, such as the various “Reviews” pages and the “Tell-A-Friend” pages.
In versions prior to 4.0.0, a bug in the software meant that the URI mappings being built for these pages only worked correctly for sites using one language.
For stores that support multiple languages, it is essential to configure the new “Auto-managed Product Page URIs” settings.
Even for stores that don't multiple languages, it is highly recommended to check these settings as, if the store doesn't use any of the “Reviews” or “Tell-A-Friend” pages, the settings can be changed so that the store's URI Mapping database doesn't fill up with lots of unused URI Mappings - this makes the software faster and more efficient, minimising preventable slowdown of the site!
Go to Modules > Ceon URI Mapping (SEO) Config in the Zen Cart Admin.
Then go to the Auto-managed Product Page URIs tab, adjust the settings appropriately for the store, and click “Save”.
This new version of the software comes with an amazingly handy Installation Check utility.
The installation check will examine the store's configuration files and warn you about any mistakes in the files which you need to correct, and will even provide full information about what you should do.
It will also check all the core files that must be modified for Ceon URI Mapping to work optimally, and warn you if any of the modifications are missing or out of date, again giving information on what you should do!
A quick glance at this new admin page should help you identify and fix any problems with the installation quickly and easily!
Go to Modules > Ceon URI Mapping (SEO) Config in the Zen Cart Admin.
Then go to the Installation Check tab and click on the link to open the Installation Check utility page.
The module will now automatically carry out the installation check.
If any errors are listed, follow the instructions given by the software.
The suggested “Example” Rewrite Rule supplied with this distribution has been further optimised, and should result in [slight, but welcome] performance gains for sites using the new format.
To make things as easy as possible, this new version of the software comes with handy new “Example Rewrite Rule” functionality.
The module will analyse the filesystem on the server and attempt to build a rewrite rule for the store that has any necessary exclusions added.
Go to Modules > Ceon URI Mapping (SEO) Config in the Zen Cart Admin.
Then go to the Installation Check tab and click on the link to open the Installation Check utility page.
Since any errors with the store's configuration files should have been fixed after running the installation check in the previous step, the “Example Rewrite Rule” panel will be displayed.
Read the instructions given in that panel and copy and paste the new Rewrite Rule to the store's .htaccess file/VirtualHost directive, if desired.
Remember this is just an Example rewrite rule, and although it's likely to be better than that used for a previous version of the software, it will not have any customisations made by whoever added the original rewrite rule.. so be sure to carefully merge the changes as appropriate - this is your reponsibility!
If the store uses the Google Sitemap module, it needs to be configured to work better with static URIs.
Otherwise, the store's rankings may be penalised because of links in the sitemap redirecting to other links.
Go to Configuration > Sitemap XML in the Zen Cart Admin.
Make sure that “Generate language_id for default language” is set to “false” .
Lots of people ask us the same questions. It's worth reading the FAQs.
At the very least, here are some of the most popular questions that are covered:
It may have taken a wee while this time, but the above should all have been fairly easy to do. And the new Installation Check certainly helps!
As mentioned previously, that's likely to be the last involved upgrade of this software.. upgrading to subsequent versions will most likely just be a matter of overwriting some files, taking only a few seconds.
Enjoy the new version of the software, there are hundreds of hours of work in it and we hope you like all the new/improved functionality!