1.1 Drupal页面开发案例1 - 项目列表页

本文从一个网站页面实例出发，讲解drupal是如何处理呈现一个页面的。http://www.qingfan.com/zh/project_list 这个是项目列表页面。 首先在drupal中我们要定义一个页面，是使用hook_menu()钩子函数，假定我们是在模块：custom_project里定义，代码见辅助内容区：

我们先来简单解析下代码： 大家看到函数的命名格式是：模块名_menu()，每个模块都可以以这样的方式来定义页面被drupal识别。 然后project_list就是我们要定义的页面地址，到最后访问时，就是：域名/project_list这样。 title参数是定义页面的标题，page callback是指定页面的回调函数，file参数是指定回调函数所在的文件，access callback是指定该页面的访问权限的回调函数，也可以直接赋予TRUE表示任何人都可访问。type参数是声明页面的类型，MENU_CALLBACK就是最常用的类型，其它的这里暂不予详细介绍。

/**
 * Implements hook_menu().
 */
function custom_project_menu() {
  // 项目列表页面
  $items['project_list'] = array(
    'title' => '项目列表',
    'page callback' => 'project_list',
    'access callback' => TRUE,
    'type' => MENU_CALLBACK,
    'file' => 'custom_project.pages.inc',
  );

  return $items;
}

 

然后我们去custom_project.pages.inc文件里（若没有就创建一个，就在模块根目录下）定义这个回调函数，代码见辅助内容区：

写好后，清除下drupal的缓存即可生效（模块要保证已启用哦），访问下project_list页面，就会看到中间主要内容部分显示了你在页面回调函数里返回的内容。 这里实验如果没没问题的话，我们接着往下： 按照这个页面的设计，我们要在回调里返回的内容应该有：1.banner，2.项目查询表单，3.项目列表结果。（页面的header和footer部分是全站统一的设计，我们就将其放在全局的header.php和footer.php了，然后在页面模版里将其include引入即可） 内容还是不少的，所以我们准备定义一个模版来让前端先把前端部分做好。

 

/**
 * Page callback of menu - 'project_list'.
 */
function project_list() {
  $output = '';

  $output .= '这里是项目列表页面的内容';

  return $output;
}

 

如何定义一个新模板呢？要先介绍下drupal的hook_theme钩子函数，它可以让我们来声明新的主题来指定模版，废话少说先上代码示例（见辅助内容区）：

我们定义了一个新的主题叫project_list，然后给主题定义了一个可用变量叫projects，就是项目列表的数据，然后通过template参数指定了一个模版文件。这个路径是相对于当前模块的，我们在drupal当前启用的主题里也放一个这个模版来使用即可。文件名叫：project-list.tpl.php。 我们先让前端去在这个模版里添加前端代码。 

/**
 * Implements hook_theme().
 */
function custom_project_theme() {
  return array(
    'project_list' => array(
      'variables' => array('projects' => NULL),
      'template' => 'templates/project-list'
    ),
  );
)

 

回到我们的页面回调函数，我们需要改成调用这个主题模版来返回显示内容，代码见辅助内容区：

我们通过theme函数调用了project_list主题，并传入了projects变量的值，这样在project-list.tpl.php模版文件里就可以使用projects变量了，等前端完成工作，我们就套用即可。

/**
 * Page callback of menu - 'project_list'.
 */
function project_list() {
  $output = '';

  // 获取项目列表数据
  $projects = array();  

  $output .= theme('project_list', array('projects' => $projects));

  return $output;
}

 

本书共8小节。


评论 (0)