Tad 教材網 - 線上書籍

:::

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

[![](http://tad0616.net/uploads/dl.gif)](http://www.tad0616.net/uploads/tad_book3/file/1041/3.pdf)

### 一、 smarty樣板

1. 樣板（template）是使用者眼睛看到的界面，我們經由程式產生的任何結果，都可以傳送至樣板以便呈現在畫面上。
2. 樣板檔=html檔+smarty樣板標籤，樣板標籤看起來像這樣：<{$樣板標籤}>
3. XOOPS透過$xoopsTpl物件，來將PHP產生的值套用到樣板中（即樣板標籤）：
4. $xoopsTpl->assign('樣板標籤' , $值);
5. 若是在函數中要使用$xoopsTpl樣板物件，記得用global $xoopsTpl，才能使用。
6. 若要在樣板中直接使用語系，請用：
7. <{$smarty.const.\_語系名稱}>
 
### 二、 smarty迴圈：製作樣板標籤二維陣列變數

1. 樣板標籤除了一次傳一個值外，也可以傳陣列，方法一模一樣，但陣列格式必須像這樣： <table border="1" cellpadding="1" cellspacing="1" style="width: 100%;"> <tbody> <tr> <td>資料庫</td> <td>二維陣列格式</td> <td>實際範例</td> </tr> <tr> <td>第一筆資料</td> <td>$陣列名稱\[0\]\['索引名稱1'\]  
   $陣列名稱\[0\]\['索引名稱2'\]  
   $陣列名稱\[0\]\['索引名稱3'\]</td> <td>$list\_ebook\[0\]\['ebook\_sn'\]=1;  
   $list\_ebook\[0\]\['ebook\_title'\]="第一期 創刊號";  
   $list\_ebook\[0\]\['ebook\_post\_date'\]="2015-04-15";</td> </tr> <tr> <td>第二筆資料</td> <td>$陣列名稱\[1\]\['索引名稱1'\]  
   $陣列名稱\[1\]\['索引名稱2'\]  
   $陣列名稱\[1\]\['索引名稱3'\]</td> <td>$list\_ebook\[1\]\['ebook\_sn'\]=2;  
   $list\_ebook\[1\]\['ebook\_title'\]="第二期 會考特輯";  
   $list\_ebook\[1\]\['ebook\_post\_date'\]="2015-05-15";</td> </tr> </tbody> </table>
2. 利用 $ebook = $xoopsDB->fetchArray($result); 剛好可以取得一維陣列，即： <table border="1" cellpadding="1" cellspacing="1" style="width: 100%;"> <tbody> <tr> <td>$ebook\['ebook\_sn'\]=1;  
   $ebook\['ebook\_title'\]="第一期 創刊號";  
   $ebook\['ebook\_post\_date'\]="2015-04-15";</td> <td>該筆資料的「ebook\_sn」欄位值  
   該筆資料的「ebook\_title」欄位值  
   該筆資料的「ebook\_post\_date」值</td> </tr> </tbody> </table>
3. 也就是說，在while迴圈中，再給予一個數字索引即可完成所需的二維陣列 ```
  <pre class="brush:php;">
  //用$i做第一個索引，這裡先設初始值
  $i=0;
  //設定二維陣列變數的初始值
  $list_ebook="";
  //用迴圈一筆一筆抓出資料庫的數據
  while($ebook = $xoopsDB->fetchArray($result)){
    //將抓出的數據陣列，放到一維陣列中
    $list_ebook[$i]=$ebook;
    //索引值+1
    $i++;
  }
  //將此陣列套用到樣板標籤 list_ebook
  $xoopsTpl->assign('list_ebook' , $list_ebook);
  ```
 
### 三、 smarty迴圈：套用二維陣列變數的樣板標籤

1. 做好二維陣列並套用到樣板後，可以利用<{foreach}>的方式來一筆一筆讀出陣列值： <table border="1" cellpadding="1" cellspacing="1" style="width: 100%;"> <tbody> <tr> <td><{foreach from=$list\_ebook item=ebook}>  
   <tr>  
   <td><{$ebook.ebook\_sn}></td>  
   <td><{$ebook.ebook\_title}></td>  
   <td><{$ebook.ebook\_post\_date}></td>  
   <td><{$ebook.ebook\_publish\_date}></td>  
   </tr>  
   <{/foreach}></td> <td>從$list\_ebook擷取一筆資料，並塞入ebook樣板標籤中  
   建立一列表格  
   秀出期刊編號  
   秀出期刊標題  
   秀出投稿截止日  
   秀出發行日  
   一列結束  
   迴圈結束</td> </tr> </tbody> </table>
2. from就是來自PHP的二維陣列變數
3. item就是設定樣板標籤名稱，以便將該變數取出陣列值後，塞進此樣板標籤
4. 樣板標籤若是陣列，其表示方式為：<{$樣板標籤.索引名稱}>
 
### 四、 BootStrap表格

1. 在表格標籤加入 class="table table-striped table-bordered table-hover"
2. table-striped 會出現斑馬紋，較容易辨識
3. table-bordered 會加入表格框線
4. table-hover 移過去該列會變色，較醒目
 
### 五、 在樣板檔中加入刪除的功能連結

1. 利用 get 的傳遞方式可過連結來傳遞各種參數，格式為： ```
  <pre class="brush:xml;">
  <a href="檔案.php?參數1=值1&參數2=值2&參數3=值3">連結名稱</a>
  ```
2. 流程控制是利用$op，所以需傳遞一個op變數，以便告訴程式接下來要執行什麼動作。
3. 此外，還要傳遞流水號，如此，才能知道要刪除哪一筆資料（編號請用樣板標籤）： ```
  <pre class="brush:xml;">
  <a href="main.php?op=delete_ebook&ebook_sn=編號">刪除</a>
  ```
 
### 六、 在php檔的流程控制中加入刪除

1. 一旦有設定一組op的動作（如op=delete\_ebook），接收端（main.php）就必須在流程控制的switch中加入一組 case "delete\_ebook": 的對應動作。 ```
  <pre class="brush:php;">
  //若$op=del_ebook時
  case "del_ebook":
    //執行del_ebook()函數以刪除資料
    del_ebook($ebook_sn);
    //刪除後轉向回自己這頁
    header("location:{$_SERVER['PHP_SELF']}");
    //停止程式
    exit;
  //跳出流程（基本上執行不到...）
  break;
  ```
2. 由於del\_ebook()需要傳入期刊編號$ebook\_sn，此編號用get方式傳來，但未來易可能從post方式傳來，故在流程控制之前，可先產生$ebook\_sn的初始值： ```
  <pre class="brush:php;">
  $ebook_sn=empty($_REQUEST['ebook_sn'])?"":intval($_REQUEST['ebook_sn']);
  ```
3. 這是三元一次式的寫法：(條件)?真:假;
4. intval()用來強制數字化，用$\_REQUEST則可接收來自get、post、cookie的變數。
 
### 七、 刪除資料庫資料

1. 在資料庫中要刪除資料的SQL語法： ```
  <pre class="brush:sql;">
  delete from 資料表where 條件
  ```
2. 執行刪除或更新等動作時，需用 $xoopsDB->queryF($sql) 來強制執行 SQL 語法。
 
### 八、 加入確認後刪除

1. 先修改原先的刪除連結，改為執行javascript函數 ```
  <pre class="brush:xml;">
  <a href="javascript:del_ebook_func(編號)" class="btn btn-mini btn-danger">刪除</a>
  ```
2. 在樣板中，加入以下javascript函數語法（需在執行之前） <table border="1" cellpadding="1" cellspacing="1" style="width: 100%;"> <tbody> <tr> <td><script>  
   function del\_ebook\_func(sn){  
   var sure = window.confirm('確定要刪除此資料？');  
   if (!sure) return;  
   location.href="main.php?op=del\_ebook&ebook\_sn=" + sn;  
   }  
   </script></td> <td>script起始標籤  
   定義del\_ebook\_func(ebook\_sn)函數  
   使用確認框，將使用者的選擇存入sure變數  
   假如按「否」，則跳出函數，不執行刪除  
   跳轉頁面至main.php，並帶參數，+是連接符，連接sn參數  
     
   script結束標籤</td> </tr> </tbody> </table>
 
### 九、 加入修改功能

1. 和加入刪除的動作差不多，但op值可改為edit\_ebook，一樣要傳遞流水號。
2. 新增一組edit\_ebook流程，直接呼叫原有的表單函數ebook\_form($ebook\_sn)，並傳入流水號，以便修改之。換言之，有傳入流水號即修改，沒傳入流水號即新增。
3. 在ebook\_form()函數加入一組$ebook\_sn參數。
4. 修改時，需讀出原有資料，並將之設為表單元件預設值。
5. 記得將$xoopsDB物件設為global，以便在函數中使用。 ```
  <pre class="brush:php;">
  
  // 假如有流水號（更新模式）
  if($ebook_sn){
    // 先加入資料表前置字串
    $tbl=$xoopsDB->prefix('ebook');
    // 讀取指定流水號的所有資料
    $sql="select * from $tbl where $ebook_sn='$ebook_sn'";
    // 送出執行，執行失敗則停止，並秀出原因
    $result=$xoopsDB->query($sql) or die(mysql_error());
    // 利用list()將得到的一筆結果，四個欄位值，分別塞入四個指定變數中。
    list($ebook_sn,$ebook_title,$ebook_post_date,$ebook_publish_date) = $xoopsDB->fetchRow($result);
    // 設定$op值為 update_ebook
    $op="update_ebook";
    // 將投稿截止日的日期轉為時間戳記
    $ebook_post_date=strtotime($ebook_post_date);
    // 將發行日的日期轉為時間戳記
    $ebook_publish_date=strtotime($ebook_publish_date);
  // 若沒有傳入流水號（新增模式）
  }else{
    // 標題和編號初始值均為空值
    $ebook_title=$ebook_sn="";
    // 投稿截止日設為現在時間
    $ebook_post_date=time();
    // 發行日設為現在時間
    $ebook_publish_date=time();
    // 設定$op值為insert_ebook
    $op="insert_ebook";
  }
  ```
6. op的值記得改為變數，變根據不同情形，使用不同op。另加入ebook\_sn的隱藏欄位，以便將流水號帶給下一個動作。 ```
  <pre class="brush:php;">
  $form->addElement(new XoopsFormHidden('ebook_sn', $ebook_sn));
  $form->addElement(new XoopsFormHidden('op', $op));
  ```
 
### 十、 編輯時無須秀出列表

1. 修改樣板檔，在列出所有期刊列表的語法前後，利用<{if $list\_ebook}><{/if}>將之包起來，如此，只有在有傳入$list\_ebook二維陣列時，才會出現列表。
2. 編輯時，並不會產生$list\_ebook陣列，故列表剛好可以隱藏，無須出現。
 
### 十一、 更新資料庫資料

1. 在流程新增一組update\_ebook的流程，並建立update\_ebook函數
2. 在資料庫中要更新資料的SQL語法： ```
  <pre class="brush:sql;">
  update 資料表 set 欄位1='值1' ,  欄位2='值2' , … where 條件
  ```
 
### 十二、 BootStrap按鈕

1. 在<a>或<button>標籤中，加入 class="btn" 可使用bootstrap的按鈕風格
2. btn-mini 可以讓按鈕縮小，另有btn-small或btn-large
3. btn-primary 藍色按鈕，用在主功能按鈕，例如「送出」、「儲存」、「查詢」
4. btn-warbing 黃色按鈕，有警告意味，例如「修改」
5. btn-danger 紅色按鈕，較重要或危險之動作，例如「刪除」
6. 另有btn-success 綠色按鈕及btn-info淺藍色按鈕可套用。

:::