discuz X2二次开发帮助文档

《discuz X2二次开发帮助文档》由会员分享，可在线阅读，更多相关《discuz X2二次开发帮助文档（13页珍藏版）》请在装配图网上搜索。

1、相信有不少人热衷于基于修改原有系统文件所做的插件，当然了解程序文件功能是最重要的，下面我把Discuz! X2.0主要的程序文件功能说一下。我只是整理，不是自己原创编辑的，所有权归原创作者所有哦。Tips:Q:针对说明的文件是？A:我只基于原版文件对upload目录中基本的程序文件（php,htm,js,除了极少数无关紧要的） 进行解释，其余文件（如图片文件），一般不做说明Q:某些目录下空白的index.htm是用来做什么的？A: 用来防止列目录的Q：文件名颜色和标识的意义是？A:粗体表示这个文件比较重要，除非你非常了解其功能，否则修改错误会导致全站瘫痪；斜 体表示这个文件已被加密，一般情况下

2、修改没有意义;下划线表示这个文件一般99.99%的修 改是用不上的，了解即可 绿色的是函数库文件，蓝色的是常量调用文件，红色的是系统全局核心文件Q: 文件名命名有什么特别规律吗？A:有的，一般inc的是调用文件，func是函数库文件，class是库文件，lng的是语言包文 件，了解这些后缀能快速掌握文件功能。Q:我看了你的帖子，可是我还是看不懂文件内是什么意思啊？A:这个嘛，还是要有一定基础了，一般掌握SQL,PHP和Htm你就可以去改文件做你要的功能 了，这个不是我的任务了哦。一般来说，如果随便指个地方，你能在1分钟内说出大概位置 及所在的文件，那么你基本就算合格了。不过我个人认为最重要的还

3、是多改多读，在实践中 提高自己的能力下面开始了，请看你的upload目录里面的文件，表述的格式依次为文件名，功能描述等等 先从根目录开始，根目录文件一般都是入口，即执行具体功能的代码一般不在这些文件中， 而是在其调用的文件中admin.php 系统站点管理入口文件 api.php Discuz!合作应用入口文件（例如漫游、支付宝什么的都走这里） connect.php QQ互联入 口文件cp.php应用入口文件crossdomain.xml数据交互文件，如果在里面定义其它站点的地址，那么这两个不同站点就 可以交互数据favicon.ico 图标文件，显示在浏览器的标题栏 forum.php 论

4、坛入口文件group.php 群组入口文件home.php 家园入口文件index.php 功能与 portal.php 基本相同member.php 用户信息入口文件misc.php 网站用户常用操作入口文件，例如像评分、收藏等功能都是走这个文件的plugin.php插件入口文件portal.php 门户入口文件robots.txt 在这个文件中加上具体的地址，可以防止被搜索蜘蛛检索到 search.php 搜索功能入口程序userapp.php 用户应用入口程序API目录中的文件主要是和Discuz!进行合作的商家的应用程序，一般不要也无需修改，这 里不多说明。想了解的可以单独问我，这个目

5、录的大部分文件现在都解密了。archiver目录中只有一个index.php,就是经常说的无图版程序的入口，这个一般不是给人 看的，是给机器人看的。config 目录中有两个文件， config_global_default.php 是你在安装论坛的时候就要修改 的配置文件,另一个config_ucenter_default.php是自动生成的，一般不能手动修改内容， 否则会导致出错。data 目录下的文件通常是动态缓存文件，这些文件里面都带有可以被调用的常量，当然附 件、头像等等也是在这里保存的，这个不多说明，实际功能打开看就知道了。install 是安装程序的目录，里面文件的含义没有太多解

6、释的意义了，这里省略。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 功能基本同 c

7、ommon.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 首页 D

8、IYportal_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目录 中的是标签，

