Discuz! X2 插件开发一些细节记录

admin · 发表于 2013-3-30 05:31

做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目录下比较合适

关于插件开发的细节众多，本人也会在将来开发的路上，不断补充~

骆飞双 · 发表于 2017-6-6 16:08

支持一下！！呵呵

3d预测胆码 3d预测胆码 neiba.cn/

		自动登录	找回密码
密码			立即注册

Discuz! X2 插件开发一些细节记录

相关帖子