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文件里

<?phpfunction my_first_module_menu() {  $items = array();    $items['mypage'] = array(    'title' => '第一个模块 ?? 页面', //菜单项的名称    '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[] 路径

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 函数的一串参数数组，上面例子没用用到，我们稍加修改：

修改后，完整代码如下：

<?phpfunction my_first_module_menu() {  $items = array();    $items['mypage/%/edit'] = array( //修改路径    'title' => '第一个模块 ?? 页面',    '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 .= '<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,

常用几种：

想深入了解，可以打开目录下 /modules/menu/menu.modules文件，然后结合http://www.yoursite.com/?q=admin/structure/menu/manage/navigation，帮助你了解

menu_name

如果你不要把这个菜单项放在Navigation下，就可以在这里指定。譬如：'menu_name' => 'main-menu'，这样就会和Home一起出现在主菜单上

（更多参数，慢慢完善）

??