9、group 里面的是群组模板， home 中的是家园模板， portal 里面的是文章首页 模板，这些对插件作者来说一般用不上，这里就不多叙述了。只说下面的目录，后面对文件被调用的场合进行说明default/member 下面有四个文件getpasswd.htm 密码取回login.htm用户登录login_simple.htm 同上，但是功能简单点register.htm 用户注册default/common 下面的 css 我不做解释，因为对做插件的人来说基本用不上，有兴趣的请 自行请教模板风格作者，同样对使用的场合进行说明block_forumtree.htm 论坛树形列表模块block

10、_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 同上 he

11、ader_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 程序所调用的模板文件都是在这里（小提示，一般

12、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 收费附件付费

13、记录浏览 comment.htm 点评 comment_more.htm 同上 debate_umpire.htm 辩论 discuz.htm 论坛首页discuzcode.h tm Discuz!代码editor_ajax.htm 编辑器editor_menu_forum.htm 论坛菜单forumdisplay.htm 主题列表浏览 forumdisplay_fastpost.htm 快速回复框架 forumdisplay_leftside.htm 主题列表浏览边栏 forumdisplay_list.htm 主题列表 forumdisplay_passwd.htm 论坛密码输入页面 fo

14、rumdisplay_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_mo

15、derate.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

16、发表活动主题 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 排序选项

17、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 站点统

18、计，交易统计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 浏览的主题时调

19、用的全局模板 viewthread_activity.htm 浏览活动主题 viewthread_debate.htm 浏览辩论主题 viewthread_fastpost.htm 浏览主题时快速发帖的框子 viewthread_from_node.htm 同 viewthread_node.htm viewthread_mod.htm 浏览主题时的管理项 viewthread_node.htm 浏览主题的时候显示的用户信息 viewthread_node_body.htm 同上 viewthread_pay.htm 浏览付费主题 viewthread_poll.htm 浏览投票主题 view

20、thread_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! 版本进行识别，一般不

21、动的。source 下面的多个目录中， plugins 目录是插件目录，如果你要用插件接口开发插件，一般 文件都是放这个目录中的；language目录中是所有的语言包文件，里面的内容自己打开看 就可以了； archiver 目录中的是无图版的程序。这些一般是无关紧要的，这里就不浪费篇 幅了。class目录中都是调用库的文件，对一般的插件作者来说，只需要掌握下面的几个目录里面 的文件就可以了 。sourceclassmagic 里面是所有的道具脚本文件，具体文件对应的道具功能到系统设置看 就可以了sourceclasstask 里面是所有的论坛任务脚本文件task_avatar.php 头像上传

22、任务task_blog.php 日志任务task connect bind.php QQ 互联任务 task_email.php 邮箱验证任务 task_friend.php 加好友的任务 task_gift.php 红包类任务 task_member.php 用户类任务 task_post.php 发帖任务 task_profile.php 完善用户信息的任务 task_promotion.php 空间任务classblockforum 里面的文件是 DIY 论坛页面的时候，所用到的模块程序，这里的程序只 管理数据的搜索方式而不管理数据的具体显示block_activity.php 论坛活动

23、 block_activitycity.php 论坛活动城市 block_activitynew.php 最新活动 block_forum.php 论坛 block_thread.php 主题 block_threaddigest.php 精华主题 block_threadhot.php 最热主题 block_threadnew.php 最新主题 block_threadspecial.php 特殊主题展示 block_threadspecified.php 分类主题展示 block_threadstick.php 置顶主题展示 block_trade.php 商品主题展示 block_tra

24、dehot.php 最热商品主题展示 block_tradenew.php 最新商品主题展示 block_tradespecified.php 商品分类信息展示blockclass.php 只有几行的程序，用来显示论坛对应的名称，不作为单独的模块module 目录中，对一般插件作者来说，掌握 forum/home/group/member/misc 这 5 个目录的 程序文件含义就足够了，另外这些文件调用的模板与 templates/default 下面的目录结构 和文件是对应的，这点非常好辨别，所以如果要修改对应的模板显示方式的话，去按照这 个规则找htm文件改就可以了。sourcemodu

