drupal爱好者 drupal教程|drupal模块|drupal中文的网站

Drupal钩子（hook）描述: hook_help()
在drupal模块中写注释
在模块中写注释是一个好习惯。下面的注释对于任何看到你代码的人都会感觉很清晰。
<?php
/**
* @file
* A block module that displays recent blog and forum posts.
*/
?>
@file 意味着这段注释是针对整个文件的。

摘要：.info文件

所有的模块必须有一个'modulename.info'文件, 它包含了模块的基本信息。

一般的格式如下：

name = Module name
description = A description of what your module does.
core = 7.x

对于我们教程中的实例的模块，我们将用current_posts来代替modulename。如果

没有.info文件，模块不会显示在模块列表里。以下是实例模块的内容

name = Current posts
description = A block module that lists links to recent posts.

core = 7.x

增加一个名字为current_posts.info的源文件，并且将此文件放在目录

sites/all/modules/current_posts下。

注意：如果你拷贝或者粘贴这个上面的代码，要确保描述数据中不包含换行。否

则，.info文件不会被正确解析。

摘要：模块文件名和模块所在位置

本系列介绍怎么创建一个初始的模块文件和目录。

命名你的模块

创建模块的第一步是先给模块起一个简称。这个简称因为将要用在你模块所包含的所有文件和函数里面，所以，简称必须以字母开头，并且只能包括小写字母和下划线。对于本教程，我们将选择"current_posts"作为模块简称。

注意：你一定要遵守这些建议，不要用大写字母在你的模块简称里，因为模块简称将用于模块的文件名字和某个函数的前缀。当你执行一个drupal钩子（钩子将会在后面的教程里介绍）的时候，drupal将会认出你的钩子函数，如果这些钩子跟模块文件名有相同的函数名前缀。

还有一点也很重要，就是你的模块的简称不能跟任何你站点正在用的主题有相同的简称。

创建一个文件夹和一个模块文件

本教程将会教你如何在drupal7下创建一个模块-module

如果你的目的是将drupal6或者更早版本的drupal模块转化成drupal7版本的，请参考：http://drupal.org/update/modules

模块(module)：指的是一系列函数的集合体，模块将drupal连接起来，并且在drupal安装时提供了附加的功能。读完这个教程，你将可以建立一个基本的block模块，并且可以把它当做更多高级模块的一个模板。

这个教程不准备教你为公共的发布程序写模块。教程也不会包括缓存，或者权限、代码安全方面的议题。这个教程仅仅作为一个切入点，可以扩展你用其他资源的技能。

本教程假设你掌握了以下方面的知识

基本的PHP知识，包括语法和一些PHP对象的概念
基本的关于数据表，数据字段，数据记录和SQL语句的相关知识
安装好一个drupal7
drupal的超级管理员权限
可以访问web服务

本教程假设你没有drupal模块方面的认识知识。