==== IMPORTANT ====

Latest version of SSU can be found at [[http://eazy-templates.com/web-templates/zen-cart/modules/simple-seo-url|Eazy-Templates.com]]

**Please always make sure you have the latest version. Version found on Zencart download section is NOT always the latest. Also, all versions of SSU are FREE**

For support, please post question(s) in [[http://www.zen-cart.com/forum/showthread.php?t=86353|Zencart's Forum]]

Some of you asked if we do offer commercial installation service, and we do. We can help to [[http://eazy-templates.com/web-templates/zen-cart/modules/simple-seo-url|get this up and running]] on your site in no time.

==== REQUIREMENT ====
  - PHP 5 (if you have php4, please get version 2.9.6 which is the last version that supports php4)
  - [[http://www.wallpaperama.com/disp-post19.html|mod_rewrite enabled]] on your APACHE server (which is true in most cases)
  - [[http://code.google.com/p/zencart-module-manager/downloads/list|Module Manager]] installed (please make sure this module is installed, or you will run into errors)

==== PRE INSTALLATION ====

Check your includes/configure.php

**Common mistake for sites located in subfolder:**

Assuming 
  - your site is: http://www.site.com/subfolder
  - your secure site is at https://secure.site.com/~username/subfolder

So you set in your configure.php like this:
<code php>
define('HTTP_SERVER', 'http://www.site.com/subfolder');

define('HTTPS_SERVER', 'https://secure.site.com/~username/subfolder');
</code>

This may work in the normal ZC setting, but it will cause SSU to malfunction. You need to set like this:
<code php>
define('HTTP_SERVER', 'http://www.site.com');

define('HTTPS_SERVER', 'https://secure.site.com');

define('DIR_WS_CATALOG', '/subfolder/');

define('DIR_WS_HTTPS_CATALOG', '/~username/subfolder/');
</code>

So basically, the http ones should contain only the domain name, no sub folders at all. 

==== INSTALLATION ====

Steps:

1. Upload all files to your server.

2. Visit admin->extras->ssu manager (you should see notice saying that the database patches have been applied)

**WARNING:** 

A. If your path_to_store/.htaccess file is not blank, do NOT overwrite it. Open the .htaccess file and append the following lines:
<code htaccess>
#### BOF SSU
Options +FollowSymLinks
RewriteEngine On
# Change "/zencart/ to the correct setting
# if your site is located at root folder, then you should have RewriteBase /
# Go to your include/configure.php, this value should be the same with the value of DIR_WS_CATALOG
RewriteBase /zencart/

# Deny access from .htaccess
RewriteRule ^\.htaccess$ - [F]

RewriteCond %{SCRIPT_FILENAME} -f [OR]
RewriteCond %{SCRIPT_FILENAME} -d
RewriteRule .* - [L]

RewriteRule ^(.+) index.php/$1 [E=VAR1:$1,QSA,L]
#### EOF SSU
</code>

**Don't forget to change the "RewriteBase" in .htaccess as instructed in the .htaccess file**

B. if you are NOT using Zencart 1.3.8a, it's safer to not upload includes/functions/html_output.php but to do this:
Open your current includes/functions/html_output.php
  * find the function zen_href_link
  * find this line:
<code php>
global $request_type, $session_started, $http_domain, $https_domain;
</code>

Insert these lines below that line:

<code php>
//bof simple seo url
    global $ssu;
    if(is_object($ssu) && ($link = $ssu->ssu_link($page, $parameters, $connection, $add_session_id, $search_engine_safe, $static, $use_dir_ws_catalog))!= false) return $link;
//eof simple seo url</code>

2. This mod use the cache folder path defined in: DIR_FS_SQL_CACHE in file includes/configure.php

This folder is usually located at the root of your ZC store (http://site.com/path_to_store/cache)
  * If it is NOT, you will find in the SSU package the folder cache/ssu, copy this ssu folder along with its sub folders into your cache folder.
  * Go to path_to_cache_folder/ssu, set this "ssu" folder's and all its subfolders permission to 0777
  * It is VERY important to check and make sure that the values of DIR_FS_SQL_CACHE defined at the bottom of includes/configure.php and admin/includes/configure.php are the SAME.

**Configure SSU**

For most users, SSU can be run "as is", but you may want to take a look at this [[zencart/modules/ssu/config|configuration guide]] to see what SSU allows you to do. 
names as well)

**Enable SSU**

As of beta 2.5, you can turn SSU on-off, and it's off by default, so you need to turn it on in [[zencart/modules/ssu/config|admin]]. That's it.

==== POST INSTALLATION ====

As of version 3.2.9, there is a file called ssu_check.php which can help you to check if there is anything wrong with your current setting. Go to http://yoursite/ssu_check.php to view the result

**Please delete this file afterward for security reason**

==== NOTE ====

Certain hosts such as GoDaddy have been known to cache the .htaccess files and only reload those very hour or so. So do not panic if things do not seem to work, sometimes all you have to do is to wait patiently. Remember, during this time, you can turn SSU off in the admin side so your site will still function normally.