6. Go to the Extension Manager
7. Choose in the TOP Dropdown Menu: Import Extensions
8. Go to: Extensions in TYPO3 Extension Repository
9. In the input field type: cooluri - and press the look up button
10. Choose the cooluri Extension and click on the read arrow on the left side

>>> if everything is OK the continue with Step 4

Step 4 - Installation

1. Press the Button: Make Updates - some database tables need to be modified or added
2. In the configuration part define (TIP: keep the defaults):

A. Language var

Here you can define the variable used in the xml configuration file which defines the Language Entries (default: L)

B. xml-path

Define where you have stored the CoolUriConf.xml (default: typo3conf)

C. Multi domain site

Check this if you are having more then one Domain/Subdomain in your TYPO3 Installation.

>>> if everything is OK the continue with Step 5

Step 5 - Domain Entry Check

1. Open List module
2. Go to the Page Tree



Here starts the Main Root - You need a Domain Record (test.abc-typo3.com ) and a Root Template here

Click on "Links" to get from the UNESCO BKK T3-Pack to the MULTIDOMAIN, SUBDOMAIN and ROOTDOMAIN Site
Here start another Root - You need a Domain Record (multidomain.t3pack.org ) and a Root Template here


This Page is pointed by a subdomain - You need a Domain Record only (subdomain.t3pack.org )
                To avoid doubled content you need to use a 301 redirect like shown below

Here start another Root - You need a Domain Record (rootdomain.t3pack.org ) and a Root Template here




This Page links back to the MainPage
This Page links back to the MainPage





if you are running a Multidomain Site you will have to repeat 3-6 for each Domainroot!

3. Click on the Rootpage of your Pagetree
4. Check if there is a Domain Record available

if yes

4.1 check if the domain entry is using the right syntax to avoid doubled content. (see examples below )
>>> continue with 5

if no

