Mink Machine

Speaking URLs with Typo3

Note: This content is obsolete, and kept for archive purpose only.

I’ve been using Typo3 for a while and since it’s a fairly advanced system with many pitfalls, I would like to share some of my experiences concerning speaking URLs to other Typo3 users. The configurations I describe are more like guidelines, not written stone tablets from deities with beard.

A non-technical review can be found in another article, Experiences of Typo3 – The good, the bad and the ugly.

Speaking URLs

The standard look of Typo3 URLs, as with most PHP solutions using a database, looks like this:


But it would be better with:


based on the actual page context. Apart from aesthetic reasons there are other good reasons, such as search engine optimization. This makeover is done by using the extension RealURL in combination with web server modifications.

Web server configuration

If you are using the Apache web server, modify .htaccess like this:

RewriteEngine On RewriteRule ^typo3$ – [L] RewriteRule ^typo3/.*$ – [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-l RewriteRule .* index.php IndexIgnore *

The file should be located in the root of yourTypo3 tree. In order to use the .htaccess file, you must modify http.conf like this:

AllowOverride All

Note to Windows users: As you may know, a file cannot be renamed into “.something” directly from the Windows Explorer. Instead you may rename it using the command prompt, or open the file in an application such as Notepad and save it with the correct name.

If you prefer the Microsoft IIS web server, something like this will work as well:

[ISAPI_Rewrite] RewriteRule /(.*)\.(.+)\.(.+)\.html /index.php\?id=$2&type=$3

You may also want to increase the PHP heap a bit to avoid fuzzy error messages. To do this, modify php.ini like this:

memory_limit = 32M

Typo3 configuration

Template configuration

Now you are almost up and running. Just enter these lines into your Typo3 template:

config.simulateStaticDocuments = 0 config.baseURL = 1 config.tx_realurl_enable = 1

The first line disables simulateStaticDocuments, since the two techniques are incompatible.

View a page to see the result. You may have to clear the cache.

News configuration

But the fun doesn’t stop there! If you want news management on the site, and you usually do, there are further modifications ahead. The extension called tt_news is very flexible and an ideal choice for most applications. However, the standard version is not capable of generating nice URLs with RealURL, so it has to be modified a bit.

Start with version 2.1.1 of tt_news. This version must be downloaded and installed separately (T3X_tt_news-2_1_1.t3x), since it is not available directly from the extension manager.

Enter the Typo3 backend and create a sysfolder called News (for the news categories), like this:

Typo3 sysfolder Typo3 sysfolder.

Go to the News page (not the sysfolder) and modify it’s template by adding the following to the Constants field:

plugin.tt_news { file.templateFile = media/scripts/news_template.tmpl PIDitemDisplay = news_display_pid }

where news_display_pid is the id of your News page and news_template.tmpl is the HTML template.

Good luck!


  • avatar
    17 Apr, 2009

    Since no rootpage-id is defined, this code will not work.
    Besides: There are several values set, which don’t exist.
    Better use the official manual or the homepage of the developer of the extension.

  • avatar
    22 Apr, 2009

    Thanks Joerg for your input. This post is over three years old, so I expect a lot of things have happened to the Typo3 distribution since then, making some of this content obsolete.
    I hope that most developers use the official material for reference instead of blog posts.

  • avatar
    14 Jan, 2012

    Reine, please put an “Obsolete. For reference only.” stamp or something on top of this article.

  • avatar
    14 Jan, 2012

    Luis, good point! Will fix that.

Post a comment

Your email address will not be published. Required fields are marked *

Featured stories

Memories of Skye

"The countryside is charming and some places even have coffee."

Visions of Singapore

"By extensive use of landfill with sand bought from Indonesia and Cambodia, the bay area has expanded greatly in the last few years and tall buildings pop up everywhere."

The lakes of Lombardy

"The town of Como, largest settlement around Lake Como, attracts a lot of people with big wallets. But I preferred to take the funicular up the mountain to the Brunate region, where you get a much better view of the lake."

Greetings from Moldova

"But Chisinau is an unexpected gem in the wilderness. Even though Moldova is one of the poorest countries in Europe, the capital has its fair share of impressive buildings and post-Soviet architecture."

Having champagne in Champagne

"We roamed the damp and chilly tunnels and stumbled upon a large barrel delivered by Napoleon himself."

Roaming in Valletta

"I passed the statue of Jean de Valette, the 49th Grand Master who laid the foundation stone to Valletta in 1566, to gaze at the golden interior of St. John’s Co-Cathedral, where he is buried in the crypt."