这篇文章主要介绍了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我们学到很多表单的高级用法,以后老高会在合适的时候提到