第19章在模块里使用Drupal API

by Benjamin Melancon

制作模块的游戏规则是使用Drupal提供的工具来开发。API代表应用程序编程接口，是一种有趣的方式，它使用已经清楚地定义代码跟用户代码进行交互。本章着重讲解APIs，即Drupal提供给你的钩子（hooks）和函数（function）来构建18章中介绍的X-ray模块。由于模块不同功能特性的需要，有时我们需要使用其他扩展工具（API工具箱以外的），我将会介绍给大家并使用在项目中。

在写本章内容时，Drupal核心提供了251个钩子（hooks）。本章介绍了一些最常用的。钩子（hooks）虽然星光闪耀，但必须作为合奏队的一部分出现在舞台中。你有神奇优秀的实用功能函数的支持。这些功能也是Drupal  API的一部分。

你的模块包含在自身的文件夹中，可以放在Drupal会查找到模块的任何位置，就像你从drupal.org上获取的模块一样。但是，你应该把它放在哪里呢？

你知道你想将它放在sites文件夹中的某个位置，因为你对Drupal发行包所做的每一项自定义的修改都发生在sites目录下。本章遵循将自定义的模块放在“sites/all/modules/custom”里的做法，在第一次放置模块之前，你需要创建这个目录。

注意：当你像第34章中介绍的那样，开始制作自己的发行包时，你可以将模块放置于安装配置文件的目录下。安装配置文件“example_profile”所用到的模块，会被放置在“profiles/example_profile/modules”目录下。

从drupal.org下载的每个模块都可以放到“sites/all/modules/contrib”目录下（正如第4章中关于手动放置模块和通过drush命令下载模块的介绍，一旦你创建了“sites/all/modules/contrib”目录，Drush会自动将从drupal.org下载的模块放置进去）。

原文链接：http://drupal.org/node/70627

这些表格在默认的drupal站点中是被localization（地方化）功能所需要的。请查阅数据库文档来获得更多关于数据库结构和类型的信息。

locale_meta 表格

• 可选择的locale（比如英语）的列表。

locale_source 表格

• 可被翻译的字符串的参考。

locale_target 表格

• 被翻译的的字符串。

原文链接：http://drupal.org/node/70624

以下是一个关于在默认drupal站点中为您管理集成的RSS feeds的表格列表。请参看数据库文档来查阅数据类型和结构的细节。

aggregator_feed 表格

• 储存被定义好的RSS feeds， 每条feeds都是基于URL的。

aggregator_item 表格

• 储存被RSS feeds生成的条目。

aggregator_category 表格

•    用户定义的feeds和feeds条目的类型。

aggregator_category_feed 表格

原文链接：http://drupal.org/node/4739

注意：我们在代码中应用常量，所以一般来说并没有必要知道这些值。您只有在非drupal页面才会需要这些值来在数据库中进行查找。

下面介绍以下表格的status字段。

NODES

• 0：代表没有被发布的。
• 1：代表已经发布的。

COMMENTS

• 0：代表已经发布的。
• 1：代表没有被发布的。
• 2：代表已经被删除的。（drupal4.5以上已经不再采用了）