Benutzer-Werkzeuge

Webseiten-Werkzeuge


typo3:about:functions:typolink

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

Link zu der Vergleichsansicht

Beide Seiten, vorherige ÜberarbeitungVorherige Überarbeitung
Nächste Überarbeitung
Vorherige Überarbeitung
typo3:about:functions:typolink [2014/03/23 15:51] 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^
Zeile 23: Zeile 23:
 # Ausgabe: <a href="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> </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+20.typolink.parameter = 3,99 - - "Plaintext" 
-# Ausgabe: <a href="index.php?id=3&amp;type=99" title="Plaintext-Ausgabe">+# 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> </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 Klasse "Der Titel" +30.typolink.parameter = 3 _blank foo "Titel" 
-# Ausgabe: <a href="index.php?id=3" title="Der Titel" target="_blank" class="Klasse">+# Ausgabe: <a href="index.php?id=3" title="Titel" target="_blank" class="foo">
  
-31.typolink.parameter = 3 - Klasse "Der Titel" +31.typolink.parameter = 3 - foo "Titel" 
-# Ausgabe: <a href="index.php?id=3" title="Der Titel" class="Klasse" >+# Ausgabe: <a href="index.php?id=3" title="Titel" class="foo" >
  
-32.typolink.parameter = 3 - - "Der Titel" +32.typolink.parameter = 3 - - "Titel" 
-# Ausgabe: <a href="index.php?id=3" title="Der 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> </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 40.typolink.parameter = 3 800x600
Zeile 39: Zeile 39:
 41.typolink.parameter = 3 800x600:resizable=0,location=1 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.1395586269.txt.gz · Zuletzt geändert: (Externe Bearbeitung)