File download link

On this page:

Syntax

<txp:file_download_link />

The file_download_link tag is both a single tag and a container tag. Thus it may be used as an opening and closing pair:

<txp:file_download_link>
    ...containing statements...
</txp:file_download_link>

When used as a single tag, Textpattern will replace the tag with a download link to the file being downloaded. As a container, it will assign the link to the given text or tag, while the single tag outputs the file’s plain URL.

Attributes

Tag will accept the following attributes (case-sensitive):

filename="text"
Specifies which file to display by its filename as shown on the Files administration panel.
id="integer"
Specifies the id, assigned at upload of the file, to display. Can be found on the Files administration panel.

Note: id takes precedence over filename. If neither is defined and the tag is not used within the context of a file, nothing is returned.

Examples

<txp:file_download_link id="4">
    <txp:file_download_name />
    [<txp:file_download_size format="mb" decimals="2" />]
</txp:file_download_link>

Makes a link to the given file (#4) comprising its file name and size.

Other tags used: file_download_name, file_download_size.

See something wrong in this document? Outdated info, a broken link, faulty code example, or whatever? Please write an issue and we’ll fix it.