Retired Documentation: You are using the documentation for version 1.7.3 which was retired in 2013. Go here for the latest version documentation or check here for your available upgrades to the latest version.

Wiki Template, Special Categories Section

The Special Categories section creates a list of all the categories in a site as outlined below:

Displays all the categories in the wiki.

In addition to the variables in the Wiki Page section, the Special Categories section makes use of the the following Tags:

{wiki:categories}
{wiki:category_subcategories}
{wiki:category_articles}

{wiki:categories}

This tag is used to display all the wiki's categories. When put into the Wiki Article template, it will only show the categories for that specific article. It has Parameters and Variables available to it.

backspace=""

{wiki:categories backspace="#"}

This removes "#" number of characters from the output at the end of the loop. This is useful for removing commas and <br />'s.

show_empty=""

{wiki:categories show_empty="n"

This parameter lets you tell the wiki whether or not to display categories with no articles assigned to it. The possible values are:

n: Categories with no articles will not be displayed.

style=""

{wiki:categories style=""}

This will automatically nest the categories for you as standard xhtml using <ul> or render a list without any formatting. The values are:

nested: renders the categories in a xhtml list with <ul>.
linear: renders the categories with no formatting.

For more information on nesting please see the Style parameter in the Weblog section of the User Guide.

{wiki:categories} | Variables

Single Variables
Conditional Variables

{wiki:categories} | Single Variables

{path:view_category}
{category_name}
{count}
{depth}
{switch="one|two|three"}

path:view_category

{path:view_category}

Creates a link to view a specific category page.

category_name

Displays the category name.

count

{count}

"count" of the category currently being displayed in the list

depth

{depth}

Determines how many nested layers down a category is.

switch=

{switch="option_one|option_two|option_three"}

This variable permits you to rotate through any number of values as the categories are displayed. The first category will use "option_one", the second will use "option_two", the third "option_three", the fourth "option_one", and so on.

Multiple instances of the {switch=} tag may be used and the system will intelligently keep track of each one.

{wiki:categories} | Conditional Variables

{if depth}
{if children}
{if first_child}
{if last_child}

if depth

{if depth == '#'}

You can check to see if a category is at a certain "depth" in the list.

if children

{if children}

Determines if a category has one or more "children" categories.

if first_child

{if first_child}

Determines if a category is the first child of a parent category.

if last_child

{if last_child}

Determines if a category is the last child of a parent category.

{wiki:category_subcategories}

This tag is used to display the subcategories of a single category. It has Parameters and Variables available to it.

{wiki:category_subcategories} | Parameters

backspace=""
style=""

backspace

{wiki:category_subcategories backspace="#"}

This removes "#" number of characters from the output at the end of the loop. This is useful for removing commas and <br />'s.

style

{wiki:category_subcategories style=""}

This will automatically nest the subcategories for you as standard xhtml using <ul> or render a list without any formatting. The values are:

nested: renders the categories in a xhtml list with <ul>.
linear: renders the categories with no formatting.

For more information on nesting please see the Style parameter in the Weblog section of the User Guide.

{wiki:category_subcategories} | Variables

Pair Variables
Conditional Variables
Single Variables

Pair Variables

{header}
{footer}

header


{header}

content before listing subcategories.

{/header}

This variable will display content before the subcategories are listed.

footer


{footer}

content after listing subcategories.

{/footer}

This variable will display content after the subcategories are listed.

Conditional Variables

{if subcategory_total}

if subcategory_total

{if subcategory_total == '0'}

Test the number of subcategories. This is typically used display alternate content if no subcategories exist.

Single Variables

{path:view_category}
{category_name}
{subcategory_total}

path:view_category}

{path:view_category}

This creates a link to view a category's page (a list of all the titles in that category).

category_name

{category_name}

Displays a category's name.

subcategory_total

{subcategory_total}

Displays the number of subcategories in a category.

{wiki:category_articles}

This tag displays a list of articles within a category. It has Parameters and Variables available to it.

{wiki:category_articles} | Parameters

backspace=""
limit=""
paginate=""

backspace=""

{wiki:category_articles backspace="#"}

This removes "#" number of characters from the output at the end of the loop. This is useful for removing commas and <br />'s.

limit

{wiki:category_articles limit=""}

This determines how many articles are displayed on a category's page. For example, this:

{wiki:category_articles limit="20"}

Would limit the number of articles displayed to 20.

paginate

{wiki:category_articles paginate=""}

This determines the placement of pagination. For example, if the limit parameter is set to 20 and there are 55 articles, then you can use this parameter to create pagination to browse all the articles.

The values for the paginate parameter are:

top: pagination is placed on top.
bottom: pagination is placed on the bottom.
both: pagination is placed on the top and the bottom.

{wiki:category_articles} | Variables

Pair Variables
Conditional Variables
Single Variables

Pair Variables

header


{header}

content before listing articles.

{/header}

This variable will display content before the articles are listed.

footer


{footer}

content after listing articles.

{/footer}

This variable will display content after the articles are listed.

letter_header


{letter_header}<div class="cap">{letter}</div>{/letter_header}

This is used to organize articles by the first letter of the title. It looks at the first character of each article and when there is a new character it will create a header for that letter using the {letter} variable as in the example above.

Conditional Variables

{if articles_total}

if articles_total

{if articles_total == '0'}

Test the number of articles. This is typically used to display alternate content if no articles exist for a particular category.

Single Variables

{path:view_category}
{category_name}
{articles_total}