這篇文章主要介紹了typecho外掛程式編寫教程(三):儲存配置,本文講解了完善方法、如何儲存配置、使用需要注意的問題等內容,需要的朋友可以參考下
上一節我們製作了一個裸外掛程式,下面我們開始讓我們的外掛程式開始工作!
I. 完善方法
兩個方法
我們實現activate和deactivate方法
代碼如下:
public static function activate(){
return 'activate';
}
public static function deactivate(){
return 'deactivated';
}
如上代碼所示,我們在啟用和卸載外掛程式方法中有傳回值,所以在相應操作時會有相應的提示。
完善資訊,使其更接地氣
代碼如下:
public static function activate(){
// do something
return '外掛程式安裝成功,請進入設定填寫准入密鑰';
}
public static function deactivate(){
// do something
return '外掛程式卸載成功';
}
II. 如何儲存配置
准入密鑰在哪裡儲存?當然是資料庫了。
typecho已經為我們實現了Typecho_Widget_Helper_Form類,我們只需要一點代碼就可以擺脫需要自己寫表單的煩惱了。
下圖是表單類的繼承關係,我們可以使用很多類型的表單來儲存我們的選項。
下面我們在config方法中儲存 介面調用地址,類似如下連結(你可以在百度站長平台的連結提交裡找到)
介面調用地址:http://data.zz.baidu.com/urls?site=www.phpgao.com&token=5wK0QtGCzdRzufvW
代碼如下:
public static function config(Typecho_Widget_Helper_Form $form){
//儲存介面調用地址
$element = new Typecho_Widget_Helper_Form_Element_Text('api', null, null, _t('介面調用地址'), '請登入百度站長平台擷取');
$form->addInput($element);
}
初始化參數有5個,他們都是做什麼的?
以下是表單基類的構造方法,他們的功能分別是表單輸入項名稱、選擇項、表單預設值、表單標題、表單描述。
代碼如下:
# var/Typecho/Widget/Helper/Form/Element.php:111
/**
* 建構函式
*
* @access public
* @param string $name 表單輸入項名稱
* @param array $options 選擇項
* @param mixed $value 表單預設值
* @param string $label 表單標題
* @param string $description 表單描述
* @return void
*/
public function __construct($name = NULL, array $options = NULL, $value = NULL, $label = NULL, $description = NULL)
# 以下省略
III. 使用需要注意的問題
修改表單名稱($name)後需要重啟外掛程式才能工作,因為外掛程式啟用後,表單內容就持久化到資料庫中了,禁用外掛程式才能清空該外掛程式的表單設定
Typecho_Widget_Helper_Form_Element_Fake 不用理會
由var/Widget/Plugins/Edit.php我們學到很多表單的進階用法,以後老高會在合適的時候提到