5.x

定義

user_access($string, $account = NULL)
modules/user/user.module, 第 351 行開始

描述

判斷使用者是否具有某種權限。
所有的權限判斷，都應該要例用這個函數。一來是讓所有的程式有一致性，而且可以保證SuperUser能擁有所有的權限。

參數

$string: 要判定的權限名字，如"administer nodes"
$account (預設): 一個 User 物件。在要判斷的使用者並不是「目前登入的那個人」時使用。

傳回值

如果判定是「有這個權限」，則傳回布林值 TRUE。

範例

檢查目前使用者是否有「存取管理頁面(administer comments)」的權限

$has_permission = user_access("administer comments"); // 第二個參數省略


簡介

此文將會介紹：

1. tinymce、image、img_assist的安裝流程
2. tinymce搭配drupal的image、img_assist模組，整合圖片上傳、插入文章的介面，結合image的好處是將每一個圖片視為一個node，比imce方便做後續利用。
3. tinymce附設的drupalbreak安裝方式，讓內文可以無痛插入摘要分隔
4. tinymce總是會清掉html多餘的空白，本文提供解決方式

需求模組

Image 模組(image)
Tinymce 模組(tinymce) + tinymce 編輯器檔案 (下載)
Image Assist 模組 (img_assist)

快速安裝流程

檔案配置

定義

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.'));
?>
一個綠色的方框就會出現在下一個用戶的可視頁面內

開發者不用操心顯示部份

看名字就知道這些函數是用來處理和模組有關的事情。
如果今天開發的模組需要和其它的模組互動，或是"相依"在其它的模組之上，或是要觸發其它模組的 hook 。
那麼這個部分的函數就要花時間去研究。

定義

drupal_get_path($type, $name)
includes/common.inc

描述

可用此函數取得模組、版型或版型引擎(theme engine)的路徑

參數

$type: 要尋找的種類 (如： theme, theme_engine, module)
$name: 尋找東西的名字

傳回值

要找東西的路徑(網站相對路徑，不是伺服器的系統路徑)

範例

drupal_foo的意思，就是drupal很多函數裡面以「drupal_」為開頭名稱的，會以drupal開頭的函數，表示很常被模組的開發者使用，也特別的重要。

幾乎所有的drupal_foo函數，都會在下面這些位置找到。
include/bootstrap.inc
include/common.inc
也建議模組開發者，可以善加利用drupal核心提供的API，並注意不要自行在模組裡新增drupal_foo的function，以免混淆。

這個單元是許多熱心的貢獻者，將許多drupal_foo函數寫上中文說明，每個drupal_foo的文件說明裡裡通常會包含：定義、描述、參數、傳回值、範例、程式碼...等等。若您也知道一些drupal_foo的用途，或是看到有錯誤的地方，歡迎直接共筆編輯，幫忙加上說明和解釋。