坏蛋网络
标题:
Discuz X论坛:【插件机制】-【页面嵌入】详解
[打印本页]
作者:
坏蛋网络
时间:
2020-1-20 02:51
标题:
Discuz X论坛:【插件机制】-【页面嵌入】详解
脚本格式<?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 ...; } ......}?>plugin_
+ y4 V8 P$ I2 ?6 u3 y
普通版脚本中的类名以 plugin_ 开头。手机版脚本中的类名以 mobileplugin_ 开头。identifier
5 s1 `$ Y, @' D0 E" @" f7 R% S5 y
插件的唯一标识符,在插件设置中设置。CURSCRIPT
7 D% i% S6 p% z3 ]
嵌入点位于的脚本名,如 forum.php 为 forum。HookId
5 ]3 D. m/ u2 E& @! x$ T% f* t( C
- W! D S: q, \) p+ W% E8 T! o
函数名
/ x( M; }8 L* R* b- E3 V; p, H- j9 e
调用位置
; G0 Q" u4 _% t& X% R" J/ [9 K( e
; J5 b8 D# N- r0 I" P0 L9 M: r
声明位置第一个参数含义HookId()所有模块执行前被调用脚本嵌入点类
4 i$ M8 P5 H4 F
HookId_output()模块执行完毕,模板输出前被调用脚本嵌入点类array('template' => 当前要输出的模版,'message' => showmessage 的信息内容,'values' => showmessage 的信息变量,)
4 L4 k2 y) U% S, z* d
global_HookId()模块执行完毕,模板输出前被调用全局嵌入点类
3 _$ N: Z9 Y0 _1 A5 \( |- W. h
HookId_message()showmessage() 执行时调用脚本嵌入点类array('param' => showmessage() 函数的参数数组,)
B5 g: {* J, x! l1 J* _& E7 J
ad_adId()相应的广告位中调用函数名为广告位脚本 ID如:ad_headerbanner()
$ k: \. M2 d+ f/ b
全局嵌入点类脚本嵌入点类
2 e& F6 f5 n0 I6 p* I, T& K
array('params' => 广告位参数,'content' => 当前广告位原本将要显示的内容,)
' h; e7 F2 R5 U
common()所有模块执行前被调用全局嵌入点类
3 v& q8 i1 J$ F1 w. P9 u
discuzcode()discuzcode() 函数执行时调用用于在帖子内容解析时嵌入自己的功能,函数中 $_G['discuzcodemessage'] 变量为待解析的字串
1 P9 f1 Z- x7 A& \& y% `0 j6 m0 O
全局嵌入点类array('param' => caller 函数的参数数组,'caller' => caller 函数,此嵌入点被哪个函数调用'discuzcode' 被 discuzcode() 调用'messagecutstr' 被 messagecutstr() 调用)
" Y" b4 e/ ]$ f
deletethread()deletethread() 函数执行时调用用于在主题删除前后嵌入自己的功能,此函数将在 deletethread() 中被调用 2 次,函数中 $_G['deletethreadtids'] 变量为待处理的 TID 数组
8 f3 B+ ~% Y9 l- s% E- e8 X7 h
全局嵌入点类array('param' => deletethread() 函数的参数数组,'step' => 删除的步骤'check' 检测步骤'delete' 删除步骤)
* e9 \% e. V" j3 H% ]: p- o% N/ f
deletepost()deletepost() 函数执行时调用用于在帖子删除前后嵌入自己的功能,此函数将在 deletepost() 中被调用 2 次,函数中 $_G['deletepostids'] 变量为待处理的 ID 数组
: Z, y- s# z* n
全局嵌入点类array('param' => deletepost() 函数的参数数组,'step' => 删除的步骤'check' 检测步骤'delete' 删除步骤)
# ?& z4 k$ g6 t0 L( H! J8 ^8 u
avatar()(X2.5 新增)
- I) z1 W) m1 E+ S
avatar() 函数执行时调用用于在头像调用时嵌入自己的功能,函数中 $_G['hookavatar'] 变量为新头像返回值
2 p9 U7 l7 s# R; Q
全局嵌入点类array('param' => avatar() 函数的参数数组
( N: m' e9 t) \4 m& m" q7 N: ?
)
. f; i2 O, _" S1 Z
要查看所有的预定义嵌入点,请打开 config/config_global.php 文件,将文件结尾添加的设计者模式值改成“2”,然后更新缓存即可。在页面源码中查找"<hook>"可搜索到嵌入点。(详细内容可参阅的《插件嵌入点列表》)
3 w0 h( U: E3 C
, [6 p3 V; ^6 D& B" D
$_config['plugindeveloper'] = 2;
2 c% |3 y. N2 q% s7 C7 D
预定义的嵌入点会在页面预置好的位置输出函数返回的内容。函数返回值类型如果是 array 且是空值的,必须输出一个空数组,如:
- Y2 i8 O1 M) [+ E. E" o2 t: F* Z
; N5 t8 M& `7 l! z
return array();
* c* z$ d( E6 J8 f3 i: q- [( v
函数名并不限于以上列表,您可以自定义,只要符合以下规则,函数就会在适当的地方被调用。
' {7 n* S7 B: X
7 W/ u U$ A& v3 [% U, t: a
function CURMODULE_USERDEFINE[_output]()
. B6 i% @* K/ W+ W0 c1 ~6 P
CURMODULE 指明了此函数在哪个模块执行,可通过常量 CURMODULE 得到当前页面的 CURMODULE 值。 USERDEFINE 可自定义,如果函数名以“_output”结尾则会在模板输出前调用,否则会在模块执行前调用。如:attachment_test() 函数会在论坛的下载附件的时候执行。“_output”结尾的函数的第一个参数为数组,含义为 array('template' => 要输出的模板名, 'message' => showmessage 的文字) 如:以下函数将在登录的时候输出调试文字
/ ]1 t/ D+ i- @4 W9 P. k
# Y7 ], |: Z: V. O B; `! U
function logging_test_output($a) { print_r($a); print_r($_POST);}
6 f( }0 W; w6 @
plugin_identifier 类中的其它函数为了便于阅读建议以“_”开头,如:
% c7 j$ V' \7 X
/ p& t5 a1 {2 x/ D
<?phpclass plugin_sample { function _updatecache() { ...... return ...; }}class plugin_sample_forum extends plugin_sample { function viewthread_posttop() { ...... return ...; } ......}?>
4 j4 u; \& T& y$ T) l
插件嵌入点列表全局(common/)
4 f* k6 {# q/ h+ S: P
extcredits.htm string spacecp_credit_extra faq.htm string faq_extra footer.htm string global_footer string global_footerlink header.htm string global_cpnav_top (X2.5) string global_cpnav_extra1 string global_cpnav_extra2 string global_usernav_extra1 string global_usernav_extra2 string global_usernav_extra3 string global_usernav_extra4 (X2.5) string global_nav_extra (X2.5) string global_header userabout.htm array global_userabout_top string userapp_menu_top string userapp_menu_middle array global_userabout_bottom
" Q0 A I0 N2 B. H. W- f
论坛(forum/)
2 I5 y+ G2 j0 ~9 }
collection_all.htm (X2.5) string collection_index_top string collection_index_bottom collection_comment.htm (X2.5) string collection_nav_extra collection_index.htm (X2.5) string collection_index_top string collection_index_bottom collection_mycollection.htm (X2.5) string collection_index_top string collection_index_bottom collection_nav.htm (X2.5) string collection_nav_extra collection_view.htm (X2.5) string collection_viewoptions string collection_view_top string collection_threadlistbottom string collection_relatedop string collection_view_bottom string collection_side_bottom discuz.htm string index_status_extra string index_nav_extra (X2.5) string index_top string index_catlist_top (X2.5) array index_favforum_extra (X2.5) array index_catlist (X2.5) array index_forum_extra (X2.5) array index_forum_extra (X2.5) string index_middle string index_bottom string index_side_top string index_side_bottom discuzcode.htm array viewthread_attach_extra (X2.5) editor_menu_forum.htm string post_image_btn_extra string post_image_tab_extra string post_attach_btn_extra string post_attach_tab_extra forumdisplay.htm string forumdisplay_leftside_top string forumdisplay_leftside_bottom string forumdisplay_forumaction string forumdisplay_modlink string forumdisplay_top string forumdisplay_middle string forumdisplay_postbutton_top string forumdisplay_threadtype_inner (X2.5) string forumdisplay_filter_extra (X2.5) string forumdisplay_threadtype_extra (X2.5) string forumdisplay_bottom string forumdisplay_side_top string forumdisplay_side_bottom forumdisplay_fastpost.htm string forumdisplay_fastpost_content string forumdisplay_fastpost_func_extra string forumdisplay_fastpost_ctrl_extra string global_login_text string forumdisplay_fastpost_btn_extra string forumdisplay_fastpost_sync_method forumdisplay_list.htm string forumdisplay_filter_extra array forumdisplay_thread array forumdisplay_thread_subject (X2.5) array forumdisplay_author array forumdisplay_thread (X2.5) array forumdisplay_author (X2.5) string forumdisplay_threadlist_bottom (X2.5) string forumdisplay_postbutton_bottom forumdisplay_sort.htm (X2.5) string forumdisplay_postbutton_bottom forumdisplay_subforum.htm (X2.5) array forumdisplay_subforum_extra array forumdisplay_subforum_extra guide.htm string guide_nav_extra string guide_top string guide_bottom guide_list_row.htm (X2.5) array forumdisplay_thread index_navbar.htm string index_navbar post.htm string post_top string post_middle string post_btn_extra string post_sync_method string post_bottom post_activity.htm string post_activity_extra post_debate.htm string post_debate_extra post_editor_body.htm string post_editorctrl_right string post_editorctrl_left string post_editorctrl_top string post_editorctrl_bottom post_editor_option.htm string post_side_top string post_side_bottom post_infloat.htm string post_infloat_top string post_infloat_middle string post_infloat_btn_extra post_poll.htm string post_poll_extra post_reward.htm string post_reward_extra post_trade.htm string post_trade_extra topicadmin_modlayer.htm string forumdisplay_modlayer string modcp_modlayer trade_info.htm string viewthread_tradeinfo_extra viewthread.htm string viewthread_top string viewthread_postbutton_top string viewthread_modoption string viewthread_beginline (X2.5) string viewthread_title_extra string viewthread_title_row string viewthread_middle string viewthread_bottom viewthread_activity.htm string viewthread_activity_extra1 string viewthread_activity_extra2 viewthread_fastpost.htm string viewthread_fastpost_side string viewthread_fastpost_content string viewthread_fastpost_func_extra string viewthread_fastpost_ctrl_extra string global_login_text string viewthread_fastpost_btn_extra (X2.5) viewthread_from_node.htm array viewthread_postheader array viewthread_postheader array viewthread_postheader array viewthread_endline viewthread_node.htm array viewthread_profileside array viewthread_imicons array viewthread_magic_user array viewthread_avatar array viewthread_sidetop array viewthread_sidebottom array viewthread_postheader string viewthread_modaction (X2.5) string viewthread_share_method string viewthread_useraction array viewthread_postsightmlafter (X2.5) array viewthread_postfooter array viewthread_postaction (X2.5) string viewthread_magic_thread array viewthread_magic_post array viewthread_endline viewthread_node_body.htm array viewthread_posttop string global_login_text array viewthread_postbottom viewthread_poll.htm string viewthread_poll_top string viewthread_poll_bottom viewthread_portal.htm string viewthread_useraction_prefix string viewthread_useraction string viewthread_side_bottom viewthread_trade.htm array viewthread_trade_extra群组(group/)
0 x2 X/ Y% {% u7 X3 Q
group.htm string group_navlink string forumdisplay_navlink string group_navlink string forumdisplay_navlink string group_top string forumdisplay_top string group_nav_extra string forumdisplay_nav_extra string group_bottom string forumdisplay_bottom string group_side_bottom string forumdisplay_side_bottom group_list.htm string forumdisplay_postbutton_top string forumdisplay_filter_extra array forumdisplay_thread string forumdisplay_postbutton_bottom group_my.htm string my_header string my_bottom string my_side_top string my_side_bottom group_right.htm string group_index_side string group_side_top string forumdisplay_side_top index.htm string index_header string index_top string index_bottom string index_side_top string index_side_bottom type.htm string index_top array index_grouplist string index_bottom string index_side_top string index_side_bottom家园(home/)
: e6 p6 o' W/ [
follow_feed.htm (X2.5) string follow_nav_extra string follow_top spacecp_avatar.htm string spacecp_avatar_top string spacecp_avatar_bottom spacecp_blog.htm string spacecp_blog_top string spacecp_blog_middle string spacecp_blog_bottom spacecp_credit_base.htm string spacecp_credit_top string spacecp_credit_extra string spacecp_credit_bottom spacecp_credit_log.htm string spacecp_credit_top string spacecp_credit_bottom spacecp_privacy.htm string spacecp_privacy_top string spacecp_privacy_base_extra string spacecp_privacy_feed_extra string spacecp_privacy_bottom spacecp_profile.htm string spacecp_profile_top string spacecp_profile_extra string spacecp_profile_bottom spacecp_promotion.htm string spacecp_promotion_top string spacecp_promotion_bottom spacecp_usergroup.htm string spacecp_usergroup_top string spacecp_usergroup_bottom string spacecp_usergroup_top string spacecp_usergroup_bottom string spacecp_usergroup_top string spacecp_usergroup_bottom space_album_pic.htm string space_album_pic_top string space_album_pic_op_extra string space_album_pic_bottom string space_album_pic_face_extra space_album_view.htm string space_album_op_extra space_blog_list.htm array space_blog_list_status space_blog_view.htm string space_blog_title string space_blog_share_method (X2.5) string space_blog_op_extra string space_blog_face_extra space_card.htm string space_card_top string space_card_baseinfo_middle string space_card_baseinfo_bottom string space_card_option string space_card_magic_user string space_card_bottom space_comment_li.htm array space_blog_comment_op string space_blog_comment_bottom space_doing.htm string space_doing_top string space_doing_bottom space_favorite.htm (X2.5) string space_favorite_nav_extra space_friend.htm string space_interaction_extra space_header.htm string global_usernav_extra1 string global_usernav_extra2 space_home.htm string space_home_side_top (X2.5) string space_home_side_bottom string space_home_top string space_home_navlink string space_home_bottom space_magic.htm (X2.5) string magic_nav_extra space_medal.htm (X2.5) string medal_nav_extra space_menu.htm string space_menu_extra space_profile_body.htm string space_profile_baseinfo_top string follow_profile_baseinfo_top (X2.5) string space_profile_baseinfo_middle string follow_profile_baseinfo_middle (X2.5) string space_profile_baseinfo_bottom string follow_profile_baseinfo_bottom (X2.5) string space_profile_extrainfo string follow_profile_extrainfo (X2.5) space_share_li.htm array space_share_comment_op space_status.htm string space_home_doing_sync_method space_wall.htm string space_wall_face_extra注册/登录(member/)
4 ~" \7 t ?" p5 f: ^
login.htm string logging_side_top string logging_top string logging_input string logging_method login_simple.htm string global_login_extra register.htm string register_side_top string register_top string register_input string register_logging_method string register_bottom门户(portal/)
* o2 N0 q+ n; y( D! H9 ?
portalcp_article.htm string portalcp_top string portalcp_extend string portalcp_middle string portalcp_bottom view.htm string view_article_top (X2.5) string view_article_subtitle (X2.5) string view_article_summary (X2.5) string view_article_content (X2.5) string view_share_method string view_article_op_extra (X2.5) string view_article_side_top (X2.5) string view_article_side_bottom (X2.5)排行榜(ranklist/)
2 u. i& p; n/ s- J1 q
side_left.htm string ranklist_nav_extra搜索(search/)
- v. R2 X0 A5 ]* W: `9 J, U& e
album.htm string album_top string album_bottom blog.htm string blog_top string blog_bottom footer.htm string global_footer string global_footerlink forum.htm string forum_top string forum_bottom group.htm string group_top string group_bottom header.htm string global_usernav_extra1 string global_usernav_extra2 portal.htm string portal_top string portal_bottom应用(userapp/)
. j- r9 W8 K0 \
userapp_app.htm string userapp_app_top string userapp_app_bottom userapp_index.htm string userapp_index_top string userapp_index_bottom userapp_menu_list.htm string userapp_menu_top string userapp_menu_middle string userapp_menu_bottom手机全局(mobile/common/)
/ r' N( F- Q1 P' W1 k4 `
footer.htm string global_footer_mobile header.htm string global_header_mobile手机论坛(mobile/forum/)
" B L0 _, N. o, L9 ?
discuz.htm string index_top_mobile string index_middle_mobile string index_bottom_mobile forumdisplay.htm string forumdisplay_top_mobile array forumdisplay_thread_mobile string forumdisplay_bottom_mobile viewthread.htm string viewthread_top_mobile array viewthread_posttop_mobile array viewthread_postbottom_mobile string viewthread_bottom_mobile
作者:
666
时间:
2020-1-20 03:16
谢谢楼主,共同发展
作者:
672815626
时间:
2020-1-21 04:52
支持一下
作者:
全村的希望
时间:
2020-1-22 01:32
不知该说些什么。。。。。。就是谢谢
作者:
江山狂念
时间:
2020-1-22 14:50
学习了,不错,讲的太有道理了
作者:
岁月神偷
时间:
2020-1-22 15:35
我是来刷分的,嘿嘿
作者:
hgfhgf
时间:
2020-1-25 03:06
过来看看的
作者:
手机用户kY19317
时间:
2020-1-25 23:43
学习了,谢谢分享、、、
作者:
张红霞
时间:
2020-1-26 10:42
顶
作者:
jjj111
时间:
2020-1-26 12:39
支持楼主,用户楼主,楼主英明呀!!!
作者:
起什么名字呢?
时间:
2020-1-26 14:23
真是 收益 匪浅
作者:
1287252690
时间:
2020-1-29 02:07
有道理。。。
作者:
yyc
时间:
2020-1-31 01:02
我是来刷分的,嘿嘿
作者:
373044885
时间:
2020-2-1 04:29
我抢、我抢、我抢沙发~
作者:
66666
时间:
2020-2-3 16:40
好好 学习了 确实不错
作者:
foryun
时间:
2020-2-4 03:17
找到好贴不容易,我顶你了,谢了
作者:
shu1332725
时间:
2020-2-6 21:57
过来看看的
作者:
瑾瑾
时间:
2020-2-8 11:56
有道理。。。
作者:
信息港品牌
时间:
2020-8-7 14:56
支持楼主,用户楼主,楼主英明呀!!!
作者:
测试
时间:
2020-8-7 16:39
我是来刷分的,嘿嘿
作者:
jjj111
时间:
2020-8-7 18:50
我是来刷分的,嘿嘿
作者:
foryun
时间:
2022-6-26 21:45
支持一下
欢迎光临 坏蛋网络 (https://bbs.zonghengtx.cn/)
Powered by Discuz! X3.4