線上書籍

Home

[1011]XOOPS 2.5 模組開發

一、 XOOPS模組結構
  1. 一個XOOPS模組就是一個目錄，此目錄會放在modules底下。
  2. 底下是新的（2.5之後的）XOOPS的模組目錄建議結構（PHP > 5.2）：
    3. 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. 其實您完全不管這個結構也是無所謂的，但粗體黃底的目錄（如果有用到該功能的話）則是一定要有的，而且不能亂改目錄名稱！（斜體為新的2.5模組建議目錄）
  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['status_version']模組狀態可以是Alpha、Beta、RC、Release
  6. $modversion['adminmenu']後台選單的圖示為32x32，可從這裡下載：
  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修正檔下載：修正開除錯功能無法正常使用之bug（解壓→上傳→覆蓋即可）