Category List

Category List

Template: /templates/category_list.html

This page lists and links to the Index Pages of categories which are not marked as hidden. One Category List will be published for each category, showing that category as "selected". Also, one page will be published in which no categories are highlighted. This page is often included via SSI's on other pages

Templatecells

cell description

row a category name and link (1.36 and before)

row_selected a category name and link, highlighted to show that the user is browsing this category (1.36 and before)

row_depth# a category name and link used for outputting parent and subcategories (1.37 and higher)

row_selected_depth# a category name and link used for outputting parent and subcategories (1.37 and higher), highlighted to show that the user is browsing this category

not_found what to display if there are no categories to display

Note: This page supports alternating rows. By creating an alternate version of each templatecell and adding the suffix row2, it will be used for every second category in the list. For example:


or


Placeholders

Global Placeholders

placeholder description

$url_gindex$ the url to the Global Index

$url_publish$ the url to the directory containing all published files

$url_search$ the url to Article Manager's Search Engine

$file_gcategories$ filename of the Global Category List include (none selected)

$file_gheadlines$ filename of the Global Headlines include

$file_headlines_bycat$ filename of the Headlines by Category include

$file_search$ filename of the Search Form include

$global_updated$ the date and time any published pages were last updated

$gcat_name$ the Global Category Name

$url_thispage$ the url of the current page

$publishdir_virtualpath$ The path from the webroot directory to the publish directory. This is used by Article Manager to insert the path into "virtual" includes.

i.e.: If your publish URL is http://www.site.com/artman/publish/, the $publishdir_virtualpath$ is /artman/publish/.

$publishdir_filepath$ The full (absolute) server filepath to the publish directory.

i.e.: /users/home/www/html/artman/publish/

document placeholders

placeholder description

Global Placeholders For a complete list of Global Placeholders, click here

This template does not have any additional placeholders

templatecell: row_depth

placeholder description

$cat_num$ the record number of the category

$cat_name$ the title of the category

$cat_breadcrumb$ the category name and all directly related parent category names based on the design of the category_breadcrumb.html template file

e.g. News > Business > European Business

$cat_updated$ the date and time that this category (or an article in this category) was last updated

$cat_image$ the url for this category's image

$cat_image_width$ the width of this category's image

$cat_image_height$ the height of this category's image

$url_index$ the url to this category's Index Page

In version 1.36 and before there were three templatecell rows, one unnamed to publish the categories into the navigation, "selected" (with different formatting for the "current" category), and "not found" (published when you have no categories).

When subcategories were introduced in version 1.37, the row templatecells begain making use of a _depth# suffix (where # is the depth value). The _depth# suffix allows you to distinguish parent categories from subcategories. This allows you to use different formatting for parent categories (a depth of 1) than you would use for the parent's subcategories (a depth of 2).

For example, the following templatecells will publish top level categories with a font size of 3 and publish their immediate subcategories with a font size of 2 and a "--" prefix:


            <!-- templatecell : row_depth1 -->

                <a href="$url_index$" ><font size=3>$cat_name$</a><br>

            <!-- /templatecell : row_depth1 -->

                <!-- templatecell : row_depth2 -->

                <a href="$url_index$" ><font size=2>  -- $cat_name$</a><br>

            <!-- /templatecell : row_depth2 -->


            <!-- templatecell : row_selected_depth1 -->

                <a href="$url_index$" ><font size=3>$cat_name$</a><br>

            <!-- /templatecell : row_selected_depth1 -->

                <!-- templatecell : row_selected_depth2 -->

                <a href="$url_index$" ><font size=2>  -- $cat_name$</a><br>

            <!-- /templatecell : row_selected_depth2 -->

The "row_selected_depth#" cells are used for outputting the currently "selected" category.

The default templates include up to depth3. If you want to set your "Max Subcategory Depth" to 4 or higher (see Server Options -> Subcategory Settings), you'll need to add templatecells for row_depth4 and row_selected_depth4, or all the way up to the maximum depth you want.

Note: Both the row_depth and row_depth_selected templatecells make use of the same placeholders.

templatecell : not_found

placeholder description

Global Placeholders For a complete list of Global Placeholders, click here

This templatecell does not have any additional placeholders