好!欢迎访问迷津渡口 现在时间是: 天气 °C ~ °C

迷津渡口

越感到迷惑 越接近真理

插件开发指南(适用于emlog5)

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

一、插件实现原理

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

二、插件挂载点

挂载点函数:doAction 本函数内置于emlog核心代码中,就是传说中的插件挂载点。 本函数有一个固定的参数:

  $hook,$hook是执行动作的名称
  其他的参数则可以在调用本函数时依次传入,函数会自动的发送给钩子函数

例子:

      doAction('save_log',$logid);
      这是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 安全指南》
      http://www.hhacker.com/files/200709/1/index.html
      前台链接使用绝对地址

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

  • 挂载点:doAction('adm_main_top')

    • 所在文件:admin/views/header.php

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

  • 挂载点:doAction('adm_head') ===

    • 所在文件:admin/views/header.php

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

  • 挂载点:doAction('adm_siderbar_ext')===

    • 所在文件:admin/views/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('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

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

  • 挂载点:doAction('adm_footer') ===

    • 所在文件:admin/views/footer.php

    • 描述:后台底部扩展:可以用于增加后台js等

点赞0
 标签: emlog 插件开发
   支持一下
挤眼 亲亲 咆哮 开心 想想 可怜 糗大了 委屈 哈哈 小声点 右哼哼 左哼哼 疑问 坏笑 赚钱啦 悲伤 耍酷 勾引 厉害 握手 耶 嘻嘻 害羞 鼓掌 馋嘴 抓狂 抱抱 围观 威武 给力
 点赞
 签到
 表情
 图片
 代码
提交评论

清空信息
关闭评论
foneandlone
 foneandlone 2019-03-19 03:23回复
#121
<a href="http://www.lagunawoodsre.com/nike-zoom-structure-20-kvinders-sort-gr%C3%B8n-skol">nike zoom structure 20 kvinders sort gr酶n</a> <a href="http://www.highbacklink.com/hommes-asics-gel-hyper-33-rose-or-chaussuresq">hommes asics gel hyper 33 rose or</a> <a href="http://www.vuurogen.com/femmes-air-jordan-retro-1-or-bleu-chaussuresl">femmes air jordan retro 1 or bleu</a> <a href="http://www.rsvppersonnel.com/nike-kobe-9-low-dam%C3%A4nner-blau-wei%C3%9F-schuhei">nike kobe 9 low dam盲nner blau wei脽</a> <a href="http://www.shonema.com/herren-nike-huarache-ultra-gr%C3%BCn-gold-schuheh">herren nike huarache ultra gr眉n gold</a> <a href="http://www.enventsurvey.com/mennns-nike-lunarglide-6-oransje-r%C3%B8d-obuvj">mennns nike lunarglide 6 oransje r酶d</a>
foneandlone http://www.foneandlone.com/
ahmztradefx
 ahmztradefx 2019-03-18 11:18回复
#120
<a href="http://www.ortzproducts.com/richard-sherman-seahawks-jersey-nflh">richard sherman seahawks jersey</a> <a href="http://www.cooterscamera.com/coach-tan-satchel-coachh">coach tan satchel</a> <a href="http://www.marjalfun.com/air-jordan-retro-1-femminile-rosa-nero-scarpeh">air jordan retro 1 femminile rosa nero</a> <a href="http://www.alecsblog.com/nike-kobe-11-femmes-rouge-oranger-chaussuresp">nike kobe 11 femmes rouge oranger</a> <a href="http://www.troudumonde.com/north-face-denali-mens-size-chart-northfaceh">north face denali mens size chart</a> <a href="http://www.smilesdrdavid.com/dam%C3%A4nner-nike-air-max-tailwind-5-rot-gelb-schuheq">dam盲nner nike air max tailwind 5 rot gelb</a>
ahmztradefx http://www.ahmztradefx.com/
djpunjabii
 djpunjabii 2019-03-17 21:27回复
#119
<a href="http://www.xescortx.com/air-jordan-retro-1-hvit-r%C3%B8d-svart-obuvk">air jordan retro 1 hvit r酶d svart</a> <a href="http://www.naturabottega.com/nike-flyknit-kobe-11-fluorescent-gr%C3%B8nn-obuvi">nike flyknit kobe 11 fluorescent gr酶nn</a> <a href="http://www.peddlir.com/nike-mercurial-vapor-fg-azul-negro-blanco-zapatosl">nike mercurial vapor fg azul negro blanco</a> <a href="http://www.snowdaydc.com/adidas-80s-superstar-nero-scarpeh">adidas 80s superstar nero</a> <a href="http://www.alliesindex.com/nike-sb-blazer-black-shoesk">nike sb blazer black</a> <a href="http://www.cafekem.com/ray-ban-3025-aviator-gold-sunglassesh">ray ban 3025 aviator gold</a>
djpunjabii http://www.djpunjabii.com/
abanigeria
 abanigeria 2019-03-17 06:37回复
#118
<a href="http://www.shrinetalk.com/nike-flyknit-lunar-2-rosa-quartz-chaussuresf">nike flyknit lunar 2 rosa quartz</a> <a href="http://www.konyakbs.com/nike-air-max-1-bhm-hommes-chaussure-chaussuresa">nike air max 1 bhm hommes chaussure</a> <a href="http://www.cheezhayama.com/adidas-tubular-runner-primeknit-orange-blanc-butya">adidas tubular runner primeknit orange blanc</a> <a href="http://www.eagleswingair.com/air-jordan-son-of-mars-negro-cehombrest-azul-butyc">air jordan son of mars negro cehombrest azul</a> <a href="http://www.alchemaerie.com/femmes-nike-free-run-4.0-violet-or-scarpeg">femmes nike free run 4.0 violet or</a> <a href="http://www.eyecovet.com/nike-hypershift-r%C3%B8d-lyser%C3%B8d-chaussuresc">nike hypershift r酶d lyser酶d</a>
abanigeria http://www.abanigeria.com/
hagertools
 hagertools 2019-03-16 23:32回复
#117
<a href="http://www.accsmonnaux.com/menn-ralph-lauren-marinen-hvit-big-pony-polo-polou">menn ralph lauren marinen hvit big pony polo</a> <a href="http://www.acrosstheory.com/kvinners-nike-air-max-1-gr%C3%A5-gull-scarpeb">kvinners nike air max 1 gr氓 gull</a> <a href="http://www.dlhiphop.com/kyle-long-womens-ash-nike-nfl-chicago-bears-pullover-hoodie-backer-75-nfls">kyle long womens ash nike nfl chicago bears pullover hoodie backer 75</a> <a href="http://www.festivalstayz.com/salomon-fellraiser-femminile-fell-in-esecuzione-scarpe-lyrics-scarpef">salomon fellraiser femminile fell in esecuzione scarpe lyrics</a> <a href="http://www.floornhome.com/maschio-nike-free-run-2-in-esecuzione-scarpe-nero-anthracite-obuvc">maschio nike free run 2 in esecuzione scarpe nero anthracite</a> <a href="http://www.iranqnap.com/adidas-yeezy-boost-350-v2-dark-gr%C3%B8n-kit-scarpea">adidas yeezy boost 350 v2 dark gr酶n kit</a>
hagertools http://www.hagertools.com/
colintilley
 colintilley 2019-03-14 08:02回复
#116
<a href="http://www.romoautocare.com/nike-zoom-pegasus-33-kvinners-himmelen-bl%C3%A5-s%C3%B8lv-obuvk">nike zoom pegasus 33 kvinners himmelen bl氓 s酶lv</a> <a href="http://www.industrialegy.com/coach-silver-metallic-wristlet-coachh">coach silver metallic wristlet</a> <a href="http://www.bewustvitaal.com/adidas-neo-skate-nero-grigio-scarpei">adidas neo skate nero grigio</a> <a href="http://www.flushandhunt.com/femminile-nike-kd-7-verde-rosso-scarpeh">femminile nike kd 7 verde rosso</a> <a href="http://www.kendalfewster.com/new-jersey-devils-reebok-nhl-player-knit-hath">new jersey devils reebok nhl player knit</a> <a href="http://www.gisusalon.com/air-jordan-b-mo-violet-hommesthe-verte-chaussuresh">air jordan b mo violet hommesthe verte</a>
colintilley http://www.colintilley.com/
agivlar
 agivlar 2019-03-13 22:43回复
#115
<a href="http://www.beatclothes.com/adidas-neo-womens-raleigh-mid-high-sport-shoe-lace-shoesc">adidas neo womens raleigh mid high sport shoe lace</a> <a href="http://www.primarknorway.com/nike-air-max-flyknit-black-2015-volt-skog">nike air max flyknit black 2015 volt</a> <a href="http://www.shaansoftware.com/nike-air-max-invigor-womens-white-grey-sportsf">nike air max invigor womens white grey</a> <a href="http://www.irecaconfort.com/nike-air-rejuven8-mule-kvinders-bl%C3%A5-runningd">nike air rejuven8 mule kvinders bl氓</a>
agivlar http://www.agivlar.com/
real jordan eclipse
 real jordan eclipse 2019-03-13 02:34回复
#114
<a href="http://www.sunestatesgoa.com/mens-nike-new-york-giants-13-odell-beckham-jr-limited-gray-gridiron-nfl-jersey-nflt">mens nike new york giants 13 odell beckham jr limited gray gridiron nfl jersey</a> <a href="http://www.svetsekonomi.com/elite-mens-deandre-hopkins-navy-blue-home-jersey-nfl-nike-houston-texans-10-drift-fashion-nflu">elite mens deandre hopkins navy blue home jersey nfl nike houston texans 10 drift fashion</a> <a href="http://www.pardisniaz.com/yeezy-750-boost-marron-kit-kurpesc">yeezy 750 boost marron kit</a> <a href="http://www.bangnaplastic.com/nike-air-max-1-purple-australia-shoeso">nike air max 1 purple australia</a> <a href="http://www.emsisoftph.com/adidas-neo-campus-gul-lyser%C3%B8d-obuvb">adidas neo campus gul lyser酶d</a> <a href="http://www.dkcrossfit.com/ray-ban-aviators-blue-lens-sunglassesd">ray ban aviators blue lens</a>
real jordan eclipse http://www.miyazakisan.com/real-jordan-eclipse-skot
chocopictures
 chocopictures 2019-03-11 17:28回复
#113
<a href="http://www.dbievents.com/adidas-originals-shoes-green-shoesj">adidas originals shoes green</a> <a href="http://www.ilankocaeli.com/new-era-wooly-hats-hatk">new era wooly hats</a> <a href="http://www.msignworx.com/herre-nike-air-max-95-bl%C3%A5-r%C3%B8d-skoj">herre nike air max 95 bl氓 r酶d</a> <a href="http://www.dianegrams.com/ralph-lauren-woven-bag-poloh">ralph lauren woven bag</a> <a href="http://www.jobstodayng.com/adidas-superstar-black-leopard-shoesi">adidas superstar black leopard</a> <a href="http://www.hardcoreboris.com/adidas-originals-eqt-support-adv-grigio-scarpej">adidas originals eqt support adv grigio</a>
chocopictures http://www.chocopictures.com/
hiphoprapjam
 hiphoprapjam 2019-03-10 20:02回复
#112
<a href="http://www.haceryeni.com/jordan-10-noir-schuheg">jordan 10 noir</a> <a href="http://www.klarinetino.com/nike-zoom-pegasus-31-orange-braun-schuheb">nike zoom pegasus 31 orange braun</a> <a href="http://www.pitcrewcooks.com/nike-air-max-tailwind-6-dark-bl%C3%A5-lyser%C3%B8d-chaussurese">nike air max tailwind 6 dark bl氓 lyser酶d</a> <a href="http://www.zketchy.com/air-jordan-7-retro-french-bleu-2015-oil-butyg">air jordan 7 retro french bleu 2015 oil</a> <a href="http://www.cantleylaw.com/air-jordan-aero-flight-blanco-naranja-scarpea">air jordan aero flight blanco naranja</a> <a href="http://www.carikindl.com/nike-air-force-1-low-premium-sort-hvid-schuhec">nike air force 1 low premium sort hvid</a>
[url=http://www.hiphoprapjam.com/]hiphoprapjam[/url]
顶部留言底部
 00:00/00:00
我想和你虚度时光 - 花房姑娘(9)
  1. 我想和你虚度时光
  2. 花房姑娘
  3. 恋恋风尘
  4. 我喜爱一切不彻底的事物
  5. 我的心里是满的
  6. Long Way
  7. 给少年的歌
  8. 晴日共剪窗
  9. 天上的月你的脸