#pragma supplementation-page on

<<TableOfContents>>
= CollectList =
{{{#!wiki tip
deprecated for 1.9.3 please see [[MacroMarket/DictColumns|DictColumns]]
}}}

== Description ==
`<<CollectLists>>`
will create a on default a table row for every subpage of the current page and a table column for each key and fills the cells with data from each key value pair of a definition list. You can change the search_expression keyword to any regex you want. All attributes to the macro are optional.<<BR>>
You can give as an attribute to the macro the name of the template page the definition list page depends on.<<BR>>
You can also list the desired keys with the attribute column_heading. In the latter case the table colunms will have the same order as the keys listed.<<BR>>
The macro can finally also use the definition list from another pagename.<<BR>>
By setting a parser one can use a different parser than moinmoin's default like for example wikimarkup.<<BR>>
With the attribute filter_selection you can use the filter method of the databrowser widget (this needs javascript enabled).<<BR>>
By using a different filter_column_value than the default empty one, eg. name:: Cohen  you get only rows shown where that name was found.<<BR>>
If you want to rename your column titles later on that can be done by adding the dictionary keyword pointing on a page with aliases for your labels as definition list.
With sort_column_name given as list you can sort the table by multiple columns. And sort_reverse=True makes it reverse.
By using the keyword transpose the table is shown transposed. Until transpose is not part
of the databrowser widget itselfs we don't support filter_selection by transpose=True

== Download & Release Notes ==
|| Download || Release Version || Moin Version || Release Notes ||
|| [[http://hg.moinmo.in/moin/extensions/file/tip/data/plugin/macro/CollectLists.py|CollectLists.py]] ||  || 1.8, 1.9  || /ReleaseNotes  ||

== Usage ==
`<<CollectLists[([pagename="page-with-definition-list",][align=({"left"|"center"|"right"}),][column_heading='Key1, Key2,...',][template='template-deflist-depends-on',][transpose=True,][filter_column_value='key:: filter-value',][parser='parsername',][filter_selection='filter-method-of-databrowser-widget'],[search_expression=regex:title:page/],[dictionary=page-with-definition-list-for-column-labels],[sort_column_name=key-or-list-of-keys],[sort_reverse=False])>>`


== Example ==
{{{
<<CollectLists>>
}}}

== Copyright ==
 . @copyright: 2006 by michael cohen <scudette@users.sourceforge.net> (PageDicts)
 . @copyright: 2008-2010 by [[MoinMoin:ReimarBauer]] (completly rewritten)
    
== License ==
GNU GPL, see COPYING for details.

= Bugs =
[[/Discussion]]