 readme taxonomy menu readmetxt 13th of april 2009 version 6x23 indytechcook ksc content intro installation new upgrade configuration where to find the configuration screen adjustments and options path types and integration with views module menu path type default menu path type hierarchy menu path type custom integration with other modules taxonomy mangager taxonomy redirect content taxonomy taxonomy breadcrumbs hierarchical select i18n domain access pathauto additional notes prospect to planned functions end content intro this module adds links menu entries to taxonomy terms to the global navigation menu with the current version users can create one group of menu entries and add specific options for each vocabulary more functionality is beeing planned with further versions installation new 1 place this module directory in your modules folder this will usually be sites all modules don t install your module in drupal core s modules folder since that will cause problems and is bad practice in general if sites all modules doesn t exist yet just create it 2 enable the taxonomy menu module in drupal at administration site configuration modules admin build modules the drupal core taxonomy module is required the modules taxonomy menu custom path and taxonomy menu hierarchy provide additional path configuration types see the integration with views module section below 3 create a new vocabulary or edit an excisting one 4 choose which vocabularies to appear in the menu at administration content management taxonomy admin content taxonomy upgrade please read upgradetxt configuration location of configuration screen all configuration options are on the vocabulary s edit screen admin content taxonomy or admin content taxonomy edit vocabulary vid adjustments and options menu select under which menu the vocabulary s terms should appear with the current version users can create one group of menu entries for each vocabulary menu path type select how the url for the term path should be created included are default hierarchy and custom path to use hierarchy and or custom path you need to enable the related modules first menu path type default the path will be taxonomy term while term id will be passed as argument multiple arguments possible this path type uses standard taxonomy display views is not needed for other path types and their options see integration with views module for developers this is extendable using hooktaxonomymenupath see developers documentation for more information http drupalorg node 380652 syncronise changes to this vocabulary if selected the menu will auto update when you change a node or term recommened to always have this selected when you change the generated menu with the core menu function ie move it or change the structure these changes most probably get lost when adding a new taxonomy term because taxonomy menu rebuilds the menu without knowing about the changes made elsewhere display number of nodes displays the number of nodes next to the term in the menu if option display descendants is enabled also descendents will be counted hide empty terms does not create menu links for terms with no nodes attached to them item for vocabulary create a menu link for the vocabulary this will be the parent menu item auto expand menu item enables the expand option when creating the menu links this is useful if using suckerfish menus pull down menus in the primary links display descendants alters the url to display all of child terms tid tid tid tid when this is set the path alias module pathauto is not applied select to rebuild the menu on submit deletes all of menu items and relationships between the menu and terms and recreates them from the vocabulary s terms this will create new mlid s for each item so be careful if using other modules to extend the menu functionality path types and integration with views module menu path type default the path will be taxonomy term while term id will be passed as argument multiple arguments possible this path type can be used without having the views module installed views provides a view named taxonomyterm a view to emulate drupal core s handling of taxonomy term the path of the view is taxonomy term the argument is term id with depth and depth modifier but only term id will be passed as an argument one can adjust this view to ones needs but it might be a problem to have only one view for all all taxonomy menu links so it is recommended to use the option menu path type custom for individual views per vocabulary menu path type custom with this path type one can create individual views for each vocabulary you need to have a view page with path custom path and an argument term id before you create the taxonomy menu enable the option allow multiple terms per argument while adding the argument term id and choose a title like terms other options should be left by default unless really needs to change sth fields and filters can be added and options can be set according to ones needs back to taxonomy menu enter your custom path in the field base path for custom path leave out for example when your view path is interests you enter only interests here to use the display depth in custom path option you need to have taxonomy term id depth modifier as second argument within your view menu path type hierarchy this path type is mainly beeing created for developers use this should only be applied if you have custom code or a block that relies on the category vid tid tid tid if you would like the url to be this path the recomendation is to use pathauto with category vocabraw copathraw use the field base path for hierarchy path to see the base url that will match the veiw or page callback the view or pagecall back must be created before the taxonomy menu how to set up a view for menu path type hierarchy and only for this the vocabulary might be like vocabulary term1 term11 term111 term112 term12 term2 term21 what is needed modules taxonomy menu with taxonomy menu hierarchy and views steps create a view with a path category where the term category can be chosen add fields and filters according your needs add the following arguments vocabulary id title 1 term id title 2 term id title 3 term id title 4 more arguments of this types might be needed if the vocabulary has a greater depth than 3 go to admin content taxonomy select the vocabulary you want to have a menu for select menu where the menu should show up select menu path type hierarchy enter base path for hierarchy path category or what you have chosen as path for view optional display number of nodes auto expand menu item check item for vocabulary do not check display descendants after saving the menu should appear now comes the but most probably you don t see any nodes when klicking the menu items for term1 the path is category vid tid for term111 it is category vid tid tid tid everything behind category will be taken as arguments in views so only those nodes will be shown that are linked to the taxonomy terms term1 and term11 and term111 within the vocabulary it is a logical and function whereas multiple arguments termid termid termid is a logical or function once you have linked your nodes to the taxonomy terms in the described way they will be shown when clicking on the menu items it produces nice breadcrumbs and page titles remember to set the titles for the arguments in views as described and it always displays descendants the only module that supports the saving of a whole term lineage when selecting a deep level item seems to be hierachical select see chapter integration with other modules integration with other modules taxonomy mangager helpful to organize taxonomy terms taxonomy menu module does not interfere with it functions http drupalorg project taxonomymanager taxonomy redirect changes the taxonomy default url to match the custom taxonomy menu path can be controlled by taxonomy redirect http drupalorg project taxonomyredirect content taxonomy it is a nice and very helpful module to link taxonomy terms to nodes taxonomy menu does not interface with the content taxonomy tables so be sure to enable the option save values additionally to the core taxonomy system into the termnode table otherwise the related taxonomy terms will not be accessable for taxonomy menu http drupalorg project contenttaxonomy hierarchical select with submodule hstaxonomy supports the selection of terms in an hierarchical structured vocabulary for using menu path type hierarchy within taxonomy menu the hs options save term lineage and force the user to choose a term from a deepest level should be enabled http drupalorg project hierarchicalselect taxonomy breadcrumbs advanced breadcrumbs can be controlled by this module http drupalorg project taxonomybreadcrumbs menu breadcrumbs helpful to create menu breadcrumps outside the main navigation menu especially when using custom or hierarchical path http drupalorg project menubreadcrumbs i18n at the momement the multiple language support seems to work only when the taxonomy menu option item for vocabulary is disabled domain access pathauto menu items are path alias aware and compatible with pathauto have a look at the various path types which url is passed to the code delault is taxonomy term tid http drupalorg project pathauto additional notes taxonomy menu does not handle the menu call backs it only creates the links to the menus this means that everythign that is displayed on the page including title content breadcrumbs etc are not controled by taxonony menu the router item must be created before taxonomy menu creates the links failure to so so will cause the menu items to not be created router items can be created by either a view or another modules hookmenu prospect to planned functions 6x30 version concept of menu groups any number of menu groups per vocabulary more than one vocabulary within one menu group more options to define the url path other options  