4.2 click on: create a new record (you'll find it at the button of the page)
4.3 choose: Domain
4.4 enter: your domain values (see examples below )
4.5. check your entry
>>> continue with 5

5. Your Domain Record should have the following syntax.

Example: Domain Record - SUBDOMAIN incl. 301 redirect.

Don't forget to unchecked it

The domain which will be called without http:// !!!


The domain you wanna redirect to with http:// !!!
write down the exact link to the page with trailing slash (more Info )


Please check it to transfer all paranmeters to the redirect record.


Here you enter the Status code.
In our Example it is 301 for the Redirect: Permanently moved - to aviod dublicated content

Save and Close

More Info:
If someone types in his browser "subdomain.abc-typo3.com" he will be led directly to a subpage in MULTIDOMAIN called SUBDOMAIN
Even the page SUBDOMAIN has got a subtree we don't want that the link to subpages will look like "subdomain.abc-tpo3.com/sub_page_1/" if we call them from SUBDOMAIN and "multidomain.abc-typo3.com/subdomain/sub_page_1/" if the same page is been called from a page in MULTIDOMAIN.

Therfore we have to redirect the call "subdomain.abc-typo3.com" to the pageUrl as if the page would be called from MULTIDOMAIN
It has to be "multidomain.abc-typo3.com/subdomain/"

6. Check if the Status Code Box is available on the button of the domain record

If you haven't already jb_status_code installed - do it now and then continue here!

>>> Install JB_Status_Code - Go to the JB_Status_Code - Redirect 301 - Tutorial

>>> If everything is OK continue with Step 6

JB_Status_Code Tutorial

JB_Status_Code adds a new field for status code to the domain record where you can insert i.e. redirecting code and more

It enables you to redirect 301 within TYPO3. No need to edit your .htaccess!
Simply install the extension and it is working

i.e. you want to redirect 301 - permanently moved - your domain without www. to the domain using the www. prefix

Enter your domain you wanna redirect: example.com
Enter the domain you want to redirect to: http://www.example.com

Attention don't forget the http:// in front of this second "redirect to" entry. BUT http:// is not needed in the first entry!

Check the box: Transfer Parameters to Redirect URL
Enter 301 into the small Status code box below

You also need to create a second domain record for www.example.com

Create a new domain record

Use Listmodule
Go to your page
Search for the Domain Box
Click the green plus in the domain field
Enter your domain you wanna redirect: www.example.com
Save and close

That's it!

>>> Please repeat Step 5 if you haven't made the required settings

>>> if everything is OK the continue with Step 6

Step 6 - Template Setup Typoscript Check

1. Open Template module

2. Go to the Page Tree

if you are running a Multidomain Site you will have to repeat 3-6 for each Domainroot!

3. Click on the Rootpage of your Pagetree
4. Open: Setup

if you had realurl installed search for the realurl Entry and replace it

# Cooluri
config.simulateStaticDocuments = 0
config.baseURL = http://www.example.com/   use your domain here
config.tx_cooluri_enable = 1
config.redirectOldLinksToNew = 1

5. Save and Close
6. Repeat 3-6 for every Rootpage you have inside your TYPO3 Installation

 IMPORTANT!!!  >>> if you had realurl installed go to Step 7

>>> if you never had realurl stuff installed go to Step 8

Step 7 - Cleaning up realurl and localconf.php - Moving from RealURL!

If you are switching from realurl to cooluri you need to do a very carefull cleanup!

1. Please deinstall the following extensions:

adaltas_realurl_i18n
aeurltool
bk_realurl
cab_realurl_languageselector
danp_realurlconfigurator
jb_realurl_regeneration
nfc_realurl_individual
p2_realurl
realurl
realurlmanagement
realurlmanmoduleexample
realurlsettings
weeaar_languagemenu

(this list might be incomplete - please report missing extensions which are no longer needed if you are using cooluri)

2. Cleaning your Template Setup Typoscript

       You need to remove all RealUrl Settings and those made by the extensions mentioned above!

3. Clean your localconf.php file - Go here if you are using a separate config file

In order to have a clean configuration of cooluri you should clean the localconf.php file in your typoconf directory from all kind of entries caused by the above mentioned realurl stuff

i.e. everything marked red should be removed as all configuration is done with an .xml file

<?php
$TYPO3_CONF_VARS['SYS']['sitename'] = 'New TYPO3 site';

    // Default password is "joh316" :
$TYPO3_CONF_VARS['BE']['installToolPassword'] = 'bacb98acf97e0b6112b1d1b650b84971';

$TYPO3_CONF_VARS['SYS']['sitename'] = '';
$TYPO3_CONF_VARS['SYS']['cookieDomain'] = '';
$TYPO3_CONF_VARS['BE']['warning_email_addr'] = '';
$TYPO3_CONF_VARS['BE']['notificationPrefix'] = '[TYPO3 Note]';
$TYPO3_CONF_VARS['BE']['installToolPassword'] = '';
$typo_db_username = '';
$typo_db = '';
$typo_db_password = '';
$typo_db_host = '';

$TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tstemplate.php']['linkData-PostProc'][] = 'EXT:realurl/class.tx_realurl.php:&tx_realurl->encodeSpURL';
$TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_fe.php']['checkAlternativeIdMethods-PostProc'][] = 'EXT:realurl/class.tx_realurl.php:&tx_realurl->decodeSpURL';

$TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['clearAllCache_additionalTables']['tx_realurl_urldecodecache'] = 'tx_realurl_urldecodecache';
$TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['clearAllCache_additionalTables']['tx_realurl_urlencodecache'] = 'tx_realurl_urlencodecache';

$TYPO3_CONF_VARS['FE']['addRootLineFields'].= ',tx_realurl_pathsegment';

$TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT'] = array(
    'init' => array(
        'enableCHashCache' => 1,
        'appendMissingSlash' => 'ifNotFile',
        'enableUrlDecodeCache' => 1,
        'enableUrlEncodeCache' => 1,
    ),
    'pagePath' => array(
        'type' => 'user',
        'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
        'spaceCharacter' => '_',
        'languageGetVar' => 'L',
        'expireDays' => 7,
        'rootpage_id' => 61,
    ),

     /* Prevars show up in the first part of the URL */
    'preVars' => array(
        array(
            'GETvar' => 'L',
            'valueMap' => array(
                'en' => '1',
                'de' => '2',
                'th' => '3',
                'valueDefault' => 'en',
            ),
            'noMatch' => 'bypass',
        ),
    ),
   
     /* fixedPostVars are limited to a single page in the backend */
    'fixedPostVars' => array(
        /* User Account */
        '52' => array(
            array(
                'GETvar' => 'tx_srfeuserregister_pi1[cmd]',
            ),
        ),
       
        /*
         *  Calendar Pages
         * ************************************************************* /
       
      /* Month */
      '53'=> array(
            array( 'GETvar' => 'tx_calendar_pi1[f1]' ),
            array( 'GETvar' => 'tx_calendar_pi1[f2]' ),
        ),
       
        /* Week */
        '56'=> array(
            array( 'GETvar' => 'tx_calendar_pi1[f1]' ),
            array( 'GETvar' => 'tx_calendar_pi1[f2]' ),
        ),
       
        /* Day */
        '55'=> array(
            array( 'GETvar' => 'tx_calendar_pi1[f1]' ),
            array( 'GETvar' => 'tx_calendar_pi1[f2]' ),
            array( 'GETvar' => 'tx_calendar_pi1[f3]' ),
        ),
       
        /* Event Page */
        '54'=> array(
            array(
                'GETvar' => 'tx_calendar_pi1[f1]',
                'lookUpTable' => array(
                    'table' => 'tx_calendar_item',
                    'id_field' => 'uid',
                    'alias_field' => 'title',
                    'addWhereClause' => ' AND NOT deleted',
                    'useUniqueCache' => 1,
                    'userUniqueCache_conf' => array(
                        'strtolower' => 1,
                        'spaceCharacter' => '-',
                    ),
                ),
            ),
        ),
       
        /* Blog Home */
        /*
        '81' => array(
            // news categories
            'category' => array(
                array(
                    'GETvar' => 'tx_ttnews[cat]',
                    'lookUpTable' => array(
                        'table' => 'tt_news_cat',
                        'id_field' => 'uid',
                        'alias_field' => 'title',
                        'addWhereClause' => ' AND NOT deleted',
                        'useUniqueCache' => 1,
                        'useUniqueCache_conf' => array(
                            'strtolower' => 1,
                            'spaceCharacter' => '_',
                        ),
                    ),
                ),
            ),           
        ),*/
           
        '82' => array(
            array(
                'GETvar'      => 'tx_ttnews[tt_news]',
                'lookUpTable' => array(
                    'table'               => 'tt_news',
                    'id_field'            => 'uid',
                    'alias_field'         => 'title',
                    'addWhereClause'      => ' AND NOT deleted',
                    'useUniqueCache'      => 1,
                    'useUniqueCache_conf' => array(
                        'strtolower'     => 1,
                        'spaceCharacter' => '_',
                    ),                       
                ),
            ),
        ),
       
        '40' => array(
            array(
                'GETvar'      => 'tx_ttnews[tt_news]',
                'lookUpTable' => array(
                    'table'               => 'tt_news',
                    'id_field'            => 'uid',
                    'alias_field'         => 'title',
                    'addWhereClause'      => ' AND NOT deleted',
                    'useUniqueCache'      => 1,
                    'useUniqueCache_conf' => array(
                        'strtolower'     => 1,
                        'spaceCharacter' => '_',
                    ),                       
                ),
            ),
        ),
       
        '74' => array(
            array(
                'GETvar' => 'sub',
                'valueMap' => array(
                    'subscribe' => '1',
                ),
                'noMatch' => 'bypass',
            ),
            array(
                'GETvar' => 'respond',
                'lookUpTable' => array (
                    'table' => 'tx_wecconnector_entries',
                    'id_field' => 'uid',
                    'alias_field' => 'subject',
                    'useUniqueCache' => 1,
                    'useUniqueCache_conf' => array (
                        'strtolower' => 1,
                        'spaceCharacter' => '_',
                    ),
                ),
                'noMatch' => 'bypass',
            ),
        ),
       
        '79' => array(
            array(
                'GETvar' => 'devo_sec',
                'lookUpTable' => array  (
                    'table' => 'tx_wecdevo_section',
                    'id_field' => 'uid',
                    'alias_field' => 'name',
                    'useUniqueCache' => 1,
                    'useUniqueCache_conf' => array (
                        'strtolower' => 1,
                        'spaceCharacter' => '_',
                    ),   
                ),
            ),
            array(
                'GETvar' => 'txtpg',
                'valueMap' => array(
                    'single_page' => '1',
                    'multiple_pages' => '2',
                    'scrolling' => '3',
                ),
                'noMatch' => 'bypass',   
            ),
            array(
                'GETvar' => 'txtsz',
                'valueMap' => array(
                    'small_text' => '1',
                    'medium_text' => '2',
                    'large_text' => '3',
                ),
                'noMatch' => 'bypass',
            ),
        ),
       
        '87' => array(
            array(
                'GETvar' => 'showinterest',
                'lookUpTable' => array(
                    'table' => 'tx_wecservant_minopp',
                    'id_field' => 'uid',
                    'alias_field' => 'name',
                    'addWhereClause'  => ' AND NOT deleted',
                    'useUniqueCache' => 1,
                    'useUniqueCache_conf' => array(
                        'strtolower' => 1,
                        'spaceCharacter' => '_',
                    ),
                ),
            ),
        ),
    ),
   
   'postVarSets' => array(
             '_DEFAULT' => array (
                 'photobook' => array(
                     array('GETvar' => 'tx_gooffotoboek_pi1[srcdir]'
                    ),
                    array(
                         'GETvar' => 'tx_gooffotoboek_pi1[fid]'
                     ),
                     array(
                         'GETvar' => 'tx_gooffotoboek_pi1[func]',
                         'valueMap' => array(
                             'thumbnails' => 'thumb',
                         ),
                     ),
                 ),
             ),
    ),





    'postVarSets' => array(
        '_DEFAULT' => array (
                'browse' => array(
                    array(
                        'GETvar' => 'tx_ttnews[pointer]',
                    ),
                ),
               
                'app' => array(
                    'type' => 'single',
                    'keyValues' => array(
                        'type' => 200,
                    ),
                ),

                'trackback' => array(
                    'type' => 'single',
                    'keyValues' => array(
                        'tx_timtab_pi2[trackback]' => 1,
                    ),
                ),
               
                'archive' => array(
                    array(
                        'GETvar' => 'tx_ttnews[year]',
                    ),
                    array(
                        'GETvar'   => 'tx_ttnews[month]',
                    ),
                ),
               
               
                /* News Categories */
                'category' => array(
                    array(
                        'GETvar'      => 'tx_ttnews[cat]',
                        'lookUpTable' => array(
                            'table' => 'tt_news_cat',
                            'id_field' => 'uid',
                            'alias_field' => 'title',
                            'addWhereClause' => ' AND NOT deleted',
                            'useUniqueCache' => 1,
                            'useUniqueCache_conf' => array(
                                'strtolower' => 1,
                                'spaceCharacter' => '_',
                            ),
                        ),
                    ),
                ),                   


            'forum' => array(
                array(
                        'GETvar' => 'view',                                                                                            
                ),
                array(
                        'GETvar' => 'cat_uid',
                        'lookUpTable' => array(
                                'table' => 'tx_chcforum_category',
                                'id_field' => 'uid',
                                'alias_field' => 'cat_title',
                                'addWhereClause' => ' AND NOT deleted',
                                'useUniqueCache' => 1,
                                'useUniqueCache_conf' => array(
                                      'strtolower' => 1,
                                     'spaceCharacter' => '-',
                                                ),
                                ),
                ),
                array(
                        'GETvar' => 'conf_uid',
                        'lookUpTable' => array(
                                        'table' => 'tx_chcforum_conference',
                                        'id_field' => 'uid',
                                        'alias_field' => 'conference_name',
                                        'addWhereClause' => ' AND NOT deleted',
                                        'useUniqueCache' => 1,
                                        'useUniqueCache_conf' => array(
                                                'strtolower' => 1,
                                                'spaceCharacter' => '-',
                                        ),
                                ),
                ),
                array(
                        'GETvar' => 'thread_uid',
                        'lookUpTable' => array(
                                                'table' => 'tx_chcforum_thread',
                                                'id_field' => 'uid',
                                                'alias_field' => 'thread_subject',
                                                'addWhereClause' => ' AND NOT deleted',
                                                'useUniqueCache' => 1,
                                                'useUniqueCache_conf' => array(
                                                        'strtolower' => 1,
                                                        'spaceCharacter' => '-',
                                                ),
                        ),
                ),
                array(
                        'GETvar' => 'post_uid',
                        'lookUpTable' => array(
                                                'table' => 'tx_chcforum_post',
                                                'id_field' => 'uid',
                                                'alias_field' => 'post_subject',
                                                'addWhereClause' => ' AND NOT deleted',
                                                'useUniqueCache' => 1,
                                                'useUniqueCache_conf' => array(
                                                'strtolower' => 1,
                                                'spaceCharacter' => '-',
                        ),
                ),
            ),
        ),
         'cal_group' => array(
              array(
                  'GETvar' => 'tx_calendar_pi1[targetgroup]',
                  'lookUpTable' => array(
                      'table' => 'tx_calendar_targetgroup',
                      'id_field' => 'uid',
                      'alias_field' => 'title',
                      'addWhereClause' => ' AND NOT deleted',
                      'useUniqueCache' => 1,
                      'useUniqueCache_conf' => array(
                          'strtolower' => 1,
                          'spaceCharacter' => '-',
                      ),
                  ),
              ),
          ),
          'cal_category' => array(
              array(
                  'GETvar' => 'tx_calendar_pi1[category]',
                  'lookUpTable' => array(
                      'table' => 'tx_calendar_cat',
                      'id_field' => 'uid',
                      'alias_field' => 'title',
                      'addWhereClause' => ' AND NOT deleted',
                      'useUniqueCache' => 1,
                      'useUniqueCache_conf' => array(
                          'strtolower' => 1,
                          'spaceCharacter' => '-',
                      ),
                  ),
              ),
          ),

            'not_cached' => array(
                'type' => 'single',
                'keyValues' => array(
                'no_cache' => 1,
            ),           
        ),
    ),
    ),
    'fileName' => array (
        'index' => array(
            'index.xml' => array(
                'keyValues' => array (
                    'type' => 100,
                )
            ),
            'print.html' => array(                        
                'keyValues' => array(
                    'type' => 98,
                )
            ),
                'defaultToHTMLsuffixOnPrev' => 0,
      ),
    ),
);



