線上書籍

Home

八小時模組開發

一、 使用範例模組
  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，可從這裡下載：
  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