====== txp:file_download_list ======

The ''file_download_list'' tag is a Single Tag which is used to produce a list of download links according to the attributes set in the tag criteria.

===== Syntax =====

The ''file_download_list'' tag has the following syntactic structure...
<code php><txp:file_download_list /></code>

====== Attributes ======

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

=====category="category name"===== 
Restrict to files from specified category. Default is unset.
=====status="status"===== 
Restrict to files with specified status. Available values: __hidden__, __pending__, __live__. Default is __live__.
=====sort="sort value(s)"===== 
How to sort the resulting list. Available values: __id__, __filename__, __category__, __description__, __downloads__, __rand()__ [[http://dev.mysql.com/doc/refman/5.0/en/mathematical-functions.html#function_rand |random]]. Default is __filename__.
=====limit="integer"===== 
Number of files to display. Default is __10__.
=====offset="integer"===== 
Number of files to skip. Default is unset.
=====form="form name"===== 
Use specified form. Default is __files__.
=====label="text"===== 
Label for the top of the list. Default is unset.
=====labeltag="tag"===== 
[[http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.1 |(X)HTML tag]] (without brackets) to wrap around __label__. Default is unset.
=====wraptag="tag"===== 
[[http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.1 |(X)HTML tag]] (without brackets) to wrap around list. Default is unset.
=====break="value"===== 
[[http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.1 |(X)HTML tag]] (without brackets) or string used to separate list items. Default is __br__.
=====class="class name"===== 
[[http://www.w3.org/TR/html4/struct/global.html#adef-class |(X)HTML class attribute]] to be applied to __wraptag__. Default is __file_download_list__.

======Examples======

===== Display a styled download link list of ten downloads =====

<code php><txp:file_download_list limit="10" break="li" wraptag="ul" sort="downloads asc" /></code>

Styles could go this way:

<code php>
.file_download_list
{
	list-style-type:none;
}
</code>