做Discuz! X2的插件开发也有一段时间了,不敢说对插件开发的各个细节都了解,总结了一些可能在开发中会遇到的问题,分享给喜好插件开发的童鞋们。
关于嵌入点:
除了常见的模板的嵌入点以外,Discuz! X2还有一些比较冷门的嵌入点,给大家总结下:
showmessage函数中的嵌入点
function_message.php的25行左右
- hookscript(CURMODULE, $_G['basescript'], 'messagefuncs', array('param' => $_G['messageparam']));
复制代码 对应的调用函数命名为 XXX_message(),可以接受一个传递参数。
参数的值为showmessage函数的所有参数的集合的一个数组。
该嵌入点可以用于输出成功提示之前执行操作。
discuzcode函数中的嵌入点
function_discuzcode.php的87行左右
- hookscript('discuzcode', 'global', 'funcs', array('param' => $param, 'caller' => 'discuzcode'), 'discuzcode');
复制代码 function_post.php的529行左右
- hookscript('discuzcode', 'global', 'funcs', array('param' => $param, 'caller' => 'messagecutstr'), 'discuzcode');
复制代码 对应的调用函数命名应为 discuzcode(),与showmessage的嵌入点类似,接受一个参数,参数为discuzcode函数所有参数的集合的一个数组。
'caller' 指明了入口函数是'discuzcode'还是'messagecutstr'。
该嵌入点通常用于处理discuzcode输出,可以定义插件专有的code替换代码。
deletethread和deletepost函数中的嵌入点
function_delete.php中
- hookscript('deletepost', 'global', 'funcs', array('param' => $hookparam, 'step' => 'check'), 'deletepost');
- hookscript('deletepost', 'global', 'funcs', array('param' => $hookparam, 'step' => 'delete'), 'deletepost');
- hookscript('deletethread', 'global', 'funcs', array('param' => $hookparam, 'step' => 'check'), 'deletethread');
- hookscript('deletethread', 'global', 'funcs', array('param' => $hookparam, 'step' => 'delete'), 'deletethread');
复制代码 该嵌入点分别在删除主题(帖子)操作的前后执行,区别在于'step'参数的值。
对应的调用函数命名应为 deletethread()和deletepost(),接受一个参数以取得deletethread和deletepost函数所有参数。
该嵌入点用于执行删除主题(帖子)时,嵌入插件操作
关于返回值:
通过设置配置文件中的$_config['plugindeveloper'] = 2;可以在页面上看到模板中的嵌入点。
[array XXXX]这样的嵌入点需要返回array类型的数据,而不能是其他类型的数据。
如果返回空值会导致同一个嵌入点无法被其他插件再度使用,需要特别注意一下。
正确的做法是对于array类型的hook点,如果没有返回值,请return array();
关于安全方面:
任何插件脚本文件,在开始判断IN_DISCUZ是必须的,如果是后台执行的脚本,需要判断IN_ADMINCP。
对于任何形式的提交数据,请使用$_G['gp_XXX']的形式取得值,并且最好是做一些is_array、is_numeric的判断,减少一些意外的错误。
尽量不使用插件目录作为读写文件的目录,如果有读写文件的操作,放到data目录下比较合适
关于插件开发的细节众多,本人也会在将来开发的路上,不断补充~
|