ceon_uri_mapping

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

System Requirements

Installation

Installation of the module has been made as simple as possible and shouldn't take long for any stores which have not already modified any of the core files which this module has to modify.

If any of the core files this distribution uses have already been modified (because of another third party module being installed for example) then the changes for the respective files should be applied manually by copying across the appropriate sections of code required for the URI Mapping module. These sections are clearly marked (with “// BEGIN” and “// END” comments) within the sample files provided in this distribution.

Installation Overview

  1. Copy the new files from the distribution into the Zen Cart installation.
  2. Copy the updated core files from the distribution into the Zen Cart installation, or modify the respective core files.
  3. Create the necessary database tables and configure the URI auto-generation settings.
  4. Add the rewrite rules to Apache.
  5. Set up the URI mappings for categories, products and EZ-Pages.

Installation Steps

  1. New Files

    These are the new files which make up this module. Copy them all into their respective folders in the Zen Cart installation.

    They already have the correct folder structure, so a single drag-and-drop of the folders/files in the files folder into the root directory for the store will put the files in the correct locations; there's no need to copy the files individually - that often results in files being missed out!

    Please Note: If the admin folder for the store is not named “admin” then care must be taken to place the files from within the files/admin folder into the store's admin folder, copying across the files/admin folder won't work!

    • admin/images/ceon_button_logo.png
    • admin/includes/boxes/extra_boxes/ceon_uri_mapping_modules_dhtml.php
    • admin/includes/classes/transliteration (* ALL files in this directory!)
    • admin/includes/classes/class.String.php
    • admin/includes/classes/class.Transliteration.php
    • admin/includes/extra_datafiles/ceon_uri_mapping_database_tables.php
    • admin/includes/extra_datafiles/ceon_uri_mapping_filenames.php
    • admin/includes/functions/extra_functions/ceon_uri_mapping.php
    • admin/includes/languages/english/extra_definitions/ceon_uri_mapping.php
    • admin/includes/languages/english/ceon_uri_mapping_config.php
    • admin/ceon_uri_mapping_auto_upgrade.php
    • admin/ceon_uri_mapping_config.php
    • includes/auto_loaders/config.ceon_uri_mapping.php
    • includes/extra_datafiles/ceon_uri_mapping_config.php
    • includes/extra_datafiles/ceon_uri_mapping_database_tables.php
    • includes/extra_datafiles/ceon_uri_mapping_filenames.php
    • includes/init_includes/init_ceon_uri_mapping.php
  2. Updated Core Files

    A few core Zen Cart admin files must be updated to work with the URI Mapping module.

    • It is likely that none of these files have been modified for the store already, in which case the pre-modified sample files from this distribution, for the version of Zen Cart being used by the store, should simply be copied over the existing version of the files.

    • However, if any of these core files have already been modified for the store, the changes within the sample files included in this distribution must be applied to the previously modified 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 software or the commercial Beyond Compare software) is used.

      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.

    The modified core files can be found within the modified_core_files folder in the distribution. A list of the files follows.

    If any of the “Product Types” (e.g. Document General or Product Book) aren't used by the store, there's no need to copy/modify the files in the respective directories (e.g. document_general or product_book).

    If the store's core files haven't been modified then there's no need to copy the files individually - that often results in files being missed out! They already have the correct folder structure, so a single drag-and-drop of the folders/files in the modified_core_files folder (for the exact same version of Zen Cart) into the root directory for the store will put the files in the correct locations.

    Please Note: If the admin folder for the store is not named “admin” then care must be taken to place the files from within the files/admin folder into the store's admin folder, copying across the files/admin folder won't work!

    • admin/includes/modules/document_general/collect_info.php
    • admin/includes/modules/document_general/preview_info.php
    • admin/includes/modules/document_product/collect_info.php
    • admin/includes/modules/document_product/preview_info.php
    • admin/includes/modules/product/collect_info.php
    • admin/includes/modules/product/preview_info.php
    • admin/includes/modules/product_book/collect_info.php
    • admin/includes/modules/product_book/copy_to_confirm.php
    • admin/includes/modules/product_book/delete_product_confirm.php
    • admin/includes/modules/product_book/preview_info.php
    • admin/includes/modules/product_book/update_product.php
    • admin/includes/modules/product_free_shipping/collect_info.php
    • admin/includes/modules/product_free_shipping/preview_info.php
    • admin/includes/modules/product_music/collect_info.php
    • admin/includes/modules/product_music/copy_to_confirm.php
    • admin/includes/modules/product_music/delete_product_confirm.php
    • admin/includes/modules/product_music/preview_info.php
    • admin/includes/modules/product_music/update_product.php
    • admin/includes/modules/copy_to_confirm.php
    • admin/includes/modules/delete_product_confirm.php
    • admin/includes/modules/move_product_confirm.php
    • admin/includes/modules/sidebox_move_product.php
    • admin/includes/modules/update_product.php
    • admin/categories.php
    • admin/ezpages.php
    • admin/manufacturers.php
    • admin/product.php
    • includes/functions/html_output.php
  3. Create the necessary Database Tables and Configure the URI Auto-generation Settings.

    The database tables required by the module are automatically created by an installation and upgrade script.

    This script runs automatically when the configuration utility is accessed. (In the future, if the module is being upgraded, the configuration utility should also be accessed then.)

    • Simply go to Modules > URI Mapping Config in the Admin and the database tables will be automatically created.

    Details of how to configure the URI auto-generation settings and set up the URI mappings for the store are provided in the configuration section.

  4. Add the Rewrite Rules to Apache.

    Details of how to add the necessary rewrite rules for the store are provided in the configuration section.

  5. Configure the module and Set Up the URI Mappings for Categories, Products, Manufacturers and EZ-Pages.

    Now all that has to be done is to configure the module's settings and set up the URI mappings for the store in the Zen Cart Admin.

    Details of how to configure the module and how to set up the URI mappings for the store are provided in the configuration section.

Back to top