我是初学者，想要自行开发该如何上手

大家好，我是最近才接触CMS的新手，在试着安装过joomla、e107、xoops之后，最后透过友人的推荐，决定使用drupal来架设网站，目前网站己经架设完成，但是非常阳春，我还是个初学者，其实很多东西也不是了解，市面上好像也没有drupal的书，可是我想要自己开发新的模组(或修改现成的模组)建立自己的网站，我该从何上手呢，有没有什么资料值得我先阅读的，我想从基本学起，也许只是从自己写一个功能简单的搜寻关键字的模组开始，慢慢渐入佳境，可是目前对drupal架构完全没什么概念，光是看原始码我就有点头痛了，所以想自己写一些简单基本的功能，有没有人可以给我一些意见要如何上手。谢谢

Code Snippets : 计算Views生成资料的总数

Views用来「列资料」很棒，可是如果要做一些统计、计算，虽然有些模组可以用（像是Views Cul等等），但其实都不是很好的解决方案。不过Views的API非常齐全，所以只要了解Views的写法，也是可以不需要自己写query喔！

以下范例是算出某个Views的total rows，也就是该Views的总数。
实际应用举例：
奖金猎人的「目前进行中比赛有XXX件」这样的区块。

如果你的状况需要设参数的话：

如果希望最后输出可以依照总数改变的话：

drupal_foo

drupal_ foo的意思，就是drupal很多函数里面以「drupal_」为开头名称的，会以drupal开头的函数，表示很常被模组的开发者使用，也特别的重要。

几乎所有的drupal_foo函数，都会在下面这些位置找到。

这个单元是许多热心的贡献者，将许多drupal_ foo函数写上中文说明，每个drupal_foo的文件说明里里通常会包含：定义、描述、参数、传回值、范例、程式码...等等。若您也知道一些drupal_foo的用途，或是看到有错误的地方，欢迎直接共笔编辑，帮忙加上说明和解释。

drupal_set_message

定义

drupal_set_message($message = NULL, $type = 'status') 
includes/bootstrap.inc

描述

定义一组讯息，以反映刚执行命令的状态

参数

$message:要显示的讯息
$type:类别，可以是

• 'status'
• 'error'

传回值

所有已经定义的讯息

范例

例如要告诉使用者”你己经成功注册了”:

<?php 
drupal_set_message ( t ( 'Created a new user account. No e-mail has been sent.' )); 
?>

一个绿色的方框就会出现在下一个用户的可视页面内 开发者不用操心显示部份

又例如要显示一个错误：

<?php 
drupal_set_message ( t ( 'Invalid password.' ) , 'error' ); 
?>

后面的一个参数如果为'error' 
一个错误的红色框就会出现

注：第一个参数可以为html 
注：t()函数指可翻译的

程式码

<?php 
function drupal_set_message ( $message = NULL , $type = 'status' ) { 
  if ( $message ) { 
    if (!isset( $_SESSION [ 'messages' ])) { 
      $_SESSION [ 'messages' ] = array( ); 
    }     if (!isset( 

$_SESSION [ 'messages' ][ $type ])) { 
      $_SESSION [ 'messages' ][ $type ] = array(); 
    } 

    $_SESSION [ 'messages' ][ $type ] [] = $message ; 
  } 

  //如果发生资料库连接错误，则讯息不会被记录
  return isset( $_SESSION [ 'messages' ]) ? $_SESSION [ 'messages' ] : NULL ; 
} 
?>

附加档案	大小
drupal_set_message_1.JPG	6.59 KB

module_foo

看名字就知道这些函数是用来处理和模组有关的事情。
如果今天开发的模组需要和其它的模组互动，或是"相依"在其它的模组之上，或是要触发其它模组的hook 。
那么这个部分的函数就要花时间去研究。

theme user login block form

之前在怎样styling user login block ?讨论内回应的内容上有一些错误
回应的内容已经没办法编辑
所以修改后另外PO一篇

在版型资料夹下的template.php 内加上

然后在版型资料夹下增加一个login_block_form.tpl.php的档案作为样板档
直接在样板档里排成我想要的样子

drupal的表单必须把$form['form_id'] & $form['form_token']必须print出来表单才有作用
不过user_login_block似乎是例外表单结构内原本就没有$form['form_token'] 
所以这边只render $form['form_id']

另外搭配imagebutton 还可以把原本的submit按钮改成图片

