這篇文章主要介紹了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我們學到很多表單的高級用法,以後老高會在合適的時候提到