filelink erzeugt Links zu Dateien in TYPO3. Der Dateiname wird im Frontend ausgegeben und mit der Datei verknüpft. Es wird hierbei keine Kopie im Ordner uploads/ angelegt.
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| path | path / stdWrap | Der relative Pfad zur Datei. Der Dateiname selbst muss zuvor z.B. mit value angegeben werden! 10 = TEXT 10.value = gitarre.png 10.filelink.path = fileadmin/images/ # Ausgabe: <a href="fileadmin/images/gitarre.png" >gitarre.png</a> |
| icon | boolean | Stellt dem Dateinamen ein Icon voran. Ausschlaggebend ist die Dateiendung im Wert. Seit TYPO3 4.7 ist es möglich, das Icon selbst zu bestimmen. 10 = TEXT 10.value = gitarre.png 10.filelink.path = fileadmin/images/ 10.filelink.icon = 1 <!-- Ausgabe --> <img src="typo3/sysext/cms/tslib/media/fileicons/png.gif" width="18" height="16" border="0" alt="" /> <a href="fileadmin/images/gitarre.png" >gitarre.png</a> |
| icon. | stdWrap | Seit TYPO3 4.7: Ermöglicht eigene Datei-Icons. icon.path' → Pfad zum Icon-Ordner (default: typo3/gfx/fileicons/)icon.ext' → Dateiendung der Icons (default: gif)icon.widthAttribute → Breite des Icons in Pixeln (default: 18)icon.heightAttribute' → Höhe des Icons in Pixeln (default: 16) |
| icon_image_ext_list | Liste von Dateiendungen / stdWrap | Kommaseparierte Liste von Bild-Dateiendungen, die statt Icon ein Vorschaubild erhalten sollen. icon muss dafür aktiviert sein. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ icon = 1 icon_image_ext_list = png,jpg } |
| icon_thumbSize | string / stdWrap | Ermöglicht die Größenangabe des Vorschaubildes. Ein Wert gilt als maximale Höhe und Breite. Bei zwei Werten gilt Breite x Höhe. Die Bildproportionen bleiben immer erhalten. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ icon = 1 icon_image_ext_list = png,jpg icon_thumbSize = 150x300 } |
| iconCObject | cObject | Alternative Möglichkeit, ein Vorschaubild zu generieren, z.B. mit IMAGE oder GIFBUILDER. |
| icon_link | boolean | Wenn aktiviert, wird das Icon ebenfalls verlinkt. |
| labelStdWrap | stdWrap | Ermöglicht stdWrap für die Beschriftung des Links. Der Dateiname könnte z.B. aus einem Datenbankfeld ausgelesen werden. Oder, wie im folgenden Beispiel, mit einem cObject einfach überschrieben. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ labelStdWrap.cObject = TEXT labelStdWrap.cObject.value = Die neue Gitarre } |
| wrap | wrap / stdWrap | Ermöglicht ein Wrap für Label (Dateiname) und Anker. Icon/Vorschaubild sowie Dateigröße wären nicht betroffen. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ wrap = <div>|</div> } # Ausgabe: <div><a href="#" >gitarre.png</a></div> |
| ATagBeforeWrap | boolean | Wenn aktiviert, wird wrap innerhalb des a-Elements angewendet. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ wrap = <div>|</div> ATagBeforeWrap = 1 } # Ausgabe: <a href="#" ><div>gitarre.png</div></a> |
| file | stdWrap | Ermöglicht stdWrap-Funktionen für Label (Dateiname) und Anker. Icon/Vorschaubild sowie Dateigröße wären nicht betroffen. |
| size | boolean / stdWrap | Wenn aktiviert, wird die Dateigröße in Bytes ausgegeben. Mit stdWrap.bytes kann die Dateigröße umgerechnet werden. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ size = 1 } # Ausgabe: <a href="#" >gitarre.png</a>3282982 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ size = 1 size.bytes = 1 size.bytes.labels = B | KB | MB | GB } # Ausgabe: <a href="#" >gitarre.png</a>3.1 MB |
| 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).10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ jumpurl = 1 } <!-- jumpurl = 0 --> <a href="fileadmin/images/gitarre.png" >gitarre.png</a> <!-- jumpurl = 1 --> <a href="index.php?id=3& type=0& jumpurl=fileadmin%2Fimages%2Fgitarre.png& juHash=58c2[...]" >gitarre.png</a> |
| target | target / stdWrap | Ergänzt den Link um das target-Attribut, um das Ziel in einem neuen Frame oder Fenster zu öffnen. |
| stdWrap | stdWrap | Ermöglicht stdWrap-Funktionen für das gesamte filelink-Objekt. |
| ATagParams | a-Parameter / stdWrap | Ergänzt den Anker um Parameter. Wenn icon_link aktiviert wurde, gilt dies auch für diesen Link. 10 = TEXT 10.value = gitarre.png 10.filelink { path = fileadmin/images/ ATagParams = foo="bar" } # Ausgabe: <a href="#" foo="bar">gitarre.png</a> |
| removePrependedNumbers | boolean | Wenn aktiviert, werden eventuell anhängende zweistellige Ziffern im Label entfernt. 10 = TEXT 10.value = gitarre_01.png 10.filelink { path = fileadmin/images/ removePrependedNumbers = 1 } # Ausgabe: <a href="fileadmin/images/gitarre_01.png" >gitarre.png</a> |
| altText titleText | string / stdWrap | Fügt beim Icon oder Vorschaubild ein alt- bzw. title-Attribut ein. Bilder, die mit iconCObject erzeugt wurden, müssen diese Attribute mit eigenen Eigenschaften erhalten. |
| emptyTitleHandling | string / stdWrap | Statt titleText für Icon bzw. Vorschaubild:useAlt → Verwendet den Inhalt des alt-Attributs als title. keepEmpty → Ein leeres title-Attribut wird verwendet. |
| longdescURL | string / stdWrap | Fügt beim Icon oder Vorschaubild ein longdesc-Attribut ein. Bilder, die mit iconCObject erzeugt wurden, müssen dieses Attribut mit einer eigenen Eigenschaft erhalten. |
