WordPress doesn't have a good way to generate pages or categories lists, this plug-in is inspirited by the one from Adi Sieker, that was a very good base to start.
It uses an array because it can provide better tag options than a simple string launch, but every option has a default value, so if the default one is the one desired can be omitted in the initialization.
If you have your custom css with this plug-in you can create also interactive menu or very useful site maps, see screenshots.

Bugs can be mailed at: cimmino_DOT_marco_AT_gmail_DOT_com


REQUIREMENTS:
WordPress = 2.x (tested both with 2.0 and 2.1)


INSTALLATION:
just copy the php file in your WordPress plug-in directory and activate it


USAGE:
This is only a small example how to use the plug-in, of course you can add options or just modify them.

$params = Array(
	'show_all_parents' => 1,
	'show_root' => 1,
	'show_children' => 1,
	'nested' => 1,
	'ul_id_parent' => 'navmenu',
	'li_class_current' => 'page_item',
	'li_class_nocurrent' => 'page_item',
	'append_child' => 0,
	'show_div' => 0,
	'nested_li_ul_li' => 1,
	'current' => 0,
	'show_all_children' => 1,
	'sort_column' => 'menu_order',
);

$result = Array();
$result = init_args($params);

/* gives the root page ID, should be useful to customize header images for every group of parents-children pages */
$root = $result['root'];

/* this function can be called more than one time without calling init_args again, because all options are saved into $result array */
output_parents($result);


PARAMETERS (should be added in $params Array):

'type'
choose what should be displayed: 'pages' or 'categories'
[default: 'pages']

'current'
set the current item
[default: the item visited or if it's a post then default is 0]

'list_tag'
add all default tags that are <div> and <ul> before the element and <li> for each element
[default: 1]

'depth'
you can specify which was the max children depth to show
[default: -1, equal to: no limit]

'show_root'
show the root item
[default: 1]

'show_parents'
show all and only current item's parents
[default: 1]

'show_all_parents'
show all parents, NOT only the current item's parents
[default: 0]

'show_children'
show all and only current item's children
[default: 1]

'show_all_children'
show all children, NOT only current item's children
[default: 0]

'own_tag_open'
add a custom open tag after the default open tags and before the item
[default: '']

'own_tag_close'
add a custom close tag before the default close tags and after the item
[default: '']

'link_options'
add some options to element <a ...> for every item
[default: '']

'nested'
list all children if there are before list other items
[default: 1]

'nested_li_ul_li'
just don't close the <li> tag if there are children, tag will be closed after the children
[default: 0]

'li_class_current'
set a different class for <li> tag in the current item
[default: '']

'li_class_nocurrent'
set a different class for <li> tag in non current items
[default: '']

'li_id_current'
set a different id for <li> tag in the current item
[default: 'current']

'li_id_nocurrent'
set a different id for <li> tag in non current items
[default: 'nocurrent']

'ul_class_parent'
set a different class for <ul> tag in parent items
[default: 'level#' (level1, level2, etc)]

'ul_id_parent'
set a different id for <ul> tag in parent items
[default: '']

'ul_class_children'
set a different class for <ul> tag in children items
[default: 'level#' (level1, level2, etc)]

'ul_id_children'
set a different id for <ul> tag in children items
[default: '']

'div_class_parent'
set a different class for <div> tag in parent items
[default: '']

'div_id_parent'
set a different id for <div> tag in parent items
[default: 'n#' (n1, n2, etc)]

'div_class_children'
set a different class for <div> tag in children items
[default: '']

'div_id_children'
set a different id for <div> tag in children items
[default: 'n#' (n1, n2, etc)]

'append_child'
append the string '-child' to every <ul> class and id in children items
[default: 1]

'show_div'
show <div> tag for every items
[default: 1]

SPECIFIC ONLY FOR CATEGORIES:

'hide_empty'
hide categories without posts
[default: 1]

'include_cat'
include one or more categories, if more than one separate with ','
[default: '']

'exclude_cat'
exclude one or more categories, if more than one separate with ','
[default: '1,2' they represents Uncategorized and Blogroll]


CHANGE LOG:
v0.3.0 beta3
- Fixed a php error when 'depth' parameter was set too low, now it prints a warning
- Changed plug-in link, now it points to the specific blog page

v0.3.0 beta2
- Fixed categories links

v0.3.0 beta1 (never released to public)
- Added possibility to choose from pages or categories to be displayed, use 'type' parameter
- Added 4 new parameters: 'type' mentioned before and also 'hide_empty', 'include', 'exclude' only for categories

v0.2.0
- First public release