25、leforum 管理所有与论坛有关的程序 forum_ajax.php 论坛 ajax 效果程序 forum_announcement.php 论坛公告forum_attachment.php 论坛附件下载 forum_forumdisplay.php 论坛主题列表 forum_group.php 群组论坛 forum_image.php 论坛图片 forum_index.php 论坛首页 forum_index_mobile.php 论坛首页手机版 forum_misc.php 杂项功能，例如像评分收藏什么都在这里 forum_modcp.php 论坛版主管理 forum_post.php

26、论坛帖子发表所用到的程序forum_redirect.php 帖子跳转，例如查看上一主题、下一主题就用到这个文件 forum_relatekw.php 标签聚合 forum_relatethread.php 相关主题显示forum_rss.php RSS 调用 forum_tag.php 标签浏览 forum_topicadmin.php 主题浏览页面的主题管理 forum_trade.php 商品交易 forum_viewthread.php 浏览主题时的主程序sourcemodulegroup 管理所有和群组有关的程序 group_attentiongroup.php 我关注的群组 gro

27、up_index.php 群组首页 group_my.php 我的群组sourcemodulehome 管理所有和家园有关的程序 home_editor.php 家园编辑器 home_invite.php 家园，邀请注册 home_magic.php 家园，道具 home_medal.php 家园，勋章 home_misc.php 家园，杂项操作 home_rss.php 家园 RSS home_space.php 家园空间 home_spacecp.php 家园空间后台管理 home_task.php 家园，任务操作sourcemodulemember 功能比较杂，下面详细说 member_

28、activate.php 用户激活 member_clearcookies.php 信息清理 member_connect.php QQ 互联 member_connect_logging.php 互联登录 member_connect_register.php 互联注册 member_emailverify.php Email 验证 member_getpasswd.php 获取密码 member_logging.php 标准登录 member_lostpasswd.php 找回密码 member_register.php 用户注册 member_regverify.php 注册验证 mem

29、ber_switchstatus.php 状态切换，例如从隐身切换到非隐身sourcemodulemisc 功能也比较杂，下面详细说 misc_buyinvitecode.php 邀请码购买 misc_diyhelp.php DIY 帮助 misc_error.php 错误提示页 misc_faq.php 论坛自带的帮助misc initsys.php所有云服务功能在此 misc_invite.php 邀请注册 misc_manyou.php 漫游程序 misc_mobile.php手机版杂项功能 misc_ranklist.php 排行榜页面 misc_report.php 用户报告 mis

30、c_seccode.php 验证码生成程序 misc_secqaa.php 验证提问生成程序 misc_stat.php 站点统计 misc_swfupload.php 附件快速批量上传 misc_tag.php 标签管理sourceadmincp 下面的都是和系统站点设置相关的文件，下面的目录的文件不必掌握，只 需要知道cloud是跟云服务有关的系统设置就可以了sourceadmincpmoderate 是跟后台审核有关的程序，内容说明如下moderate_article.php 文章审核moderate_blog.php 日志审核 moderate_comment.php 评论审核mode

31、rate_doing.php 动态审核 moderate_member.php 用户审核moderate_picture.php 上传图片审核 moderate_portalcomment.php 门户评论审核moderate_reply.php 回复审核moderate_share.php 分享审核moderate_thread.php 主题审核 sourceadmincpadmincp_addons.php 认证插件作者管理 admincp_admingroup.php 管理组管理 admincp_adv.php 广告管理 admincp_album.php 相册管理 admincp_al

32、bumcategory.php 相册分类管理 admincp_announce.php 公告管理 admincp_article.php 文章管理 admincp_attach.php 附件管理 admincp_block.php 模块管理 admincp_blockstyle.php 模块风格 admincp_blockxml.php 同上 admincp_blog.php 日志管理 admincp_blogcategory.php 日志分类管理 admincp_card.php 卡密生成 admincp_checktools.php 检查工具 admincp_click.php 家园访问

