Das Mysterium RealUrl

Mit RealUrl können URLs mit GET Parametern (id=2&type=123) automatisch an Hand einer Konfiguration in sprechende URLs (/sitemap/pdf/) umgewandelt werden. Dazu muss das Apache Modul mod_rewrite verfügbar sein und in der .htaccess konfiguriert sein.

Installation

Installiert realurl mit Hilfe des Extensionmanagers

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

Typoscript

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

dsa

Automatische Konfiguration

RealUrl kann die aktuelle TYPO3 Konfiguration und evtl. vorhandene Domain Datensätze auslesen und daraufhin eine minimalistische RealUrl Konfiguration automatisch erstellen. Dafür muss über den Extensionmanager in der Konfiguration von realurl die Checkbox für die automatische Konfiguration aktiviert werden.

So schön wie der Automodus ist, ich empfehle Euch die automatisch angelegte Konfigurationsdatei typo3conf/realurl_autoconf.php nicht nachträglich zu bearbeitet. Es braucht nur jemand einen Domain Datensatz (sys_domain) anzulegen oder zu ändern und diese Datei wird komplett überschrieben und Eure Änderungen sind weg. Solltet ihr unbedingt Änderungen an dieser Datei durchführen wollen/müssen, dann kopiert die realurl_autoconf.php und gebt den neuen Dateinamen in der Extensionkonfiguration an. Dadurch gehen Euch natürlich die Vorteile des Automodus verloren.

Die automatische Konfiguration klappt nur dann, solange $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] nicht gesetzt ist. Das Blöde ist nur, dass andere Extensions wie EXT:restdoc diese Variable befüllen und somit den Automodus verhindern. Verwendet das Backendmodul "Konfiguration", um zu prüfen, ob diese Variable gefüllt ist.

Den Automodus erweitern

Als Extensionentwickler habt Ihr die Möglichkeit eigene realurl Konfigurationen in den Automodus zu integrieren. Nutzt dafür diesen Hook:

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/realurl/class.tx_realurl_autoconfgen.php']['extensionConfiguration']

Manuelle Konfiguration

bla