默认接口
在Typecho中只要这个类是继承自Typecho_Widget基类,它就默认具备了这个插件接口。接口开发者可以使用这个接口无缝地向当前的Class中注入方法
比如我要给Widget_Archive类增加一个方法获取当前文章的字数(charactersNum),只需要在你的插件`activate`方法中声明
Typecho_Plugin::factory('Widget_Archive')->___charactersNum = array('MyPlugin', 'charactersNum');
注意,我们在方法名前面加三个下划线表示这是一个内部方法。而实现这个方法也很简单,因为系统会将当前的对象作为参数传递给你
public static function charactersNum($archive){ return mb_strlen($archive->text, 'UTF-8');}
那么这个方法就已经植入到Widget_Archive中去了,你在模版中可以直接调用如下代码输出它
<?php $this->charactersNum(); ?>
Widget接口
Widget_Archive
接口 | 参数 | 描述 |
---|---|---|
indexHandle |
|
当访问最近文章首页以及分页时被触发 |
error404Handle |
|
当访问404页面时被触发 |
singleHandle |
|
当访问单独页面时被触发(文章,页面,附件) |
categoryHandle |
|
当访问按分类归档页面时被触发 |
tagHandle |
|
当访问按标签归档页面时被触发 |
authorHandle |
|
当访问按作者归档页面时被触发 |
dateHandle |
|
当访问按日期归档页面时被触发 |
search |
|
这是一个独占接口,当访问搜索页面时被触发 当这个接口被实现后,系统自己的搜索动作将不会继续,你需要在这个接口内自己push搜索的数据到Widget_Archive对象 此接口多用于自己实现站内搜索来替换默认的 |
searchHandle |
|
当访问搜索页面时被触发 |
query |
|
Widget_Archive所有的数据库查询动作最终将由一个query方法来执行 此接口在query方法内,多用于hack某些查询语句 |
select |
|
|
handleInit |
|
|
handle |
|
|
pageNav |
|
|
headerOptions |
|
|
header |
|
|
footer |
|
|
beforeRender |
|
|
afterRender |
|
|
commentFeedItem |
|
|
feedItem |
|
Widget_Feedback
接口 | 参数 | 描述 |
---|---|---|
comment |
|
|
finishComment |
|
|
trackback |
|
|
finishTrackback |
|
Widget_Login
接口 | 参数 | 描述 |
---|---|---|
loginFail |
|
|
loginSucceed |
|
Widget_Logout
接口 | 参数 | 描述 |
---|---|---|
logout |
无 |
Widget_Register
接口 | 参数 | 描述 |
---|---|---|
register |
|
|
finishRegister |
|
Widget_Upload
接口 | 参数 | 描述 |
---|---|---|
beforeUpload |
|
|
upload |
|
|
beforeModify |
|
|
modify |
|
Widget_User
接口 | 参数 | 描述 |
---|---|---|
login |
|
|
hashValidate |
|
|
loginSucceed |
|
发表回复