Menu Descriptions (menu_descriptions) ************************************* Ever wanted to create a menu that had more than just menu names? This module extends Drupal's menu system by allowing you to attach a full description to a menu item, which can then be displayed along with the menu using menu blocks that the module provides. Use this to give users more direction as to what menu options do what. Because this is an add-on to the menu system, menu blocks obey all access control, so that the links and descriptions that are generated are 'dynamic' depending of the user's permissions. A new checkbox is added to the menu edit form to indicate that a Menu Descriptions block should be generated for that menu, and a new text field is added to menu item edit forms for the longer description. Installation ~~~~~~~~~~~~ Install menu_descriptions like any standard Drupal 6 contrib module. Place its directory under sites/all/modules, and then enable the module. Note that this module required the Menu module to be installed. Configuration ~~~~~~~~~~~~~ To use enable a menu for menu descriptions, edit that menu, and check the "Create a menu descriptions block for this menu". A new block will appear in the blocks UI that can be place like any other block. Then, edit each menu item for that menu, scroll down to the "Longer description" text box, and enter your description / instruction text there. Place your block in the region you want, with the appropriate visibility settings for your needs, and that's it - you're done! Theming ~~~~~~~ There are three theme functions for themers: - theme_menu_descriptions_menu(array $tree) Themes the entire menu tree with descriptions. The $tree array is the standard menu tree produced by menu_tree_all_data with a depth of one, and with the menu description added to each menu item. Note the menu description is an object that has both the description text and the text / input format. So, each element of the $tree array looks like [link] => array - standard link stuff, [below] => standard, and not used in the theming, [menu_descriptions] => object [description] => string - the description, [format] => string - the input / text format of the [description] - theme_menu_descriptions_link(array $link) Called by theme_menu_descriptions_menu and themes the links. Gets passed the [link] element of the menu item. - theme_menu_descriptions_description(object $description, string $class) Also called by theme_menu_descriptions_menu and themes the description portion itself.

Shawn Sheridan
authored
Name | Last commit | Last update |
---|---|---|
README.txt | ||
menu_descriptions.info | ||
menu_descriptions.install | ||
menu_descriptions.module |