33、admincp_cloud.php 云服务 admincp_comment.php 评论管理 admincp_counter.php 论坛统计更新 admincp_cpanel.php 调用库，调用一些函数 admincp_credits.php 积分设置 admincp_db.php 数据库管理 admincp_district.php 分类信息模型 admincp_diytemplate.php 模板 DIY 管理 admincp_doing.php 后台设置搜索功能 admincp_domain.php 导航栏管理 admincp_ec.php 电子商务 admincp_faq.php

34、论坛帮助管理 admincp_feed.php 动态设置 admincp_forums.php 论坛设置 admincp_founder.php 创始人设置 admincp_group.php 用户组设置 admincp_index.php 后台首页 admincp_login.php 后台登陆页面 admincp_logs.php 系统记录查看 admincp_magics.php 道具设置 admincp_main.php 调用的模板，显示头部信息用途 admincp_medals.php 勋章设置 admincp_members.php 会员设置 admincp_menu.php 系统设

35、置中的菜单 admincp_misc.php 杂项设置，在线列表，友情链接等等的 admincp_moderate.php 审核管理，直接调用下面 moderate 目录的程序 admincp_nav.php 系统设置中的导航栏 admincp_perm.php 权限设置 admincp_pic.php 上传图片管理 admincp_plugins.php 插件管理 admincp_portalcategory.php 门户文章分类管理 admincp_postcomment.php 帖子点评管理 admincp_postsplit.php 帖子批量管理 admincp_profilefiel

36、d.php 用户信息设置 admincp_prune.php 过滤词语设置 admincp_quickquery.php 快速 SQL 语句设置 admincp_recyclebin.php 回收站管理 admincp_recyclebinpost.php 回收站帖子管理 admincp_report.php 报告管理 admincp_search.php 搜索管理 admincp_setting.php 系统全局设置 admincp_share.php 分享设置 admincp_smilies.php 表情设置 admincp_specialuser.php 特殊用户设置 admincp_s

37、tyles.php 风格设置admincp_tag.php 标签管理admincp_tasks.php 任务管理 admincp_templates.php 模板管理 admincp_threads.php 主题管理 admincp_threadsplit.php 主题批量管理 admincp_threadtypes.php 主题分类admincp_tools.php 系统工具admincp_topic.php 主题批量管理，不是单独使用的 admincp_tradelog.php 商品交易记录 admincp_usergroups.php 用户组设置 admincp_verify.php 用

38、户验证管理discuzdb.md5标准数据库校验文件数据文件discuzfiles.md5标准程序文件校验文件数据文件，里面记录了标准文件的尺寸信息sourcefunction 下面就全部都是函数文件了，这些文件真的很好用的，里面有很多强大 的函数，调用这些文件就能用了。sourcefunctioncache里面的文件跟缓存文件生成有关，不必掌握。 sourcefunction 我把和这些函数有关的操作写出来function_admincp.php 系统设置 function_attachment.php 附件操作 function_block.php 模块 function_blog.php

39、 日志 function_cache.php 缓存 function_cloud.php 云服务 function_comment.php 评论 func tio n_connec t.php QQ 互联 function_core.php 大量的核心函数在这里，相当于旧版本的 global.func.php function_credit.php 积分操作 function_delete.php 删除操作func tio n_discuzcode.php Discuz!代码function_domain.php 导航栏 function_ec_credit.php 积分交易 function

40、_editor.php 编辑器 function_exif.php 相片 exif 信息 function_feed.php 动态管理 function_filesock.php 远程文件 function_forum.php 论坛 function_forumlist.php 论坛列表 function_friend.php 好友 function_group.php 群组 function_grouplog.php 群组记录 function_home.php 家园 function_importdata.php 导出数据 function_magic.php 道具function_mai

41、l.php 邮箱操作 function_manyou.php 漫游 function_member.php 用户 function_message.php 信息 function_misc.php 杂项函数 function_plugin.php 插件 function_portal.php 门户 function_portalcp.php 门户后天 function_post.php 帖子 function_profile.php 个人信息 function_search.php 搜索 function_seccode.php 验证码 function_share.php 分享 functi

