/ 
Posy-Plugin-Categories-0.40
/ Posy::Plugin::Categories

NAME

Posy::Plugin::Categories - Posy plugin to give category links.

VERSION

This describes version 0.40 of Posy::Plugin::Categories.

SYNOPSIS

    @plugins = qw(Posy::Core
		  Posy::Plugin::TextTemplate
		  ...
		  Posy::Plugin::Categories);

DESCRIPTION

This provides category-based (lists of) links: a category tree which can be used as a site map, contains a list of lists of all the categories; and a breadcrumb list which provides a "breadcrumb trail" list.

These methods can be called from within templates if one is using the TextTemplate plugin.

For example:

[==Posy->category_tree()==]

Helper Methods

Methods which can be called from elsewhere.

category_tree

    $links = $self->category_tree(
	tree_head=>'<ul>',
	tree_foot=>'</ul>',
	subtree_head=>'<ul>',
	subtree_foot=>'</ul>',
	pre_item=>'<li>',
	post_item=>'</li>'
	pre_active_item=>'<em>',
	post_active_item=>'</em>',
	item_sep=>"\n",
	tree_sep=>"\n",
	use_count=>1,
	root=>'Home');

Generates a list (of lists) of links of all the categories.

This provides a large number of options to customize the appearance of the list. The default setup is for a simple UL list, but setting the options can enable you to make it something other than a list altogether, or add in CSS styles or classes to make it look just like you want.

If HTTP_REFERRER exists, this will also flag a "you were here" in the list.

Options:

tree_head

The string to prepend the top-level tree with.

tree_foot

The string to append to the top-level tree.

subtree_head

The string to prepend to lower-level trees.

subtree_foot

The string to append to lower-level trees.

pre_item

The string to put in front of each item.

post_item

The string to append to each item.

pre_active_item

An additional string to put in front of each "active" item, after pre_item.

The active item is the category which is the current category if the current path is a category path. A regular item will have a link to that category; the active category doesn't, because we're already there.

post_active_item

An additional string to append to each active item, before post_item.

item_sep

The string to separate each item.

tree_sep

The string to separate each tree.

use_count

If true, display the count of entries for that category next to that category.

root

What label should we give the "root" category? (default: Home)

you_were_here

String which points to the directory we just came from. (default: '&lt;-- you were here')

    $links = $self->breadcrumb(
	tree_head=>'<ul>',
	tree_foot=>'</ul>',
	subtree_head=>'<ul>',
	subtree_foot=>'</ul>',
	pre_item=>'<li>',
	post_item=>'</li>'
	pre_active_item=>'<em>',
	post_active_item=>'</em>',
	item_sep=>"\n",
	tree_sep=>"\n",
	root=>'Home');

Generates a list (of lists) of links of the categories above (and just below) the current path.

This provides a large number of options to customize the appearance of the list. The default setup is for a simple UL list, but setting the options can enable you to make it something other than a list altogether, or add in CSS styles or classes to make it look just like you want.

Options:

tree_head

The string to prepend the top-level tree with.

tree_foot

The string to append to the top-level tree.

subtree_head

The string to prepend to lower-level trees.

subtree_foot

The string to append to lower-level trees.

last_subtree_head

The string to prepend to the last (lowest) tree.

last_subtree_foot

The string to append to the last (lowest) tree.

pre_item

The string to put in front of each item.

post_item

The string to append to each item.

pre_active_item

An additional string to put in front of each "active" item, after pre_item.

The active item is the category which is the current category if the current path is a category path. A regular item will have a link to that category; the active category doesn't, because we're already there.

post_active_item

An additional string to append to each active item, before post_item.

item_sep

The string to separate each item.

tree_sep

The string to separate each tree.

root

What label should we give the "root" category? (default: Home)

start_depth

The depth (from the root) at which to start the tree. The default is zero, which means start from the root. Most of the time that is just what one wants.

end_depth

The depth (from the root) at which to end the tree. The default is the depth of the current path ($path_depth) plus one. This allows one to have a breadcrumb path which looks below the current directory, as well as above it. If one wishes to just show the current directory and those above it, then set this option to $path_depth.

Private Methods

_build_lol

Build a list of lists of categories.

_traverse_lol

Traverse the list of lists of categories to produce links.

REQUIRES

Posy
Posy::Core
Posy::Plugin::TextTemplate

Test::More

SEE ALSO

perl(1). Posy

BUGS

Please report any bugs or feature requests to the author.

AUTHOR

Kathryn Andersen (RUBYKAT)
perlkat AT katspace dot com
http://www.katspace.com

COPYRIGHT AND LICENCE

Copyright (c) 2004-2005 by Kathryn Andersen

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.