Tad 教材網 - 線上書籍

:::

XOOPS 模組開發
==========

### 一、 模組偏好設定

1. 偏好設定可以讓您的模組更有彈性一點，而且您不用自己做資料表，就可以把和模組相關的設定值，存到資料庫。
2. 模組若需要偏好設定功能，那麼請加入以下項目（在此常數需要加上引號才正常！）：
 ```
<pre class="brush: php;" title="code">
//識別名稱（給程式用的）
$modversion['config'][1]['name'] = 'show_num';
//顯示標題
$modversion['config'][1]['title'] = '_MI_HONOR_SHOW_NUM';
//偏好設定的說明
$modversion['config'][1]['description'] = '_MI_HONOR_SHOW_NUM_DSC';
//偏好設定的輸入欄位類型
$modversion['config'][1]['formtype'] = 'select';
//偏好設定的輸入值型態
$modversion['config'][1]['valuetype'] = 'int';
//偏好設定的選項設定
$modversion['config'][1]['options'] = array(5=>5,10=>10,15=>15);
//偏好設定的預設值。
$modversion['config'][1]['default'] = 10;
```

4. 輸入欄位類型其可用的項目有： 
  - (1) 「yesno」是否的單選框
  - (2) 「select」下拉選單
  - (3) 「select\_multi」可複選的下拉選單
  - (4) 「group」群組下拉選單
  - (5) 「group\_multi」可複選的群組下拉選單
  - (6) 「textbox」文字框
  - (7) 「textarea」大量文字框
  - (8) 「user」已註冊使用者下拉選單
  - (9) 「user\_multi」可複選的已註冊使用者下拉選單
  - (10) 「timezone」時區下拉選單
  - (11) 「language」語系下拉選單
5. 偏好設定的輸入值型態，其可用的項目有： 
  - (1) 「int」整數： yesno 、group、user
  - (2) 「float」浮點數
  - (3) 「text」一般文字
  - (4) 「array」陣列： select\_multi、group\_multi、 user\_multi
6. 偏好設定的選項設定使用陣列寫法，用於有 select 或 select\_multi 時，「5=>5」左邊的5（索引）會顯示在螢幕上，可用文字，右邊的5（值）會存入資料庫。
 
### 二、 套用模組偏好設定值

1. 我們做了一個叫做show\_num 的偏好設定，要套用時，就像這樣使用：$xoopsModuleConfig\['show\_num'\]
2. 用$xoopsModuleConfig\['show\_num'\] 取代掉分頁的數量即可。

:::