42、on_space.php 个人页面 function_spacecp.php 个人页面设置 function_stat.php 站点统计 function_sysmessage.php 系统信息 function_threadsort.php 主题排序 function_trade.php 商品交易 function_userapp.php 用户应用最后就是sourceinclude文件了，很多操作通过入口程序后，执行的具体代码都在这里。 其 中 sourceincludecron 里 面 全 部 是 计 划 任 务 的 脚 本 文 件 。 重 点 介 绍 modcppostspacethre

43、adtopicadmin 这 5 个目录里面的文件含义sourceincludemodcp 版主后台程序都在这里 modcp_announcement.php 公告modcp_forum.php 论坛标记 modcp_forumaccess.php 论坛权限 modcp_home.php 主页 modcp_log.php 运行记录 modcp_login.php 登录页面 modcp_member.php 用户编辑 modcp_moderate.php 审核 modcp_noperm.php 无权限提示页面 modcp_plugin.php 插件管理 modcp_recyclebin.php

44、回收站 modcp_recyclebinpost.php 回收站帖子 modcp_report.php 用户报告 modcp_thread.php 主题批量管理sourceincludepost 帖子发表操作都在这里进行 post_albumphoto.php 发表相册照片 post_editpost.php 编辑帖子 post_newreply.php 发新回复post_newthread.php 发新主题 post_newtrade.php 发新商品主题 post_threadsorts.php 主题分类信息sourceincludespace 个人设置信息的操作都在这里进行 space_

45、activity.php 邮箱验证 space_album.php 我的相册 space_blog.php 我的日志 space_debate.php 我的辩论 space_doing.php 我的动作 space_favorite.php 个人收藏 space_friend.php 我的好友 space_home.php 我的家园 space_index.php 我的设置主页 space_notice.php 个人提醒 space_plugin.php 跟插件有关的设置 space_pm.php 论坛内短信息 space_poll.php 我的投票 space_profile.php 我的个

46、人信息 space_reward.php 我的悬赏 space_share.php 我的分享 space_thread.php 我的主题 space_trade.php 我的商品交易 space_videophoto.php 视频验证 space_wall.php 我的空间风格设置sourceincludespacethread 所有的特殊主题的操作都单独在这个文件夹中的文件中进 行thread_activity.php 活动主题 thread_debate.php 辩论主题 thread_pay.php 收费主题 thread_poll.php 投票主题 thread_printable.p

47、hp 主题打印 thread_reward.php 悬赏主题 thread_trade.php 商品主题sourceincludespacetopicadmin 记得在浏览主题的时候下拉的主题管理菜单吗？主要 的管理操作代码都在这里的文件中 topicadmin_banpost.php 屏蔽帖子 topicadmin_copy.php 主题复制 topicadmin_delcomment.php 删除评论 topicadmin_delpost.php 删除帖子 topicadmin_getip.php 查看发帖人的 IPtopicadmin_merge.php 合并主题topicadmin_m

48、oderate.php 主题推荐、精华、指定、移动等操作 topicadmin_refund.php 强制退款 topicadmin_removereward.php 取消悬赏 topicadmin_repair.php 修复主题 topicadmin_restore.php 同上 topicadmin_split.php 主题分割 topicadmin_stamp.php 主题鉴定topicadmin_stamplist.php 主题鉴定的标印列表 topicadmin_stickreply.php 回复贴内指定 topicadmin_warn.php 对某个帖子进行警告扩展模板创建一、创建

49、模板套系1、首先进入后台 - 界面 - 模板管理，扩展制作模板时需要创建一个专属套系用来后期修 改2、基于“模板套系”可以扩展针对 ./template/default/ 目录中对的模板文件3、创建套系的原则是不破坏原有模板基础上进行全新的扩展模板设计实例1. 在站点根目录./template/中创建新的目录如./template/mytest2. 在 mytest 目录中创建必要子目录与文件如： ./template/mytest/common/./template/mytext/common/extend_common.css ./template/mytext/common/extend