注册新帐号&忘记密码的连结也都是定义在$form里面
在样板档里print_r($form)看一下就知道了

然后再加入css (这边只是简单示意一下详细的css 请自己再作设定)

要直接加在样板档的档案内
或版型的style.css档案内都可以
如果是只有一个样板档用到的style 
个人是喜欢直接放在样板档里

在样板档里就像一般的网页制作一样
随你怎么排列
只要知道element的名字
想在哪render都可以也不用照$form里的顺序
可以改出单用css或hook_form_alter没办法达成的排版

虽然在$form['name']['title']可以把标题改成空字串而不显示标题
但是不建议这样做
因为表单的错误讯息会没有栏位的名称
例如请填写密码栏位的错误讯息会变成请填写栏位
如果表单的栏位有5个栏位没填就会变成

请填写栏位
请填写栏位
请填写栏位
请填写栏位
请填写栏位

根本没办法辨识是哪个栏位未输入
所以#title还是留着比较好
不想显示标题的时候建议还是用css把label隐 ​​藏掉

user_foo

user也是模组之一，管理使用者的登入登出，或是权限的认证。
总之想作好一个有管理使用者的模组，这个部分的函数就必须有所了解。
这些函数不需要特别去引用，直接呼叫函数的名称就可以了。

常用的全域变数

在写模组的同时，发现有些资讯是记在全域变数里面，在遍寻的函数找不到之后才发现。
所以把一些常用的全域变数整理到这里，提供给人查询。
所有用变数使用之前，必须要先「global $变数;」才能使用...

$user

使用者物件
既使没有人登入，也会有一个"访客"况态的物件。要知道这个人有那些资讯，就必须要使用这个物件。

$base_url

网站根目录网址
当使用「clean_url(简絜网址)」的时候，有时候会需要用到绝对路径来作网页连结。
不确定网址的开头是什么的时候，像是不确定自己的模组会被装到哪个站里面，可以用它来 ​​查询网站根目录的网址。
如果我用把drupal装在"drupal_test"的目录下，在本机测试时，这个变数可能会是「http://localhost/drupal_test」。

$base_path

网站根目录网址(相对路径) 
当使用「clean_url(简絜网址)」的时候，有时候会需要用到绝对路径来作网页连结。
不确定网址的开头是什么的时候，像是不确定自己的模组会被装到哪个站里面，可以用它来 ​​查询网站根目录的网址。
如果我用把drupal装在"drupal_test"的目录下，在本机测试时，这个变数会是「drupal_test」。

慢慢增加中....

把玩Drupal模组： Hook System运作简介

模组系统是drupal很重要的运作方式，drupal依靠着少少的核心程式，便能让模组能做到任何事情。

drupal只有21个档案在include里头，每次必会loading进来，其他的全都放在modules。
也就是说，除了那几只档案以外，全部的东西都把他当成module在写。诸如CMS最基本的功能，文章管理、评论、讨论区、分类...等的功能，全部都写在module里，include里头所提供的是各种api，档案处理函式、资料库存取、表单生成...等等，这样的分层，module便可以专心的开发各种功能。

当然，这样的架构不够令人注目。有许多web app架构，对于模组（module）、插件（plug-in）...等的运作，通常是让他们各自为政，自己干自己的事情。多是用核心提供的object和function，加上module自己额外的code，达到module要做到的额外功能。但是drupal的核心运作却不是如此。

drupal处理使用的程式为modules/user.module。如果今天想要在看使用者资料的同时，也想看看所有使用者过去发表文章的list，那该怎么写呢？

直接一点，更改user.modue，在显示时，顺便去文章资料库抓相关的资料？然而这样却不是一个好方式，今天任何想要对使用者增加新功能的时候，都得trace一次user.module的code，看懂他在干啥，然后把新的code安插在合适的地方.. .最后可能增加user.module的复杂度，增加维护那支module的难度，共同开发时，更是一个危险的方式。

第二种方式，重写一个新的浏览页面，重新写一个SELECT的语句，让SELECT的时候除了使用者资讯，也把文章资料一起抓出来，然后显示到不同的页面。但是这样很浪费，明明跟user.module重复的功能达到一半以上，那是不是之后要新增功能，都得重写一次呢？

