首页 » 编程与开发 » 模块开发指南 » 模块编写教程 » 模块编写教程-5.x

04. 声明我们的区块内容

主要内容描述：区块内容
Drupal"钩子“描述：hook_block

有这样几类模块：区块模块和节点模块是其中的两个。区块模块一般（但不总是，也不是必须）建立简短内容并显示在页面左右两边。节点模块生成整页内容（例如blog，论坛或书籍页面）。

我们将从建立一个区块内容开始，之后再讨论节点模块，还有过滤内容。一个模块不仅可以为区块可以生成内容，也可以生成一整页的（blog模块就是一个好例子）。区块模块的钩可以被更确切的叫做区块，所以开始我们的下一个函数：

<?php
/**
* Generate HTML for the onthisdate block
* @param op the operation from the URL
* @param delta offset
* @returns block HTML
*/
function onthisdate_block($op='list', $delta=0) {

} // end function onthisdate_block
?>

区块函数可以有两个参数：作用（operation）和弥补（offset, or delta）。弥补参数可以让你在同一个区块函数里为不同的区块建立不同的内容。现在我们将只关心作用参数。具体的，我们只关心区块被列在区块页面这个特殊的情况。在所有其他情况下，我们将显示区块内容。

当模块被列在区块页面时，$op（作用参数）的值应为'list'：

<?php
/**
* Generate HTML for the onthisdate block
* @param op the operation from the URL
* @param delta offset
* @returns block HTML
*/
function onthisdate_block($op='list', $delta=0) {
  // listing of blocks, such as on the admin/block page
  if ($op == "list") {
     $block[0]["info"] = t('On This Date');
     return $block;
  }

} // end onthisdate_block
?>

下面，我们将来生成区块内容。

关于帮助钩的更多信息：
Drupal HEAD

原文：http://drupal.org/node/82955

»