probably the best Zen Cart URI Mapping/SEO Module in the world! ...ever!
Each change in the core files required for the URI Mapping module to work is clearly marked in the sample versions of the files.
Changes begin with a comment such as:
// BEGIN CEON URI MAPPING 1 of x
And end with a comment such as:
// END CEON URI MAPPING 1 of x
Where ‘x’ is the number of code changes within the current file which must be included for the Ceon URI Mapping module to use that file correctly.
This is most likely caused by using the wrong path to “index.php” being used in the RewriteRule
directive or by other rewrite rules on the server interfering with the rule being used for the Ceon URI Mapping module.
As is mentioned in the Setting up a Rewrite Rule section of the documentation, if putting the rule in a VirtualHost directive, the RewriteRule
will need to have the relative path to the Zen Cart directory prepended to index.php
. If putting the rule in a .htaccess file, then care needs to be taken with the location of the file and the final path to index.php
being used in the RewriteRule
directive.
If putting the rule in a VirtualHost directive, try adding the relative path to the shop (e.g. “/” or “/shop/”) before index.php
in the last line of the Rewrite Rules and restart the webserver. Depending on your version of Apache, that may fix things!
For example, the line may end up looking as follows:
RewriteRule (.*) /index.php?%{QUERY_STRING} [L]
If putting the rule in a .htaccess file, try adding the directory the shop is in (e.g. “shop/”) before index.php
in the last line of the Rewrite Rules and restart the webserver. That may fix things!
For example, the line may end up looking as follows (note that there's no slash at the beginning of the shop's directory name):
RewriteRule (.*) shop/index.php?%{QUERY_STRING} [L]
If reading Setting up a Rewrite Rule section of the documentation and trying the above doesn't help, then, as mentioned in the configuration section, this kind of issue is something that is outside the scope of this documentation. There are plenty of guides to be found on the internet on how to configure a server properly for Rewrite handling.
Please Note: If you attempt to contact Ceon directly about any such issues you will be required to pay for any support given, as outlined in the support documentation.
Information about adding exceptions to the rewrite rule - and therefore restoring access to particular addresses on/sections of the site - can be found in the configuration documentation.
?cPath
” is being added to the end of a product's URI!The module retains Zen Cart's category history when linking to a linked product which is not within its “master” category, so the full path back through any parent categories is available. To do so, it is essential that the “cpath
” query string parameter is added to the URI.
Without this feature all linked products would always show as belonging to their “master” category, which will not be the category the customer has accessed the product from.. this would make it appear to the customer that they had “jumped” to another part of the site, they would no longer be in the same category they were in previously!
There is no way to avoid the cPath
parameter being added for linked products. It's advised to use linked products only when necessary and/or to simply accept that it's not possible in Zen Cart to omit the cPath
parameter in the URI of linked products.
Yes, the software is GPL. However, the documentation in this distribution is copyrighted to Ceon and must not be distributed in a modified form without our express permission.
As long as the documentation isn't modified, it can be freely distributed along with the software.
If you'd like to modify the documentation, for example by branding it with your company logo, please contact us for permission! A credit acknowledgement to Ceon and JKED will always be required.
If you have any feedback or a bug report, please send it to us! There's nothing that makes developing more rewarding that feeling that it is appreciated!