線上書籍

Home

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

一、模組區塊(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.更新模組,編輯區塊,即可看到效果。