Index

Latest version of SSU can be found at 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 Zencart's Forum

Some of you asked if we do offer commercial installation service, and we do. We can help to get this up and running on your site in no time.

1. PHP 5 (if you have php4, please get version 2.9.6 which is the last version that supports php4)
2. mod_rewrite enabled on your APACHE server (which is true in most cases)
3. Module Manager installed (please make sure this module is installed, or you will run into errors)

Check your includes/configure.php

Common mistake for sites located in subfolder:

Assuming

1. your site is: http://www.site.com/subfolder
2. your secure site is at https://secure.site.com/~username/subfolder

So you set in your configure.php like this:

define('HTTP_SERVER', 'http://www.site.com/subfolder');
 
define('HTTPS_SERVER', 'https://secure.site.com/~username/subfolder');

This may work in the normal ZC setting, but it will cause SSU to malfunction. You need to set like this:

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/');

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

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:

#### 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

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:

global $request_type, $session_started, $http_domain, $https_domain;

Insert these lines below that line:

//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

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 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 admin. That's it.

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

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.