Emlog插件开发..docVIP

/item.htm?idrt=1328600725000prc=1 Emlog插件开发 emlog插件开发手册（基于最新版本emlog 4.0.0） emlog支持插件机制，这样使得开发者可以方便地向emlog中添加自己需要的功能。 1.插件实现原理 在emlog整个运行过程中我们设定了一些动作事件，遇到这些事件时emlog会自动的调用插件绑定到该事件的上的所有插件函数，从而实现插件的功能。 2、插件挂载点 挂载点函数：doAction 本函数内置于emlog核心代码中，就是传说中的插件挂载点。 本函数有一个固定的参数： $hook，$hook是执行动作的名称 其他的参数则可以在调用本函数时依次传入,函数会自动的发送给钩子函数 例子: doAction(save_log,$id); 这是emlog的添加日志事件,在添加日志后会触发,参数为新日志的$id号码. 那么系统会自动的将$id传入到每一个绑定到本事件的钩子函数中。 添加事件调用方法 函数: addAction 本函数是插件用来想挂载点挂载方法的函数，写在插件文件中。 函数有两个参数：$hook, $actionFunc。 $hook 是绑定事件的名称, $actionFunc 是绑定到该事件钩子上的函数名称 例子: addAction(save_log,plugin_addlog); 例子中将plugin_addlog函数绑定到系统的save_log事件中,只要系统执行到了save_log挂载点时,就会调用plugin_addlog函数.  插件文件系统 插件目录：/content/plugins/ 仅识别 “插件目录/插件名/插件名.php” 目录结构的插件。 例如：emlog默认的tips插件,其文件夹名称为tips,程序文件名称为tips.php 插件的激活与关闭 在emlog后台的插件管理中,点击每个插件后的状态按钮即可激活/关闭插件。 自emlog4.0.0起增加激活和关闭插件函数，来完成激活和关闭时的一些初始化工作。 如果插件需要，可以给插件增加 plugin_callback.php 文件，其中包含两个函数： callback_init()为插件激活时调用 callback_rm()为插件关闭时调用 插件前台显示页面 如果想让插件在前台输出一个页面，可以在插件中定义一个 pluginname_show.php 的文件。 此时插件的前台显示地址为：http://博客地址/?plugin=pluginname 这样就可以在pluginname_show.php文件构建插件的页面显示。 插件后台显示配置页面 如果你想让插件在后台输出一个设置页面，可以在插件中定义一个 pluginname_setting.php 的文件 此时插件的后台配置地址为：http://博客地址/admin/plugin.php?plugin=pluginname 3.插件开发标准 插件命名规则 插件名只能以半角的字母、数字、下划线(_)、横杠(-) 组合而成，且只能以字母作为开头 函数/变量命名标准 插件的所有函数/变量采用 插件名_ 作为前缀来命名 例如: $emlogplugin_var emlogplugin_dosomething() 采用这样的命名方式可以避免于其他插件的函数或者变量出现冲突. 插件文件名称 插件主文件名称必须与插件所在文件夹名称相同 设定插件参数的配置程序文件名称必须为 “插件名称_setting.php” (注:该文件为可选,如果你的插件需要用户配置参数才需要该文件来完成配置功能) 例如: emlogplugin/ emlogplugin.php emlogplugin_setting.php 安全性 在插件文件开头增加限制语句 插件函数文件需要增加: !defined(EMLOG_ROOT) exit(access deined!); 如果不增加该语句,那么直接访问插件的程序文件php会爆出博客的物理路径,对博客的安全造成威胁。 如果你的插件需要接收一些参数,请务必严格过滤每一个变量的数据. 例如：获取外部获取一个int型的参数，$id = $_GET[id]; 这样写是