$TYPO3_CONF_VARS['EXT']['extList'] = 'tsconfig_help,context_help,extra_page_cm_options,impexp,sys_note,tstemplate,tstemplate_ceditor,tstemplate_info,tstemplate_objbrowser,tstemplate_analyzer,func_wizards,wizard_crpages,wizard_sortpages,lowlevel,install,belog,beuser,aboutmodules,setup,taskcenter,info_pagetsconfig,viewpage,rtehtmlarea,css_styled_content';

$typo_db_extTableDef_script = 'extTables.php';

## INSTALL SCRIPT EDIT POINT TOKEN - all lines after this points may be changed by the install script!

$TYPO3_CONF_VARS['EXT']['extConf']['partner'] = 'a:1:{s:13:"noTabDividers";s:1:"0";}';    //  Modified or inserted by TYPO3 Extension Manager.
// Updated by TYPO3 Extension Manager:39:04
// Updated by TYPO3 Install Tool:57:50
$TYPO3_CONF_VARS['EXT']['extConf']['news_lngselect'] = 'a:2:{s:11:"defaultFlag";s:14:"United Kingdom";s:10:"oneDefault";s:1:"1";}';       // Modified or inserted by TYPO3 Extension Manager.
$TYPO3_CONF_VARS['EXT']['extConf']['p2_realurl'] = 'a:2:{s:13:"language_uids";s:3:"all";s:20:"default_language_uid";s:1:"1";}';    //  Modified or inserted by TYPO3 Extension Manager.
$TYPO3_CONF_VARS['EXT']['extConf']['js_select'] = 'a:1:{s:5:"JSDIR";s:16:"fileadmin/abc/j/";}';    //  Modified or inserted by TYPO3 Extension Manager.
$TYPO3_CONF_VARS['EXT']['extConf']['css_select'] = 'a:2:{s:6:"CSSDIR";s:16:"fileadmin/abc/c/";s:6:"CSSEXT";s:3:"css";}';    //  Modified or inserted by TYPO3 Extension Manager.
......... PLEASE CHECK THE COMPLETE FILE!!!
?>

          

            4. Moving from RealURL with separate RealURL config file

