亚洲一区二区三区四区五区中文,中文字幕在线第一页,精品国产一区二区三区久久久樱花

Drupal5.x创徏自定义模块指南－02把你的模块告知Drupal�pȝ��(Creating modules - a tutorial: Drupal 5.x �Q�－02. Telling Drupal about your module)

Tue, 27 Mar 2007 01:32:00 GMT

[��译:陈市�?摘自:http://drupal.org/node/82926]
�?.x中，你模块的基本信息不再是通过函数hook_help提供�l�Drupal�Q�而是在info文�g定义name和description卛_��Q�具体格式参见info文�g指南�Q�。在我们的例子中�Q�该文�g为onthisdate.info
通常格式如下�Q?br />

; $Id$
name = Module Name
description = "A description of what your module does."

如果没有�q�个文�g�Q�则drupal不能在模块安装的时候找到该模块�?br />在我们的例子中，onthisdate.info应该包含如下数据�Q?br />

; $Id$
name = On this date
description = "A block module that lists links to content such as blog entries or forum discussions that were created one week ago."

��把�q�些代码写到onthisdate.info文�g中，保存到sites/all/modules/onthisdate目录
下面3句是在info文�g中是可选的

dependencies = module1 module2 module3
package = "Your arbitrary grouping string"
version = "$Name$"

在我们的例子中，��不使用�q�些代码。如果你的模块依赖其他模块，则Drupal在你的依赖模块没有被�Ȁ�zȝ��情况下是不允许激�zȝ��?br />Package�Q�在模块列表��面中的昄��分组�Q�如果该��gؓ�I�则默认为“Uncategorized”�?br />Version�Q�通过cvs直接得到的模块的版本�?br />该文件��用的是ini格式�Q�所以该文�g可以包含;表示注释�Q?br />; $Id$则让cvs自动把该文�g的ID信息自动替换�?br />关于ini的格式，具体参见PHP.net parse_ini_file documentation

除了info文�g�Q�我们还可以通过实现help钩子来添加额外的帮助信息。不��怎么��P��最好还是实现help钩子。onthisdate模块的help钩子叫做onthisdate_help�Q?br />

php
function onthisdate_help($section='') {
}?>

$section变量�Q�是该页面的�l�点路径。官�Ҏ(gu��)��荐，最好在模块中通过swtich case语句来判断是否是该模块的�l�点路径。你可以参照如下代码�Q?br />

php
/**
* 昄��帮助和模块信�?br />* @param 当前帮助�l�点的�\�?模块�?br />* @return 昄��的帮助信�?br />*/
function onthisdate_help($section='') {
  $output = '';
  switch ($section) {
    case "admin/help#onthisdate":
      $output = '

'. t("Displays links to nodes created on this date"). '

';
      break;
  }
  return $output;
} // function onthisdate_help
?>

把这些代码写到onthisdate.module文�g中，保存到目录sites/all/modules/onthisdate

原文�Q?br />

In Drupal 5.x the basic information about your module, its name and description, is no longer provided by hook_help. Instead, all modules now need to have a modulename.info file, containing meta information about the module (for details see Writing .info files (Drupal 5.x)). For our example, "onthisdate.info'.

The general format is:

; $Id$
name = Module Name
description = "A description of what your module does."

Without this file, your module will not show up in the module listing!.

for our example, it could contain the following:

; $Id$
name = On this date
description = "A block module that lists links to content such as blog entries or forum discussions that were created one week ago."

Add the source above to a file named to onthisdate.info before saving in your module's directory at sites/all/modules/onthisdate.

There are also three optional lines that may appear in the .info file:
dependencies = module1 module2 module3
package = "Your arbitrary grouping string"
version = "$Name$"

For our example module, these don't apply and we will simply omit them. If you assign dependencies for your module, Drupal will not allow it to be activated until the required dependencies are met.

If you assign a package string for your module, on the admin/build/modules page it will be listed with other modules with the same category. If you do not assign one, it will simply be listed as 'Uncategorized'. Not assigning a package for your module is perfectly ok; in general packages are best used for modules that are distributed together or are meant to be used together. If you have any doubt, leave this field blank.

Suggested examples of appropriate items for the package field:

    * Audio
    * Bot
    * CCK
    * Chat
    * E-Commerce
    * Event
    * Feed Parser
    * Organic groups
    * Station
    * Video
    * Views
    * Voting (if it uses/requires VotingAPI)

The version line will provide the version string for users getting their modules directly from CVS rather than using the tarball package that is created with a release.

The files use the ini format and can include a ; $Id$ to have CVS insert the file ID information.

For more information on ini file formatting, see the PHP.net parse_ini_file documentation.

We can also provide help and additional information about our module. Because of the use of the .info file described above, this hook is now optional. However, it is a good idea to implement it. The hook name for this function is 'help', so start with the onthisdate_help function:

php
function onthisdate_help($section='') {

}
?>

The $section variable provides context for the help: where in Drupal or the module are we looking for help. The recommended way to process this variable is with a switch statement. You'll see this code pattern in other modules.

php
/**
* Display help and module information
* @param section which section of the site we're displaying help
* @return help text for section
*/
function onthisdate_help($section='') {

  $output = '';

  switch ($section) {
    case "admin/help#onthisdate":
      $output = '

'. t("Displays links to nodes created on this date"). '

';
      break;
  }

  return $output;
} // function onthisdate_help
?>

The admin/help#modulename case is used by the Drupal core to linked from the main help page (/admin/help or ?q=admin/help). You will eventually want to add more text to provide a better help message to the user.

More information about the help hook:
Drupal HEAD

Add the source above to a file named to onthisdate.module before saving in your Drupal installation.

陈市�?/a> 2007-03-27 09:32 发表评论

Drupal5.x创徏自定义模块指南－01开�?Creating modules - a tutorial: Drupal 5.x �Q�－01. Getting started)

