Search Engine Safe Application.cfm Settings

• <cfset request.sestemplate = ""> - Path to the search engine safe template in the store directory. This should remain blank until you are ready to create the files. Generally same as request.cartpagetemplate and you may even use #request.cartpagetemplate# here.
• <cfset request.sescategories = "departments/"> - Enter a folder name with a trailing slash (/) for the main category/category files. This can be renamed to include an important keyword pertaining to your products. THIS MUST BE A VALID NAME. No spaces. Use hyphens for spaces for best results. Only letters, numbers, hyphens and undescores are advisable. Place this folder in the same folder as the ezcart folder (not directly in the ezcart folder). DON'T use the slash when naming the actual folder. Folder will be created if it doesn't exist.

  This folder is not required, however if you do not use it, 1 folder and 3 files for each main category will be created right in the "main server" folder, so to be safe and keep things separate, we suggest using a folder here.

  If using a single level of category you can leave this blank, then place all of your product categories in main category 0. Set the search engine safe name for main category 0 to something unique and it would basically be used in place of this setting.

• <cfset request.sesmanufacturers = "brands/"> - Enter a folder name with a trailing slash (/) for the manufacturer files. This can be renamed to include an important keyword pertaining to your products. THIS MUST BE A VALID NAME. No spaces. Use hyphens for spaces for best results. Only letters, numbers, hyphens and underscores are advisable. Place this folder in the same folder as the ezcart folder (not directly in the ezcart folder). DON'T use the slash when naming the actual folder. Folder will be created if it doesn't exist.

  The same notes and warnings as the categories folder apply. If you're not using manufacturers, you can ignore this.

• <cfset request.sesmap = "map.cfm"> - Name of file to load product map. A file with this name will be created in each of the 2 directories specified above. Again, use an important keyword in naming.
• <cfset request.sesfileext = "cfm"> - Template type. Don't change this unless your ColdFusion server uses a different extension.
• <cfset request.sespageseparator = "~"> - This must be a URL-Safe character that will never be used anywhere in your URLs or filenames. A tilde ~ is recommended unless you have a reason not to use a tilde.
• <cfset request.sesfirstmaincatpage = "x"> - Set to "x" to allow us to set action=custom when clicking on a main category. We can use that to allow the customer to filter on Manufacturers, or search within that maincategory, etc. Otherwise make this "1" to set action=list to list all products under a main category. See Technical Notes.
• <cfset request.sesfirstcatpage = "1"> - Set to "x" to allow us to set action=custom when clicking on a category/sub category. We can use that to allow the customer to filter on Manufacturers, or search within that category, etc. Otherwise leave this "1" to set action=list to list all products under a main category. See Technical Notes.
• <cfset request.sesdisable = "0"> - Set to "1" to turn off all search engine safe code, inclding the file system and the traditional method. You'll need to use the old custom tags, etc. if you do this.
• <cfset request.forcesubdomain = ""> - If clicking on Next links and Continue Shopping buttons cause you to go from http://www.yourdomain.com/page.cfm to http://yourdomain.com/page.cfm, add "www." to this setting.
• <cfset request.removefrompath = ""> - Some servers read cgi.script_name from the root of the machine and others the root of the web site. If clicking on Next links and Continue Shopping buttons cause you to get "Page Not Found" errors, and you notice that the URL goes from http://www.yourdomain.com/page.cfm to something like http://www.yourdomain.com/mysitename/page.cfm, add the extra part to be removed. In the example, that would be "mysitename/".

Technical Notes: When using the search engine safe file system, we create 3 files for each main category and category in the category hierarchy. These are the search engine safe name plus .cfm, ~x.cfm (assuming you left ~ as request.sespageseparator) and ~1.cfm. So search engine safe name "beauty-products-cosmetics" results in the following 2 files being created.
beauty-products-cosmetics.cfm
beauty-products-cosmetics~x.cfm
beauty-products-cosmetics~1.cfm
These files are identical except .cfm includes the action "sitemap", ~x.cfm includes the action "custom" and ~1.cfm includes the action "list". Within our ezcartpagecontent.cfm file, if action is "custom", we'll show a list of manufacturers to select from. If the action is "list" we show the products and cf_ezcart will automatically duplicate and number enough pages to show all of your products at the number of products per page (attributes.maxrows) that you set.

If you are not using the search engine safe file system but are using traditional SES URLs, we will pass the appropriate action (custom for x, list for 1) in the URL.