==============================================

1. If you used a separate RealURL config file (i.e. realurl_config.php), delete it. 
2. Delete the include at localconf.php too.
3. Delete the following RealURL tables from your database using PHPMyAdmin
   (if you know how to do it, otherwise leave it alone)

1. tx_realurl_chashcache
2. tx_realurl_errorlog
3. tx_realurl_pathcache
4. tx_realurl_redirects
5. tx_realurl_uniqalias
6. tx_realurl_urldecodecache
7. tx_realurl_urlencodecache

         

>>> if you are finished check once again and then continue with Step 8

Step 8 - CoolUriConf.xml Check

1. Copy the CoolUriConf.xml_default to the typo3conf directory

using SSH from typo3conf directory
cp ext/cooluri/cooluri/CoolUriConf.xml_default CoolUriConf.xml

using ftp or cpanel etc.
go to typo3conf/ext/cooluri/cooluri/ folder
mark CoolUriConf.xml_default
Copy this file to typo3conf
Rename this file to CoolUriConf.xml

2. Edit the CoolUriConf.xml file according to your needs.

The default is:

<?xml version="1.0" encoding="utf-8"?>
<cooluri>
  <cooluris>1</cooluris>
 
  <cache>
    <usecache>1</usecache>
    <params2cool>
      <checkforchangeevery>1</checkforchangeevery>
    </params2cool>
    <cool2params>
      <translateifnotfound>0</translateifnotfound>
      <oldlinksvalidfor>365</oldlinksvalidfor>
    </cool2params>
    <cacheparams>0</cacheparams>
   
    <pagenotfound>
      <status>HTTP/1.0 404 Not Found</status>
      <behavior type="message"><![CDATA[ <h1>Page not found!</h1> ]]></behavior>
    </pagenotfound>
  </cache>

  <pagepath>
    <title>alias,subtitle,title</title>
    <saveto>id</saveto>
    <default>0</default>   
    <userfunc>tx_cooluri->getPageTitle</userfunc>
  </pagepath>
 
  <uriparts>
    <part>
      <parameter>tx_ttnews[tt_news]</parameter>
      <lookindb>
        <to>SELECT title FROM tt_news WHERE uid=$1</to>
        <translatetoif>
          <match>^[0-9]+$</match>
        </translatetoif>
        <urlize>1</urlize>
      </lookindb>
    </part>
    <part>
      <parameter>tx_eeblog[showUid]</parameter>
      <lookindb>
        <to>SELECT subject FROM tx_eeblog_maintable WHERE uid=$1</to>
        <translatetoif>
          <match>^[0-9]+$</match>
        </translatetoif>
        <urlize>1</urlize>
      </lookindb>
    </part>
  </uriparts>
   
  <predefinedparts>
    <part>
      <parameter>tx_ttnews[backPid]</parameter>
    </part>
    <part>
      <parameter>cHash</parameter>
    </part>
    <part>
      <parameter>tx_eeblog[pointer]</parameter>
    </part>
    <part>
      <parameter>tx_eeblog[backPID]</parameter>
    </part>
    <part>
      <parameter>no_cache</parameter>
    </part>
  </predefinedparts>
 
  <valuemaps>
    <valuemap>
      <parameter>L</parameter>
      <value key="">0</value>
      <value key="en">1</value>
    </valuemap>
  </valuemaps>
 
  <paramorder>
    <param>L</param>
  </paramorder>
 
