编辑“Discuz:插件设置及管理”

{{Discuz! 6.0 top}}
<div style="clear:both;"></div>
<p style="text-indent:2em;">[[插件]]，是基于 [[Discuz]]! [[论坛]]系统之上，设计开发的一种小程序或小方案，用来实现对论坛现有功能扩展和改进。由于 Discuz! 已具有相当完备的底层架构，因此插件并不需要具备很多深层的设计思想，也不需要很专业的开发人员，只要把想实现的功能与论坛的基本体系挂接起来，论坛就能拥有更加个性化的功能。</p>
<p style="text-indent:2em;">那么我针对插件管理和设置做一个详细的说明。插件管理主要是针对插件设计者使用，而一般的使用者，使用插件设置即可。</p>
<p style="text-indent:2em;">我们进到后台 -> 扩展设置 -> 论坛插件，可以看到个当前安装的插件。如图 1 所示：</p>
[[{{ns:image}}:dz540.gif]]
<p style="text-indent:2em;">对于插件设计者来说，插件管理到底是怎么使用的呢？或者怎么设计一个插件呢？进插件管理选项。首先得新增加一个插件的配置，那么在新增那里，填写好插件名称和唯一标识符，提交后，就可以得到一个新的插件配置了的。如图 2 所示：</p>
[[{{ns:image}}:dz541.gif]]
<p style="text-indent:2em;">下面的那个导入插件数据，这个文本输入框，这个是把插件作者设计好的配置，直接粘贴，即可导入论坛。如果插件在论坛的版本不一致的情况下开发的，那么勾选上 允许导入不同版本 Discuz! 的插件(易产生错误!!) 即可导入插件的配置详细。</p>
<p style="text-indent:2em;">在我们新增加了一个插件配置后，我们得对插件的配置进行细节的配置。</p>
<p style="text-indent:2em;">那么我们增加好的列表里面，选择对应的插件，点详情，如图 3 所示：</p>
[[{{ns:image}}:dz542.gif]]
<p style="text-indent:2em;">这个就是点帐户中心的详情，进来看到的各个基本配置。但是有这个基本配置还是不够的。</p>
<p style="text-indent:2em;">那么需要增加对应的模块来实现需要的功能。但是因为为了插件的安全和使用我们提供的统一调用接口，那么配置对应的模块：如图 4 所示：</p>
[[{{ns:image}}:dz543.gif]]]
<p style="text-indent:2em;">增加对应模块的方法，同样是写上模块的名称（模块的标识符）和 菜单名称即可增加新的模块。</p>
<p style="text-indent:2em;">直接链接[[URL]],这个选项，如果填写，那么这个就是在前台增加一个url链接，直接跳转到你填写的地址。</p>
<h5>模块类型有下面几种：</h5>
<p style="text-indent:2em;"><span style="color:red;">直接链接（前台菜单）：</span>可在前台右上角加入一个菜单项，可自主指派菜单链接的 URL。注意：由于引用外部程序，因此即便设置了模块的使用等级，您的程序如需权限判断，仍需要引用 common.inc.[[php]] 和插件相关的缓存文件，并自行判断使用等级是否合法。</p>
<p style="text-indent:2em;"><span style="color:red;">前台调用（前台菜单）：</span>与直接链接类似，但其调用的是插件的一个模块，模块文件名指派为“./plugins/插件目录/插件模块名.inc.php”，由 plugin.php 调用此模块。 </p>
<p style="text-indent:2em;"><span style="color:red;">后台调用（后台菜单）：</span>可在后台插件设置中为此插件增添一个管理模块，模块文件名指派为“./plugins/插件目录/插件模块名.inc.php”，由 admincp.php 调用此模块。</p>
<p style="text-indent:2em;"><span style="color:red;">包含运行（无菜单）：</span>可设置一个在论坛所有页面均包含运行的脚本，此脚本在 ./include/common.inc.php 中加载，脚本文件名指派为“./plugins/插件目录/插件模块名.inc.php”。请注意，为了不导致错误的插件影响论坛运行，在 common.inc.php 加载此模块时，屏蔽了错误信息，因此请务必仔细检查是否存在语法错误，任何微小的语法错误都将不被提示出来，并且导致此模块不被正常加载。如果您配置了不正确的包含脚本而导致论坛系统设置无法使用，删除[[服务器]]上相应的脚本文件即可解决。</p>
<p style="text-indent:2em;">您可以为每个模块设置不同的使用等级，例如设置为“超级版主”，则超级版主及更高的管理者（例如论坛管理员）可以使用此模块。</p> 
<p style="text-indent:2em;"><span style="color:red;">前后台调用方式为：</span></p>
<p style="text-indent:2em;">如果您的插件包含“前台调用（前台菜单）”模块，该模块将统一用 plugin.php?identifier=xxx&module=yyy 的方式调用，请在相应链接、表单中使用此方式。其中 xxx 为插件的惟一标识符，yyy 为模块名称。前台插件外壳程序 plugin.php 已经加载了通用初始化模块（./include/common.inc.php），不需再次引用。</p>
<p style="text-indent:2em;">如果您的插件包含“后台调用（后台菜单）”模块，该模块将统一用 admincp.php?action=plugins&identifier=xxx&mod=yyy 的方式调用，请在相应链接、表单中使用此方式。其中 xxx 和 yyy 的定义与“前台调用（前台菜单）”模块中的相同。系统还允许用 admincp.php?action=plugins&edit=$edit&mod=$mod 的方式来生成链接和表单地址，$edit 和 $mod 变量已经被插件后台管理接口赋值，因此将这两个变量值带入 URL 中也是被支持的。由于后台模块是被 admincp.php 调用，因此已加载了通用初始化模块（./include/common.inc.php）并进行了后台管理人员权限验证，因此模块程序中可直接写功能代码，不需再进行验证。</p>
<p style="text-indent:2em;">这些是模块的设计，基本的变量设置，例如本插件需要用到的设置变量，那么该怎么增加的呢？</p>
<p style="text-indent:2em;">在前面点进某个插件的详情，在最下面，就是显示的是本插件当前所有的变量设置：如图 5 所示：</p>
[[{{ns:image}}:dz544.gif]]
<p style="text-indent:2em;">变量的增加和前面插件的增加类似。例如增加好了一个 管理员是否可用的 这个变量设置，点详情，如图 6 所示：</p>
[[{{ns:image}}:dz545.gif]]
<p style="text-indent:2em;">根据每一项的左边的提示就可以完成一个变量的设置。</p>
<p style="text-indent:2em;">我们设计的插件变量已经设置好了之后，如果我们需要修改到 Discuz! 本身的文件，那么我们可以使用插件钩子。如图 7 所示：</p>
[[{{ns:image}}:dz546.gif]]
<p style="text-indent:2em;">点详情：如图 8 所示：</p>
[[{{ns:image}}:dz547.gif]]
<p style="text-indent:2em;">最后调用是在需要修改代码的页面增嵌入例如 eval($hooks['accounts_hook']); 这样的代码即可。</p>
<p style="text-indent:2em;">现在整个插件的管理我介绍的差不多了。</p>
<p style="text-indent:2em;">那么设计出来的插件效果是什么样的呢，那么我们可以到插件设置来看，进入插件设置，如图 9 所示：</p>
[[{{ns:image}}:dz548.gif]]
<p style="text-indent:2em;">这里就把论坛安装的所有的插件都罗列出来。就以我们增加的插件帐户中心来看看我们的设计：首先是插件参数设置：如图 10 所示：</p>
[[{{ns:image}}:dz549.gif]]
<p style="text-indent:2em;">对应插件管理的设置：如图 11 所示：</p>
[[{{ns:image}}:dz550.gif]]
<p style="text-indent:2em;">参数设置的效果就是这个样子表现了的。</p>
<p style="text-indent:2em;">那么 模块：绑定搜索 的效果，如图 12 所示：(访问的地址：admincp.php?action=plugins&identifier=accounts&mod=stats)</p>
[[{{ns:image}}:dz551.gif]]
<p style="text-indent:2em;">这个对应的插件管理，如图 13 所示：</p>
[[{{ns:image}}:dz552.gif]]
<p style="text-indent:2em;">那么实际上是后台调用执行了我自己写的模块代码：./plugins/accounts/stats.inc.php ，如图 14 所示：</p>
[[{{ns:image}}:dz553.gif]]
<p style="text-indent:2em;">模块：参数设置 的效果，如图 15 所示：（访问地址：admincp.php?action=plugins&identifier=accounts&mod=setting）</p>
[[{{ns:image}}:dz554.gif]]
<p style="text-indent:2em;">对应插件管理：如图 16 所示：</p>
[[{{ns:image}}:dz555.gif]]
<p style="text-indent:2em;">那么实际上是后台调用执行了我自己写的模块代码：./plugins/accounts/setting.inc.php 。后台的插件设置已经已经介绍完毕，那么刚才还有一个 帐户中心的这个模块，这个到哪去了呢？这个设置为前台的链接：如图 17 所示：</p>
[[{{ns:image}}:dz556.gif]]
<p style="text-indent:2em;">可以看出是前台的菜单模块，而且是直接链接的。那么到前台看是什么效果的呢？如图 18 所示：</p>
[[{{ns:image}}:dz557.gif]]
<p style="text-indent:2em;">就是显示一个链接，跳到你设置的直接链接的 url 。一个插件配置设计基本就是上面说明了的，我们可以根据需要关闭或者导出这个插件配置如图 19 所示：</p>
[[{{ns:image}}:dz558.gif]]
<p style="text-indent:2em;">看完上面所有的说明，是不是发现设计一个插件也是如此简单！</p>

== 参考来源 ==
*http://faq.comsenz.com/
{{Discuz! 6.0}}
[[category:Discuz后台扩展管理]]