Tree Module

Navigation in tree form

The 'Tree' module shows the jDownloads Categories in a tree like scheme.  It gives a visual representation of the category organisation. The Tree module was released with  jDownloads 3.2 v34.

As illustrated later the view may be arranged to exclude certain branches or part of a branch of the tree.  Also it may restrrict the view to selected branches. In this 'include' option it must give a branch explicitly starting at a top level category. If the view is restricted by the 'exclude' or 'include' options then the Overview link is not shown (from jD3.2 v45 and higher).

The initial Public view using the default module setup is typically as shown in the first picture opposite.

As usual clicking on the + symbol gives an expanded view.

The only Categories shown when not logged in are those that have Public or Guest View Access Level.

Tree01Tree01A

After logging in then the module shows all of the categories for which the user group has view access. 

Note that if partway down a branch a Category becomes 'invisible' because of a change in View Access Level then the branch will stop at that point.

 

Tree02

The picture opposite shows the effect of enabling the 'Display number of Subcategories', 'Display number of Downloads' and the 'View zero values?' options.

Note the use of ( ) and [ ] to denote number of sub categories and number of Downloads in the currebt and subsequent subcategories.

This assists recognition when only one type is shown. See also below on enabling Tooltips

Tree03

A feature of the tree, in common with other modules, is that the links are active.  So clicking a link will show details in the main content area.

The only category that is not linked is the one that is currently being shown in the main content area. With the default css the links are shown in blue text and the active on is in black text

This does not have to have come from the Tree module, it could be from another module, from a jDownloads menu item, or from a content link.

 Tree04
The module has an option to show tooltips for the number of Categories and Downloads in the current category and its subcategories.  Tree05
For sites with a significant depth of categories it is useful to have the ability to limit the depth. Tree08A

One of the most useful abilities is to only include specific branches of the tree.

Note that any branch must be specified in full, starting at a top level category.

Basically you need to list out the individual category branches you wish to 'include'

If the view is restricted by the 'exclude' or 'include' options then the Overview link is not shown (from jD3.2 v45 and higher).

 Tree06

A convenient way to see what has been selected and its relationship to other categories is to look at the pulldown list.

All selected categories are shown in less intense grey text.

 Tree06A

 This does not override any View Access Levels.  For example if all the Categories in the selected Branches have Registered as the Access Level then a user who is not logged in will not see any part of the Tree module. Even the module title is not shown!

Note: In Joomla! one can make multiple copies of a module each with its own name and configuration.  By setting the Access Level then different views can be shown for different Access Levels.

 tree16A

Multiple Branches may be setup, such as shown below.  This gives the views as shown opposite.Tree06E

 

 

tree17tree18
 The converse is the Exclude filter option.  The listed categories and all their subsequent sub categories are excluded from the view.  The listed categories may be anywhere in the tree.  Tree07
   tree19

Colin Mercer, June 2015

  • Thursday, 25 June 2015