Awesome URL

Features

• Compatible with Typo3 6.2 and 7.6
• Easy configuration via backend
• Speaking URLs
• Page language by domain name or path prefix
• Old links to pages will still work if title or alias changed
• Dataset and cHash support
• 404 Handling
• Easy migration from simulatestatic possible

Usage

Awesome URL extends the domain settings of Typo3 with mapping information. Only pages with a domain and mapping information will get speaking urls.

Go to "List"-view and open a domain dataset. There you have to add at least one mapping. A mapping for a domain consists of language and prefix.

Example domain setups

Multiple languages, each language with its own domain

• domain 1
  • name: www.example.com
  • mapping:
    • language: Default (English), prefix: '' (empty)
• domain 2
  • name: www.example.de
  • mapping:
    • language: German, prefix: '' (empty)

Multiple languages, one domain

• domain 1
  • name: www.example.com
  • mapping:
    • language: Default (English), prefix: '' (empty)
    • language: German, prefix: 'de'
    • language: French, prefix: 'fr'

German and french URLs will be prefixed. For example http://www.example.com/de/foo/bar

One languages, one domain

• domain 1
  • name: www.example.com
  • mapping:
    • language: [All] / Default, prefix: '' (empty)

Page settings

Pages have two new settings: "URL alias" and "URL part in subpages".

If you do not like the URL derivated by the page title you can fill in the "URL alias". If you start the alias with a slash character (/) you override the whole path from the beginning.

If you check "hide URL part in subpages" the title or alias will not be part of subpage URLs.

Template Setup

Your template must set a base tag . Usually done with config.baseURL = / in typoscript.

URL rewriting

Do not forget to enable URL rewriting. See _.htaccess if you are using apache.

Dataset configuration

In your project extension ext_localconf.php add

if (class_exists('WV\AwesomeUrl\Service\UriRules')) {
    \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('WV\AwesomeUrl\Service\UriRules')
        ->addRule(array(
            'name' => 'news',
            'table' => 'tx_news_domain_model_news',
            'params' => array(
                'tx_news_pi1[news]' => array(
                    'type' => 'table',
                    'table' => 'tx_news_domain_model_news',
                    'uid' => 'uid',
                    'L' => 'sys_language_uid',
                    'Lall' => '-1',
                    'l10n_parent' => 'l10n_parent',
                    'tstamp' => 'tstamp',
                    'title' => array('path_segment', 'title')
                ),
                'tx_news_pi1[controller]' => 'News',
                'tx_news_pi1[action]' => 'detail'
            ),
            'cHash' => true
        ));
}

Additional RegEx groups for different languages

Chinese

basic.charsWhitelist: \p{Han} basic.charsWhitelistAlias: \u4E00-\u9FA5