Tad 教材網 - 線上書籍

:::

15-3 上課範例：templates/blocks/new_notes.html

\[1011\]XOOPS 2.5 模組開發
======================

[![](http://tad0616.net/uploads/dl.gif)](http://www.tad0616.net/uploads/tad_book3/file/1011/16.zip)

### 一、 替列表加入分類

1. 我們讓使用者可以點選分類名稱，就列出該分類記事文章。
 ```
<pre class="brush: php;" title="code">
$sql="select a.* , b.`cate_title` from ".$xoopsDB->prefix("tad_notes")." as a left join ".$xoopsDB->prefix("tad_note_cate")." as b on a.cate_sn=b.cate_sn where a.`note_public`='1' order by a.note_sort";
```

3. 多送出二組樣板標籤cate\_sn、cate\_title，樣板也記得修改！
 ```
<pre class="brush: xhtml;" title="code">
<td><a href='index.php?cate_sn=<{$page.cate_sn}>'><{$page.cate_title}></a></td>
```

5. 列出函數也要多一組參數，並修改其內容：
 ```
<pre class="brush: php;" title="code">
$and_cate_sn=empty($cate_sn)?"":" and a.cate_sn='$cate_sn'";
$sql="select a.*, b.cate_title from ".$xoopsDB->prefix("tad_notes")." as a left join ".$xoopsDB->prefix("tad_note_cate")." as b on a.cate_sn=b.cate_sn where a.`note_public`='1'  $and_cate_sn order by a.note_sort";
```

### 二、 加入通知的步驟與流程

1. 在xoops\_version.php中設定好通知的「類別」以及「事件」這兩種設定。
2. 修改 include/notification.inc.php這個檔，好讓通知功能可以取得正確的資料。
3. 在模組樣版中加入一行引入「通知」畫面的樣版語法，讓會員可以在模組或區塊裡看到「通知」的設定畫面。
4. 製作通知內容的樣版，也就是要來設計寄給會員的通知內容。
5. 修改程式，在各個需觸發通知的地方加入觸發事件，例如當有新文章發佈時，那麼就觸發一個通知事件，好讓系統去發出通知給會員。
 
### 三、 在xoops\_version.php中加入通知「類別」設定（索引從1開始）。

1. $modversion\['hasNotification'\] = 1;
2. 「全局通知」類別（使用者觀看文章列表時可設定的通知項目）： 
  - (1) 當有新文章時， 就通知我。
3. 「新文章」的類別（使用者觀看某文章內容時可設定的通知項目）： 
  - (1) 當有針對這個項目的新評論張貼時通知我
  - (2) 將這個項目加入書籤中（沒有通知）
4. 類別格式為：$modversion\['notification'\]\['category'\]\[1\]\['xxx'\] 
  - (1) \['name'\] = '類別名稱'; //「name」用來設定類別的名稱，名稱可自訂，請用英文。如果要設定成「全局」類別，則請填入「global」。
  - (2) \['title'\] = \_標題語系常數;
  - (3) \['description'\] = \_描述語系常數;
  - (4) \['subscribe\_from'\] = array('頁面1.php','頁面2.php',...); //用來設定模組中的哪些頁面會出現此通知「類別」，它的值是一個陣列，例如：「global」類別會出現在index.php及view.php中，其值為：array('index.php','view.php')。
  - (5) \['item\_name'\] = '唯一編號欄位'; //填入「唯一編號欄位」的名稱，例如流水號sn。只有屬於「global」的類別可以不用設定此項，其餘自訂的都要！
  - (6) \['allow\_bookmark'\] = 1; //用來設定該類別是否可使用「書籤」功能。使用者可以從使用者選單中的「通知」裡面看到自己設定的書籤。
 
### 四、 在xoops\_version.php中加入通知「事件」設定（索引從1開始）。

1. 每一個類別底下都會有至少一個的通知「事件」，格式為：$modversion\['notification'\]\['event'\]\[1\]\['xxx'\] 
  - (1) \['name'\] = '事件名稱'; //設定該通知事件的名稱，用以辨識不同的事件，請用英文來命名之。
  - (2) \['category'\] = '所屬類別';
  - (3) \['title'\] = '事件標題';
  - (4) \['caption'\] = '事件內容'; //會出現在通知設定選單中
  - (5) \['description'\] = '事件描述';
  - (6) \['mail\_template'\] = '通知信的樣版名稱'; //不需寫入副檔名，需放在「language/語系/mail\_template」目錄中，副檔名為.tpl，如：new\_doc.tpl。
  - (7) \['mail\_subject'\] = '郵件主題';
  - (8) \['admin\_only'\] = '1'; //設定該事件只有管理者可用
  - (9) \['invisible'\] = '0'; //設定該事件是否為隱藏事件
 
### 五、 若模組有用到「評論功能」或有使用書籤功能需要再加入以下設定：

```
<pre class="brush: php;" title="code">
$modversion['notification']['lookup_file'] = 'include/notification.inc.php';
$modversion['notification']['lookup_func'] = '通知函數名稱';
```

### 六、 產生 include/notification.inc.php這個檔

1. 這個檔主要的用途就是依據「通知類別」以及「唯一編號」來擷取寄發通知時所需要的一些訊息，包括「name」和「url」。
2. 主要的處理函數會接收到兩個參數，包括$category（類別名稱）、 $item\_id（唯一編號值）
 ```
<pre class="brush: php;" title="code">
function get_note_notification($category, $item_id){
  if ($category=='global') {
    $item['name'] = '';
    $item['url'] = '';
    return $item;
  }
  global $xoopsDB;
  if ($category=='cate') {
    $sql = 'SELECT cate_title FROM ' . $xoopsDB->prefix('tad_note_cate') . ' WHERE cate_sn = '.$item_id;
    $result = $xoopsDB->query($sql); // TODO: error check
    $result_array = $xoopsDB->fetchArray($result);
    $item['name'] = $result_array['cate_title'];
    $item['url'] = XOOPS_URL . '/modules/tad_note/index.php?cate_sn=' . $item_id;
    return $item;
    }
}
```

4. 在樣版中加入一行引入「通知」畫面的樣版語法：<{include file='db:system\_notification\_select.html'}>

:::