Index

Admin→Configuration→Simple SEO URL

For most users, this is the only place you will need to go to configure SSU to work the way you want. Some important settings you should pay attention to:

1. File extension: can be html, php or whatever you want. Currently extension is only added to a limited number of pages. It is recommended that you leave this blank because the only thing it does is making your links a bit longer (which is not a good thing).
2. Name delimiter: is used to replace all non alpha-numeric characters in product/category/… names
3. ID delimiter: is used to separate product/category/…. names and their ids
4. Page Exclude list: is the list of pages that should be excluded from using seo style links, separated by comma with no blank space. It is recommended that you exclude these pages (at least):

   advanced_search_result,redirect,popup_image_additional,search,download,wordpress

5. Query Key's Exclude List: is the list of query keys that you want SSU to avoid converting, separated by comma with no blank space. It is recommended that you exclude these query keys(at least):

   zenid,gclid,number_of_uploads,number_of_downloads,action,sort,page,disp_order,filter_id,alpha_filter_id,currency,keyword,search_in_description

6. Set Auto Alias Status: when set to true SSU will automatically build “aliases” of your product/category/manufacture/… and hence will remove all the identifiers such as -c-14 from your links.
7. Set Category Separator: with auto alias mode on, SSU goes 1 step further by allowing you to put a character of your choice between the category names on a link. (i.e: if the separator is '/', honda-accord-c-14_7 → honda/accord)

Note:

Sample link: index.php?main_page=contact_us&action=send&status=success

Here, “contact_us” is the page while “action” and “status” are the query keys

As of version 3.2, SSU comes with 2 config files located in includes/classes/ssu

1. config.php (this file contains the default settings and should be used as a reference only)
2. local.config.php (this is the file you should edit)

This configuration step will hopefully make its way into the admin some day, to provide a more convenient way to config SSU.

As of now, SSU needs to know all the languages you are currently supporting on your site, and which language parser you want to use for this language (note: multiple languages can share the same parser, for example: you may or may not use the same parser for Russian and Serbian)

The default config only specifies English parser, in your includes/classes/ssu you should have the file local.config.php.example. You can change local.config.php.example to local.config.php, take out the /* */, and define the language codes.

    $ssuLocalConfig = array(
 
        'languages'        =>    array(    'fr'    =>    'default',
                                    'ru'    =>    'ru',
                                    )
    );

Please note:

• English uses the default parser, you don't have to specify it here unless you want to use your own parser.
• Even if the additional languages use the default parser, you still have to specify that (in the example above, we use the default for French)
• Currently there are only 2 language parsers come by default with SSU, if you want a parser for Chinese i.e, you will have to write your own.

By default, SSU only tries to put product, category, and ezpage names on links. This works good for most stores, but some may need more. Additional page parsers can be used as well, these parsers can be found in includes/classes/ssu/plugins/parsers.

As of now, the only additional parser available is the “manufacturer” parser, but you can certainly write your own page parser as well. To enable this page parser you need to config two things:

• You have to tell SSU to use that parser.
• You have to specify an identifier for the name created by that parser.

This will add manufacturer parser:

<?php
$ssuLocalConfig = array(
'plugins'        =>    array('parsers'    =>    array('manufacturers')
                            ),
 
    'identifiers'    =>    array('manufacturers'    =>    'manufacturer')
);

So here is the config that will add manufacturer parser, and French and Russian parsers:

<?php
$ssuLocalConfig = array(
'plugins'        =>    array('parsers'    =>    array('manufacturers')
                            ),
 
    'identifiers'    =>    array('manufacturers'    =>    'manufacturer'),
 
'languages'        =>    array(    'fr'    =>    'default',
                                    'ru'    =>    'ru',
                                    )
);