Missing documentation for MENU_LOCAL_ACTION in hook_menu() [#649820]

It appears that docs weren't added to hook_menu() to describe the MENU_LOCAL_ACTION type constant.

The attached patch adds the description used in the constants API page: http://api.drupal.org/api/constant/MENU_LOCAL_ACTION/7

Comment	File	Size	Author
#3	649820-hook_menu_menu_local_action_docs-rev3.patch	1.26 KB	brianV
#1	649820-hook_menu_menu_local_action_docs-rev2.patch	1.06 KB	brianV
	hook_menu_menu_local_action_docs.patch	906 bytes	brianV

Comments

Comment #1

brianV commented 3 December 2009 at 04:44

Status	File	Size
new	649820-hook_menu_menu_local_action_docs-rev2.patch	1.06 KB

Improved the MENU_LOCAL_TASK description to hopefully make the difference between tasks and actions a little clearer.

The naming scheme is a WTF in it's own right, but I'll save that for #607656: rename one/both of MENU_LOCAL_ACTION / MENU_LOCAL_TASK.

Comment #2

jhodgdon

she/her

English

commented 3 December 2009 at 17:07

Status:

Needs review

» Needs work

Why take out the information about them being displayed as tabs?

Comment #3

brianV commented 4 December 2009 at 15:37

Status:

Needs work

» Needs review

Status	File	Size
new	649820-hook_menu_menu_local_action_docs-rev3.patch	1.26 KB

Added the info about TASKs being rendered as tabs, and tried to add similar about ACTIONS:

 *     - MENU_LOCAL_ACTION: Local actions are menu items that describe actions
 *       on the parent item such as adding a new user or block, and are
 *       rendered in the action-links list in your theme.
 *     - MENU_LOCAL_TASK: Local tasks are menu items that describe different
 *       displays of data, and are generally rendered as tabs.

I couldn't come up with better wording for Actions, since where and how the action-links list is rendered can and likely will vary much by theme.