Tad 教材網 - 線上書籍

:::

XOOPS 模組開發
==========

### 一、 XOOPS的模組管理後台

1. XOOPS並沒有規定一定要有管理後台，若是沒有管理後台，只要在xoops\_version.php中把$modversion\['hasAdmin'\]設為0即可。
2. $modversion\['adminindex'\] = 'admin/index.php'; 這是定義當使用者點選模組管理時，要連到的後台預設頁面。
3. $modversion\['adminmenu'\] = 'admin/menu.php'; 這是定義後台模組管理界面的其他功能選單。
 
### 二、 模組管理後台選單檔

```
<pre class="brush:php;" title="code">
$i++;
$adminmenu[$i]['title'] = _MI_TH_ADMENU1;
$adminmenu[$i]['link'] = "admin/main.php";
$adminmenu[$i]['desc'] = _MI_TH_ADMENU1_DESC ;
$adminmenu[$i]['icon'] = "images/admin/main.png";
```

1. 每多一個功能選項，請多一組以下設定，有中文的地方盡量用常數（直打中文也行，只是這樣只有相同編碼的網站才能使用）。
2. 其中路徑部份是以該模組目錄為基準。
3. 其中desc和icon都是新架構才有的東西，圖片大小一律為32x32。
4. 圖示可以到這裡找：<http://findicons.com>
 
### 三、 模組管理後台架構

```
<pre class="brush:php;" title="code">
<?php
/*
main.php 是模組後台的主要內容頁面（入口）。
但並不一定要叫做 main.php ，您愛命名為什麼都行，只要 menu.php 設定好就好。
*/

/*------------------ 檔頭（引入檔案） ------------------*/
//使用樣板檔
$xoopsOption['template_main'] = "後台樣板檔.html";
//引入 XOOPS 後台檔案檔頭（必要）
include 'header.php';
//引入共同檔案設定檔（必要）
include_once "../function.php"; //引入自訂的共同函數檔

/*------------------ 流程判斷（告訴程式現在要做什麼） -----------------*/

//$op 為XOOPS常用之動作變數，用來告知程式欲執行之動作
$op=isset($_REQUEST['op'])?$_REQUEST['op']:"";

//判斷目前動作該執行哪一個
switch($op){
  //當 $op 的值等於「動作1」時，欲執行的動作
  case "動作1":
  admin_do_something();
  break;

//預設動作
  default:

break;
}

/*------------------ 所有函數（實際執行動作） ------------------*/

//當 $op 的值等於「動作1」時，欲執行的函數
function admin_do_something(){

}

/*------------------ 檔尾（輸出內容到樣板） ------------------*/
include "footer.php"; //XOOPS檔尾

?>
```

1. 後台檔案最基本架構如下，前後兩行是必備的其他部份則是建議使用的架構。
 
### 四、套用樣板檔

1. admin/main.php 中的 $xoopsOption\['template\_main'\] 請設定一個網頁樣板檔： ```
  <pre class="brush:php;">
  //使用樣板檔
  $xoopsOption['template_main'] = "tad_honor_adm_main.html";
  ```
2. xoops\_version.php 要加入一個樣板設定，這樣 XOOPS 才知道要載入您的樣板檔： ```
  <pre class="brush:php;">
  $modversion['templates'][$i]['file'] = 'tad_honor_adm_main.html';
  $modversion['templates'][$i]['description'] = 'tad_honor_adm_main.html';
  ```
3. 實際去生出 tad\_honor\_adm\_main.html ，樣板檔一律放在 templates 下： ```
  <pre class="brush:xml;">
  
  <link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_url}>/modules/tadtools/bootstrap/css/bootstrap.css" />
  <link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_url}>/modules/tadtools/bootstrap/css/bootstrap-responsive.css" />
  <link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_url}>/modules/tadtools/css/xoops_adm.css" />
  
  <h1>校園榮譽榜管理</h1>
  ```
4. 更新模組，以便讓XOOPS重讀xoops\_version.php，以便載入 tad\_honor\_adm\_main.html 樣板檔。
 
### 四、將自己設定的樣板標籤套用到樣板檔中

1. XOOPS的樣板物件為 $xoopsTpl
2. 套用樣板標籤到樣板檔的方法為（寫在 php 檔中）： ```
  <pre class="brush:php;">
  //利用 global 讓 $xoopsTpl 可以在函數中使用
  global $xoopsTpl;
  
  //$xoopsTpl->assign("樣板標籤" , "欲呈現的內容");
  $xoopsTpl->assign('temp_title' , '榮譽榜編輯表單');
  ```
3. 樣板檔中的寫法： ```
  <pre class="brush:xml;">
  <h1><{$temp_title}></h1>
  ```

:::