Channel Fields¶

Single Variable Usage¶

In its most basic form, a File field can be used as a single tag that simply outputs the URL of the file:

{news_image}

If you have defined any Image Manipulations you can modify the tag with the Short Name of the manipulation. For example, if you’ve defined a “small” manipulation, the following will output the URL to that version:

{news_image:small}

{news_image wrap="link"}

<a href="http://example.com/dir/filename.ext">filename</a>

{news_image wrap="image"}

<img src="http://example.com/dir/filename.ext" alt="filename" />

Variable Pair Usage¶

You can show detailed information about the file by using it as a tag pair and then referencing any of the available variables:

{news_image}
        This file is a {extension} and was uploaded on {upload_date format="%Y %m %d"}
        <a href="{url}">View it now</a>
{/news_image}

{credit}

{description}

{extension}

{file_id}

{file_name}

{file_size}

{height}

{location}

{mime_type}

{modified_date format="%Y %m %d"}

{path}

{title}

{upload_date format="%Y %m %d"}

{url}

{url:small}

{width}

Limit Parameter¶

This parameter limits the number of selected items output by the tag. It works for both the single variable, as well as the tag pair.

Markup Parameter¶

As a single tag, the multi option fields will display a comma seperated list of values. If you want an html list, you can use markup=”ul” or markup=”ol” to change the output to the equivalent html list

{poll_options markup="ul"}

Which will render as

<ul>
    <li>Green</li>
    <li>Blue</li>
    <li>Orange</li>
</ul>

Backspace Parameter¶

When used as a tag pair, the multi option fields are a looping pair. Backspacing removes characters (including spaces and line breaks) from the last iteration of the loop. For example, if you put a <br /> tag after each item you’ll have this

{poll_options backspace="7"}
    {item}<br />
{/poll_options}

Which will render as

<ul>
    <li>Green</li><br />
    <li>Blue</li><br />
    <li>Orange</li><br />
</ul>

You might, however, not want the <br /> tag after the final item. Simply count the number of characters (including spaces and line breaks) you want to remove and add the backspace parameter to the tag. The <br /> tag has 6 characters plus a new line character.