立即注册 找回密码

QQ登录

只需一步,快速开始

查看: 3258|回复: 0

[Discuz 通用教程] Discuz插件页面嵌入类型脚本格式

[复制链接]

114

主题

10

回帖

1564

积分

超级版主

Rank: 8Rank: 8

积分
1564

最佳新人活跃会员热心会员推广达人宣传达人突出贡献优秀版主荣誉管理论坛元老

发表于 2017-12-16 17:22:43 | 显示全部楼层 |阅读模式
道勤网-数据www.daoqin.net

亲注册登录道勤网-可以查看更多帖子内容哦!(包涵精彩图片、文字详情等)请您及时注册登录-www.daoqin.net

您需要 登录 才可以下载或查看,没有账号?立即注册

x
discuz 插件页面嵌入类型脚本格式
  1. <?php

  2. //全局嵌入点类(必须存在)
  3. class plugin_identifier {

  4.         function HookId_1() {
  5.                 ......
  6.                 return ...;
  7.         }

  8.         function HookId_2() {
  9.                 ......
  10.                 return ...;
  11.         }

  12.         ......

  13. }

  14. //脚本嵌入点类
  15. class plugin_identifier_CURSCRIPT extends plugin_identifier {

  16.         function HookId_1() {
  17.                 ......
  18.                 return ...;
  19.         }

  20.         function HookId_2() {
  21.                 ......
  22.                 return ...;
  23.         }

  24.         ......

  25. }

  26. ?>
复制代码
1、plugin_
普通版脚本中的类名以 plugin_ 开头。手机版脚本中的类名以 mobileplugin_ 开头。

2、identifier
插件的唯一标识符,在插件设置中设置。

3、CURSCRIPT
嵌入点位于的脚本名,如 forum.php 为 forum。

HookId
函数名调用位置声明位置第一个参数含义
HookId()所有模块执行前被调用脚本嵌入点类
HookId_output()模块执行完毕,模板输出前被调用脚本嵌入点类array(
'template' => 当前要输出的模版,
'message' => showmessage 的信息内容,
'values' => showmessage 的信息变量,
)
global_HookId()模块执行完毕,模板输出前被调用全局嵌入点类
HookId_message()showmessage() 执行时调用脚本嵌入点类array(
'param' => showmessage() 函数的参数数组,
)
ad_adId()相应的广告位中调用
函数名为广告位脚本 ID 如:ad_headerbanner()
全局嵌入点类
脚本嵌入点类
array(
'params' => 广告位参数,
'content' => 当前广告位原本将要显示的内容,
)
common()所有模块执行前被调用全局嵌入点类
discuzcode()discuzcode() 函数执行时调用
用于在帖子内容解析时嵌入自己的功能,函数中 $_G['discuzcodemessage'] 变量为待解析的字串
全局嵌入点类array(
'param' => caller 函数的参数数组,
'caller' => caller 函数,此嵌入点被哪个函数调用
'discuzcode' 被 discuzcode() 调用
'messagecutstr' 被 messagecutstr() 调用
)
deletethread()deletethread() 函数执行时调用
用于在主题删除前后嵌入自己的功能,此函数将在 deletethread() 中被调用 2 次,函数中 $_G['deletethreadtids'] 变量为待处理的 TID 数组
全局嵌入点类array(
'param' => deletethread() 函数的参数数组,
'step' => 删除的步骤
'check' 检测步骤
'delete' 删除步骤
)
deletepost()deletepost() 函数执行时调用
用于在帖子删除前后嵌入自己的功能,此函数将在 deletepost() 中被调用 2 次,函数中 $_G['deletepostids'] 变量为待处理的 ID 数组
全局嵌入点类array(
'param' => deletepost() 函数的参数数组,
'step' => 删除的步骤
'check' 检测步骤
'delete' 删除步骤
)
avatar()
(X2.5 新增)
avatar() 函数执行时调用
用于在头像调用时嵌入自己的功能,函数中 $_G['hookavatar'] 变量为新头像返回值

