模板开发入门
一套主题就是 view/ 下的一个目录。讲清布局继承、变量、转义、过滤器、条件、循环,以及十个一定会踩的坑。
约 6 分钟
模板
代码块右上角可一键复制
本页目录(6 分钟读完)
这一章只做两件事:怎么换模板、怎么改页面文字。
不用会写代码。能找到文件、会改字、会保存就行。
怎么换一套模板#
作用:前台换一个样子。
步骤:
- 点左侧「系统设置」→「基础设置」
- 找到「前台模板」
- 下拉选一个主题
- 点「保存」
- 刷新前台看效果
后台界面永远用 default,换前台模板不会把后台换坏。
选的主题目录不存在时,会自动用 default,不会白屏。| 你选的 | 前台用哪套 |
|---|---|
| default | view/default/ |
| mysite | view/mysite/ |
换了没变?→ 去「缓存与维护」点「重建缓存」,再刷新
怎么新建自己的模板#
最快的办法:复制 default 改个名。
步骤:
- 进服务器,找到
view/ - 把
default整个文件夹复制一份 - 改名为
mysite - 后台「前台模板」选
mysite - 保存,刷新前台
主题文件夹里有什么:
| 文件 | 是什么 | 常改吗 |
|---|---|---|
layout.html | 全站骨架,页头页脚 | 偶尔 |
common/header.html | 页头、导航、登录入口 | 常改 |
common/footer.html | 页脚 | 常改 |
common/pager.html | 分页 | 很少 |
index/index.html | 首页 | 常改 |
index/node.html | 栏目列表页 | 常改 |
index/article.html | 内容详情页 | 常改 |
index/page.html | 单页 | 偶尔 |
index/search.html | 搜索结果页 | 很少 |
error/404.html | 404 页 | 很少 |
static/css/style.css | 全部样式 | 常改 |
static/js/style.js | 脚本 | 很少 |
只想换个颜色、字体?
只改 static/css/style.css 就行,一个文件就能变个样。怎么改页面文字#
场景:想把「上一篇」改成「上一条」,把页脚那句话改掉。
步骤:
- 找到对应模板文件(看上面的表)
- 用文本编辑器打开
- 直接改那几个字
- 保存文件
- 刷新前台
文字都在哪:
| 想改什么 | 改哪个文件 |
|---|---|
| 导航上的字 | 加栏目就行,不用改模板 |
| 页头搜索框旁边的字 | common/header.html |
| 页脚版权、备案 | common/footer.html |
| 「上一篇」「下一篇」 | index/article.html |
| 「相关阅读」标题 | index/article.html |
| 首页标题、栏目名 | index/index.html |
| 「暂无内容」提示 | index/node.html |
| 404 页文字 | error/404.html |
例子:把「相关阅读」改成「相关内容」
- 打开
index/article.html - 找到「相关阅读」四个字
- 改成「相关内容」
- 保存
- 刷新前台
改错了、页面乱了?→ 把 default 里同名文件的对应段落抄回来
怎么改站点名、Logo、备案号#
这些不在模板里,在后台设置里。
步骤:
- 点左侧「系统设置」→「基础设置」
- 改这几项
- 点「保存」
| 想改什么 | 填哪一项 |
|---|---|
| 站点名 | 站点名称 |
| 浏览器标签上的标题 | 首页标题 |
| Logo | 站点 Logo |
| 页脚备案号 | ICP 备案号 |
| 页脚版权 | 版权信息 |
| 访问统计 | 统计代码 |
统计代码直接粘进去就行。
不要再包一层 <script>,否则统计抓不到数据。怎么改样式(颜色、字号、间距)#
作用:页面颜色、字体、间距不对。
步骤:
- 打开
static/css/style.css - 找到要改的样式
- 改数值
- 保存
- 浏览器强制刷新(Ctrl + F5)
常用对照:
| 想改什么 | 找什么 |
|---|---|
| 主色(按钮、链接) | color、background |
| 正文字号 | font-size |
| 行距 | line-height |
| 内容宽度 | max-width |
| 圆角 | border-radius |
改样式后浏览器可能显示旧的。
强制刷新:Windows 按 Ctrl + F5,Mac 按 Cmd + Shift + R。怎么只给某一个栏目换版式#
步骤:
- 点左侧「内容」→「栏目管理」
- 点这个栏目后面的「编辑」
- 「列表模板」填文件名,比如
grid - 点「保存」
| 填在哪 | 结果 |
|---|---|
| 列表模板 | 用 node/ 下的文件 |
| 详情模板 | 用 article/ 下的文件 |
只填文件名,不带 .html。
找不到文件会自动用默认模板,不会白屏。详细步骤看 怎么给栏目换模板。
改模板的几条规矩#
| 规矩 | 为什么 |
|---|---|
| 改之前复制一份备份 | 改坏了还能抄回来 |
| 只改自己主题里的文件 | 别动 default,以后升级会覆盖 |
| 样式写进 CSS 文件 | 别写在 HTML 标签里 |
| 改完清缓存 | 不清可能看不到效果 |
| 字可以随便改 | {$...} 这种花括号别动 |
看到 {$article.title} 这种写法:
这不是文字,是取数据的标签,别删、别改。
真要改,看 [模板标签速查](/manual/template-tags)。模板坏了怎么救#
| 症状 | 怎么办 |
|---|---|
| 页面空白 | 模板文件名写错,或改坏了;对照 default 检查 |
页面漏出 {$...} | 标签被弄坏了;对照 default 抄回来 |
页面漏出 <?php | 语法错了;看报错行号 |
| 样式全丢 | static/css/style.css 打不开;查路径和权限 |
| 改了没生效 | 清缓存;浏览器 Ctrl + F5 |
让页面说真话(排查完记得关掉):
# 打开这个地址,会显示真正的报错
http://你的域名/server_debug.php# 重建全部缓存
php aucms cache:rebuild救不回来?→ 把 default 里同名文件整个复制回来,再慢慢改
下一步#
没找到答案?
在后台「缓存与维护 → 系统体检」里看环境是否正常;仍无解就打开
server_debug.php 复现一次,页面会直接告诉你异常文件与行号。