discuz X2二次开发帮助文档

相信有不少人热衷于基于修改原有系统文件所做的插件，当然了解程序文件功能是最重要的，下面我把Discuz! X2.0主要的程序文件功能说一下。我只是整理，不是自己原创编辑的，所有权归原创作者所有哦。

Tips:

Q:针对说明的文件是？

A:我只基于原版文件对upload目录中基本的程序文件(php,htm,js，除了极少数无关紧要的)进行解释，其余文件（如图片文件），一般不做说明

Q:某些目录下空白的index.htm是用来做什么的？

A:用来防止列目录的

Q:文件名颜色和标识的意义是？

A:粗体表示这个文件比较重要，除非你非常了解其功能，否则修改错误会导致全站瘫痪；斜体表示这个文件已被加密，一般情况下修改没有意义;下划线表示这个文件一般99.99%的修改是用不上的，了解即可

绿色的是函数库文件，蓝色的是常量调用文件，红色的是系统全局核心文件

Q:文件名命名有什么特别规律吗？

A:有的，一般inc的是调用文件，func是函数库文件，class是库文件，lng的是语言包文件，了解这些后缀能快速掌握文件功能。

Q:我看了你的帖子，可是我还是看不懂文件内是什么意思啊？

A:这个嘛，还是要有一定基础了，一般掌握SQL,PHP和Htm你就可以去改文件做你要的功能了，这个不是我的任务了哦。一般来说，如果随便指个地方，你能在1分钟内说出大概位置及所在的文件，那么你基本就算合格了。不过我个人认为最重要的还是多改多读，在实践中提高自己的能力

下面开始了，请看你的upload目录里面的文件，表述的格式依次为文件名，功能描述等等

先从根目录开始，根目录文件一般都是入口，即执行具体功能的代码一般不在这些文件中，而是在其调用的文件中

admin.php 系统站点管理入口文件

api.php Discuz!合作应用入口文件（例如漫游、支付宝什么的都走这里）

connect.php QQ互联入口文件

cp.php 应用入口文件

crossdomain.xml 数据交互文件，如果在里面定义其它站点的地址，那么这两个不同站点就可以交互数据

favicon.ico图标文件，显示在浏览器的标题栏

forum.php 论坛入口文件

group.php 群组入口文件

home.php 家园入口文件

index.php 功能与portal.php基本相同

member.php 用户信息入口文件

misc.php 网站用户常用操作入口文件，例如像评分、收藏等功能都是走这个文件的plugin.php 插件入口文件

portal.php 门户入口文件

robots.txt在这个文件中加上具体的地址，可以防止被搜索蜘蛛检索到

search.php 搜索功能入口程序

userapp.php 用户应用入口程序

API目录中的文件主要是和Discuz!进行合作的商家的应用程序，一般不要也无需修改，这里不多说明。想了解的可以单独问我，这个目录的大部分文件现在都解密了。

archiver目录中只有一个index.php，就是经常说的无图版程序的入口，这个一般不是给人看的，是给机器人看的。

config目录中有两个文件，config_global_default.php是你在安装论坛的时候就要修改的配置文件，另一个config_ucenter_default.php是自动生成的，一般不能手动修改内容，否则会导致出错。

data目录下的文件通常是动态缓存文件，这些文件里面都带有可以被调用的常量，当然附件、头像等等也是在这里保存的，这个不多说明，实际功能打开看就知道了。

install是安装程序的目录，里面文件的含义没有太多解释的意义了，这里省略。

uc_client和uc_server目录中的文件关系到UCentre的运行，一般里面的内容不推荐修改，同理省略。

static目录中的文件全部属于静态文件，例如像图片、预览什么的，这里我只对下面js目录中的文件进行说明

Discuz!中许多的Ajax效果都是这个文件中的代码来实现的，会Javascript的可以尝试去改下，后面我生效的位置进行说明

admincp.js 站点管理

bbcode.js Discuz!代码效果实现

calendar.js 日历

common.js系统全局

common_diy.js 首页DIY效果

common_extra.js 功能基本同common.js

editor.js 编辑器效果

forum.js 论坛效果

forum_moderate.js 论坛管理

forum_post.js 论坛发帖

forum_slide.js 论坛边栏

forum_viewthread.js 论坛主题浏览

google.js google搜索

home.js 家园

home_blog.js 家园日志

home_drag.js 家园，表格拖动

home_friendselector.js 家园好友选择

home_uploadpic.js 家园图片上传

logging.js 登录

md5.js MD5加密

portal.js 首页

portal_diy.js 首页DIY

portal_upload.js 首页上传

register.js 注册页面

seditor.js 编辑器效果

smilies.js 表情

space_diy.js 个人空间DIY

threadsort.js 主题排序

tree.js 树形列表

userapp_swfobject.js FLASH批量上传

接着回到根目录，这里我对templates/default目录中的模板文件的功能做下解释

其中userapp和style里面的模板分别对应着应用和家园风格，mobile目录的模板对应的是3G手机版，search目录里面是搜索页面模板，ranklist对应的是排行榜模板，tag目录中的是标签，group里面的是群组模板，home中的是家园模板，portal里面的是文章首页模板，这些对插件作者来说一般用不上，这里就不多叙述了。

只说下面的目录，后面对文件被调用的场合进行说明

default/member 下面有四个文件

getpasswd.htm 密码取回

login.htm 用户登录

login_simple.htm 同上，但是功能简单点

register.htm 用户注册

default/common 下面的css我不做解释，因为对做插件的人来说基本用不上，有兴趣的请自行请教模板风格作者，同样对使用的场合进行说明

block_forumtree.htm 论坛树形列表模块

block_thread.htm 主题模块

block_userinfo.htm 用户信息模块

buyinvitecode.htm 邀请码购买

css_sample.htm CSS样例

editor.htm 编辑器

editor_menu.htm 编辑器菜单按钮

extcredits.htm 拓展积分列举

faq.htm 使用帮助

footer.htm 站点底部文件，一般的模板文件都要调用这个模板以正常显示底部信息

footer_ajax.htm 同上