前台模板存放在 {TPLPATH}pc/{SITE_TEMPLATE}/home/， 静态资源在 static/{SITE_THEME}/（{dr_lang('模板中通过')} {code}{HOME_THEME_PATH}{/code} {dr_lang('引用')}）。 当前站点模板目录为 {SITE_TEMPLATE}，主题风格为 {SITE_THEME}，可在 网站设置 中修改。
| {dr_lang('文件')} | {dr_lang('触发场景')} | {dr_lang('说明')} |
|---|---|---|
| index.html | {dr_lang('网站首页')} | {dr_lang('全站首页，可调用各模块数据块')} |
| list.html | {dr_lang('列表栏目')} | {dr_lang('栏目内容分页列表，输出')} {code}{$pages}{/code} {dr_lang('分页')} |
| show.html | {dr_lang('内容详情')} | {dr_lang('标题、正文、上下篇、关联内容等')} |
| category.html | {dr_lang('封面栏目')} | {dr_lang('展示子栏目及每个子栏目的部分内容')} |
| page.html | {dr_lang('单页栏目')} | {dr_lang('输出栏目名称与正文')} {code}{$content}{/code} |
| search.html | {dr_lang('模块搜索')} | {dr_lang('搜索表单与结果列表')} |
| header.html / footer.html | {dr_lang('公共引入')} | {dr_lang('通过')} {code}{template "header.html"}{/code} {dr_lang('复用')} |
在 模块管理 中可为单个模块绑定独立风格目录；栏目编辑页也可单独指定 list/show/page 等模板文件名。
优先级：内容自定义模板 > 栏目模板设置 > 模块风格 > 站点默认风格。
迅睿模板语法由花括号标签与 PHP 混合组成，循环体内当前行数据通常用 $t 表示。
{code}{template "header.html"}
{template "footer.html"}{/code}
{dr_lang('引入同目录下的页头、页脚；也可引入子路径模板，如')} {code}{template "index_data.html"}{/code}。
| {dr_lang('变量')} | {dr_lang('说明')} |
|---|---|
| {code}{$meta_title}{/code} | {dr_lang('页面标题')} |
| {code}{$meta_keywords}{/code} | {dr_lang('页面关键词')} |
| {code}{$meta_description}{/code} | {dr_lang('页面描述')} |
| {code}{$indexc}{/code} | {dr_lang('首页标记（仅首页为 1）')} |
| {code}{$catid}{/code} | {dr_lang('当前栏目 ID')} |
| {code}{$cat.name}{/code} / {code}{$cat.url}{/code} | {dr_lang('当前栏目名称与链接')} |
| {code}{$title}{/code} / {code}{$content}{/code} | {dr_lang('详情页标题与正文')} |
| {code}{$updatetime}{/code} | {dr_lang('更新时间（已格式化）')} |
| {code}{$pages}{/code} | {dr_lang('列表分页 HTML')} |
| {code}{MOD_DIR}{/code} | {dr_lang('当前模块目录名')} |
| {code}{SITE_LOGO}{/code} | {dr_lang('站点 LOGO 地址')} |
| {code}{HOME_THEME_PATH}{/code} | {dr_lang('当前风格静态资源路径')} |
{code}{if $indexc} class="is-active"{/if}
{if $catid && dr_in_array($catid, $t.catids)} class="is-active"{/if}
{/code}
在 网站信息 中维护的字段，模板中读取：
{code}{php $mysite=dr_site_value('hdtp');}
{loop $mysite $v}
{dr_get_file($v[1])}
{/loop}{/code}
安装时默认包含 hdtp（幻灯片）、yqlj（友情链接）等字段。
{dr_lang('以下为建站系统最常用的前台标签；不熟悉语法时，可优先使用下方标签生成工具，再粘贴到模板中调试。完整文档见')} {dr_lang('官方模板手册')}。
{dr_lang('制作模板时不必手写全部标签，以下两个工具可可视化生成调用代码，复制到模板即可使用。')}
| {dr_lang('工具')} | {dr_lang('说明')} | {dr_lang('入口')} |
|---|---|---|
| Mbdy {dr_lang('字段标签调用工具')} |
{dr_lang('官方应用市场免费插件。支持字段调用、页面标签、循环标签、搜索条件等，可按模块/栏目/字段点选生成代码，适合后台开发时使用。')}
|
{if dr_is_app('mbdy')} {dr_lang('打开 Mbdy')} {else} {dr_lang('需先安装插件')} {/if} |
| {dr_lang('在线标签生成器')} | {dr_lang('迅睿官方在线工具，无需安装插件。可生成常用标签、导航循环、module/category 内容循环、自定义字段调用等代码，适合快速查阅与复制。')} | {dr_lang('打开在线工具')} |
{dr_lang('提示：在线工具部分「自定义字段调用」功能需后台安装《字段标签生成工具》插件后配合使用，详见')} xunruicms.com/doc/code。
{code}{module module=news num=6 order=updatetime}
{$t.url} {$t.title}
{/module}
{module catid=$catid order=updatetime page=1}
{$t.url} {$t.title}
{/module}
{$pages}{/code}
{code}{category module=share pid=0}
{$t.url} {$t.title}
{/category}
{category module=share pid=$t.id return=t2}
{$t.url} {$t.title}
{/category}{/code}
{code}{related module=MOD_DIR tag=$tag num=6}
{$t.url} {$t.title}
{/related}{/code}
{dr_lang('按 Tag 或关键词关联推荐，常用于详情页底部「相关内容」。')}
| {dr_lang('函数')} | {dr_lang('说明')} |
|---|---|
| dr_catpos($catid, ...) | {dr_lang('面包屑导航')} |
| dr_module_url($dir) | {dr_lang('模块首页地址')} |
| dr_thumb($thumb) | {dr_lang('缩略图地址')} |
| dr_get_file($id) | {dr_lang('附件/图片完整 URL')} |
| dr_show_hits($id) | {dr_lang('详情页浏览量（自动计数）')} |
| dr_strcut($str, $len) | {dr_lang('字符串截断')} |
| dr_site_value('字段名') | {dr_lang('读取网站信息自定义字段')} |
| dr_get_content_kws($keywords) | {dr_lang('关键词转 Tag 链接数组')} |
<link href="{HOME_THEME_PATH}pc/css/style.bundle.css" rel="stylesheet" />
<script src="{HOME_THEME_PATH}swiper/js/swiper.min.js"></script>
<link href="{THEME_PATH}assets/icon/css/icon.css" rel="stylesheet" />
{code}{HOME_THEME_PATH}{/code} {dr_lang('指当前风格目录下的 static 资源；')}{code}{THEME_PATH}{/code} {dr_lang('指系统后台公共资源。')}
{dr_lang('推荐复制当前')} {SITE_TEMPLATE} {dr_lang('模板再修改，可最大程度保证页面类型完整、标签调用正确。')}
将 template/pc/{SITE_TEMPLATE}/ 复制为新目录（如 mytpl）； 手机端同步复制 template/mobile/{SITE_TEMPLATE}/ → template/mobile/mytpl/。
将 static/{SITE_THEME}/ 复制为 static/mytpl/， 修改模板中的样式、图片路径均相对于 {code}{HOME_THEME_PATH}{/code}。
至少保留 index.html、list.html、 show.html、header.html、footer.html； 按需调整 HTML 结构与 {code}{module}{/code}、{code}{category}{/code} {dr_lang('标签调用')}。
进入 网站设置， 将「模板目录」改为 mytpl，「主题风格」改为 mytpl 并保存； 手机设置 中同步选择对应风格。
依次访问首页、栏目列表、内容详情、搜索页，确认布局与数据正常； 修改模板后刷新浏览器即可，无需更新系统缓存（URL/栏目结构变更除外）。
某模块需独立风格时，在 模块管理 设置模块主题风格； 某栏目需特殊列表/详情页时，在栏目编辑的「模板设置」中指定模板文件名。