全局嵌入点类array(
'param' => avatar() 函数的参数数组
)


要查看所有的预定义嵌入点,请打开 config/config_global.php 文件,将文件结尾添加的设计者模式值改成“2”,然后更新缓存即可。在页面源码中查找"<hook>"可搜索到嵌入点。(详细内容可参阅的《插件嵌入点列表》)
  1. $_config['plugindeveloper'] = 2;
复制代码
预定义的嵌入点会在页面预置好的位置输出函数返回的内容。函数返回值类型如果是 array 且是空值的,必须输出一个空数组,如:

return array();
函数名并不限于以上列表,您可以自定义,只要符合以下规则,函数就会在适当的地方被调用。

function CURMODULE_USERDEFINE[_output]()

CURMODULE 指明了此函数在哪个模块执行,可通过常量 CURMODULE 得到当前页面的 CURMODULE 值。 USERDEFINE 可自定义,如果函数名以“_output”结尾则会在模板输出前调用,否则会在模块执行前调用。 如:attachment_test() 函数会在论坛的下载附件的时候执行。 “_output”结尾的函数的第一个参数为数组,含义为 array('template' => 要输出的模板名, 'message' => showmessage 的文字) 如:以下函数将在登录的时候输出调试文字
  1. function logging_test_output($a) {
  2.         print_r($a);
  3.         print_r($_POST);
  4. }
复制代码


discuz 插件页面嵌入类型脚本格式
  • <?php
  • //全局嵌入点类(必须存在)
  • class plugin_identifier {
  •         function HookId_1() {
  •                 ......
  •                 return ...;
  •         }
  •         function HookId_2() {
  •                 ......
  •                 return ...;
  •         }
  •         ......
  • }
  • //脚本嵌入点类
  • class plugin_identifier_CURSCRIPT extends plugin_identifier {
  •         function HookId_1() {
  •                 ......
  •                 return ...;
  •         }
  •         function HookId_2() {
  •                 ......
  •                 return ...;
  •         }
  •         ......
  • }
  • ?>

[color=rgb(51, 102, 153) !important]复制代码

1、plugin_
普通版脚本中的类名以 plugin_ 开头。手机版脚本中的类名以 mobileplugin_ 开头。

2、identifier
插件的唯一标识符,在插件设置中设置。

3、CURSCRIPT
嵌入点位于的脚本名,如 forum.php 为 forum。

HookId
函数名调用位置声明位置第一个参数含义
HookId()所有模块执行前被调用脚本嵌入点类
HookId_output()模块执行完毕,模板输出前被调用脚本嵌入点类array(
'template' => 当前要输出的模版,
'message' => showmessage 的信息内容,
'values' => showmessage 的信息变量,
)
global_HookId()模块执行完毕,模板输出前被调用全局嵌入点类
HookId_message()showmessage() 执行时调用脚本嵌入点类array(
'param' => showmessage() 函数的参数数组,
)
ad_adId()相应的广告位中调用
函数名为广告位脚本 ID 如:ad_headerbanner()
全局嵌入点类
脚本嵌入点类
array(
'params' => 广告位参数,
'content' => 当前广告位原本将要显示的内容,
)
common()所有模块执行前被调用全局嵌入点类
discuzcode()discuzcode() 函数执行时调用
用于在帖子内容解析时嵌入自己的功能,函数中 $_G['discuzcodemessage'] 变量为待解析的字串
全局嵌入点类array(
'param' => caller 函数的参数数组,
'caller' => caller 函数,此嵌入点被哪个函数调用
'discuzcode' 被 discuzcode() 调用
'messagecutstr' 被 messagecutstr() 调用
)
deletethread()deletethread() 函数执行时调用
用于在主题删除前后嵌入自己的功能,此函数将在 deletethread() 中被调用 2 次,函数中 $_G['deletethreadtids'] 变量为待处理的 TID 数组
全局嵌入点类array(
'param' => deletethread() 函数的参数数组,
'step' => 删除的步骤
'check' 检测步骤
'delete' 删除步骤
)
deletepost()deletepost() 函数执行时调用
用于在帖子删除前后嵌入自己的功能,此函数将在 deletepost() 中被调用 2 次,函数中 $_G['deletepostids'] 变量为待处理的 ID 数组
全局嵌入点类array(
'param' => deletepost() 函数的参数数组,
'step' => 删除的步骤
'check' 检测步骤
'delete' 删除步骤
)
avatar()
(X2.5 新增)
avatar() 函数执行时调用
用于在头像调用时嵌入自己的功能,函数中 $_G['hookavatar'] 变量为新头像返回值

