Tad 教材網 - 線上書籍

:::

\[1011\]XOOPS 2.5 模組開發
======================

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

### 一、 XOOPS模組結構

1. 一個XOOPS模組就是一個目錄，此目錄會放在modules底下。
2. 底下是新的（2.5之後的）XOOPS的模組目錄建議結構（PHP > 5.2）：
 <table border="1" cellpadding="1" cellspacing="1" width="500"> <tbody> <tr> <td><span style="font-size: 12px;">admin  
 blocks  
 class  
 css  
 docs  
 images  
 |--- admin  
 |--- icons  
 include  
 language  
 |--- english  
 |--- help  
 sql  
 templates  
 |--- blocks  
 test</span></td> <td><span style="font-size: 12px;">模組後台目錄  
 區塊檔案目錄  
 額外的物件庫或函式庫目錄  
 模組樣式目錄  
 說明文件目錄  
 圖檔目錄  
 |--- 後台界面用到的圖檔  
 |--- 其他圖檔  
 引入檔目錄：如搜尋、模組自動檔  
 語系目錄  
 |--- 英語語系（Big5中文為tchinese、UTF-8為tchinese\_utf8）  
 |--- 說明文件語系  
 資料庫結構目錄：裡面會有.sql檔  
 模組樣板目錄：用來放置模組頁面的樣板檔，均為.html檔  
 |--- 區塊樣板檔：一樣為.html檔  
 測試檔目錄：放置Selenium 測試檔</span></td> </tr> </tbody> </table>

4. 其實您完全不管這個結構也是無所謂的，但粗體黃底的目錄（如果有用到該功能的話）則是一定要有的，而且不能亂改目錄名稱！（斜體為新的2.5模組建議目錄）
5. 關於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\['status\_version'\]模組狀態可以是Alpha、Beta、RC、Release
6. $modversion\['adminmenu'\]後台選單的圖示為32x32，可從這裡下載： 
  - (1) <http://findicons.com>
  - (2) <http://www.iconfinder.com>
7. $modversion\['sqlfile'\]\['mysql'\]資料庫結構檔，可從phpMyAdmin直接匯出，不須加上前置字串（XOOPS的資料表均有前置字串，每個網站都不同，正常安裝時可自設）。注意結尾不要是Type=MyISAM（新版MySQL不支援舊寫法），不寫亦可。
 
### 三、 開發主題

1. 本期預設要開發的模組為記事本模組，可設定分類，可多人共用。
2. 分類資料表需要的欄位如下：分類編號（cate\_sn）、分類名稱（cate\_title）、分類排序（cate\_sort）、是否使用（cate\_enable）、人氣（cate\_count）。
3. 文章資料表需要的欄位如下：文章編號（note\_sn）、所屬分類（cate\_sn）、文章標題（note\_title）、文章內容（note\_content）、文章發布日期（note\_date）、是否公開（note\_public）、人氣（note\_count）、發布者（uid）、文章排序（note\_sort）。
4. 建立好之後，請匯出資料庫格式，並存成sql檔到sql目錄中。
 
[ mainfile.php修正檔下載](http://www.tad0616.net/uploads/tad_book3/file/1011/mainfile.zip)：修正開除錯功能無法正常使用之bug（解壓→上傳→覆蓋即可）

:::