 readme  id readmetxt v 114 20100322 191936 johnalbin exp adding menu blocks to add new menu blocks use the add menu block tab or button on the administer blocks page admin build block you will then be able to configure your menu block before adding it configuring menu blocks when adding or configuring a menu block several configuration options are available block title for menu trees that start with the 1st level the default block title will be the menu name for menu trees that start with the 2nd level or deeper the default block title will be the title for the parent menu item of the specified level for example if the active menu trail for the navigation menu is administer site building menus primary links then a menu block configured to start with the 1st level of the navigation will display a block title of navigation and a menu block configured to start with the 3rd level of the navigation menu will display a block title of site building block title as link for menu trees that start with the 2nd level or deeper the default block title will be the title for the parent menu item of the specified level if this option is checked the block title will be a link to that menu item administrative title to help identify the block on the administer blocks page you can specify a unique title to be used on that page if blank the regular title will be used parent item first select the menu then select the parent item from that menu the tree of links will only contain children of the selected parent item starting level blocks that start with the 1st level will always be visible blocks that start with the 2nd level or deeper will only be visible when the trail to the active menu item is in the block s tree make the starting level follow the active menu item if the active menu item is deeper than the level specified above the starting level will follow the active menu item otherwise the starting level of the tree will remain fixed maximum depth from the starting level specify the maximum depth of the tree blocks with a maximum depth of 1 will just be a single unnested list of links with none of those links children displayed expand all children of this menu will be expanded sort sort each item in the active trail to the top of its level when used on a deep or wide menu tree the active menu item s children will be easier to see when the page is reloaded styling menu blocks classes themers should look at the myriad of classes added to the and elements the wrapped around the menu tree has a class for several of the configurable options of the block menublock block id number menuname menu name parentmlid menu link id menulevel level number the elements of the menu tree can have an extended list of classes compared to standard menu trees first last menumlid menu link id haschildren active activetrail the elements of the menu tree can have active activetrail templates in addition the wrapper for the block is generated using the menublockwrappertplphp template and menu block provides several theme hook suggestions for that template menublockwrapper block id number tplphp menublockwrapper menu name tplphp for example a file in your theme called menublockwrapperprimarylinkstplphp can be used to override the for just the primary links menu blocks theme functions menu block uses drupal core s menu theme functions however it also provides theme hook suggestions that can be used to override any of the theme functions called by it thememenutree can be overridden by creating one of theme menutreemenublock theme menutreemenublock menu name theme menutreemenublock block id number thememenuitem can be overridden by creating one of theme menuitemmenublock theme menuitemmenublock menu name theme menuitemmenublock block id number thememenuitemlink can be overridden by creating one of theme menuitemlinkmenublock theme menuitemlinkmenublock menu name theme menuitemlinkmenublock block id number for example if you created a garlandmenutreemenublock function it would override thememenublock any time it was used by this module but not when used by any other module similarly a garlandmenuitemmenublock1 function would override thememenuitem but only for the first menu block in your system the menu block with an id of 1 menu block api developers can use the api of this module to create their own menu trees outside the confines of blocks all of the publicly available api functions are documented in the menublockmodule file in addition menu block implements hookgetmenus and hookmenublocktreealter see menublockapiphp for documentation  