De:TSref/filelink
From TYPO3Wiki
| De:TSref/filelink |
|
||||
TypoScript This page is document in progress.
filelink
Erstellt einen Link auf eine Datei. Bietet die Möglichkeit ein Icon für den Dateityp mit anzuzeigen, die Dateigröße oder auch ein kleines Vorschaubild anzeigen zu lassen.
icon, size und file wird in der hier angegebenen Reihenfolge ausgegeben.
| Eigenschaft | Datentyp | Kommentar | Standardwert |
| path | path /stdWrap |
Beispiel: "uploads/media/" | |
| icon | boolean /stdWrap | Soll das Icon angezeigt werden? | |
| icon_image_ext_list | Liste von Bild-Dateierweiterungen | Dateien mit dieser Dateierweiterung sollen anstelle von Icons mit Thumbnails angezeigt werde | |
| iconCObject | cObject | Fügt ein cObject (z.B. IMAGE) ein, welches alternativ für die Icons verwendet wird. Diese Einstellung ersetzt die Verwendung des Thumbnail-Skripts für das Anzeigen von Thumbnails. | |
| icon_link | boolean | Steuert ob das Icon ebenfalls verlinkt werden soll. | |
| labelStdWrap | stdWrap | Der dateiname wird als Linktext gesetzt. Dieses verhalten kann mit der stdWrap-Funktion überschrieben werden um z.B. einen anderen Titel aus der Datenbank zu laden. Der stdWrap wird vor dem Wrapping mit dem a-Tag ausgeführt. | |
| wrap | wrap | wrapped den Link | |
| ATagBeforeWrap | boolean | Wenn diese Eigenschaft gesetzt ist, dann wird der Link zuerst mit .wrap gewrapped und erst dann mit dem a-Tag. | |
| file | stdWrap | stdWrap des Labels, nachdem der a-Tag drumherum gewrappt wurde. | |
| size | boolean /stdWrap | Setzen wenn die Größe ebenfalls angezeigt werden soll. | |
| jumpurl | boolean | Decides if the link should call the script with the jumpurl paramter in order to register any clicks in the stat.
This has the advantage that any clicks on the file will register in the stat. The disadvantage is, that users cant right-click and select "Save Target As" in the browser. Properties: .secure (boolean)If set, then the file pointed to by jumpurl is NOT redirected to, but rather it's read from the file and returned with a correct header. This option adds a hash and locationData to the url and there MUST be access to the record in order to download the file. If the fileposition on the server is furthermore secured by a .htaccess file preventing ANY access, you've got secure download here! .secure.mimeTypes (list of mimetypes, syntax [ext] = [mimetype] Example: .secure = 1 .secure.mimeTypes = pdf=application/pdf, doc=application/msword | |
| target | target | ||
| stdWrap | stdWrap | ||
| ATagParams | <A>-params /stdWrap | Zusätzliche Parameter für den a-Tag
Beispiel: class="board" | |
| removePrependedNumbers | boolean | Entfernt aus dem Dateinamen alle angehängten Ziffern ("filename_02.gif" wird zu "filename.gif"). | |
| altText
titleText | string /stdWrap | For icons (image made with "iconCObject" must have their own properties)
If no titltext is specified, it will use the alttext insteadIf no alttext is specified, it will use an empty alttext | |
| longdescURL | string /stdWrap | For icons (image made with "iconCObject" must have their own properties)
"longdesc" attribute (URL pointing to document with extensive details about image). |
[tsref:->filelink]
Beispiele
#Example:
1.filelink {
path = uploads/media/
icon = 1
icon.wrap = <td> | </td>
size = 1
size.wrap = <td> | </td>
file.fontTag = {$styles.content.uploads.wrap}
file.wrap = <td> | </td>
jumpurl = 1
target = _blank
stdWrap = <tr> | </tr>
}
# Ein Link auf die Datei fileadmin/bilder/screenshot.png wird ausgegeben.
20 = TEXT
20.value = screenshot.png
20.filelink {
path = fileadmin/bilder/
icon = 1
icon.wrap = |
icon_link = 1
size = 1
size.noTrimWrap = | (| Bytes) |
stdWrap.wrap = <div>|</div>
}
# Zeigt die Größe mit passender Einheit an und rendert aus dem Screenshot ein # Vorschaubild 20 = TEXT 20.value = screenshot.png 20.filelink { path = fileadmin/bilder/ icon = 1 icon.wrap = | icon_link = 1 icon_image_ext_list = png,gif size = 1 size.noTrimWrap = | (| Bytes) | size.bytes = 1 size.bytes.labels = | K| M| G stdWrap.wrap = | }
