2.1 插件模块三类型与挂载位置

把功能挂到导航、挂到用户页、还是插进现有页面，看这一节就能选对。

模块是什么，谁来挂

插件本身只是一堆躺在 source/plugin/标识符/ 里的 PHP 文件，Discuz! 不会自动执行它们。真正把它们叫醒的是插件模块机制：后台插件详情页分三块设置，每块配置「在什么位置、按什么身份、调用哪个文件」。差别本质是挂载目标不同：挂导航条、挂已有设置页、挂系统脚本的执行点。

打个比方：程序链接是新开一扇门，扩展项目是在墙上开一扇窗，程序脚本是在水管上装过滤器。

一个程序链接类模块的最简文件形态，就是模块名加后缀：

<?php
// source/plugin/hello/hello.inc.php  ← 后台模块名填 hello
defined('IN_DISCUZ') or exit('Access Denied');
$msg = 'Hello, Discuz!';
include template('hello');

模块名必须和 .inc.php 的文件名一字不差，这是 404 的头号来源。

类型一：程序链接类

这一类负责把插件挂到站点的导航体系上，后台能配的位置有：

每个位置可以指派两种目标：一个 URL，或者调用一个插件模块。选了后者，后台让你填模块名，对应 source/plugin/{标识}/{模块名}.inc.php。模块名填 hello，就找 source/plugin/hello/hello.inc.php，生成的链接是 plugin.php?id=标识:模块名。

类型二：扩展项目类

扩展项目不新增页面，而是挂到系统已有的固定位置上。脚本同样以 .inc.php 结尾，但模板是固定文件名，放在 source/plugin/{标识}/template/ 子目录里，与脚本同名。后台提供的挂载位置共 10 个：

「固定文件名 + 与脚本同名」这条最容易踩坑。脚本叫 mytools.inc.php，模板就必须是 template/mytools.htm。写错的表现是页面一片空白，控制台没有任何提示。

类型三：程序脚本类

程序脚本不负责出页面，而是插进系统脚本的执行过程里：

脚本以 .class.php 结尾，写成一个类，类名和钩子名有严格对应关系。普通版用 plugin_ 前缀，手机版用 mobileplugin_ 前缀。完整骨架与调用时机见 2.3、2.4。

三类模块对照

横向比一次：程序链接和扩展项目都用 .inc.php，区别在于前者的模板名你自己定（通过 include template() 指定），后者是固定名放在 template/ 子目录。前两者都是「用户点进来才执行」，程序脚本是「系统在执行点自动调用」，不写模板。

决策表：我想把功能挂哪儿

口诀：要出页面用 .inc.php，不出页面插钩子用 .class.php。

使用等级不等于权限校验

每个模块都能在后台设一个「使用等级」，比如超级版主、管理员。但这个设置只是菜单层面的显示与初步过滤，程序内部仍需自行校验权限。

原因很直接：用户可以手工构造 URL 访问模块。菜单里看不见入口，不代表 URL 打不开。所以模块脚本第一件事是查身份：

<?php
if (!defined('IN_DISCUZ')) {
    exit('Access Denied');
}

// $_G['uid'] 非 0 即已登录；$_G['adminid'] 1~3 为管理身份
if (!$_G['adminid']) {
    showmessage('抱歉，您没有权限使用此功能');
}

这段放在 source/plugin/标识/模块名.inc.php 的开头。少这一行，模块就等于对全站注册用户开放。

常见坑

小结

三类模块对应三种意图：程序链接新开门，扩展项目开窗，程序脚本装过滤器。选型只看一件事——这功能需不需要自己出一张页面。需要就 .inc.php，在导航或扩展位置上挂；不需要就 .class.php，去找对应钩子点。

再强调一次最容易翻车的规则：后台的使用等级只是菜单过滤，权限判断必须写在你自己的模块文件里。

2.2 讲最省事的落地方式：文件一放，plugin.php 直接就能访问。