1. Discuz X3.5模板目录全景解析
第一次打开Discuz X3.5的template目录时,我完全被里面密密麻麻的文件夹和文件搞晕了。经过三个月的实战摸索,终于理清了这套模板系统的设计逻辑。现在我就用最直白的语言,带大家逛一遍这个"迷宫"。
整个模板体系就像一栋大楼,default目录就是精装修的样板间。里面每个子目录对应不同的功能区域:
- common是公共大厅,放着所有页面都会用到的"家具"
- forum是论坛主会场
- portal是门户展示区
- member是会员服务中心
- touch则是移动端专属楼层
最常打交道的几个核心文件,我习惯叫它们"四大金刚":
- header.htm - 每个页面的"帽子",控制顶部导航栏
- footer.htm - 每个页面的"鞋子",决定底部信息栏
- module.css - 控制所有模块的"穿衣风格"
- common.css - 全站通用的"基础穿搭"
新手最容易犯的错误就是直接修改default目录里的文件。正确的做法是新建一个风格目录(比如/template/my_style/),然后只复制需要修改的文件过去。这样系统升级时,你的定制内容才不会丢失。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 公共模板目录深度拆解
2.1 common目录实战指南
common目录里有二十多个文件,但真正需要经常动的就那几个。我整理了个优先级清单:
必须掌握的文件:
- header.htm:修改这里可以添加全站统一的导航菜单。上次我给客户加了个快捷搜索框,就是在第38行插入的form代码。
- footer.htm:版权信息修改点。有个小技巧:用
<!--{if $_G['uid']}-->判断登录状态,可以给未登录用户显示特别提示。 - module.css:这个文件控制着所有模块的间距、边框等样式。记住修改后要到后台更新CSS缓存。
进阶修改文件:
- editor.css:编辑器样式调整。比如想把字体选择下拉框加宽,就改第72行的width值。
- showmessage.htm:系统提示框模板。我经常在这里添加自定义的提示图标。
有个坑我踩过:修改common.js时一定要保留原始事件绑定。有次我把整个文件重写了,结果导致所有AJAX功能失效,论坛直接瘫痪两小时。
