Module: menutree 2.2
Author: Pawel Preneta <jusuff@jabster.pl>
Url: http://code.zikula.org/bianor
Released: 13.11.2009
PURPOSE
-----------------
Module "menutree" has no functionalities - serves only as the "container" for the block. Bellowed description concerns only the block functionality.
MENUTREE BLOCK
-----------------
Menutree block allows to create multilevel, hierarchical menu. You can manage this block by "drag&drop" method.
REQUIREMENTS
-----------------
This version of "menutree" module requires Zikula 1.2
Moreover module and block requires prototype.js library and scriptaculous "familly" (scriptaculous.js, effects.js ,dragdrop.js). You can find these files in standard Zikula package in "javascript/ajax" directory.
INSTALLATION
-----------------
1. Extract the files to your Zikula directory.
2. Regenerate modules list in the admin page
3. Initialize and activate the "menutree" module
Now you can add "menutree" block
USAGE
-----------------
To add a block follow the standard procedure: in administration panel choose Block -> New block -> menutree/Treelike menu (menutree).
Until first element in menu is created one have possibility to import one of existing menus ("menu", "extmenu" and "menutree"). If in menu, which will be imported, option "Display modules" was marked - links to all modules will be also imported.
Managing this block is possible by "drag&drop" method.
"Menutree" block allows to use well-know shorthands for modules link: [Module] or {Module}.
Menu generated by this block is unordered list (build by "ul" and "li" tags), obviously respecting structure build during block edition.
Package contains also two example templates:
"menutree_block_menutreeext.htm", which shows how to format vertical dropdown menu.
"menutree_block_vertical.htm" - expample of vertical dropdown menu,
"menutree_block_tree.htm" - expample of "tree-like" menu (similar to that in the admin panel, with the possibility for expanding and collapsing), this template uses javascript.
If you're looking for interesting templates for menutree block - visit the BlankTheme project site (http://code.zikula.org/blanktheme/).
PERMISSIONS
-----------------
Permissions schema used by block "menutree" is the same as standard (core) menu: one can define permissions for all block (giving the block title) or only for single element (giving the link name). Permissions define for element are inherited by its subelements.
The permission schema is as follows
Component: menutree:menutreeblock:
Instance: Block title:Link name:
The following are the relevant permissions you can set and what they do
NONE block or element wont be displayed
READ block or element will be displayed
Example:
Group Component Instance Permission:
-------------------------------------------------------------------------------------
Unregistered menutree:menutreeblock: Menu:: NONE
All groups menutree:menutreeblock: Menu:Administration: NONE
First rule will hide block titled "Menu" from unregistered users.
Second rule will hide element "Administration" (and all of it subelements - if there are subelements) from all groups.
