Snippets + Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Du befindest dich hier: Home » typo3 » about » functions » typolink
Zuletzt angesehen: • tsconfig • if
typo3:about:functions:typolink

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

Link zu der Vergleichsansicht

Nächste Überarbeitung		Vorherige Überarbeitung
typo3:about:functions:typolink [2014/03/23 14:41] – angelegt admintypo3:about:functions:typolink [2017/12/11 19:26] (aktuell) – [linkAccessRestrictedPages] admin
Zeile 1: Zeile 1:
-===== typolink ======+====== typolink =======
  
-Mit **typolink** können Werte mit internen und externen Links verknüpft werden.+**typolink** ermöglicht die Generierung von internen und externen Links, auch von E-Mail-Adressen und Dateiverweisen.
  
 ^Eigenschaft^Datentyp^Beschreibung^ ^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, eine externe URL, eine E-Mail-Adresse oder eine Datei auf dem Server handeln. <code typoscript>+^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:** <code typoscript> 
 +10.typolink.parameter = 3 
 +# Ausgabe: <a href="index.php?id=3"> 
 +</code> **URL Alias:** Wird in den Seiteneigenschaften eingetragen. <code typoscript> 
 +11.typolink.parameter = aliasname 
 +# Ausgabe: <a href="index.php?id=aliasname"> 
 +</code> **Sprungmarke:** Kann ohne UID oder Alias verwendet werden, um auf der aktuellen Seite zu verlinken. <code typoscript> 
 +12.typolink.parameter = 3#absatz1 
 +# Ausgabe: <a href="index.php?id=3#absatz1"> 
 +</code> **Externer Link:** //%%http://%%// wird automatisch hinzugefügt, kann aber auch selbst gesetzt werden. <code typoscript> 
 +13.typolink.parameter = www.example.org 
 +# Ausgabe: <a href="http://www.example.org" target="_top"> 
 +</code>  **E-Mail-Adresse:** <code typoscript> 
 +14.typolink.parameter = info@example.org 
 +# Ausgabe: <a href="mailto:info@example.org"> 
 +</code> **Datei auf dem Server:** <code typoscript> 
 +15.typolink.parameter = fileadmin/images/gitarre.png 
 +# Ausgabe: <a href="fileadmin/images/gitarre.png"> 
 +</code> Wenn nach UID oder Alias ein Komma und eine Integerzahl folgt, wird diese als typeNum gelesen: <code typoscript> 
 +20.typolink.parameter = 3,99 - - "Plaintext" 
 +# Ausgabe: <a href="index.php?id=3&amp;type=99" title="Plaintext"> 
 +</code> 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: <code typoscript> 
 +30.typolink.parameter = 3 _blank foo "Titel" 
 +# Ausgabe: <a href="index.php?id=3" title="Titel" target="_blank" class="foo">
  
-</code> Nach dem Ziel können weitere Parameter beschrieben werden: Target, Klasse und Titel (in dieser Reihenfolge). Wenn man nicht alle Parameter definieren möchte, genügt ein Bindestrich als Platzhalter: <code typoscript>+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">
 +</code> 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: <code typoscript>
 +40.typolink.parameter = 3 800x600
 +
 +41.typolink.parameter = 3 800x600:resizable=0,location=1
 </code>| </code>|