上面两种方式在drupal中也都可以达成，然而熟悉Drupal的人却不会如此。Drupal的开发者很聪明，他的模组系统（module system）考虑到了模组再利用这一点，每个模组都视为可以再利用的资源，只要写module的人想写，透过模组系统便可以跟所有的module交互作用。

第三种方式以modules/user.module为例，他即是处理包含新增、修改、删除、注册、登入....等所有与使用者相关的功能。在进行每个重要的功能时，user.module都会呼叫一个函式去扫所有的module，看看是否有其他的module要在user.module进行此动作时，也进行一些其他想要做的事情，这就是drupal重要的Hook System。example: 在drupal user.module里头可以找到如下的程式码
 

function user_view($uid = 0) {
  // ... skip
  // moudle_invoke扫描所有的module
  // 看看有没有modulename_user这个function
  // 有个话就看'view'这个功能的部份要加上什么
  foreach (module_list() as $module) {
    if ($data = module_invoke($module, 'user', 'view', '', $account)) {
      // do something...
    }
  }
  // ... skip
}

所以，第三种方式，不用重写，也不用改到user.module，只要自己新增module和写一个function，便可以轻松让浏览使用者资讯时，加上过往文章。example: 新增自己的module，与hook system紧密运作新增sample.module

 

function sample_user($type, &$edit, &$user, $category = NULL) {
  if ($type == 'view') {
    return /*过往文章，型别为一阵列*/;
  }
}

这就是drupal把众多主要功能都写成module的原因，让所有模组之间都可以交互利用，或是写给别人利用，或是利用别人的module，像积木一样推砌成想要的功能，却又不浪费资源。

参考资源：
详细的用法在：http://drupaldocs.org/api/head/function/hook_user Module developer's guide：http://drupal.org/node/508

 

不使用views，如何自订节点清单显示页面

原文连结：http://www.500959.com/node/510
基本上，views和cck是大家都建议用的两个drupal模组，因为这两个模组太强大了，一个可以自由定制栏位，一个可以自由过滤资料用以显示， drupal的许多其它模组都是基于这两个的。正因其强大，所以也庞大，庞大耗费资源，相对来说，配置起来也较复杂。对于一些把drupal做为个人博客来用的朋友来说，通常不想使用这两个模组，但drupal预设就只有一种排列文章的方式，按时间发表顺序，而bloger们可能就需要有多一些的排列显示方式。

这个时候可以用查询资料库再配合drupal的一些核心函数来达到简单过滤显示的目的。举个例子吧，用习惯了国内cms的朋友，都喜欢在首页上显示一些区块，什么最新文章、最新推荐、最新评论、热门文章……

咱们先创建一个page节点，标题就看你的爱好了，随便取吧。内容呢，就随便写段代码吧：

现在进入第二步，到“网站资讯（admin/settings/site-information）”中，拉到最后面，把默认首页设置为咱们刚才创建的页面路径：index.html，好，现在打开网站，发现默认首页就剩“嘿罗世界”了，忽悠人啊这不是。别急，接下来做第三步。

第三步，开始往里边添加内容了。我想添加个最新blog文章的列表。drupal区块里有个默认的最新blog文章，到区块中，查看最新blog文章的区块连结是这样的：admin/build/block/configure/blog/0，注意最后两层（blog/0） ，这很重要。这表示这个区块是由blog.module生成的第0个区块（从0开始计数的）。现在我们编辑那篇文章，把里边的“嘿罗世界”可以删除了，放这段代码进去：

我想要显示其它类型，比如story的最新文章呢？因为默认没有提供区块，所以一般的做法呢是用views来过滤出来，但文章一开头就说了，咱们不用views。这就进入另一个重点部分，读取资料库来显示。编辑文章，在后面插入这段代码：

保存，现在看看效果，最新story文章列表是不是出现了呢？而热门内容呢，statistics模组也提供了一个按点击排序的文章列表，我们可以直接用上面插入区块的办法把它放到页面里。现在我们页面里有最新文章、最新推荐、最新日志、热门内容、最新评论等区块列表了，看起来像那么回事了，接下来的事就是排版了。这个就取决于个人的审美观了，熟悉css的就用css，不熟悉的就直接用表格套上去就行了。

可以收工了，可我还想有个more，你看大多数网站的列表下面，不都有个more，点击进去，显示更多的内容，并且这里边的内容还是可以分页的。好，现在我们来解决这个问题。还是举例子吧，也想不到其它更好的手段了。先在首页的清单下面加个more连结：