Dbt: Hilfe für KategorieBaum eingefügt, muss noch eingedeutscht werden, Funktion ist sehr Hilfreich für Sidebars!!!

2008-02-17T16:02:20Z

Hilfe für KategorieBaum eingefügt, muss noch eingedeutscht werden, Funktion ist sehr Hilfreich für Sidebars!!!

Neue Seite

== Usage ==
CategoryTree can be used in three ways: directly on the category pages, as a "custom tag" (or "parser function") to show a category structure in-line on a wiki page, and as a special page.

The CategoryTree extension adds <nowiki>[+]</nowiki> "expand" widgets to the subcategories listed on category pages. If Javascript is disabled, those widgets just do nothing.

:'''''Note to bot users:''' bots and scripts that parse the HTML of category pages can use the <tt>notree</tt> URL parameter to force the traditional output. However, HTML output is generally not stable, so it is recommended to change your script to use <tt>[[Extension:Query|query.php]]</tt> or <tt>[[Manual:api.php|api.php]]</tt> to fetch category listings and similar.''

=== The <categorytree> tag ===
Example:<pre><categorytree mode=pages style="float:right; clear:right; margin-left:1ex; border:1px solid gray; padding:0.7ex; background-color:white;">Manual</categorytree></pre>
<categorytree mode=pages style="float:right; clear:right; margin-left:1ex; border:1px solid gray; padding:0.7ex; background-color:white;">Hilfe</categorytree>
The custom tag is called <categorytree>. For example, if you put
<categorytree>Foo</categorytree> on a wiki page, it will show the contents
of category Foo as a dynamic tree on that page (see example to the right). The tag accepts the following
attributes, using a HTML-like syntax:

;mode: can be "categories", "pages" or "all" - see the ''[[#Modes|Modes]]'' section below for the meaning of each. The default for this attribute is controlled by <tt>$wgCategoryTreeDefaultMode</tt>, and is initially set to <tt>CT_MODE_CATEGORIES</tt>, the equivalent of setting the mode attribute to "categories".
;depth: determines how many levels of the tree are shown initially. Default is 1, 0 means only the root node. The maximum value depends on the mode specified, and on the $wgCategoryTreeMaxDepth option. ''(introduced between [[rev:r20410]] and [[rev:20840]], Mar 30 2007)'' - '''note:''' depth values greater than 1 do not (yet) work with $wgCategoryTreeDynamicTag enabled!
;onlyroot: set this to "on" to only show the "root" node of the tree initially. Equivalent to depth="0". ''(introduced in [[rev:20385]], March 13 2007)''
;hideroot: set this to "on" to hide the "root" node of the tree, i.e. the mention of category Foo from the example.
;style: can be used to specify any CSS styles you would like for the tree.

=== The <nowiki>{{#categorytree}}</nowiki> parser function ===
Since [[rev:25825]] (2007-9-13), you can also use ''parser function'' syntax to place a category tree on a page. This works just like the <categorytree> tag, using a different syntax, e.g. <tt><nowiki>{{#categorytree:Foo}}</nowiki></tt>; options can be specified using the syntax for named template parameters, e.g. <tt><nowiki>{{#categorytree:Foo|hideroot|mode=pages}}</nowiki></tt>.

Using the parser function syntax has the advantage that it allows you to use magic words, templates and template parameters when specifying the category to show. Some examples:
* Using a magic variable to show "this pages" category tree (may be useful on category description pages): <tt><nowiki>{{#categorytree:{{PAGENAME}}}}</nowiki></tt>.
* Using a template to specify the category: <tt><nowiki>{{#categorytree:{{root category}}}}</nowiki></tt> - the name of the root category would be defined by the contents of Template:Root_category.
* Using a template parameter to specify the category, when using CategoryTree inside a template: <tt><nowiki>{{#categorytree:{{{1}}}}}</nowiki></tt> in Template:Baz can be called using <nowiki>{{Baz|Foo}}</nowiki>

=== The Special:CategoryTree page ===

The special page is called Special:CategoryTree; there you can enter the
name of a category and then browse its content. The CategoryTree
extension also adds a tab for this special page to every category page.

=== Modes ===
The category tree can be shown in different modes, determining what types of "leaves" the "tree" has:
* '''categories''' (constant <tt>CT_MODE_CATEGORIES</tt>): show subcategories only
* '''pages''' (constant <tt>CT_MODE_PAGES</tt>): show subcategories and pages, except images
* '''all''' (constant <tt>CT_MODE_ALL</tt>): show all pages, subcategories, images, etc

The CT_MODE_XXX constants can be used with configuration options (see below).

== Weblinks ==

*[[MW:Extension:CategoryTree#Usage|see more at Mediawiki Usage of CategoryTree]]

Hilfe:CategoryTree - Versionsgeschichte

Dbt: Hilfe für KategorieBaum eingefügt, muss noch eingedeutscht werden, Funktion ist sehr Hilfreich für Sidebars!!!