模板开发入门

一套主题就是 view/ 下的一个目录。讲清布局继承、变量、转义、过滤器、条件、循环,以及十个一定会踩的坑。

约 6 分钟 模板 代码块右上角可一键复制
本页目录(6 分钟读完)

这一章只做两件事:怎么换模板、怎么改页面文字。

不用会写代码。能找到文件、会改字、会保存就行。

怎么换一套模板#

作用:前台换一个样子。

步骤:

  1. 点左侧「系统设置」→「基础设置」
  2. 找到「前台模板」
  3. 下拉选一个主题
  4. 点「保存」
  5. 刷新前台看效果
文本
后台界面永远用 default,换前台模板不会把后台换坏。
选的主题目录不存在时,会自动用 default,不会白屏。
你选的前台用哪套
defaultview/default/
mysiteview/mysite/

换了没变?→ 去「缓存与维护」点「重建缓存」,再刷新

怎么新建自己的模板#

最快的办法:复制 default 改个名。

步骤:

  1. 进服务器,找到 view/
  2. 把 default 整个文件夹复制一份
  3. 改名为 mysite
  4. 后台「前台模板」选 mysite
  5. 保存,刷新前台

主题文件夹里有什么:

文件是什么常改吗
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.html404 页很少
static/css/style.css全部样式常改
static/js/style.js脚本很少
文本
只想换个颜色、字体?
只改 static/css/style.css 就行,一个文件就能变个样。

怎么改页面文字#

场景:想把「上一篇」改成「上一条」,把页脚那句话改掉。

步骤:

  1. 找到对应模板文件(看上面的表)
  2. 用文本编辑器打开
  3. 直接改那几个字
  4. 保存文件
  5. 刷新前台

文字都在哪:

想改什么改哪个文件
导航上的字加栏目就行,不用改模板
页头搜索框旁边的字common/header.html
页脚版权、备案common/footer.html
「上一篇」「下一篇」index/article.html
「相关阅读」标题index/article.html
首页标题、栏目名index/index.html
「暂无内容」提示index/node.html
404 页文字error/404.html

例子:把「相关阅读」改成「相关内容」

  1. 打开 index/article.html
  2. 找到「相关阅读」四个字
  3. 改成「相关内容」
  4. 保存
  5. 刷新前台

改错了、页面乱了?→ 把 default 里同名文件的对应段落抄回来

怎么改站点名、Logo、备案号#

这些不在模板里,在后台设置里。

步骤:

  1. 点左侧「系统设置」→「基础设置」
  2. 改这几项
  3. 点「保存」
想改什么填哪一项
站点名站点名称
浏览器标签上的标题首页标题
Logo站点 Logo
页脚备案号ICP 备案号
页脚版权版权信息
访问统计统计代码
文本
统计代码直接粘进去就行。
不要再包一层 <script>,否则统计抓不到数据。

怎么改样式(颜色、字号、间距)#

作用:页面颜色、字体、间距不对。

步骤:

  1. 打开 static/css/style.css
  2. 找到要改的样式
  3. 改数值
  4. 保存
  5. 浏览器强制刷新(Ctrl + F5)

常用对照:

想改什么找什么
主色(按钮、链接)color、background
正文字号font-size
行距line-height
内容宽度max-width
圆角border-radius
文本
改样式后浏览器可能显示旧的。
强制刷新:Windows 按 Ctrl + F5,Mac 按 Cmd + Shift + R。

怎么只给某一个栏目换版式#

步骤:

  1. 点左侧「内容」→「栏目管理」
  2. 点这个栏目后面的「编辑」
  3. 「列表模板」填文件名,比如 grid
  4. 点「保存」
填在哪结果
列表模板用 node/ 下的文件
详情模板用 article/ 下的文件
文本
只填文件名,不带 .html。
找不到文件会自动用默认模板,不会白屏。

详细步骤看 怎么给栏目换模板。

改模板的几条规矩#

规矩为什么
改之前复制一份备份改坏了还能抄回来
只改自己主题里的文件别动 default,以后升级会覆盖
样式写进 CSS 文件别写在 HTML 标签里
改完清缓存不清可能看不到效果
字可以随便改{$...} 这种花括号别动
文本
看到 {$article.title} 这种写法:
这不是文字,是取数据的标签,别删、别改。
真要改,看 [模板标签速查](/manual/template-tags)。

模板坏了怎么救#

症状怎么办
页面空白模板文件名写错,或改坏了;对照 default 检查
页面漏出 {$...}标签被弄坏了;对照 default 抄回来
页面漏出 <?php语法错了;看报错行号
样式全丢static/css/style.css 打不开;查路径和权限
改了没生效清缓存;浏览器 Ctrl + F5

让页面说真话(排查完记得关掉):

Shell
# 打开这个地址,会显示真正的报错
http://你的域名/server_debug.php
Shell
# 重建全部缓存
php aucms cache:rebuild

救不回来?→ 把 default 里同名文件整个复制回来,再慢慢改

下一步#

没找到答案? 在后台「缓存与维护 → 系统体检」里看环境是否正常;仍无解就打开 server_debug.php 复现一次,页面会直接告诉你异常文件与行号。