50、_module.css 其中common目录为公共模板目录，其内部新建的extend_common.css、extend_module.css 为扩展型 CSS 文件，它们可以在./template/default/common/common.css 的和 module.css 的基础上进行CSS代码的覆盖性扩展如果需要替换论坛首页模板，可以新建./template/mytext/common/forum/discuz.htm,或 复制./template/default中的对应文件放在mytext对应目录，以在缓存生成时覆盖原有 模板缓存，达到修改模板而不破坏原生模板的目的二、后台风格管理进

51、入后台 - 界面 - 风格管理 “风格管理”可以对已有风格进行风格变量的编辑，也可以基于前面创建的“模板套系”来 全新开辟新的风格三、新建风格 后台风格管理中，可以通过新增和复制原有风格进行新建风格的操作 新建风格之后，需要编辑它，调整里面的“匹配模板”为上面创建的新套系即可 四、风格管理编辑页面中重点风格常量介绍 匹配模板：对应的模板套系 扩展配色：此风格基础上可用于用户切换配色方案的扩展，它对 应 ./template/mytest/style/ 目 录 中 的 样 式 文 件 。 全 新 创 建 时 应 在./template/mytest/style/目录中建立如tl/style.cs

52、s之后方能生效 默认配色：指定站点访问时，用户首先看到的配色方案 默认表情分类：对应后台 - 界面 - 表情管理中所启用的表情界面基础图片目录:可用于更改模板图片目录，在CSS文件中使用IMGDIR的常量进行输出， 在Discuz! X2版本之后的模板中需要使用$_Gstyleimgdir扩展图片目录:用来更改扩展图片目录，在CSS文件中使用STYLEIMGDIR的常量进行输出， 在Discuz! X2版本之后的模板中需要使用$_Gstylestyleimgdir其他风格常量：以上没有提到风格常量，均可以在后台取得以花括号框选的常量用以在CSS 文件中使用（X2以后的模板中均需要$_Gs ty

53、le中对应的数组键值），涉及到CSS样式 的动态变更，可以在修改对应设置如：正常字体大小F0NTSIZE:12px/1.5,则直接修改程 序运行中 CSS 缓存中的值自定义模板变量-新增：可以根据扩展需求，针对个性化的CSS进行全局的定义 五、CSS部分CSS缓存存放：./da ta/cache/目录中，以“st yle_风格自增编号应用入口关键字所在页 面的mod值.css ”形式保存 自建新套系模板文件可以通过创建 ./template/mytest/common/extend_common.css 或 extend_module.css 进行 CSS 扩展 /* forum:index,

54、forum:forumdisplay */.mycss font: FONTSIZE FONT;/* end */l. 上面的写法含义是：针对 forum 的 index 和 forumdisplay 追加一个自定义的 CSS 样式 mycss ， Discuz! 模板解析将会根据 forum:index 的关键词将 mycss 分别追加在“./data/cache/style_2_forum_index.css”和“./da ta/cache/s tyle_2_forum_forumdisplay.css” 中（里面的数字 2,根据新增的风格编 号而定）2这样的写法好处就是，不变更默认模板的

