---
title: "TYPO3-HowTo: Domain-basierte Sprachumschaltung mit RealURL"
url: "https://www.typo3.net/d/900011-typo3-howto-domain-basierte-sprachumschaltung-mit-realurl"
source: "typo3.net"
tags: ["News"]
created: "2013-06-24"
last_reply: "2013-06-24"
replies: 0
solved: false
page: 1
pages: 1
lang: "de"
---

# TYPO3-HowTo: Domain-basierte Sprachumschaltung mit RealURL

News · 0 Antworten · gestartet 2013-06-24

## Eröffnungsbeitrag

**Forumsbote** · 2013-06-24 · [Beitrag #1](https://www.typo3.net/d/900011-typo3-howto-domain-basierte-sprachumschaltung-mit-realurl/1)

**Für eine Suchmaschinen-optimierte Ausgabe der von TYPO3 erzeugten Pfade ist es sinnvoll, die Erweiterung RealURL zu verwenden. Was nicht jedem bekannt sein dürfte, ist die Möglichkeit, mit der Top-Level-Domain (TLD) die Sprache umzuschalten. Wie das funktioniert, erfahrt Ihr in diesem HowTo.**

[Bild](https://www.typo3.net/fileadmin/_migrated/news_uploads/img_newsartikel_sprachumstellung.png)

Hier findet Ihr übrigens [**das komplette TypoScript**](https://blog.mittwald.de/wp-content/uploads/2013/05/TypoScript.zip), das ich selber zum Testen verwendet habe.

**Sprachumschaltung**

In älteren RealURL-Versionen musste man noch manuell in der ***realurl_conf.php*** eine Abfrage der TLD machen und dann $_GET['L'] auf den passenden Wert einstellen. Dies geht heute aber bedeutend einfacher, da RealURL selbst auf die Domains reagieren kann. In diesem Beispiel habe ich drei Sprachen mit den drei Domains example.com, example.de und example.cn verwendet. Zunächst muss im Verzeichnis ***typo3conf*** die Datei ***realurl_conf.php*** angelegt werden. Hier findet Ihr [**die vollständige Datei**](https://blog.mittwald.de/wp-content/uploads/2013/05/realurl_conf.zip).

```php
<?php
$TYPO3_CONF_VARS['EXTCONF']['realurl'] = array (
    '_DEFAULT' => array(
        'init' => array(…),
        'redirects_regex' => array (),
        'preVars' => array(
            array(
                'GETvar' => 'no_cache',
                'valueMap' => array(
                    'no_cache' => 1,
                ),
                'noMatch' => 'bypass',
            ),
            array(
                'GETvar' => 'L',
                'valueMap' => array(
                    'en' => '0',
                    'de' => '1',
                    'cn' => '2',
                ),
                'noMatch' => 'bypass',
                'valueDefault' => 'en',
            ),
        ),
        'pagePath' => array(…),
        'fixedPostVars' => array(…),
        'postVarSets' => array(…),
        'fileName' => array(…),
    ),
    '_DOMAINS' => array(
        'encode' => array(
            array(
                'GETvar' => 'L',
                'value' => '',
                'ifDifferentToCurrent' => TRUE,
                'useConfiguration' => '_DEFAULT',
                'urlPrepend' => 'http://example.com',
            ),
            array(
                'GETvar' => 'L',
                'value' => '0',
                'ifDifferentToCurrent' => TRUE,
                'useConfiguration' => '_DEFAULT',
                'urlPrepend' => 'http://example.com',
            ),
            array(
                'GETvar' => 'L',
                'value' => '1',
                'ifDifferentToCurrent' => TRUE,
                'useConfiguration' => '_DEFAULT',
                'urlPrepend' => 'http://example.de',
            ),
            array(
                'GETvar' => 'L',
                'value' => '2',
                'ifDifferentToCurrent' => TRUE,
                'useConfiguration' => '_DEFAULT',
                'urlPrepend' => 'http://example.cn',
            ),
        ),
        'decode' => array(
            'example.com' => array(
                'GETvars' => array(
                    'L' => '',
                ),
                'useConfiguration' => '_DEFAULT',
            ),
            'example.de' => array(
                    'GETvars' => array(
                    'L' => '1',
                ),
                'useConfiguration' => '_DEFAULT',
            ),
            'example.cn' => array(
                    'GETvars' => array(
                    'L' => '2',
                ),
                'useConfiguration' => '_DEFAULT',
            ),
        ),
    ),
);
```

Wichtig für die Sprachumschaltung ist der Abschnitt **_DOMAINS** mit den untergeordneten Arrays ***encode*** und ***decode***. Unter ***encode*** wird definiert, dass RealURL bei L=0 „<http://example.com>“ voranstellen soll. Bei L=1 wird „<http://example.de>“ und bei L=3 „<http://example.cn>“ vor die URL (ohne Slash am Ende) gestellt. Beim ***decode*** muss je nach Domain der passende GET-Parameter L wieder gesetzt werden. Zusätzlich müssen noch die Sprachen bei den preVars eingesetzt werden und im TYPO3-Backend in der Listenansicht die Domains eingetragen werden.

**Umleitung www.example.tld → example.tld**

Damit sowohl www.example.tld als auch example.tld funktionieren, sollte in der .htaccess-Datei im Wurzelverzeichnis noch die passende **permanente Weiterleitung** eingerichtet werden. Umleitungen sollten aus Performance-Gründen nicht in der realurl_conf.php eingetragen werden (Somit sollte die Zeile „'redirects_regex' => array (),“ besser nicht benutzt werden.) Wenn auf das www verzichtet werden soll, könnte die Umleitung so gemacht werden:

```apacheconf
<IfModule mod_rewrite.c>
    RewriteCond %{HTTPS} !=on
    RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
    RewriteRule ^ http://%1%{REQUEST_URI} [R=301,L]
</IfModule>
```

Soll immer das www vorangestellt werden, wäre diese Alternative zu verwenden:

```apacheconf
<IfModule mod_rewrite.c>
   RewriteCond %{HTTPS} !=on
   RewriteCond %{HTTP_HOST} !^www\..+$ [NC]
   RewriteRule ^ http://www.%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</IfModule>
```

In diesem Fall müssten natürlich auch die Domains im TYPO3-Backend und die Angaben in der realurl_conf.php angepasst werden.

**Aktivierung von RealURL im TypoScript-Setup**

Nachdem die Konfigurationsdatei für RealURL erstellt ist, muss die Extension aus dem TER installiert werden. Mit den folgenden Zeilen im TypoScript Setup wird RealURL aktiviert:

```typoscript
config {
    tx_realurl_enable = 1
    prefixLocalAnchors = 1
    absRefPrefix = /
}
```

Auf das Deaktivieren der Extension „Simulate Static URLs“ über TypoScript habe ich verzichtet, da diese sich mit RealURL so beißt, dass TYPO3 keine Links mehr richtig auswertet. Ich habe auch nicht das den meisten vertraute "config.baseURL = <http://example.de/>" verwendet, sondern ***absRefPrefix*** benutzt. Wegen Problemen mit XHTML und dem Internet Explorer sowie einigen Crawlern, die dieses Tag nicht richtig interpretieren, wird vor der **Verwendung von baseURL abgeraten**. Es sollte immer config.absRefPrefix benutzt werden. Sollten Extensions Links in der Form <http://example.com/http://example.com/my/page> erzeugen, haben die Extensionentwickler Fehler in ihren Scripten gemacht. In der [**RealURL-Dokumentation**](http://docs.typo3.org/typo3cms/extensions/realurl/1.12.4/#config-absrefprefix) steht beschrieben, wie die Verlinkungen richtig gemacht werden können.

**Sprachmenü mit dem cObject HMENU**

Für eine einfache Sprachumschaltung kann auch das ***cObject HMENU*** verwendet werden. Ich bevorzuge Texte, da bei Flaggen immer die Frage ist, ob man beispielsweise die englische oder amerikanische Flagge zeigt. Das hier gezeigte ***lib.langmenu*** könnt Ihr direkt auf einen Marker/Subpart bzw. in einem Fluidtemplate auf eine Variable kopieren.

```typoscript
lib {
    langmenu = HMENU
    langmenu {
        special = language
        special.value = 0,1,2

        1 = TMENU
        1 {
            wrap = <ul>|</ul>
            NO = 1
            NO {
                stdWrap.cObject = TEXT
                stdWrap.cObject.value = English || Deutsch || 中国的
                wrapItemAndSub  = <li>|</li>
            }
            USERDEF1 < .NO
            USERDEF1 {
                doNotShowLink = 1
                wrapItemAndSub >
            }
        }
    }
}
```

**Canonical-Link**

Damit die Suchmaschinen nicht **doppelten Content** auf Eurer Seite finden, macht es Sinn, eine ***Canonical-URL*** im Bereich der Webseite auszugeben. Eine kanonische Seite ist die bevorzugte Seite, die eine Suchmaschine anzeigen soll. Ich möchte hier erreichen, dass TYPO3 nicht mit URLs wie <http://example.com/index.php?id=2>, sondern immer mit den RealURL-Pfaden in der Suchmaschine erscheint. Mit dem {getIndpEnv: TYPO3_REQUEST_HOST} sorge ich dafür, dass automatisch die richtige Domain mit dem passenden Protokoll (http:// bzw. https://) eingetragen wird.

```typoscript
page {
    headerData {
        10 = TEXT
        10 {
            typolink {
                parameter.data = TSFE:id
                addQueryString = 1
                addQueryString {
                    method = GET
                    exclude = id
                }
                returnLast = url
            }
            dataWrap = <link rel="canonical" href="{getIndpEnv: TYPO3_REQUEST_HOST}|" />
        }
    }
}
```

---

Quelle: „TYPO3-HowTo: Domain-basierte Sprachumschaltung mit RealURL“, typo3.net, https://www.typo3.net/d/900011-typo3-howto-domain-basierte-sprachumschaltung-mit-realurl
Beiträge von Mitgliedern des Forums. Bitte mit Link auf die Diskussion zitieren.
