2. XOOPS模組基本結構（40分鐘）

一、 使用範例模組

1. 將 demo.zip 解壓，得到demo目錄。
2. 將 demo 目錄改名為您自訂的模組名稱如：my_dict
3. 將 my_dict 搬移到網頁目錄下的 modules 中，如：C:\my_xoops\www\modules\my_dict

二、 XOOPS模組結構

1. 一個XOOPS模組就是一個目錄，此目錄會放在modules底下。
2. 底下是新的（2.5之後的）XOOPS的模組目錄建議結構（PHP > 5.2）：

   admin blocks class css docs images     |--- admin     |--- icons include language     |--- english         |--- help sql templates     |--- blocks test

   模組後台目錄 區塊檔案目錄 額外的物件庫或函式庫目錄 模組樣式目錄 說明文件目錄 圖檔目錄     |--- 後台界面用到的圖檔     |--- 其他圖檔 引入檔目錄：如搜尋、模組自動檔 語系目錄     |--- 英語語系（Big5中文為tchinese、UTF-8為tchinese_utf8）         |--- 說明文件語系 資料庫結構目錄：裡面會有.sql檔 模組樣板目錄：用來放置模組頁面的樣板檔，均為.html檔     |--- 區塊樣板檔：一樣為.html檔 測試檔目錄：放置Selenium 測試檔

3. 其實您完全不管這個結構也是無所謂的，但黃底的目錄（如果有用到該功能的話）則是一定要有的，而且不能亂改目錄名稱！紅底的目錄則是常用的目錄。
4. 關於Selenium可參考http://www.jaceju.net/blog/archives/1293/

三、認識xoops_version.php

1. XOOPS的模組目錄下一定有xoops_version.php設定檔，否則就不是標準模組。
2. 設定檔中，最重要的設定為$modversion['dirname']，可直接輸入模組目錄名稱。
3. 接著請依照設定檔順序，產生相對檔案出來。
4. $modversion['version'] 版本號寫法：1.0、2.3...均可，但1.0.1需寫成 1.01。
5. $modversion['module_status']模組狀態可以是Alpha、Beta、RC、Release
6. $modversion['adminmenu']後台選單的圖示為32x32，可從這裡下載：
   • (1)  http://findicons.com
   • (2)  http://www.iconfinder.com
   • (3) 若是沒有影像處理軟體，可下載photoimpact12試用版來製作
   •  
7. $modversion['sqlfile']['mysql']資料庫結構檔，可從phpMyAdmin直接匯出，不須加上前置字串 （XOOPS的資料表均有前置字串，每個網站都不同，正常安裝時可自設）。

四、xoops_version.php 中的語系

1. xoops_version.php 若有用到中文的部份，建議做成語系檔。

   $modversion['name'] = _MI_MYDICT_MOD_NAME;

2. 當然，若時間不夠，或只只是自己用，那直接寫中文亦可（偏好設定部份除外，一定要用語系），如（字串一定要加上引號）：

   $modversion['name'] = '我的英漢字典';

3. xoops_version.php 的語系檔一律位於 language/tchinese_utf8/modinfo.php 中（不可自訂檔案或改檔名）
4. 語系設定方法： define("_MI_語系名稱" , "對應的實際中文");

   define("_MI_MYDICT_MOD_NAME" , '我的英漢字典');

5. 「_MI_語系名稱」是PHP常數，一般而言建議用底線開頭，並全部大寫，以容易識別（但其實無強制性）。
6. _MI 是XOOPS建議的常數開頭。
7. 一般 _MI 後面會加上模組名稱，以避免常數衝突，例如： _MI_MYDICT_XXX