====== txp:category1 ======

The ''category1'' tag can be used as either a single or containing tag. It will display information of the category as defined by Cat1 of the article being displayed. When used as a containing tag, it will turn the contents into a link to that category. Otherwise, it will return plain text.

This tag may be used within either an article Form, or, in a page, wrapped in an //if_individual_article// conditional tag.

===== Syntax =====

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


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

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

=====title="boolean"===== 
Whether to output category title, rather than name. Available values: __1__ (yes) or __0__ (no, output name). Default is __0__ (no).

=====link="boolean"===== 
Whether to link to articles from the same category. Available values: __1__ (yes) or __0__ (no). Default is __0__ (no).

=====section="section name"===== 
Only link to articles from the specified section. Default is unset.

=====this_section="boolean"===== 
Whether to only link to articles from the section containing the current article. Available values: __1__ (yes) or __0__ (no). Default is __0__ (no, allow from any section).

=====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 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 ======

===== Display the Cat1 category of the article being displayed in plain text =====

<code php><txp:category1 /></code>

===== Display the Cat1 category hyperlinked to search for articles of the same category =====

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

If category1 is "General", this tag returns the following URL

<code php>http://yoursite.com/category/general</code>

If you find you have URL mode or version conflicts with this, what follows will serve as well.

<code php><a href="/subdirectory/index.php?c=<txp:category1 />"><txp:category1 /></a></code>


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

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

  * __encode__, __class__, __section__, __this_section__, __wraptag__ added.