</cooluri>

To modify and add the settings according to your needs, edit the CoolUriConf.xml

(TIP: Do it in a Second Step after you have finished this Tutorial - Try first the default settings)

>>> Have a look to our xml-examples at the End

>>> if everything is OK then continue with Step 9

Step 9 - Create new URLs with CoolUri-Manager

1. Open the Backend of TYPO3
2. Go to Tools
3. Click on CoolUri - the CoolUri Manager will open
4. Press Delete/Update All

5. Click on DELETE EVERYTHING AND START AGAIN
6. Clear your TYPO3 Caches
7. Clear the Browser Cache
8. Call your domain(s) and check

>>> if everything is OK then continue with Step 10

Step 10 - Check your Site(s)

1. Try to click on the Menus and check their links

FURTHER STEPS - Managing the URLs

All URLs are stored like shown on the picture below

Domain@url                                                                                           Parameters Created                               Options

1. Clicking on the stick will open the Edit Page of the specific URL
   
   (Screenshot goes here)
   
   
2. Clicking on the green arrows will delete and renew the specific URL
   
   
3. Clicking on the dustbin will delete the URL. A new one will be created when the page is called again.
   
   
   
   >>> Other Tips and Tricks using CoolUri
   
   
   
   >>> Check out the XML-Examples

