Tad 教材網 - 線上書籍

:::

\[1011\]XOOPS 2.5 模組開發
======================

[![](http://tad0616.net/uploads/dl.gif)](http://www.tad0616.net/uploads/tad_book3/file/1011/18.zip)

### 一、 XOOPS系統權限均在group\_permission資料表：

1. 這個表有五個欄位，分別為： gperm\_id（權限的流水編號）、gperm\_groupid（群組編號）、gperm\_itemid（模組、區塊或細部項目編號）、gperm\_modid（模組編號）、gperm\_name（權限種類）。這簡單的五個欄位就可以設定各種模組、區塊，甚至是自訂的細部權限。 
  - (1) 「system\_admin」就是「系統管理權」
  - (2) 「module\_read」就是「模組的使用權」
  - (3) 「module\_admin」就是「模組的管理權」
  - (4) 「block\_read」就是「區塊的使用權」
2. 若在gperm\_name欄位裡頭看到不屬於以上這四種名稱者，代表該權限並不是系統預設的權限，而是模組自訂的細部權限。
 
### 二、 細部權限設定（請將「groupperm.php」複製到模組admin下）

1. 「權限項目陣列」其寫法如下：
 ```
<pre class="brush: php;" title="code">
$item_list = array(
    '編號1' => "權限項目1",
    '編號2' => "權限項目2"
);
```

3. 「編號」會存在gperm\_itemid欄位裡，要判斷某群組是否有該項目權限都要靠此編號來判定，故設好後編號和項目的對應就別亂改（但可新增）。
4. 「權限項目」直接寫中文即可。
5. 「權限名稱」非常重要了！請用英文名稱設定，且盡量別和其他模組重複。一旦設好了，此項目值千萬別改，因為一改，可能之前針對此模組所設訂的權限會全部泡湯。
 
### 三、 程式套用細部權限（請開啟套用權限機制.txt）

1. $gperm\_handler->checkRight()就是用來判斷權限狀況，而該方法需要四個參數，上面的1~9行其實就只是為了產生此四個參數而存在的。其參數如下： 
  - (1) $perm\_name：權限名稱，即groupperm.php中的$perm\_name設定。
  - (2) $perm\_itemid：權限項目編號，即groupperm.php中的$item\_list設定。
  - (3) $groups：目前登入者的所屬群組。
  - (4) $module\_id：模組編號，用$xoopsModule->getVar('mid')取得目前模組編號。
2. 若是該段語法是在函數中使用，記得global $xoopsUser及$xoopsModule。
 
### 四、 安裝、更新及移除模組用的設定

1. 這個項目沒有也沒關係，主要是用來設定在安裝（或反安裝）模組時，要順便進行的一些指定動作，並不常用（也並沒有規定一定要放在include中）。
 ```
<pre class="brush: php;" title="code">
$modversion['onInstall'] = "include/onInstall.php";
```

3. 模組安裝時要執行的程式。檔案裡頭必須包含一個函數： xoops\_module\_install\_{dirname} ，此函數將會在模組安裝時被執行。
 ```
<pre class="brush: php;" title="code">
$modversion['onUninstall'] = "include/onUninstall.php";
```

5. 模組移除時要執行的程式。檔案裡頭必須包含一個函數： xoops\_module\_uninstall\_{dirname} ，此函數將會在模組反安裝時被執行。
 ```
<pre class="brush: php;" title="code">
$modversion['onUpdate'] = "include/onUpdate.php";
```

7. 模組更新時要執行的程式。檔案裡頭必須包含一個函數： xoops\_module\_update\_{dirname} ，此函數將會在模組更新時被執行。

:::