typolink ermöglicht die Generierung von internen und externen Links, auch von E-Mail-Adressen und Dateiverweisen.
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| parameter | string / stdWrap | Die wichtigste Eigenschaft von typolink. Hiermit wird das Ziel des Links definiert. Dabei kann es sich um eine Seiten-UID oder Seiten-Alias, eine Sprungmarke, eine externe URL, eine E-Mail-Adresse oder eine Datei auf dem Server handeln. Interne Seitenverweise werden geprüft; falls die angegebene Seite nicht existiert, wird auch kein Link generiert! Seiten-UID: 10.typolink.parameter = 3 # Ausgabe: <a href="index.php?id=3"> URL Alias: Wird in den Seiteneigenschaften eingetragen. 11.typolink.parameter = aliasname # Ausgabe: <a href="index.php?id=aliasname"> Sprungmarke: Kann ohne UID oder Alias verwendet werden, um auf der aktuellen Seite zu verlinken. 12.typolink.parameter = 3#absatz1 # Ausgabe: <a href="index.php?id=3#absatz1"> Externer Link: http:// wird automatisch hinzugefügt, kann aber auch selbst gesetzt werden. 13.typolink.parameter = www.example.org # Ausgabe: <a href="http://www.example.org" target="_top"> E-Mail-Adresse: 14.typolink.parameter = info@example.org # Ausgabe: <a href="mailto:info@example.org"> Datei auf dem Server: 15.typolink.parameter = fileadmin/images/gitarre.png # Ausgabe: <a href="fileadmin/images/gitarre.png"> Wenn nach UID oder Alias ein Komma und eine Integerzahl folgt, wird diese als typeNum gelesen: 20.typolink.parameter = 3,99 - - "Plaintext" # Ausgabe: <a href="index.php?id=3&type=99" title="Plaintext"> Nach dem Ziel können weitere Werte beschrieben werden: Target, Klasse und Titel (in dieser Reihenfolge). Wenn man nicht alle Werte definieren möchte, genügt ein Bindestrich als Platzhalter: 30.typolink.parameter = 3 _blank foo "Titel" # Ausgabe: <a href="index.php?id=3" title="Titel" target="_blank" class="foo"> 31.typolink.parameter = 3 - foo "Titel" # Ausgabe: <a href="index.php?id=3" title="Titel" class="foo" > 32.typolink.parameter = 3 - - "Titel" # Ausgabe: <a href="index.php?id=3" title="Titel"> Statt dem Target kann man als zweiten Wert eine Fenstergröße angeben. Dadurch wird mit JavaScript ein neues Fenster geöffnet, welches die angegebenen Maße besitzt. Weitere Parameter sind möglich: 40.typolink.parameter = 3 800x600 41.typolink.parameter = 3 800x600:resizable=0,location=1 |
| extTarget | target / stdWrap | Setzt das Target für externe Links. Ein ggf. unter parameter definiertes Target hat Vorrang. 10.typolink.parameter = www.example.org 10.typolink.extTarget = _blank |
| fileTarget | target / stdWrap | Setzt das Target für Dateilinks. Ein ggf. unter parameter definiertes Target hat Vorrang. 10.typolink.parameter = fileadmin/images/gitarre.png 10.typolink.fileTarget = _blank |
| target | target / stdWrap | Setzt das Target für interne Links. Ein ggf. unter parameter definiertes Target hat Vorrang. 10.typolink.parameter = 3 10.typolink.target = _blank |
| no_cache | boolean | Wenn aktiviert, wird der GET-Parameter &no_cache=1 an die URL angehangen. 10.typolink.parameter = 3 10.typolink.no_cache = 1 #Ausgabe: <a href="index.php?id=3&no_cache=1"> |
| additionalParams | string / stdWrap | Ermöglicht das Anhängen von GET-Parametern an die URL. Funktioniert nur bei internen Links. So können z.B. Suchbegriffe aus dem Register SWORD_PARAMS übermittelt werden. 10.typolink.additionalParams = &foo=bar 20.typolink.additionalParams.data = register:SWORD_PARAMS |
| addQueryString | boolean | Wenn aktiviert, wird der aktuelle Query-String dem Link hinzugefügt..method ermöglicht es, die Art der Übertragung (GET/POST) zu wählen.Mittels .exclude können Parameter ausgeschlossen werden. 10.typolink.addQueryString = 1 20.typolink.addQueryString.method = GET |
| jumpurl | boolean | Verwendet den jumpurl-Parameter für den Link. Hierbei werden alle Links über das index_ts.php-Skript weitergeleitet, welches alle Aufrufe in einer Statistik protokolliert (muss im Setup mit config.jumpurl_enable = 1 aktiviert werden). |
| wrap | wrap / stdWrap | Ermöglicht einen Wrap für den Link. 10 = TEXT 10 { value = Link typolink.parameter = 3 typolink.wrap = <p>|</p> } # Ausgabe: <p><a href="index.php?id=3" >Link</a></p> |
| ATagBeforeWrap | boolean | Wenn aktiviert, wird der unter .wrap angegebene Wrap innerhalb der <a>-Elemente angewendet. 10 = TEXT 10 { value = Link typolink.parameter = 3 typolink.wrap = <p>|</p> typolink.ATagBeforeWrap = 1 } # Ausgabe: <a href="index.php?id=3" ><p>Link</p></a> |
| ATagParams | <a>-params / stdWrap | Ermöglicht zusätzliche Attribute im <a>-Element, z.B. eine Klasse. Eine ggf. unter parameter definierte Klasse hat Vorrang. 10.typolink.ATagParams = accesskey="b" class="verweis" |
| forceAbsoluteUrl | boolean | Wenn aktiviert, wird die gesamte URL eingetragen. 10.typolink.parameter = 3 10.typolink.forceAbsoluteUrl = 1 # Ausgabe: <a href="http://www.example.org/index.php?id=3"> |
| title | string / stdWrap | Erstellt das title-Attribut des Ankers. Ein ggf. unter parameter definierter Titel hat Vorrang. |
| JSwindow_params | string | Wenn unter parameter eine Fenstergröße definiert wurde, können die Eigenschaften des Fensters direkt dahinter oder aber unter JSwindow_params aufgeführt werden.Mögliche Werte: status=1,menubar=1,scrollbars=1,resizable=1,location=1,directories=1,toolbar=1 10.typolink.parameter = 3 400x400 10.typolink.JSwindow_params = resizable=0,toolbar=1 |
| returnLast | string | Wird diese Eigenschaft angewendet, erfolgt die Ausgabe des Links nicht als kompletter Anker. Mögliche Werte: target → Gibt nur das Target aus. url → Gibt nur die URL aus. 10.typolink.parameter = 3 _blank 10.typolink.returnLast = target # Ausgabe: _blank 20.typolink.parameter = 3 _blank 20.typolink.returnLast = url # Ausgabe: index.php?id=3 30.typolink.parameter = 3 _blank 30.typolink.forceAbsoluteUrl = 1 30.typolink.returnLast = url # Ausgabe: http://www.example.org/index.php?id=3 |
| section | string / stdWrap | Hiermit kann eine Sprungmarke definiert werden. 10.typolink.parameter = 3 10.typolink.section = sprungmarke # Ausgabe: <a href="index.php?id=3#sprungmarke"> |
| linkAccessRestrictedPages | boolean | Wenn aktiviert, wird der Link zur Seite auch erstellt, wenn diese zugriffsgeschützt ist. Statt der zugriffsgeschützten Seite wird dann die nächste erreichbare Seite entlang der rootLine geladen. |
Der Link kann mit einem CASE-Objekt abhängig von der aktuellen Frontend-Sprache gesetzt werden. Praktisch z.B. bei Impressums-Seiten, die nicht in derselben TYPO3-Instanz liegen.
TypoScript:
10 = TEXT
10 {
value = Legal notice
lang.de = Impressum
typolink.parameter.cObject = CASE
typolink.parameter.cObject {
key.data = GP:L
1 = TEXT
1.value = http://www.example.de/impressum/
default = TEXT
default.value = http://www.example.com/legal-notice/
}
}
Quelle: http://stackoverflow.com/questions/26156629/typoscript-conditional-typolink-parameter#26157797