Menu system / menu module distinction is not obvious to folks new to Drupal [#749992]

Comment	File	Size	Author
#5	749992.patch	1.84 KB	jhodgdon

Comment #1

she/her

English

commented 23 March 2010 at 15:10

Title:	Doc wish with Menu system	» Menu system / menu module distinction is not obvious to folks new to Drupal
Category:	support	» bug

Hmmm...

The Menu System page on http://api.drupal.org/api/group/menu/7 is about menu.inc, which deals with hook_menu() and associated actions. That is, it's about page routing in Drupal (defining paths and what should happen when a visitor goes to that path).

The menu_save() and menu_delete() functions have to do with the Menu module, which is about creating lists of links to be displayed as navigation. So those two functions do not actually belong in the Menu System topic page.

What we should probably do, however, is add something to the Menu System topic page to point new folks to menu.module if they are interested in manipulating navigation menus.

Also, the text here: http://api.drupal.org/api/drupal/modules--menu--menu.module/7 should probably be expanded a bit. For one thing, it should say "navigation menus", and maybe it should point to the menu system topic as well?

Log in or register to post comments

Comment #2

jpsoto commented 23 March 2010 at 19:47

Thanks for your kind answer ...

Indeed, I was aware of such a difference.

I wanted to point up a difficulty to find out how create/delete a menu (container). No docs describe it. I had to look for into the devel module because it creates a custom menu.

Another tip. Seemingly, the proper place to call for menu_save() is the hook_enable; as devel module does it. However, devel module calls for menu_delete() in the hook_uninstall; instead of the hook_disable (counterpart of the hook_enable).

Anyway, thanks for your patience ... JP