Bearbeiten von „Cooluri“

===== Suchmaschinenfreundliche URLs mit coolURI=====

wesentlich einfacher und schneller zum einbauen als relaurl  .

http://docs.google.com/View?docid=dd33gg45_3f8j96p



(http://www.t3net.de/dokumentation/yaml-fuer-templavoila/cooluri.html) 14.04.2011

Die TYPO3 Erweiterung coolURI ist eine gute Alternative zu realURL, die aber bedeutend einfacher zu konfigurieren ist und, um mit den Worten des Autors Jan Bednarik zu sprechen, "den Vodoo-Zauber der realURL-Konfiguration beseitigt". Die Unterstützung von coolURI ist seit der Version 2.0.10 dieses Templates bereits eingebaut und mit dem Constant Editor konfigurierbar.


Wer es nicht weiß: coolURI macht aus URLs wie z.B. www.mydomain.com/index.php?&id=10 wesentlich besser lesbare (und suchmaschinenfreundlichere) in der Form  www.mydomain.com/beispiele/vorlagendesigns/ - und das bereits mit der Standard-Konfiguration, die diesem Template im Verzeichnis fileadmin/cooluri/ unter dem Namen CoolURIConf.xml beiliegt.
Voraussetzungen für den Einsatz von coolURI

    * Sie müssen TYPO3 mit dem Constant Editor für den Betrieb von coolURI einrichten. Das wird weiter unten erklärt.
    * Auf Ihrem Webserver muss mindestens PHP 5.x.x mit eingeschaltetem SimpleXML installiert sein.
    * Sie benötigen einen MySQL-Server mit mindestens der Version 4.1
    * Im Wurzelverzeichnis des Webservers muss sich eine .htaccess Datei befinden, die mindestens folgenden Inhalt hat:

   1.
      RewriteEngine On
   2.
      RewriteRule ^/(typo3|typo3temp|typo3conf|t3lib|tslib|fileadmin|uploads|showpic\.php)$ - [L]
   3.
      RewriteRule ^/(typo3|typo3temp|typo3conf|t3lib|tslib|fileadmin|uploads|showpic\.php)/.*$ - [L]
   4.
      RewriteCond %{REQUEST_FILENAME} !-f
   5.
      RewriteCond %{REQUEST_FILENAME} !-d
   6.
      RewriteCond %{REQUEST_FILENAME} !-l
   7.
      RewriteRule .* index.php 

Wichtig für Windows-Benutzer: Der Windows-Explorer lässt es nicht zu, eine Datei .htaccess direkt zu erstellen und quittiert einen solchen Versuch mit der Fehlermeldung "Geben Sie einen Dateinamen ein.". Erzeugen Sie deshalb zunächst eine Datei htaccess.txt, fügen Sie obigen Inhalt ein, starten Sie die Eingabeaufforderung, wechseln Sie in das richtige Verzeichnis und geben Sie den Befehl rename htaccess.txt .htaccess ein, gefolgt von ENTER.
TYPO3 auf den Einsatz von coolURI vorbereiten
coolURI mit dem Constant Editor vorbereiten.

Öffnen Sie den Constant Editor und dort den Bereich YAML-URLS. Hier schalten Sie die Option Use cooluri? ein. Setzen Sie hierzu in die linken Checkboxen zwei Häkchen, klicken Sie auf Update, stellen Sie die Optionen ein und klicken Sie bitte nochmals auf Update. Nur so werden die Werte auch übernommen. Das gilt grundsätzlich bei der Arbeit mit dem Constant Editor.

In dem Feld Base URL tragen Sie die Domain ein, unter der das Web momentan läuft und zwar in der angegebenen Form, mit abschließendem Schrägstrich. Wenn Sie Ihr Web lokal entwickeln und anschließend auf einen Server im Internet transferieren, müssen Sie diesen Wert wieder ändern.

Die Option Prefix local anchors müssen Sie nicht ändern, sie ist bereits voreingestellt und richtig konfiguriert.

Damit ist die Konfiguration mit dem Constant Editor abgeschlossen und Sie können die Extension coolURI installieren.
coolURI installieren und konfigurieren

Verwenden Sie den TYPO3 Extension Manager um coolURI aus dem TER herunterzuladen und auf Ihrem Server zu installieren.

coolURI muss zwei Datenbank-Felder ändern und statische Daten importieren. Lassen Sie alle Optionen in der Standard-Einstellung mit Ausnahme des Pfades zur Konfigurationsdatei (XML Path). Diesen ändern Sie bitte auf fileadmin/cooluri/ weil dort die diesem Template beiliegende Standard-Konfiguration gespeichert ist.

Löschen Sie den TYPO3 Cache und rufen Sie das Frontend auf. Jeder Link sollte nun eine lesbare und suchmaschinenfreundliche URL aufweisen.
XML-Konfiguration von coolURI anpassen

Möglicherweise sind Sie mit den URLs, welche die Standard-Konfiguration erzeugt, nicht zufrieden oder Sie müssen weitere Optionen hinzufügen, weil Sie Extensions installiert haben, die zusätzliche GET-Parameter an die URL anhängen, die Sie ebenfalls suchmaschinenfreundlicher gestalten möchten.

In diesem Fall müssen Sie die Datei fileadmin/cooluri/CoolUriConf.xml mit einem Texteditor bearbeiten und anpassen. Dazu müssen Sie die Dokumentation auf der Website des Autors lesen und verstehen.

Andreas Becker hat eine hervorragende Anleitung mit vielen sofort anwendbaren Beispielen geschrieben, die Sie unbedingt anschauen sollten, wenn Sie an der Konfiguration Änderungen durchführen müssen. (link siehe oben)

====.html====
If you .html file extensions to simulate real .html files instead of directories 
myurl/page/subpage.html instead of myurl/page/subpage/
enter the following two lines in your CoolUriConf.xml file, right behind <cooluri>:
<urlsuffix>.html</urlsuffix>
<removetrailingslash>1</removetrailingslash>