放牧代码和思想
专注自然语言处理、机器学习算法
    恕不接待索要源码语料者、索求技术方案者、以及不Google的懒人。

Drupal专业开发指南学习笔记1 第一段代码 实现一个钩子

算是Drupal的HelloWorld吧,我对其做了中文注解:

<?php
// $Id$
/**
 * @file
 * Administration page callbacks for the annotate module.
 */
/**
 * Form builder.
 * Configure annotations.
 *
 * @ingroup forms
 * 
 * @see system_settings_form().
 *
 */
function annotate_admin_settings ()
{
    // Get an array of node types with internal names as keys and
    // "friendly names" as values. E.g.,
    // array('page' => 'Page', 'story' => 'Story')
    // 通过好懂的键值命名节点类型
    $options = node_get_types('names');//node_get_types函数是一个非常重要的drupal函数。这个函数的作用是:得到节点的类型和名字
    $form['annotate_node_types'] = array(
            '#type' => 'checkboxes',
            '#title' => t('Users may annotate these content types'),//在Drupal中所有的字符串都应该使用t()函数封装;它是Drupal的翻译函数,由于经常使用,为了方便,所以将其函数简写为“t”
            '#options' => $options,
            '#default_value' => variable_get('annotate_node_types',//当你的模块取回已存储的设置时,应该使用variable_get(),variable_get($name, $default = NULL) 
                    array(
                            'page'
                    )),
            '#description' => t(
                    'A text field will be available on these content types to make user-specific notes.')
    );
    return system_settings_form($form);
}
<?php
// $Id$
/**
 * @file
 * Lets users add private annotations to nodes.
 *
 * Adds a text field when a node is displayed
 * so that authenticated users may make notes.
 */
/**
 * Implementation of hook_menu().
 */
function annotate_menu ()
{
    $items['admin/settings/annotate'] = array(        //items数组是被聚合器aggregator用到的,
                                                      //定义于globals.php, line 236,全局变量
            'title' => 'Annotation 设置',
            'description' => 'Change how annotations behave.',
            'page callback' => 'drupal_get_form',
            'page arguments' => array(
                    'annotate_admin_settings'
            ),
            'access arguments' => array(
                    'administer site configuration'
            ),
            'type' => MENU_NORMAL_ITEM,
            'file' => 'annotate.admin.inc'
    );
    return $items;
}

如果是Drupal7的话,可能会得到一个Fatal error:  Call to undefined function node_get_types() in \drupal\sites\all\modules\custom\annotate\annotate.admin.inc on line 22

这是因为drupal6和drupal7中有许多函数发生了改变。drupal6中node_get_types('names')对应dupal7中的node_type_get_names('names')更多详情参考:http://drupal.org/node/1121648

知识共享许可协议 知识共享署名-非商业性使用-相同方式共享码农场 » Drupal专业开发指南学习笔记1 第一段代码 实现一个钩子

分享到:更多 ()

评论 欢迎留言

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

我的开源项目

HanLP自然语言处理包基于DoubleArrayTrie的Aho Corasick自动机