RealUrl Tutorial

Einträge in dem TypoScript-Setup

Sourcecode für Text-Editor optimiert zeigen.

config {
prefixLocalAnchors = all
simulateStaticDocuments = 0

baseURL = http://www.domain.tld/

tx_realurl_enable = 1
}

In TypoScript wird mit diesen Zeilen RealUrl aktiviert und gegebenenfalls SimulateStaticDocuments deaktiviert. Anzupassen wäre die baseURL mit der richtigen Domain. prefixLocalAnchors sorgt dafür, dass Ankerpunkte auch bei Verwendung von RealURL auf einer Seite richtig angesprungen werden können.

Sourcecode für Text-Editor optimiert zeigen.

$TYPO3_CONF_VARS['FE']['addRootLineFields'].= ',tx_realurl_pathsegment';
$TYPO3_CONF_VARS['EXTCONF']['realurl'] = array(
'_DEFAULT' => array(
'init' => array(
'enableCHashCache' => 1,
'appendMissingSlash' => 'ifNotFile',
'enableUrlDecodeCache' => 1,
'enableUrlEncodeCache' => 1,
'postVarSet_failureMode' => '',
),
'redirects' => array(),
'preVars' => array(
array(
'GETvar' => 'no_cache',
'valueMap' => array(
'nc' => 1,
),
'noMatch' => 'bypass',
),
array(
'GETvar' => 'L',
'valueMap' => array(
# 'de' => '0',
'en' => '1',
),
'valueDefault' => 'de',
'noMatch' => 'bypass',
),
),
'pagePath' => array(
'type' => 'user',
'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => 7,
'rootpage_id' => 1,
'firstHitPathCache' => 1,
),
'fixedPostVars' => array(),
'postVarSets' => array(
'_DEFAULT' => array(
// news archive parameters
'archive' => array(
array(
'GETvar' => 'tx_ttnews[year]' ,
),
array(
'GETvar' => 'tx_ttnews[month]' ,
'valueMap' => array(
'january' => '01',
'february' => '02',
'march' => '03',
'april' => '04',
'may' => '05',
'june' => '06',
'july' => '07',
'august' => '08',
'september' => '09',
'october' => '10',
'november' => '11',
'december' => '12',
)
),
),
// news pagebrowser
'browse' => array(
array(
'GETvar' => 'tx_ttnews[pointer]',
),
),
// news categories
'select_category' => array (
array(
'GETvar' => 'tx_ttnews[cat]',
),
),
// news articles anMd searchwords
'article' => 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' => '-',
),
),
),
array(
'GETvar' => 'tx_ttnews[backPid]',
),
array(
'GETvar' => 'tx_ttnews[swords]',
),
),
),
),
// configure filenames for different pagetypes
'fileName' => array(
'defaultToHTMLsuffixOnPrev' => 1,
'index' => array(
'print.html' => array(
'keyValues' => array(
'type' => 98,
),
),
'rss.xml' => array(
'keyValues' => array(
'type' => 100,
),
),
'rss091.xml' => array(
'keyValues' => array(
'type' => 101,
),
),
'rdf.xml' => array(
'keyValues' => array(
'type' => 102,
),
),
'atom.xml' => array(
'keyValues' => array(
'type' => 103,
),
),
),
),
),
);

Einträge in die .htaccess-Datei

Sourcecode für Text-Editor optimiert zeigen.

RewriteEngine On

RewriteBase /

RewriteRule ^(typo3|typo3temp|typo3conf|t3lib|tslib|fileadmin|uploads|showpic\.php)/ - [L]
RewriteRule ^typo3$ typo3/index_re.php [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l

RewriteRule .* /index.php [L]

In der .htaccess-Datei müssen die Zeilen 2 und 8 gegenüber der Vorlage aus dem dummy-Paket modifiziert werden.

Einträge in typo3conf/localconf.php

In der Datei localconf.php im Verzeichniss typo3conf könnte z.B. der folgende Code stehen. Angepasst werden müsste vor allem die Zeile 36 mit der Seiten-ID Ihrer Rootseite.

Für die Standardsprache sollten Sie auf keinen Fall einen Wert definieren. Die Zeile 23 ist aus diesem Grund auch auskommentiert. Würde diese Zeile einkommentiert gäbe es "Duplicate Content", da dann der Inhalt unter dem Pfad www.domain.tld und www.domain.tld/de/ den gleichen Inhalt liefern würde.

Als Beispiel sind hier zwar am Ende einige TypeNum beschrieben, aber print.html sollte natürlich besser nicht verwendet werden. Besser für die Printansicht ist es, ein spezielles CSS für die Printausgabe zu definieren!

Das Beispiel für die localconf.php beinhaltet auch schon die Konfiguration für die Extension tt_news.

Zu Zeile 105:
Durch den Eintrag 'defaultToHTMLsuffixOnPrev' => 1, werden die Pfade so erzeugt, dass am Ende des Pfades kein Ordner, sondern eine statische HTML-Seite simuliert wird.

Wichtiger Hinweis!

Sollten Sie den "Pagepath" über den Web-Menüpunkt Info->Speaking Url Management ändern, kann es Ihnen passieren, dass die Pfade in Links und Menüs nicht aktualisiert werden.

Als Workaround hilft es, den Seitencache zu löschen und dann die Seiten mit einem anderen Browser zu öffnen, bei dem man nicht als BE-User eingeloggt ist.

Beispiel für eine RealURL Konfiguration

Dies ist nur ein Beispiel für eine funktionierende RealURL-Konfiguration. Weiteres kann man dann in der Dokumentation finden.

Hinweis zu den aktuellen RealURL-Versionen

Die aktuellen Versionen haben die Möglichkeit, zwischen einer automatischen Konfiguration und einer manuellen Konfiguration zu wechseln. Falls Sie die manuelle Konfiguration benutzen, dann wird der Teil, der vorher in der localconf.php eingetragen wurde, in der Datei realurl_conf.php eingetragen! Hier muss der beschriebene PHP-Code noch mit "<?php" und "?>" umschlossen werden!