====== txp:category ======

The ''category'' tag can be used as either a single or containing tag. It will display information of the category as defined by the __name__ attribute, or the one currently being viewed. When used as a containing tag, it will turn the contents into a link to the category. Otherwise, it will return plain text.

May be used in any context.

===== Syntax =====

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








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

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

=====name="category name"=====
Display specific category. Default is unset (use current category).

=====type="category type"===== 
Available values: __article__, __image__, __link__, __file__. Default is __article__.

=====title="boolean"===== 
Whether to display category's title. Available values: __1__ (yes) or __0__ (no, display name). Default is __0__ (no, display name).

=====link="boolean"===== 
Whether to display as link. Available values: __1__ (yes) or __0__ (no). Default is __0__ (no).

=====section="section name"===== 
Restricts category search to named section. Default is current section (for backwards compatibility).

=====this_section="boolean"===== 
Only link to articles from the current section. __section__ attribute overrides this setting. Available values: __1__ (yes) or __0__ (no). Default is __0__ (no).

=====class="class name"===== 
[[http://www.w3.org/TR/html4/struct/global.html#adef-class |(X)HTML class attribute]], applied to __wraptag__. 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 output. Default is unset.










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

===== Displays the current category name=====

<code php><txp:category /></code>

=====Display hyperlinked category name=====

<code php><txp:category link="1" /></code>

=====Display hyperlinked category title=====

<code php><txp:category title="1" link="1" /></code>

=====Display "articles" category's title, hyperlinked===== 

<code php><txp:category name="articles" title="1" link="1" wraptag="p" /></code>

=====Container Example=====

<code php><txp:category name="book">My books</txp:category></code>



====== Genealogy ======


=====Version 4.0.4=====

  * __this_section__ added.