emlog支持插件机制，这样使得开发者可以方便地向emlog中添加自己需要的功能。

一、插件实现原理

在emlog整个运行过程中我们设定了一些动作事件，遇到这些事件时emlog会自动的调用插件绑定到该事件的上的所有插件函数，从而实现插件的功能。

二、插件挂载点

挂载点

函数：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

三、插件开发标准

插件命名规则

插件名只能以半角的字母、数字、下划线()、横杠(-) 组合而成，且只能以字母作为开头。

函数/变量命名标准

插件的所有函数/变量采用 "插件名" 作为前缀来命名。

例如：$emlogplugin_var emlogplugin_dosomething() 

采用这样的命名方式可以避免于其他插件的函数或者变量出现冲突.。

插件文件名称

插件主文件名称必须与插件所在文件夹名称相同，设定插件参数的配置程序文件名称必须为 “插件名称_setting.php” (注:该文件为可选，如果你的插件需要用户配置参数才需要该文件来完成配置功能)。

例如：emlogplugin/emlogplugin.php emlogplugin_setting.php

安全性

在插件文件开头增加限制语句，插件函数文件需要增加: 

!defined('EMLOG_ROOT') && exit('access deined!'); 

如果不增加该语句，那么直接访问插件的程序文件php会爆出博客的物理路径，对博客的安全造成威胁。 

如果你的插件需要接收一些参数，请务必严格过滤每一个变量的数据。

例如：获取外部获取一个int型的参数，$id = $_GET['id']，这样写是不安全的，要改为：$id = intval($_GET['id'])； 如果是一个字符型的参数，$action = $_GET['action']，这样写也是不安全的，要改为：$action = addslashes($_GET['action'])。

更多安全方面的内容可以参考一下这篇文章《PHP 安全指南》

前台链接使用绝对地址。

四、当前插件挂载点及说明

1、挂载点：doAction('adm_main_top')

• 所在文件：admin/views/header.php
• 描述：后台红线区域扩展

2、挂载点：doAction('adm_head')

• 所在文件：admin/views/header.php
• 描述：后台头部扩展：可以用于增加后台css样式、加载js等

3、挂载点：doAction('adm_siderbar_ext')

• 所在文件：admin/views/header.php
• 描述：后台侧边栏 功能扩展 子菜单扩展，用于插件单独页面。

4、挂载点：doAction('save_log', $blogid)

• 所在文件：admin/save_log.php
• 描述：新增日志、修改日志扩展点

5、挂载点：doAction('del_log', $key)

• 所在文件：admin/admin_log.php
• 描述：删除日志操作扩展点

6、挂载点：doAction('adm_writelog_head', $key)

• 所在文件：
• admin/add_log.phpadmin/add_page.phpadmin/edit_log.php
• admin/edit_page.php
• 描述：可以再红框处显示扩展内容，如插入网络相册照片的插件。

7、挂载点：doAction('comment_post')

• 所在文件：./index.php
• 描述：发表评论扩展点（写入评论前）。可用于垃圾评论防范

8、挂载点：doAction('comment_saved’)

• 所在文件：include/model/comment_model.php
• 描述：发表评论扩展点（写入评论后）。用于发布评论成功的后续操作，如发通知邮件

9、挂载点：doAction('log_related',$logData)

• 所在文件：content/templates/default/echo_log.php
• 描述：阅读日志页面扩展点、用于增加日志相关内容

10、挂载点：doAction('index_head')

• 所在文件：Content/templates/default/header.php
• 描述：前台头部扩展：可以用于增加前台css样式、加载js等

11、挂载点：doAction('index_footer')

• 所在文件：content/templates/default/footer.php
• 描述：首页底部扩展点

12、挂载点：doAction('comment_reply', $commentId, $reply)

• 所在文件：admin/comment.php
• 描述：回复评论扩展点

13、挂载点：doAction('data_prebakup')

• 所在文件：admin/data.php
• 描述：扩展备份数据库页面，可以对插件增加的表进行备份

14、挂载点：doAction('rss_display')

• 所在文件：rss.php
• 描述：Rss输出扩展

15、挂载点：doAction('attach_upload')

• 所在文件：include/lib/function.base.php
• 描述：扩展附件上传，如增加图片水印效果等

16、挂载点：doAction('url_rewrite')

• 所在文件：include/lib/function.base.php
• 描述：扩展url重写，可以自定义其他url优化方案

17、挂载点：doAction('adm_comment_display')

• 所在文件：admin/views/comment.php
• 后台评论显示扩展，可以用于查询评论人ip所在地域

18、挂载点：doAction('index_loglist_top')

• 所在文件：content/templates/default/log_list.php
• 描述：日志列表顶部扩展点，如显示公告等

19、挂载点：doAction('diff_side')

• 所在文件：content/templates/default/side.php
• 描述：侧边栏控制扩展点

20、挂载点：doAction('reply_twitter', $r, $name, $date, $tid)

• 所在文件：t/index.php
• 描述：回复碎语扩展点，用于回复邮件提醒等

21、挂载点：doAction('post_twitter', $t)

• 在文件：
• /m/index.php
• /admin/twitter.php
• 描述：发布碎语扩展点，用于碎语和其他微博类产品同步等

22、挂载点：doAction('adm_footer')

• 所在文件：admin/views/footer.php
• 描述：后台底部扩展：可以用于增加后台js等

免费，高速。 禁止上传违规图片。自适应：Kindeditor、Ueditor。

更新日志

修正：CSS错位

优化：队列引擎

新增：停止功能

新增：错误提示

PS：SM图床接口升级，此插件已失效。

看板小人，两个样式。也是自己喜欢的样式。

自定义文章关键词让其跳转到指定链接，从而实现seo优化及信息聚合

顾名思义就是在每个文章底部生成链接的二维码和版权声明。

1.清晰明了的后台，一键开启。

2.将下载的文件解压上传到content/plugins。

3.挂载点 doAction('ttjtg_taobaoke')。

文章二维码，支持qrcode.js作为二维码接口，支持草料api接口(已美化二维码)。

自定义二维码高度，宽度，线条颜色以及二维码背景色。

支持SSL开关。

请检查echo_log.php文章是否有log_related挂载点，没有请添加。

相信大家都见过诸多的WordPress大牛的网站都有独立页面页面吧，可是他们怎么实现的呢？一直是个迷，有人说是在子目录新建一个站点，但事实上并不是这样，因为维护起来成功很大，而且还会增加服务器的负载，得不偿失。

而Emlog也支持此功能，相信很多人都使用过蓝叶以及孤狼的下载插件，都是是很不错的插件，也有很多修改版的插件，但是个人使用起来感觉不太符合自己的需求，所以自己搞一个，开整！

更新日志

新增文件同步，不再用FTP上传文件。

修复已知BUG。

优化代码逻辑。

投稿页默认嵌入前台页面，与某些插件存在兼容问题，建议使用独立模板。

如需更换模板，用压缩包里的front文件夹，替换content/plugins/qiukong_submit/front文件夹即可。

更新日志

贴图库回调变更

文章页内容下方，加入一个文章读后感表态功能，用户可以对文章进行表情评论。

仿搜狐畅言的心情读后感，完全本地化，可以防止重复投票。

本插件基于数据库查询后生成缓存文件的，由于5.1.2以下版本的数据库与5.1.2之后的数据库不相同，所以不能用于5.1.2以下的版本。