来自舍力博客

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

一、插件实现原理：

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

二、插件命名原则：

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

1、插件文件名称

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

• 文件夹名：slemlog
• 主文件名：slemlog.php（必须有此文件，相当于模板的module.php，舍力是这样理解的，函数变量的命名请尽快用于插件名一样<如：slemlog_xxx()>， 采用这样的命名方式可以避免于其他插件的函数或者变量出现冲突。）
• 参数设置文件：slemlog_setting.php（此文件看需求，可有可无）
• 写入数据库文件：slemlog_callback.php（数据需要写入数据库必须要有才文件）
• 前台显示文件：slemlog_show.php（此文件中的内容将会在前台显示，格式为：域名/?plugin=slemlog）

2、安全性

• 在插件文件开头增加限制语句
• 插件函数文件需要增加:!defined('EMLOG_ROOT') && exit('access deined!');
• 如果不增加该语句,那么直接访问插件的程序文件php会爆出博客的物理路径,对博客的安全造成威胁。
• 如果你的插件需要接收一些参数,请务必严格过滤每一个变量的数据.
• 例如：获取外部获取一个int型的参数，$id = $_GET['id']; 这样写是不安全的，要改为：$id = intval($_GET['id']);
• 如果是一个字符型的参数，$action = $_GET['action']; 这样写也是不安全的，要改为：$action = addslashes($_GET['action']);

三、插件各文件的写法说明

• 以下代码是在后台 “扩展功能” 中显示测试插件这几个字，可参考挂载点说明，放入不同的位置

  <?php function slemlog_menu(){?><div class="sidebarsubmenu"><a href="./plugin.php?plugin=slemlog">测试插件</a></div>
  <?php }
  addAction('adm_sidebar_ext', 'slemlog_menu');?>

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

• 挂载点：

  doAction('adm_main_top')

• 所在文件：

  admin/views/default/header.php

• 描述：后台红线区域扩展

• 挂载点：

  doAction('adm_head')

• 所在文件：

  admin/views/default/header.php

• 描述：后台头部扩展：可以用于增加后台css样式、加载js等

• 挂载点：

  doAction('adm_siderbar_ext')

• 所在文件：

  admin/views/default/header.php

• 描述：后台侧边栏 功能扩展 子菜单扩展，用于插件单独页面。

• 挂载点：

  doAction('save_log', $blogid)

• 所在文件：

  admin/save_log.php

• 描述：新增日志、修改日志扩展点

• 挂载点：

  doAction('del_log', $key)

• 所在文件：

  admin/admin_log.php

• 描述：删除日志操作扩展点

• 挂载点：

  doAction('adm_writelog_head', $key)

• 所在文件：

  admin/add_log.phpadmin/add_page.phpadmin/edit_log.php
  admin/edit_page.php

• 描述：可以再红框处显示扩展内容，如插入网络相册照片的插件。

• 挂载点：

  doAction('comment_post')

• 所在文件：

  ./index.php

• 描述：发表评论扩展点（写入评论前）。可用于垃圾评论防范

• 挂载点：

  doAction('comment_saved’)

• 所在文件：

  include/model/comment_model.php

• 描述：发表评论扩展点（写入评论后）。用于发布评论成功的后续操作，如发通知邮件

• 挂载点：

  doAction('log_related',$logData)

• 所在文件：

  content/templates/default/echo_log.php

• 描述：阅读日志页面扩展点、用于增加日志相关内容

• 挂载点：

  doAction('navbar', '<li>', '</li>')

• 所在文件：

  content/templates/default/header.php

• 描述：用于扩展导航条。例如相册插件会利用这个挂载点生成一个相册的导航链接

• 挂载点：

  doAction('index_head')

• 所在文件：

  Content/templates/default/header.php

• 描述：前台头部扩展：可以用于增加前台css样式、加载js等

• 挂载点：

  doAction('index_footer')

• 所在文件：

  content/templates/default/footer.php

• 描述：首页底部扩展点

• 挂载点：

  doAction('comment_reply', $commentId, $reply)

• 所在文件：

  admin/comment.php

• 描述：回复评论扩展点

• 挂载点：

  doAction('data_prebakup')

• 所在文件：

  admin/data.php

• 描述：扩展备份数据库页面，可以对插件增加的表进行备份

• 挂载点：

  doAction('rss_display')

• 所在文件：

  rss.php

• 描述：Rss输出扩展

• 挂载点：

  doAction('attach_upload')

• 所在文件：

  include/lib/function.base.php

• 描述：扩展附件上传，如增加图片水印效果等

• 挂载点：

  doAction('url_rewrite')

• 所在文件：

  include/lib/function.base.php

• 描述：扩展url重写，可以自定义其他url优化方案

• 挂载点：

  doAction('adm_comment_display')

• 所在文件：

  admin/views/comment.php

• 后台评论显示扩展，可以用于查询评论人ip所在地域

• 挂载点：

  doAction('index_loglist_top')

• 所在文件：

  content/templates/default/log_list.php

• 描述：日志列表顶部扩展点，如显示公告等

• 挂载点：

  doAction('diff_side')

• 所在文件：

  content/templates/default/side.php

• 描述：侧边栏控制扩展点

• 挂载点：

  doAction('reply_twitter', $r, $name, $date, $tid)

• 所在文件：

  t/index.php

• 描述：回复碎语扩展点，用于回复邮件提醒等

• 挂载点：

  doAction('post_twitter', $t)

• 所在文件：

  /m/index.php
  /admin/twitter.php

• 描述：发布碎语扩展点，用于碎语和其他微博类产品同步等