55、情况下有效的扩展CSS，并可以很好的进行多站 点移植Discuz! X系列产品中CSS文件会在缓存时按照以下顺序进行合并：l. template/default/*.css 文件2当默认模版是非默认模版时,template/模版目录/extend_*.css文件 或template/模版 目录/*.css3. 当某插件启用时，source/plugin/插件目录/template/extend_*.css文件 因此非默认模版目录中的 CSS 属性将继承默认模版中的 CSS 属性，插件目录中的 CSS 文 件将继承前二者的 CSS 属性css自身的集成顺序为：当CSS属性名称相同是，CSS文件中

56、，写在后面的替换前面的代 码CSS 书写规范1. 属性写在一行内，属性之间、属性名和值之间以及属性与“”之间须有空格，例如： .class width: 400px; height: 300px; 2. 属性的书写顺序：1. 针对特殊浏览器的属性， 应写在标准属性之前， 例如： -webkit-box-shadow:; -moz-box-shadow:; box-shaow:;2. 按照元素模型由外及内，由整体到细节书写，大致分为五组：1.位置： position,left,right,float2. 盒模型属性： display,margin,padding,width,height3. 边

57、框与背景： border,background4. 段落与文本： line-height,text-indent,font,color,text-decoration,.5. 其他属性： overflow,cursor,visibility,.3谨慎添加新的选择符规则，尤其不可滥用id，尽可能继承和复用已有样式4. 选择符、属性、值均用小写（格式的颜色值除外），缩写的选择符名称须说明缩写前的全 称，例如 .cl - Clearfix5. 勿使用冗余低效的 CSS 写法，例如： ul li a span . 6. 慎用 !important7. 建议使用在 class/id 名称中的词语1. 表

58、示状态： a-active2. 表示结构： h-header,c-content,f-footer3. 表示区域： mn-main,sd-side,nv-navigation,mu-menu4. 表示样式： l-list,tab,p_pop常用 CSS左浮动、右浮动.z float: left; .y float: right; 因为左右浮动造成的父级浮动溢出，及使用方法.cl:after content: .; display: block; height: 0; clear: both; visibility: hidden; .cl zoom: 1; 大标题字体.wx, .ph font

59、-family: Microsoft YaHei, Hiragino Sans GB, STHeiti, Tahoma, SimHei, sans-serif; font-weight: 100; 行内分割竖线.pipe margin: 0 5px; color: #CCC; 文字字体大小.xs0 font-family: SMFONT; font-size: SMFONTSIZE; -webkit-text-size-adjust: none; .xs1 font-size: 12px !important; .xs2 font-size: 14px !important; .xs3 fon

60、t-size: 16px !important; 灰色文字.xg1, .xg1 a color: LIGHTTEXT !important; .xg1 .xi2 color: HIGHLIGHTLINK !important; .xg2 color: MIDTEXT; 高亮文字，1 为橙色，2为蓝色.xi1, .onerror color: NOTICETEXT; .xi2, .xi2 a, .xi3 a color: HIGHLIGHTLINK ; 文字粗体.xw0 font-weight: 400; .xw1 font-weight: 700; 层下边线.bbda border-botto

61、m: 1px dashed COMMONBORDER; .bbs border-bottom: 1px solid COMMONBORDER !important; 去除边框.bw0 border: none !important; .bw0_all, .bw0_all th, .bw0_all td border: none !important; 去除背景.bg0_c background-color: transparent !important; .bg0_i background-image: none !important; .bg0_all background: none !i

62、mportant; 外边距样式.mtn margin-top: 5px !important; .mbn margin-bottom: 5px !important; .mtm margin-top: 10px !important; .mbm margin-bottom: 10px !important; .mtw margin-top: 20px !important; .mbw margin-bottom: 20px !important; 内边距样式.ptn padding-top: 5px !important; .pbn padding-bottom: 5px !important

63、; .ptm padding-top: 10px !important; .pbm padding-bottom: 10px !important; .ptw padding-top: 20px !important; .pbw padding-bottom: 20px !important; DIY 模块模板语法详解基本语句loop./loop标签来循环显示模块中的数据；如果要在模板中多处循环可以使用 loopl./loopl的方式扩展（只能扩展1-9个）order二N./order标签来替代默认loop中的第N个位置数据的展示，你可以使用orderl二N./orderl的方式来扩展（对应loopl,只能扩展1-9个）其中：order=odd为奇数行，order二even为偶数行index二N./index的方式来指定第N条数据的展示方式，由该语法指定的数据不再在 loop循环中出现，可以通过index1./index1的方式来扩展（只能扩展1-9个）以实 现同一条数据多处展示通用变量当前数据的链接地址： url当前数据的标题： title当前数据的图片地址： pic 当前数据的简介： summary当前数据顺序： curre