10. 模組偏好設定

一、 模組偏好設定

1. 偏好設定可以讓您的模組更有彈性一點，而且您不用自己做資料表，就可以把和模組相關的設定值，存到資料庫。
2. 模組若需要偏好設定功能，那麼請加入以下項目（在此常數需要加上引號才正常！）：

//識別名稱（給程式用的）
$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;

3.  輸入欄位類型其可用的項目有：
   • (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」語系下拉選單
4. 偏好設定的輸入值型態，其可用的項目有：
   • (1)  「int」整數： yesno 、group、user
   • (2)  「float」浮點數
   • (3)  「text」一般文字
   • (4)  「array」陣列： select_multi、group_multi、 user_multi
5. 偏好設定的選項設定使用陣列寫法，用於有 select 或 select_multi 時，「5=>5」左邊的5（索引）會顯示在螢幕上，可用文字，右邊的5（值）會存入資料庫。

二、 套用模組偏好設定值

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