Tad 教材網 - 線上書籍

\[981\]PHP入門+XOOPS模組設計
======================

[![](http://tad0616.net/uploads/dl.gif)](http://120.115.2.76/tad/tad_book3/file/9801/15.zip)

### 一、模組區塊（Blocks）設定

1.$modversion\['blocks'\]\[1\]\['file'\] = "new\_contact.php";  
 區塊主要程式的檔名。區塊程式一律放在「模組目錄/blocks」下。  
 2.$modversion\['blocks'\]\[1\]\['name'\] = "最新通訊錄";  
 區塊的預設名稱  
 3.$modversion\['blocks'\]\[1\]\['description'\] = "列出最新的幾筆資料";  
 區塊的說明。  
 4.$modversion\['blocks'\]\[1\]\['show\_func'\] = "new\_contact";  
 放在區塊主要程式中的執行函數名稱。  
 5.$modversion\['blocks'\]\[1\]\['template'\] = "new\_contact.html";  
 區塊樣板，其位置為「模組目錄/templates/blocks」。  
 6.$modversion\['blocks'\]\[1\]\['edit\_func'\] = "new\_contact\_edit";  
 區塊編輯功能，放在區塊主要程式中的編輯函數名稱。  
 7.$modversion\['blocks'\]\[1\]\['options'\] = "10|0";  
 設定預設值，有區塊編輯功能才需要設定。若是區塊的設定欄位有一個以上，那麼，其預設值請以「|」隔開。

### 二、建立區塊檔案

1.建立blocks目錄，並依照xoops\_version.php中的$modversion\['blocks'\]\[1\]\['file'\]的設定值來建立檔案，如： new\_contact.php  
 2.主函數的名稱必須和xoops\_version.php中的$modversion\['blocks'\]\[1\]\['show\_func'\]設定值一樣。  
 3.其中若有連結，需注意必須使用「絕對位置」  
 4.主函數的目的僅在於從資料庫抓出資料，送到區塊樣板中。

### 三、建立區塊樣版檔

1.在templates底下建立blocks目錄，並依照xoops\_version.php中$modversion\['blocks'\]\[1\] \['template'\]的值來建立檔案，如： new\_contact.html  
 2.new\_contact.html 區塊樣版檔的內容暫時一行即可：<{$block}>  
 3.接著更新一下模組，就可以開始使用區塊了！

### 四、加入區塊編輯介面函數

1.我們在原先的區塊程式new\_contact.php 加入一個區塊編輯介面函數。  
 2.編輯介面函數的目的就是產生區塊的設定介面，其名稱必須和xoops\_version.php中的$modversion\['blocks'\]\[1\] \['edit\_func'\]設定值一致。  
 3.編輯介面函數其實就是一個網頁表單而已，只不過不需要<form></form>。  
 4.表單欄位的預設值即為xoops\_version.php中的$modversion\['blocks'\]\[1\] \['options'\]設定值。預設值的傳遞及使用均透過$options陣列。

### 五、修改顯示函數

1.區塊顯示還數若要使用區塊的設定值，可以直接引入$options參數  
 2.xoops\_version.php中的$modversion\['blocks'\]\[1\]\['options'\]的設定值，根據「|」拆開後，第一個值就是$option\[0\]，第二個值就是$option\[1\]依此類推。  
 3.請將$option\[0\]、$option\[1\]套用到該用的地方。  
 4.更新模組，編輯區塊，即可看到效果。

:::