Tips and Tricks with CoolUri

Changing from RealUrl oder StaticUrl to CoolUri.

If you want to preserve your old links you should save your values externally, so they can be copied back into cooluri:

CoolUri is storing Values like this

>>> Check out the XML-Examples

Moving from RealUrl to CoolUri

Follow Step 1 - 10
Additionally you need to do a special check of your former RealUrl Configuration - VERY IMPORTANT!
Check your localconf.php
Check your separate RealUrl Config file
    (if you had your RealUrl Configuration in such a file or one of the followin extensions installed
    i.e.

• if you used cbstarter Extension - you need to delete the file and the include in localconf.php
• if you are using abcstarter the RealUrl file is only active if people are using PHP4. No further settings are needed here.
  CoolUri is default in abcstarter

>>> Check out the XML-Examples

Moving from Simulate Static to CoolUri

>>> Check out the XML-Examples

XML-EXAMPLES

 

HOW TO - Create the Settings

Languages XML
ab_downloads
ab_linklist
advCalendar
bahag_fotogallery

cal

 

 

Creating the Settings is easy:

parameter => URL
-----------------------
somevariable=X => X

uriparts:
<part>
    <parameter>somevariable</parameter>
</part>


somevariable=X => X is UID in DB table => get value

uriparts:
<part>
    <parameter>somevariable</parameter>
    <lookindb>
        <to>SELECT title FROM table WHERE uid=$1</to>
        <t3conv>1</t3conv>
     </lookindb>
</part>


somevariable=X => sometextX

predefinedparts:
<part key="sometext([0-9]+)" regexp="1">
     <parameter>somevariable</parameter>
</part>


somevariable=X => X'
somevariable=Y => Y'
somevariable=Z => Z'

valuemaps:
<valuemap>
     <parameter>somevariable</parameter>
     <value key="">0</value>
     <value key="X'">X</value>
     <value key="Y'">Y</value>
     <value key="Z'">Z</value>
</valuemap>


somevariable=X => remove from URL

predefinedparts:
<part>
     <parameter>somevariable</parameter>
</part>


somevariable=X => (value from DB)-X

uriparts:
<part>
     <parameter>somevariable</parameter>
     <lookindb>
          <to>SELECT CONCAT(title,'-',uid) FROM table WHERE uid=$1</to>
          <t3conv>1</t3conv>
     </lookindb>
</part>

CoolUri XML Settings --- in comparison to --- RealURL Settings in localconf.php
A - Z

Languages XML

ab_downloads (Modern Downloads)

ab_linklist

advCalendar

bahag_fotogallery

'cal'=> array(
	array(
'GETvar' => 'tx_cal_controller[view]'
	),
	array(
'GETvar' => 'tx_cal_controller[getdate]'
	),
	array(
'GETvar' => 'tx_cal_controller[gettime]'
	),
	array(
'GETvar' => 'tx_cal_controller[lastview]'
	),
	array(
'GETvar' => 'tx_cal_controller[type]'
	),
	
	array(
'GETvar' => 'tx_cal_controller[category]',
'lookUpTable' => array(
'table' => 'tx_cal_category',
'id_field' => 'uid',
'alias_field' => 'title',
'addWhereClause'  => ' AND NOT deleted',
'useUniqueCache' => 1,
'useUniqueCache_conf' => array(
'strtolower' => 1,
'spaceCharacter' => '_',
			 ),
		 
),
	),
	array(
'GETvar' => 'tx_cal_controller[uid]',
'lookUpTable' => array(
'table' => 'tx_cal_event',
'id_field' => 'uid',
'alias_field' => 'title',
'addWhereClause'  => ' AND NOT deleted',
'useUniqueCache' => 1,
'useUniqueCache_conf' => array(
'strtolower' => 1,
'spaceCharacter' => '_',
),
),
	),
	array(
'GETvar' => 'tx_cal_controller[gettime]'
	),
	array(
'GETvar' => 'tx_cal_controller[preview]'
	),
	
),

// . . . using just products (without articles). cHash and BasketHash remain as ordinary GETVars.

// product categories
'cat' => array(
	array(
		'GETvar' => 'tx_commerce_pi1[catUid]',
		'lookUpTable' => array(
			'table' => 'tx_commerce_categories',
			'id_field' => 'uid',
			'alias_field' => 'title',
			'addWhereClause' => ' AND NOT deleted',
			'useUniqueCache' => 1,
			'useUniqueCache_conf' => array(
				'strtolower' => 1,
				'spaceCharacter' => '-',
			),
		),
	),
),
// product
'pr' => array(
	array(
		'GETvar' => 'tx_commerce_pi1[showUid]',
		'lookUpTable' => array(
			'table' => 'tx_commerce_products',
			'id_field' => 'uid',
			'alias_field' => 'title',
			'addWhereClause' => ' AND NOT deleted',
			'useUniqueCache' => 1,
			'useUniqueCache_conf' => array(
				'strtolower' => 1,
				'spaceCharacter' => '-',
			),
		),
	),
),

'fileName' => array(
            'defaultToHTMLsuffixOnPrev'=>1,
            'index' => array(
                'rss.xml' => array(
                    'keyValues' => array(
                        'type' => 100,
                    ),
                ),
                'rss091.xml' => array(
                    'keyValues' => array(
                        'type' => 104,
                    ),
                ),
                'rdf.xml' => array(
                    'keyValues' => array(
                        'type' => 101,
                    ),
                ),
                'atom.xml' => array(
                    'keyValues' => array(
                        'type' => 103,
                    ),
                ),
                'atom03.xml' => array(
                    'keyValues' => array(
                        'type' => 102,
                    ),
                ),
                'robots.txt' => array(
                    'keyValues' => array(
                        'type' => 201,
                    ),
                ),
            ),
      ),
)

<urlsuffix>.html</urlsuffix>
<removetrailingslash>1</removetrailingslash>

no trailing slash

If you want endings without a trailing slash

myurl/page/subpage instead of myurl/page/subpage/

enter the following line in your CoolUriConf.xml file, right behind <cooluri>:

<removetrailingslash>1</removetrailingslash>

RSS Feed URL
You can modify what's 
after a URL part with "after" attribute. Default is of course slash. So 
you could try this:

    <valuemap after="l">
       <parameter>type</parameter>
       <value key="rss.xm">100</value>
    </valuemap>

so, l will be appended to rss.xm, creating rss.xml. Funny :). It may work.

This Tutorial was written by
Andreas Becker - ABC-TYPO3 - LisAndi Co.Ltd. (Phuket/Thailand) and Kultur und Familienwerkstatt (Stuttgart/Germany)

http://www.abc-typo3.com

Jan Bednarik

http://www.bednarik.org

(c) 2007-2008 Andreas Becker, Jan Bednarik