Tad 教材網 - 線上書籍

:::

八小時模組開發
=======

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

### 一、 使用範例模組

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）： <table border="1" cellpadding="1" cellspacing="1" width="500"> <tbody> <tr> <td>admin 
 blocks 
 class 
 css 
 docs 
 images 
 |--- admin 
 |--- icons 
 include 
 language 
 |--- english 
 |--- help 
 sql 
 templates 
 |--- blocks 
 test</td> <td>模組後台目錄 
 區塊檔案目錄 
 額外的物件庫或函式庫目錄 
 模組樣式目錄 
 說明文件目錄 
 圖檔目錄 
 |--- 後台界面用到的圖檔 
 |--- 其他圖檔 
 引入檔目錄：如搜尋、模組自動檔 
 語系目錄 
 |--- 英語語系（Big5中文為tchinese、UTF-8為tchinese\_utf8） 
 |--- 說明文件語系 
 資料庫結構目錄：裡面會有.sql檔 
 模組樣板目錄：用來放置模組頁面的樣板檔，均為.html檔 
 |--- 區塊樣板檔：一樣為.html檔 
 測試檔目錄：放置Selenium 測試檔</td> </tr> </tbody> </table>
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試用版](http://120.115.2.90/modules/tad_uploader/index.php?op=dlfile&cfsn=18&cat_sn=7&name=392_PhotoImpact%2012.exe)來製作
 - ![](http://www.tad0616.net/uploads/tad_book3/image/logo.png)
7. $modversion\['sqlfile'\]\['mysql'\]資料庫結構檔，可從phpMyAdmin直接匯出，不須加上前置字串 （XOOPS的資料表均有前置字串，每個網站都不同，正常安裝時可自設）。
 
###

### 四、xoops\_version.php 中的語系

1. xoops\_version.php 若有用到中文的部份，建議做成語系檔。 ```
 <pre class="brush:php;">
 $modversion['name'] = _MI_MYDICT_MOD_NAME;
 ```
2. 當然，若時間不夠，或只只是自己用，那直接寫中文亦可（偏好設定部份除外，一定要用語系），如（字串一定要加上引號）： ```
 <pre class="brush:php;">
 $modversion['name'] = '我的英漢字典';
 ```
3. xoops\_version.php 的語系檔一律位於 language/tchinese\_utf8/modinfo.php 中（不可自訂檔案或改檔名）
4. 語系設定方法： define("\_MI\_語系名稱" , "對應的實際中文"); ```
 <pre class="brush:php;">
 define("_MI_MYDICT_MOD_NAME" , '我的英漢字典');
 ```
5. 「\_MI\_語系名稱」是PHP常數，一般而言建議用底線開頭，並全部大寫，以容易識別（但其實無強制性）。
6. \_MI 是XOOPS建議的常數開頭。
7. 一般 \_MI 後面會加上模組名稱，以避免常數衝突，例如： \_MI\_MYDICT\_XXX

:::