模板标签以 {fy:xxx} 形式书写在主题的 .html 模板中,发布时编译为 Blade。所有标签分三类:
- 块标签:成对出现,内部可嵌套变量,如
{fy:nav}…{/fy:nav} - 单标签:独立输出,如
{fy:sitename} - 变量:取值语法,形如
[ns:field](多数在对应块内取值,[site:标识]为全局变量,任意位置可用)
站点信息(单标签)
| 标签 | 说明 |
|---|---|
{fy:sitename} | 站点名称 |
{fy:sitetitle} | 站点标题 |
{fy:sitekeywords} | 全站关键词 |
{fy:sitedescription} | 站点描述 |
{fy:logo} | 站点 Logo(后台站点设置上传,输出图片 URL) |
{fy:ico} | 站点图标(favicon,后台站点设置上传,输出文件 URL) |
{fy:icp} | 备案号 |
{fy:year} | 当前年份 |
{fy:themepath} | 主题静态资源路径 |
{fy:catimage} | 当前栏目大图,可选 cat="别名" 指定栏目;未设置回退主题 images/placeholder.svg |
{fy:catthumb} | 当前栏目缩略小图,参数规则同上 |
栏目大图 / 缩略小图在后台「栏目管理」编辑栏目的「栏目图片」区块维护。
站点图标用作浏览器标签页 favicon,在主题 <head> 中引用:
<link rel="icon" href="{fy:ico}">公共字段(全局变量)
后台「站点设置」页的公共字段区块可自定义全站通用字段(客服电话、微信二维码、公司地址等),模板中以 [site:标识] 调用。它不依赖任何块标签,页面任意位置可用:
<span>客服电话:[site:kefu_phone]</span>
<img src="[site:erweima]" alt="微信二维码">- 图片 / 文件类型输出媒体 URL,开关类型输出
是/否,日期类型支持[site:标识 format=Y-m-d],多选以「、」连接 - 字段未定义或未填值时输出空串,不会报错
- 输出默认 HTML 转义,
[site:标识 raw=1]原样输出
字段的添加、编辑与删除在后台「站点设置」完成,详见公共字段。
导航
{fy:nav}
<li class="[nav:current]"><a href="[nav:link]">[nav:name]</a></li>
{/fy:nav}- 数据来源:勾选“显示在导航”的栏目 + 已发布的单页内容
[nav:current]当前页时输出active,配合主题 CSS 做高亮[nav:image]/[nav:thumb]输出栏目大图 / 缩略小图(仅栏目项有,单页项为空)
{fy:nav}
<li><a href="[nav:link]"><img src="[nav:thumb]" alt="[nav:name]">[nav:name]</a></li>
{/fy:nav}推荐使用后台「结构 → 导航菜单」配置的菜单(支持自定义链接与拖动排序):
{fy:menu name="主导航"}
<li class="[menu:current]"><a href="[menu:link]" target="[menu:target]">[menu:title]</a></li>
{/fy:menu}栏目图片
栏目大图与缩略小图用于栏目页头图、导航缩略等场景,在后台栏目编辑的「栏目图片」区块维护:
<img src="{fy:catimage}" alt=""> <!-- 当前栏目大图(栏目页上下文) -->
<img src="{fy:catthumb}" alt=""> <!-- 当前栏目缩略小图 -->
<img src="{fy:catimage cat="news"}" alt="新闻中心"> <!-- 指定栏目别名,任意页面可用 -->cat缺省时取当前栏目(栏目列表页 / 内容详情页上下文)- 未设置图片时回退主题
images/placeholder.svg,保证<img>标签始终可用
内容列表
{fy:list cat="news" num="10" titlelen="30"}
<a href="[list:link]">[list:title]</a>
<img src="[list:cover]" alt="[list:title]">
<p>[list:summary]</p>
{/fy:list}常用属性:
| 属性 | 说明 |
|---|---|
cat | 栏目 slug,支持多栏目(逗号分隔)与排除(!slug) |
type | 内容类型 slug |
num | 数量 |
orderby | 排序 |
titlelen | 标题截断 |
page | 分页页码(静态化用) |
可用变量:[list:title]、[list:link]、[list:cover]、[list:summary]、[list:body]、[list:date format=Y-m-d]、[list:views]。
其中 [list:body] 输出正文,需配合 raw=1 原样输出(不转义富文本 HTML)。它是专题单页模板的关键取值方式——专题(单页类型)栏目的入口页使用「列表页模板」,在 {fy:list num="1"} 内用它输出整篇正文,详见列表与专题。
内容详情
{fy:content cat="news" slug="hello"}
<h1>[content:title]</h1>
<div>[content:body raw=1]</div>
{/fy:content}[content:body raw=1] 原样输出富文本正文。
相关内容
{fy:related num="5"}
<a href="[list:link]">[list:title]</a>
{/fy:related}仅可在 {fy:content} 块内使用,按栏目与标签聚合。
轮播图
轮播图按分组管理(后台「扩展 → 轮播图分组」),不同场景(PC 首页、移动端、内页横幅等)建不同分组,模板按分组标识调用:
{fy:banners group="home"}
<a href="[banners:link]"><img src="[banners:image]" alt="[banners:title]"></a>
{/fy:banners}group:分组标识(后台分组管理中的标识),缺省时输出全部可见轮播图- 分组不存在或组内无可见图时输出空集
- 仅输出勾选「显示」的轮播图,按排序值输出
轮播图在后台「扩展 → 轮播图」维护,新建/编辑时可选择所属分组(也可在分组下拉中就地新建分组)。
友情链接
{fy:links}
<a href="[links:url]" target="_blank" rel="noopener">[links:name]</a>
{/fy:links}留言表单
{fy:form name="contact"}name 为后台「内容 → 留言表单」中定义的表单标识;字段与必填规则按后台配置渲染。
变量输出修饰
[list:title raw=1]:原样输出不转义(如 qa 字段的 FAQ HTML)[list:date format=Y-m-d]:日期格式化[site:标识 raw=1]/[site:标识 format=Y-m-d]:公共字段同样支持(全局变量)
Blade 逃生舱
模板编译为 Blade 后渲染;需要原生 PHP/Blade 逻辑时,可在 .html 模板中直接写 Blade 指令(@php 等),编译器会原样保留。