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.jseditor.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 首页DIYportal_upload.js 首页上传register.js 注册页面seditor.js 编辑器效果smilies.js 表情space_diy.js 个人空间DIYthreadsort.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 同上header.htm 头部文件，一般的模板文件都要调用这个文件以正常显示头部信息header_ajax.htm 同上header_common.htm 同上header_diy.htm 同上invite.htm 邀请注册preview.htm 也来pubsearchform.htm 搜索report.htm 报告seccheck.htm 验证码检查seditor.htm 编辑器sendmail.htm 邮件发送页showmessage.htm 提示信息页面，在PHP程序中使用showmessage函数出来信息使用的模板就是这个simplesearchform.htm 搜索stat.htm 站点统计userabout 用户应用信息default/forum 一般论坛里面的PHP程序所调用的模板文件都是在这里(小提示，一般htm 对应的php文件文件名都是有类似字符的，很好认的)activity_applist_more.htm 应用列表activity_applylist.htm 应用列表activity_export.htm 导出ajax_albumlist.htm 相册列表ajax_attachlist.htm 附件列表ajax_imagelist.htm 图片列表ajax_secondgroup.htm 拓展用户组ajax_threadlist.htm 主题列表announcement.htm 公告attachpay.htm 附件收费attachpay_view.htm 收费附件付费记录浏览comment.htm 点评comment_more.htm 同上debate_umpire.htm 辩论discuz.htm 论坛首页discuzcode.htm Discuz!代码editor_ajax.htm 编辑器editor_menu_forum.htm 论坛菜单forumdisplay.htm 主题列表浏览forumdisplay_fastpost.htm 快速回复框架forumdisplay_leftside.htm 主题列表浏览边栏forumdisplay_list.htm 主题列表forumdisplay_passwd.htm 论坛密码输入页面forumdisplay_subforum.htm 二级论坛框架index.htm 空文件，作用是防止列目录index_navbar.htm 头部导航栏modcp.htm 版主管理后台modcp_announcement.htm 版主管理后台公告发布modcp_forum.htm 版主管理后台论坛管理modcp_forumaccess.htm 版主管理后台论坛权限设置modcp_home.htm 版主管理后台主页modcp_log.htm 版主管理后台记录查看modcp_login.htm 版主管理后台登录页modcp_member.htm 版主管理后台用户管理modcp_moderate.htm 版主管理后台主题批量管理modcp_moderate_float.htm 版主管理后台主题管理浮动窗口modcp_post.htm 版主管理后台帖子管理modcp_recyclebin.htm 版主管理后台回收站modcp_recyclebinpost.htm 版主管理后台回收站帖子浏览页modcp_report.htm 版主管理后台用户报告管理modcp_thread.htm 版主管理后台主题管理pay.htm 收费主题pay_view.htm 收费主题付费记录查看post.htm 跟发帖有关的模板，这个是全局模板post_activity.htm 发表活动主题post_attachlimit.htm 附件限制信息页面post_debate.htm 发表辩论主义post_editor_attribute.htm 编辑器post_editor_body.htm 编辑器主题post_editor_extra.htm 编辑器附件功能post_editor_option.htm 编辑器post_forumselect.htm 发帖时论坛列表选择post_infloat.htm 浮动发帖页面post_poll.htm 投票主题发布页面post_reward.htm 发表悬赏主题post_sortoption.htm 排序选项post_trade.htm 发表商品主题postappend.htm 以往帖子列表浏览rate.htm 用户评分rate_view.htm 评分记录recommend.htm 主题推荐relatekw.htm 标签生成页search_sortoption.htm 搜索stat_main.htm 站点统计首页stat_memberlist.htm 站点统计，用户统计stat_misc.htm 站点统计，例如像竞价、主题等等的统计stat_onlinetime.htm 站点统计，在线时间统计stat_team.htm 站点统计，管理团队stat_trade.htm 站点统计，交易统计tag.htm 标签topicadmin.htm 全局模板，配合下面的使用topicadmin_action.htm 浏览主题时选择主题管理操作的下拉列表项目topicadmin_getip.htm 帖子IP查看页topicadmin_modlayer.htm 管理主题时候，悬浮的带有置顶、移动、精华等常用操作的小浮窗trade.htm 商品主题全局模板trade_displayorder.htm 商品主题基本信息trade_info.htm 商品信息浏览trade_view.htm 商品交易记录浏览upload.htm 附件上传viewthread.htm 浏览的主题时调用的全局模板viewthread_activity.htm 浏览活动主题viewthread_debate.htm 浏览辩论主题viewthread_fastpost.htm 浏览主题时快速发帖的框子viewthread_from_node.htm 同viewthread_node.htmviewthread_mod.htm 浏览主题时的管理项viewthread_node.htm 浏览主题的时候显示的用户信息viewthread_node_body.htm 同上viewthread_pay.htm 浏览付费主题viewthread_poll.htm 浏览投票主题viewthread_poll_voter.htm 浏览投票主题的选项viewthread_portal.htm 浏览文章viewthread_printable.htm 浏览可打印版本viewthread_reward.htm 浏览悬赏主题viewthread_trade.htm 浏览商品主题warn_view.htm 浏览帖子警告记录不过前面都是打酱油的程序文件，真正的大牌现在才开始，返回根目录，看source目录把，主要执行具体功能的程序都在里面source下面的discuz_version.php是Discuz!版本标示文件，这个文件是对当前Discuz!版本进行识别，一般不动的。