Skip to Content
模板与主题模板标签参考

模板标签以 {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 等),编译器会原样保留。