ceon_uri_mapping

probably the best Zen Cart URI Mapping/SEO Module in the world! ...ever!

Frequently Asked Questions (FAQs)

  1. Some of the core files have already been modified for the site. How can the URI Mapping code be added?

    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.

    • Each change should be copied and pasted into the modified core file at the exact same place it is present within the respective sample file.
    • Using a “diff” software package, such as the free WinMerge software or the commercial Beyond Compare software, makes this considerably easier to do without mistakes.
  2. Help! A server error is being displayed (e.g. a “Bad Request” error)!

    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.

  3. The module is blocking access to part of the site (e.g. the site's control panel)!

    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.

  4. A string beginning with “?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.

  5. Can we distribute this distribution to our clients?

    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.

  6. How can I help with the module?

    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!

    • It took several weeks to write version 2 and several days more to write version 3 of this module, with none of the time taken being paid for by anyone, so if you find this module useful for your shop, please consider supporting us - just click the PayPal button on the right.

      Almost no-one donates towards our software, so it would be greatly appreciated - Thanks!

Back to top