2.
XOOPS模組基本結構
一、 XOOPS模組結構
- 一個XOOPS模組就是一個目錄,此目錄會放在modules底下。
- 底下是新的(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 測試檔 |
- 其實您完全不管這個結構也是無所謂的,但粗體黃底的目錄(如果有用到該功能的話)則是一定要有的,而且不能亂改目錄名稱!(斜體為新的2.5模組建議目錄)
- 關於Selenium可參考http://www.jaceju.net/blog/archives/1293/
二、 認識xoops_version.php
- XOOPS的模組目錄下一定有xoops_version.php設定檔,否則就不是標準模組。
- 設定檔中,最重要的設定為$modversion['dirname'],可直接輸入模組目錄名稱。
- 接著請依照設定檔順序,產生相對檔案出來。
- $modversion['version'] 版本號寫法:1.0、2.3...均可,但1.0.1需寫成 1.01。
- $modversion['status_version']模組狀態可以是Alpha、Beta、RC、Release
- $modversion['adminmenu']後台選單的圖示為32x32,可從這裡下載:
- $modversion['sqlfile']['mysql']資料庫結構檔,可從phpMyAdmin直接匯出,不須加上前置字串(XOOPS的資料表均有前置字串,每個網站都不同,正常安裝時可自設)。注意結尾不要是Type=MyISAM(新版MySQL不支援舊寫法),不寫亦可。
三、 開發主題
- 本期預設要開發的模組為記事本模組,可設定分類,可多人共用。
- 分類資料表需要的欄位如下:分類編號(cate_sn)、分類名稱(cate_title)、分類排序(cate_sort)、是否使用(cate_enable)、人氣(cate_count)。
- 文章資料表需要的欄位如下:文章編號(note_sn)、所屬分類(cate_sn)、文章標題(note_title)、文章內容(note_content)、文章發布日期(note_date)、是否公開(note_public)、人氣(note_count)、發布者(uid)、文章排序(note_sort)。
- 建立好之後,請匯出資料庫格式,並存成sql檔到sql目錄中。
mainfile.php修正檔下載:修正開除錯功能無法正常使用之bug(解壓→上傳→覆蓋即可)