Typecho插件开发从入门到精通：手把手教你打造专属功能插件

52JinY 助手

最近有几个朋友问我怎么给Typecho写插件，我之前也踩过不少坑，干脆整理一下经验发出来，希望对想入门的朋友有点帮助。

先说说基础结构。Typecho的插件其实比WordPress的要简洁很多，门槛不算太高，但文档一直是个老大难问题，官方文档说实话有点残破，很多东西要靠看源码和别人的插件来学。一个最基本的插件，需要在 /usr/plugins/ 目录下新建一个文件夹，文件夹名就是插件名，然后在里面创建 Plugin.php 文件。这个文件里要定义一个类，类名和文件夹名一致，继承 Typecho_Plugin_Abstract，然后实现两个必须的静态方法：activate() 和 deactivate()，分别对应插件启用和停用时的操作。另外还有一个 config() 方法用来渲染配置界面，个人配置用 personalConfig()，这两个不是强制的，看你插件需不需要配置项。

钩子系统是整个插件机制的核心，理解了这个基本上就理解了一半。Typecho用的是观察者模式，通过 Typecho_Plugin::factory() 来绑定钩子。比方说你想在文章输出内容的时候做些处理，就可以挂载到 Widget_Abstract_Contents 的 contentEx 方法上，大概写法是 Typecho_Plugin::factory('Widget_Abstract_Contents')->contentEx = array('MyPlugin_Plugin', 'myMethod')。这里要注意一个细节，等号左边绑定的那个方法名，必须是Typecho源码里真实存在的插件接口点，不能随便写，所以看源码这步真的省不了。

配置项这块我建议稍微花点时间做好，因为很多插件的配置页面做得很糙，用户体验差。config() 方法接收一个 $form 参数，你通过这个对象来添加表单字段，比如文本框用 Typecho_Widget_Helper_Form_Element_Text，下拉框用 Select，多选用 Checkbox，这些类都在 /var/Widget/Helper/Form/Element/ 下面可以找到。读取配置的时候用 Helper:ptions()->plugin('插件名') 来获取，很方便。

说一个容易绕弯子的地方，就是多语言支持。如果你的插件想支持中英双语，需要在插件目录里建 lang 文件夹，然后放对应的语言文件。但老实说，如果只是自用或者面向中文用户的小插件，这个可以先不管，等功能稳定了再加也来得及，别一开始把自己搞得太复杂。

调试方面，Typecho默认不怎么显示错误，开发的时候建议在 config.inc.php 里把 debug 模式打开，或者直接在插件里临时用 var_dump() 加 exit() 来定位问题。另外插件如果激活失败会直接被系统禁用，后台会有提示，这时候去看 PHP 的 error log 比较高效，别傻傻地在后台界面死等。

最后说一句真心话，学插件开发最好的方式就是找一个功能接近的开源插件，把它的代码拆开来读，比看任何教程都来得直接。Github上有不少质量不错的Typecho插件，比如Handsome主题配套的一些插件，代码写得比较规范，可以参考。自己动手写几个小功能练练手，比如给评论加个表情包选择，或者给文章加个访问量统计，门槛都不高，做出来也有成就感。慢慢来，一步步来，Typecho的生态虽然不大，但做起来真的挺有意思的。