您好,欢迎访问一九零五行业门户网

Drupal 7 模块开发 建立模块 第一个页面(hook_menu)_html/css_WEB-ITnose

建立模块请参考 《drupal 7 模块开发 建立》
如果你要支持中文,文件格式必须保存为 utf-8,no bom
------------------------------
hook_menu 定义菜单项和页面反馈。
我们要用自己模块名替换 hook。在这里我们建立一个 my_first_module_menu() 在 my_first_module.module文件里
'第一个模块 页面', //菜单项的名称 'description' => '我的第一个模块页面', //当鼠标移动到菜单项,显示菜单的说明 'page callback' => 'my_page_view', //产生页面内容 'access callback' => true, //所有人都能访问 'type' => menu_normal_item, //菜单项显示类型 ); return $items;}function my_page_view() { $output = t('这是模块做的第一个页面。'); return $output;}
注意:结尾不要写 ?>
清空cache,然后访问 http://www.mysite.com/?q=mypage ,会看到下图
(事实上,这时你访问任何 http://www.mysite.com/?q=mypage/aaa/bbb 都会访问到这个page)
$items[] 路径
$items先在 [ ] 里定义路径,在访问 /mypage 页面时候,去调用 my_page_view 函数产生页面 每一个$items都是对应一个路径,写在 [ ] 里。当item用一样路径时候,就调用后写那个$items的。(有文章说和$items里参数weight有关,我测试weight不会影响先后次序)
[ ] 里也可以用通配符,譬如: [node/%/edit]。详细参见:function hook_menu 里的wildcards in paths一段
title 必须
未翻译的主题
title callback
产生主题的函数。默认是 t()。如果你不想翻译,就设置false (所以我们不必再写 'title' => t('第一个表单'))
title arguments
传递到 t() 或者 你自定义函数 的参数。可以和路径组件结合
参考:menu item title and description callbacks, localization
description
未翻译的说明描述。
page callback
当用户访问页面路径的时候,调用一个显示网页的函数。
如果不写,父菜单的回调函数将代替执行。也就是说 $items['mypage'] 和 $items['mypage/child'] 会执行一样内容。
有一个特别回调函数 drupal_get_form(),这个将在后面 drupal 7 模块开发 建立、验证、提交表单(form) 具体讲
page arguments
传递给 page callback 函数的一串参数数组,上面例子没用用到,我们稍加修改:
修改一下 $items,路径成为 $items['mypage/%/edit'],意思是当访问 mypage/1/edit,或者 mypage/2/edit 等,执行此函数 添加 page arguments:'page arguments' => array('hello', 1),
‘hello' 作为一个常量传给 $arg1
1 表示路径mypage后面第一层:当你访问 mypage/1/edit 时候,返回就是 1;如果你访问 mypage/world/edit,返回就是world 给函数 my_page_view增加传递参数, function my_page_view($arg1, $arg2) 修改后,完整代码如下:
'第一个模块 页面', 'description' => '我的第一个模块页面', 'page callback' => 'my_page_view', 'page arguments' => array('hello', 1), //添加参数 'access callback' => true, 'type' => menu_normal_item, ); return $items;}function my_page_view($arg1, $arg2) { //添加参数传递 $output = t('这是模块做的第一个页面。'); $output .= '
' . $arg1 . ' ' . $arg2; //打印参数 return $output;}
清空cache,然后访问 http://www.mysite.com/?q=mypage/world/edit ,会看到下图
access callback
如果有访问这页权限,就要返回true,否则就false(如果不写,默认是false)。如果false,页面就会出现 access denied 提示。
type
描述菜单项属性的代码。许多快捷代码的常量在 menu.inc 里。
我们这里用了默认项 menu_normal_item,所以$items里可以不写 'type' => menu_normal_item,
常用几种:
menu_normal_item,显示在navigation菜单列表下,管理员可以拖动或隐藏 menu_suggested_item,和menu_normal_item一样,只是默认状态是disabled的,需要管理员去手工enabled menu_callback 不会产生菜单和面包屑(breadcrumbs)。只是简单注册一个路径,当路径被访问时,执行相应功能。通常是被api调用。 menu_local_action 在父菜单里,显示一个link,引导下步操作。譬如:添加一个菜单 menu_local_task 也是作为一个link,不过通常是以标签(tab)格式显示 menu_default_local_task 和 menu_local_task 一样是标签(tab),不过是默认标签,和父菜单路径一样(这个itmes的路径只是表达是父菜单) 想深入了解,可以打开目录下 /modules/menu/menu.modules文件,然后结合http://www.yoursite.com/?q=admin/structure/menu/manage/navigation,帮助你了解
menu_name
如果你不要把这个菜单项放在navigation下,就可以在这里指定。譬如:'menu_name' => 'main-menu',这样就会和home一起出现在主菜单上
(更多参数,慢慢完善)
其它类似信息

推荐信息