全局嵌入点类array(
'param' => avatar() 函数的参数数组
)


要查看所有的预定义嵌入点,请打开 config/config_global.php 文件,将文件结尾添加的设计者模式值改成“2”,然后更新缓存即可。在页面源码中查找"<hook>"可搜索到嵌入点。(详细内容可参阅的《插件嵌入点列表》)
  • $_config['plugindeveloper'] = 2;

[color=rgb(51, 102, 153) !important]复制代码

预定义的嵌入点会在页面预置好的位置输出函数返回的内容。函数返回值类型如果是 array 且是空值的,必须输出一个空数组,如:

return array();
函数名并不限于以上列表,您可以自定义,只要符合以下规则,函数就会在适当的地方被调用。

function CURMODULE_USERDEFINE[_output]()

CURMODULE 指明了此函数在哪个模块执行,可通过常量 CURMODULE 得到当前页面的 CURMODULE 值。 USERDEFINE 可自定义,如果函数名以“_output”结尾则会在模板输出前调用,否则会在模块执行前调用。 如:attachment_test() 函数会在论坛的下载附件的时候执行。 “_output”结尾的函数的第一个参数为数组,含义为 array('template' => 要输出的模板名, 'message' => showmessage 的文字) 如:以下函数将在登录的时候输出调试文字
  • function logging_test_output($a) {
  •         print_r($a);
  •         print_r($_POST);
  • }

[color=rgb(51, 102, 153) !important]复制代码

plugin_identifier 类中的其它函数为了便于阅读建议以“_”开头,如:
  1. <?php

  2. class plugin_sample {

  3.         function _updatecache() {
  4.                 ......
  5.                 return ...;
  6.         }

  7. }

  8. class plugin_sample_forum extends plugin_sample {

  9.         function viewthread_posttop() {
  10.                 ......
  11.                 return ...;
  12.         }

  13.         ......

  14. }

  15. ?>
复制代码
插件嵌入点列表,

道勤主机提供365天*24小时全年全天无休、实时在线、零等待的售后技术支持。竭力为您免费处理您在使用道勤主机过程中所遇到的一切问题! 如果您是道勤主机用户,那么您可以通过QQ【792472177】、售后QQ【59133755】、旺旺【诠释意念】、微信:q792472177免费电话、后台提交工单这些方式联系道勤主机客服! 如果您不是我们的客户也没问题,点击页面最右边的企业QQ在线咨询图标联系我们并购买后,我们为您免费进行无缝搬家服务,让您享受网站零访问延迟的迁移到道勤主机的服务!
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关闭

道勤网- 推荐内容!上一条 /2 下一条

!jz_fbzt! !jz_sgzt! !jz_xgzt! 快速回复 !jz_fhlb! !jz_lxwm! !jz_gfqqq!

关于我们|手机版|小黑屋|地图|【道勤网】-www.daoqin.net 软件视频自学教程|免费教程|自学电脑|3D教程|平面教程|影视动画教程|办公教程|机械设计教程|网站设计教程【道勤网】 ( 皖ICP备15000319号-1 )

GMT+8, 2024-5-16 20:03

Powered by DaoQin! X3.4 © 2016-2063 Dao Qin & 道勤科技

快速回复 返回顶部 返回列表