育將電腦工作室 - 線上書籍

最新xoops模組開發
===========

### 一、設定徧好設定

1. xoops\_version.php ```
 <pre class="brush:as3;">
 //---偏好設定---//
 $modversion['config'] = array();
 #google Map Api Key
 $i=1;
 $modversion['config'][$i]['name'] = 'ugm_sky_googleMapApiKey';
 $modversion['config'][$i]['title'] = '_MI_UGM_SKY_GOOGLEMAPAPIKEY';
 $modversion['config'][$i]['description'] = '_MI_UGM_SKY_GOOGLEMAPAPIKEY_DESC';
 $modversion['config'][$i]['formtype'] = 'textbox';
 $modversion['config'][$i]['valuetype'] = 'text';
 $modversion['config'][$i]['default'] = '';
 ```
2. name 最多只能 25 個字元，請注意！
3. 偏好設定可以讓您的模組更有彈性一點，而且您不用自己做資料表，就可以把和模組相關的設定值，存到資料庫。
4. 模組若需要偏好設定功能，那麼請加入以下項目（在此常數需要加上引號才正常！）：
5. 輸入欄位類型其可用的項目有：
 - (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」語系下拉選單
6. 偏好設定的輸入值型態，其可用的項目有：
 - (1) 「int」整數： yesno 、group、user
 - (2) 「float」浮點數
 - (3) 「text」一般文字
 - (4) 「array」陣列： select\_multi、group\_multi、 user\_multi
7. 偏好設定的選項設定使用陣列寫法，用於有 select 或 select\_multi 時，「5=>5」左邊的5（索引）會顯示在螢幕上，可用文字，右邊的5（值）會存入資料庫。
 
### 二、套用模組偏好設定值

1. 我們做了一個叫做「ugm\_sky\_googleMapApiKey」的偏好設定，要套用時，就像這樣使用：$xoopsModuleConfig\['ugm\_sky\_googleMapApiKey'\]
2. 用$xoopsModuleConfig\['ugm\_sky\_googleMapApiKey'\] 取代掉Google Maps API KEY 即可。
3. 記得使用在函數中，必須global

Title1

Title2

Title3

Title1

Title2

Title3

MarkDown