建立模块请参考 《Drupal 7 模块开发 建立》
如果你要支持中文,文件格式必须保存为 UTF⑻,NO BOM
------------------------------
我们要用自己模块名替换 hook。在这里我们建立1个 my_first_module_menu() 在 my_first_module.module文件里
注意:结尾不要写 ?>
清空Cache,然后访问 http://www.mysite.com/?q=mypage ,会看到下图
(事实上,这时候你访问任何 http://www.mysite.com/?q=mypage/aaa/bbb 都会访问到这个page)
$items[] 路径
- $items先在 [ ] 里定义路径,在访问 /mypage 页面时候,去调用 my_page_view 函数产生页面
-
每个$items都是对应1个路径,写在 [ ] 里。当item用1样路径时候,就调用后写那个$items的。(有文章说和$items里参数weight有关,我测试weight不会影响前后次序)
-
[ ] 里也能够用通配符,比方: [node/%/edit]。详细参见:function hook_menu 里的Wildcards in Paths1段
title 必须
未翻译的主题
title callback
产生主题的函数。默许是 t()。如果你不想翻译,就设置FALSE (所以我们没必要再写
'title' => t('第1个表单'))
title arguments
传递到 t() 或 你自定义函数 的参数。可以和路径组件结合
参考:Menu item title and description callbacks,localization
description
未翻译的说明描写。
page callback
如果不写,父菜单的回调函数将代替履行。也就是说 $items['mypage'] 和 $items['mypage/child'] 会履行1样内容。
有1个特别回调函数 drupal_get_form(),这个将在后面 Drupal 7 模块开发 建立、验证、提交表单(Form) 具体讲
page arguments
传递给 page callback 函数的1串参数数组,上面例子没用用到,我们略加修改:
- 修改1下 $items,路径成为 $items['mypage/%/edit'],意思是当访问 mypage/1/edit,或 mypage/2/edit 等,履行此函数
- 添加 page arguments:'page arguments' => array('hello',1),
‘hello' 作为1个常量传给 $arg1
1 表示路径mypage后面第1层:当你访问 mypage/1/edit 时候,返回就是 1;如果你访问 mypage/world/edit,返回就是world - 给函数 my_page_view增加传递参数, function my_page_view($arg1,$arg2)
<?PHP function my_first_module_menu() { $items = array(); $items['mypage/%/edit'] = array( //修改路径 'title' => '第1个模块 ―― 页面','description' => '我的第1个模块页面','page callback' => 'my_page_view','page arguments' => array('hello',//添加参数 'access callback' => TRUE,'type' => MENU_norMAL_ITEM,); return $items; } function my_page_view($arg1,$arg2) { //添加参数传递 $output = t('这是模块做的第1个页面。'); $output .= '<br />' . $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_ITEM1样,只是默许状态是disabled的,需要管理员去手工Enabled
- MENU_CALLBACK 不会产生菜单和面包屑(Breadcrumbs)。只是简单注册1个路径,当路径被访问时,履行相应功能。通常是被API调用。
- MENU_LOCAL_ACTION 在父菜单里,显示1个link,引导下步操作。比方:添加1个菜单
- MENU_LOCAL_TASK 也是作为1个link,不过通常是以标签(TAB)格式显示
- MENU_DEFAULT_LOCAL_TASK 和 MENU_LOCAL_TASK 1样是标签(TAB),不过是默许标签,和父菜单路径1样(这个itmes的路径只是表达是父菜单)
想深入了解,可以打开目录下 /modules/menu/menu.modules文件,然后结合http://www.yoursite.com/?q=admin/structure/menu/manage/navigation,帮助你了解
file
在页面回调前,这个文件已被包括。允许页面回调函数在另外一个分开的文件里。除非这个在“file path”已指定路径,否则这个文件在履行模块的同1个目录里。这个文件不合适其他回回调(call back),只适用于 page callback
file path
这是指定file所在目录。默许路径是当前模块履行hook所在路径
menu_name
如果你不要把这个菜单项放在Navigation下,就能够在这里指定。比方:'menu_name' => 'main-menu',这样就会和Home1起出现在主菜单上
(更多参数,渐渐完善)
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。