-^extTarget|target / stdWrap| | +^extTarget|target / stdWrap|Setzt das Target für externe Links. Ein ggf. unter ''parameter'' definiertes Target hat Vorrang. <code typoscript> 
-^fileTarget|target / stdWrap| | +10.typolink.parameter = www.example.org 
-^target|target / stdWrap| | +10.typolink.extTarget = _blank 
-^no_cache|boolean| | +</code>| 
-^additionalParams|string / stdWrap| | +^fileTarget|target / stdWrap|Setzt das Target für Dateilinks. Ein ggf. unter ''parameter'' definiertes Target hat Vorrang. <code typoscript> 
-^addQueryString|boolean| | +10.typolink.parameter = fileadmin/images/gitarre.png 
-^jumpurl|boolean| | +10.typolink.fileTarget = _blank 
-^wrap|wrap / stdWrap| | +</code>| 
-^ATagBeforeWrap|boolean| | +^target|target / stdWrap|Setzt das Target für interne Links. Ein ggf. unter ''parameter'' definiertes Target hat Vorrang. <code typoscript> 
-^ATagParams |[[typo3:about:datentypen#tag_-params|<a>-params]] / stdWrap|Ermöglicht zusätzliche Attribute im <a>-Element, z.B. eine Klasse. <code typoscript>+10.typolink.parameter = 3 
 +10.typolink.target = _blank 
 +</code>| 
 +^no_cache|boolean|Wenn aktiviert, wird der GET-Parameter //&no_cache=1// an die URL angehangen. <code typoscript> 
 +10.typolink.parameter = 3 
 +10.typolink.no_cache = 1 
 +#Ausgabe: <a href="index.php?id=3&amp;no_cache=1"> 
 +</code>| 
 +^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. <code typoscript> 
 +10.typolink.additionalParams = &foo=bar 
 +20.typolink.additionalParams.data = register:SWORD_PARAMS 
 +</code>| 
 +^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. <code typoscript> 
 +10.typolink.addQueryString = 1 
 +20.typolink.addQueryString.method = GET 
 +</code>| 
 +^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. <code typoscript> 
 +10 = TEXT 
 +10 { 
 +  value = Link 
 +  typolink.parameter = 3 
 +  typolink.wrap = <p>|</p> 
 +} 
 +# Ausgabe: <p><a href="index.php?id=3" >Link</a></p> 
 +</code>| 
 +^ATagBeforeWrap|boolean|Wenn aktiviert, wird der unter ''.wrap'' angegebene Wrap innerhalb der <a>-Elemente angewendet. <code typoscript> 
 +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> 
 +</code>| 
 +^ATagParams |[[typo3:about:datentypen#tag_-params|<a>-params]] / stdWrap|Ermöglicht zusätzliche Attribute im <a>-Element, z.B. eine Klasse. Eine ggf. unter ''parameter'' definierte Klasse hat Vorrang. <code typoscript>
 10.typolink.ATagParams = accesskey="b" class="verweis" 10.typolink.ATagParams = accesskey="b" class="verweis"
 </code>| </code>|
-^forceAbsoluteUrl|boolean| | +^forceAbsoluteUrl|boolean|Wenn aktiviert, wird die gesamte URL eingetragen. <code typoscript> 
-^title|string / stdWrap| | +10.typolink.parameter = 3 
-^JSwindow_params|string| | +10.typolink.forceAbsoluteUrl = 1 
-^returnLast|string| | +# Ausgabe: <a href="http://www.example.org/index.php?id=3"> 
-^section|string / stdWrap| | +</code>| 
-^linkAccessRestrictedPages|boolean| |+^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// <code typoscript> 
 +10.typolink.parameter = 3 400x400 
 +10.typolink.JSwindow_params = resizable=0,toolbar=1 
 +</code>| 
 +^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. <code typoscript> 
 +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 
 +</code>| 
 +^section|string / stdWrap|Hiermit kann eine Sprungmarke definiert werden. <code typoscript> 
 +10.typolink.parameter = 3 
 +10.typolink.section = sprungmarke 
 +# Ausgabe: <a href="index.php?id=3#sprungmarke"> 
 +</code>| 
 +^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.| 
 + 
 +===== Beispiele ===== 
 + 
 +==== Linkziel abhängig von gewählter Sprache ==== 
 + 
 +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:** 
 +<code> 
 +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/ 
 +  } 
 +} 
 +</code>
  
 +Quelle: http://stackoverflow.com/questions/26156629/typoscript-conditional-typolink-parameter#26157797
typo3/about/functions/typolink.1395582084.txt.gz · Zuletzt geändert: (Externe Bearbeitung)

Seiten-Werkzeuge