Tad 教材網 - 線上書籍

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

###  一、 模組套用簡易樣板步驟

```
<pre class="brush: php;" title="code">
$modversion['templates'][1]['file'] = 'tad_honor_index_tpl.html';
$modversion['templates'][1]['description'] = 'index.php的樣板';
```

```
<pre class="brush: php;" title="code">
$xoopsOption['template_main'] = "tad_honor_index_tpl.html";
```

1. 請到xoops\_version.php做以下設定。設定也是兩個一組，陣列從1開始。
2. - <span style="background-color: rgb(255, 255, 153);">$modversion\['templates'\]\[1\]\['file'\] = 'tad\_honor\_index\_tpl.html';</span>  
       檔名盡量特別，別和其他樣板檔相衝。
  - <span style="background-color: rgb(255, 255, 153);">$modversion\['templates'\]\[1\]\['description'\] = "佈景說明";</span>  
       樣板描述，從後台的樣板管理就會看得到。（常數不用加引號，不然系統讀不到）
3. 建立templates/tad\_honor\_index\_tpl.html，該檔內容一行即可，樣板碼可自訂：<{$樣板碼}> 例如：<{$content}>
4. 到後台更新您的模組，讓XOOPS重讀xoops\_version.php設定檔。
5. 在index.php前面加入
6. 用「<span style="background-color: rgb(204, 255, 204);">$xoopsTpl->assign( "content" , $main) ;</span>」來把內容套入樣板，其中 content就是樣板標籤<{$content}>，而$main就是要套用進去的內容。
7. $xoopsTpl是在header.php產生的物件，所以，<span style="color: rgb(255, 0, 0);">$xoopsTpl必須在header.php之後使用</span>。若要在函數中使用，記得<span style="color: rgb(255, 0, 0);">global $xoopsTpl;</span>
 
###  二、 設一個獨立頁面view.php

```
<pre class="brush: php;" title="code">
$xoopsOption['template_main'] = "tad_honor_view_tpl.html";
```

```
<pre class="brush: php;" title="code">
$modversion['templates'][2]['file'] = 'tad_honor_view_tpl.html';
$modversion['templates'][2]['description'] = 'view.php的樣板';
```

1. 將總列表和單一頁面都設在index.php，這樣雖然可以，但要套用比較精細的樣板時，難度會增加許多，因此建議增設一個獨立頁面，也就是秀出單一文章用的頁面，如此在製作樣板時會更簡單。
2. 另存index.php為view.php，並留下顯示頁面的函數，其餘函數及流程均可刪除。另外，此頁套用新的樣板檔：
3. 將樣板檔 tad\_honor\_index\_tpl.html 複製為 tad\_honor\_view\_tpl.html
4. 到xoops\_version.php多一組樣板設定：
5. 到後台更新模組。
6. 修改index.php中的連結至view.php，搜尋檔的$ret\[$i\]\['link'\]也一樣需要修改。
 
###  三、 精細的樣板

1. 把樣板細分成各種網頁元件，由樣板提供標籤，PHP負責產生標籤所需的套用值。
2. 按照樣版產生流程，替view.php產生一組樣板tad\_honor\_view.html，其內容為： tad\_honor\_view.html ```
  <pre class="brush: xhtml;" title="code">
  <h1>恭賀「<{$students}>」</h1>
  
  <div>
    恭喜 <b><{$students}></b> 於 <b><{$date}></b> 榮獲 <b><{$descript}></b>
  
    <{if $teachers}>
      <div>指導老師：<{$teachers}></div>
    <{/if}>
  </div>
  
  
  <{if $note}>
    <p><{$note}></p>
  <{/if}>
  ```
  
   view.php ```
  <pre class="brush: php;" title="code">
    $xoopsTpl->assign( "date" , $all['honor_date']) ;
    $xoopsTpl->assign( "students" , $all['honor_students']) ;
    $xoopsTpl->assign( "descript" , $all['honor_descript']) ;
    $xoopsTpl->assign( "teachers" , $all['honor_teachers']) ;
    $xoopsTpl->assign( "note" , $all['honor_note']) ;
  ```
 
###  四、 Smarty迴圈

1. 列表部份需要用到smarty迴圈。  
   tad\_honor\_index.html ```
  <pre class="brush: xhtml;" title="code">
  <table style='font-size:11pt;'>
  <{foreach item=honor from=$honor}>
    <tr>
      <td><a href='view.php?honor_sn=<{$hono.honor_sn}>'>
  <{$honor.honor_students}></a></td>
      <td><{$honor.honor_date}></td>
      <td><{$honor.honor_descript}></td>
      <td><{$honor.honor_teachers}></td>
    </tr>
  <{/foreach}>
  </table>
  <div align='center'><{$bar}></div>
  ```
  
   index.php ```
  <pre class="brush: php;" title="code">
  $i=0;
  while($all=$xoopsDB->fetchArray($result)){
  //處理部份省略
    $main[$i]['honor_sn']=$all['honor_sn'];
    $main[$i]['honor_students']=$all['honor_students'];
    $main[$i]['honor_date']=$all['honor_date'];
    $main[$i]['honor_descript']=$all['honor_descript'];
    $main[$i]['honor_teachers']=$all['honor_teachers'];
    $i++;
  }
  $xoopsTpl->assign( "honor" , $main) ;
  $xoopsTpl->assign( "bar" , $bar) ;
  ```
 
 五、在樣板中使用模組語系常數

若語系中有如下定義：

```
<pre class="brush:php;">
define("_MI_HONOR_YEAR" , "學年度");
```

那麼在樣板中就可以用這種方式呼叫該常數： ```
<pre class="brush:xml;">
<{$smarty.const._MI_HONOR_YEAR}>
```

:::