Content last modified Tuesday 24 August 2021
hop to #bottom
Categories:
Author:
Current version:
0.3.10
About It:
Get it:
Rate it:
  • Helpful?
  • 11 Yes
  • 0 No
Flag it:

If you'd like to provide updated information and do not have access to directly edit, please contact the site admin; thanks!

cnk_section_tree

This is a section hierarchy / subsection plugin.

Download version 0.3.10: http://www.cnowak.de/works/txp_plugins/cnk_section_tree_v0.3.10.txt
Download compressed 0.3.10: http://www.cnowak.de/works/txp_plugins/cnk_section_tree_v0.3.10_compressed.txt

2009-05-30:
- As of version 0.3.10 the default section will be shown by default when using cnk_breadcrumb and cnk_sec_list. Both tags have an attribute “show_default” which hides the default section when set to “n”
- Users experiencing problems when opening the write tab, may set the CNK_REWRITE_SECTION_DROPDOWN constant to false on the first line of the plugins source code

Note: After you have installed and enabled the plugin, you have to start it’s database install routine on the tab “extensions”->“section_tree”. If you don’t like the plugin, you can always deinstall it on the same page.

Documentation:

Use <txp:cnk_breadcrumb /> to render a breadcrumb menu. Following parameters are accepted by the tag:

param name description accepted values / default value
append_article_title appends the article title (‘y’ ; ‘n’ ; default: ‘n’)
url_pattern defines the href attribute of section links. %s is the section name, %u is site_root_url (string ; default depends on txp’s permlink_mode)
show_default show default section (‘y’ ; ‘n’ ; default: ‘y’)
default_title defines the name of the default section (string ; default: home)

Use <txp:cnk_sec_list /> to render the tree. Following parameters are accepted by the tag:

param name description accepted values / default value
active_section_articles whether to show article list of active section or not (‘y’ ; ‘n’ ; default: ‘n’)
active_section_article_order_by order article list by (‘posted’ ; ‘lastmod’ ; ‘title’ ; default: ‘posted’)
active_section_article_order order article list direction (‘asc’ ; ‘desc’ ; default: ‘asc’)
active_section_article_max_count limit articles. if set to 0, all articles will be rendered (integer ; default: 5)
exclude_sections comma separated list of section names that should not show up in the tree. subsections of excluded sections won’t show up either (‘name1’,‘name2’ ; default: ‘’)
start_section name of section that should be rendered exclusively. subsections will also be rendered (string ; default: ‘’)
css_id id property of the top-level ul tag (string ; default: ‘cnk_sec_tree’)
css_active_section_class class property of active section element (string ; default: cnk_active_section)
css_active_article_class class property of active article element (string ; default: cnk_active_article)
css_article_class class property of all article elements (string ; default: cnk_article)
css_section_class class property of all section elements (string ; default: cnk_section)
css_section_class_open class property of all opened section elements (string ; default: cnk_section_open)
css_section_class_closed class property of all closed section elements (string ; default: cnk_section_closed)
show_article_count show number of articles with status 4 for every section if at least one article exists. (‘y’ ; ‘n’ ; default ‘n’)
show_article_count_bottom show number of articles with status 4 only for bottom sections if at least one article exists (‘y’ ; ‘n’ ; default ‘n’)
exclude_empties don’t show sections, which have no articles with status 4 assigned to it (‘y’ ; ‘n’ ; default ‘n’)
url_pattern_section defines the href attribute of section links. %s is the section name, %u is site_root_url (string ; default depends on txp’s permlink_mode)
url_pattern_article defines the href attribute of article links. %s is a placeholder for the section name, %a is article id, %t is article url_title, %u is site_root_url, %y(ear), %m(month), %d(ay) (string ; default depends on txp’s permlink_mode)
section_append_hmtl appends string right before the closing li tag of a section. same placeholders as url_pattern_section (string ; default ‘’)
article_count_pattern restyle the article count part of section links. %c is placeholder for article count (string ; default ‘(%c)’)
expand_all Expands all section elements. If set to ‘n’ only the active section and its parents will be expanded. (like a file-tree) (‘y’ ; ‘n’ ; default ‘y’)
show_default show default section (‘y’ ; ‘n’ ; default: ‘y’)
default_title defines the name of the default section (string ; default: home)

Compatibility tested with:

plugin name version
sed_section_fields 0.2.112 OK

Additional notes:

The section tree has to be configured in the section tab by simply selecting a parent section for each section.

Currently the plugin does not allow to simply change the order of subsections. (If you want to sort them, just add them to their parents in the order you would like to display them.)

Friendly urls will come in one of the next versions. I’m in contact with Graeme to get his permanent links plugin to work with mine.

This is how it looks like so far:

In the backend section tab there is a dropdown to select parent sections:

The section dropdown in the write view is also replaced by a tree dropdown:

Article Request Count:
Keywords/tags:
Initially released:
14.12.2007
Posted here:
16 Dec 2007

You know you want to visit the Archives.
Published with Textpattern