Mon, 26 Mar 2007 15:43:00 GMT

[��译:陈市�?摘自:http://drupal.org/node/82926]
To focus this tutorial, we'll start by creating a block module that lists links to content such as blog entries or forum discussions that were created one week ago.�q�䆾指南��教会我们如何在一个drupal的结点上创徏block content,创徏链接和回复信息�?br /> 首先在drupal的安装�\径下创徏目录sites/all/modules/onthisdate�Q�呵�?当然先得创徏目录sites/all/modules哈）。在目录sites/all/modules/ onthisdate下创��Z��个文�Ӟ��命名为onthisdate.module。在drupal 5.x中，目录sites/all/modules攄��的是一些非核心模块。这个��得你在升�U�核心模块的时候更加方便，无需担心你之前定制化�?br />

php
/* $Id$ */

在每个模块的php文�g末尾可以省去?>的标讎ͼ�只要在开头加�?lt;?php卛_��?Id$则是有助CVS的版本控制。在你模块中�Q�所有需要被Drupal调用的函数都必须以“{模块名}_{钩子名}”命名，钩子名是drupal中一些预定义的方法的前缀。通过�q�样的命名方式，可以很容易的让Druapl调用到这些方法，从而得��C��定制的数据�?br /> �q�个模块目前�q�没�q�行��h��Q�因为它�q�没有被�Ȁ�z�R��在后面的章节中�Q�我们可以看到如何激�z�该模块�?br />

原文

01. Getting started
Drupal 5.x

To focus this tutorial, we'll start by creating a block module that lists links to content such as blog entries or forum discussions that were created one week ago. The full tutorial will teach us how to create block content, write links, and retrieve information from Drupal nodes.

Start your module by creating a folder in your Drupal installation at the path: sites/all/modules/onthisdate You may need to create the sites/all/modules directory first. Create a PHP file and save it as onthisdate.module in the directory sites/all/modules/onthisdate. As of Drupal 5.x, sites/all/modules is the preferred place for non-core modules (and sites/all/themes for non-core themes), since this places all site-specific files in the sites directory. This allows you to more easily update the core files and modules without erasing your customizations.

php
/* $Id$ */

As per the Coding standards, omit the closing ?> tag and use the longhand php tag. The $Id$ string will help keep track of the revision number and date when you commit the file to CVS.

All functions in your module that will be used by Drupal are named {modulename}_{hook}, where "hook" is a pre-defined function name suffix. Drupal will call these functions to get specific data, so having these well-defined names means Drupal knows where to look. We will come to hooks in a while.

The module is not operational yet: it hasn't been activated. We'll activate the module later in the tutorial.

陈市�?/a> 2007-03-26 23:43 发表评论

Drupal Object Reference--$node - Node object(Drupal �l�点对象) for drupal 5.1

Sun, 25 Mar 2007 14:34:00 GMT

[��译:陈市�?摘自:http://drupal.org/node/49768]

Node对象:
[name] => 创徏�l�点的用户名
[date] => 创徏�l�点的时�?br />[status] => 是否发布{True:发布|False:未发�?/font> }(在action+workflow中可以做审核处理)
[moderate] => 是否可修改{0:只读|1:修改}
[promote] => 是否发布首页{0:是|1:否}
[sticky] => 是否�|�顶{0:否|1:是}
[revision] => TRUE/FALSE this is a new revision (if TRUE, will be saved as a separate entry in the database)
[comment]=> 对该�l�点是否允许��d��,阅读或者是对其讄��权限
[simple_access]=> �Ҏ(gu��)��限模块的一�?br />[title] => 昄��l�点��面的标�?br />[taxonomy] => 分类(数组,具体查看Taxonomy模块)
[body] => �l�点的内�?br />[format] => �W�合Filter模块的Content内容
[uid] => 创徏�l�点的用户ID
[created] => 创徏�l�点的Unix�c�d��的时间戳
[type] => �l�点�c�d��(�?book,page,forum,具体查看cck模块)
[teaser] => 内容概要
[validated] => 该结�Ҏ(gu��)��否有效{0:否|1:是}(是否已经保存)
[changed] => 修改�l�点的Unix�c�d��的时间戳
[nid] => �l�点ID

原文:

&$node - Node object

[name] => Username of node creator
[date] => Date the node was created
[status] => TRUE/FALSE = published/unpublished
[moderate] => Moderation enabled (0|1)
[promote] => Promoted to front page (0|1)
[sticky] => Sticky (0|1)
[revision] => TRUE/FALSE this is a new revision (if TRUE, will be saved as a separate entry in the database)
[comment] => whether comments can be added, read, or accessed, for this node
[simple_access] => Array -- A list of permissions for the Simple Access module
(
[view] => 0
)

[title] => Page title
[taxonomy] => Array -- Taxonomy classification
(
[0] => 0
)

[body] => Body content of node

[format] => which filter applies to this content.
[uid] => User ID of node creator
[created] => UNIX timestamp of node creation date.
[type] => Type of node (e.g. book, page, forum)
[teaser] => Teaser (the initial part of the body)

[validated] => has the node passed validation? (0|1) (is it ready to be saved).
[changed] => UNIX timestamp of last time node was changed.
[nid] => Node ID

陈市�?/a> 2007-03-25 22:34 发表评论