迅睿CMS单页标签调用全场景实操指南 新手看完可直接复制落地

一、前置准备（操作前必看）

1.1 环境要求

必须使用迅睿CMS V4.5及以上版本，后台已创建至少1个单页栏目，且单页栏目已填写标题、内容、自定义字段（如有）。

1.2 文件路径说明

单页模板默认存放路径为/template/当前模板目录/pagelist/，单页专属模板命名规则为「单页栏目ID.html」，比如ID为3的单页模板命名为3.html。

二、基础通用标签调用（可直接复制）

2.1 单页模板内直接调用

以下标签仅可在单页专属模板内直接使用，无需额外传参，所有属性可按需取用：

``` {$page.title} {$page.keywords} {$page.description} {$page.content} {dr_date($page.inputtime, 'Y-m-d')} {$page.hits} {dr_url('page/show', ['id'=>$page.id])} ```

注意：如果模板开启了静态缓存，修改标签后需要到后台更新全站缓存才会生效。

2.2 跨模板调用指定单页内容

如果需要在首页、列表页、文章内容页等非单页模板中调用指定单页的内容，先通过函数获取单页数据再调用，示例为调用ID为3的单页：

``` {php $page = dr_get_page(3);} {$page.title} {$page.content} ```

关键说明：dr_get_page()的参数为单页对应的栏目ID，可在后台「栏目管理」列表中直接查看对应单页的ID编号。

三、进阶场景标签调用

3.1 调用单页自定义字段

如果后台给单页栏目创建了自定义字段，比如字段名为banner_img（单页顶部横幅图）、contact_tel（联系电话），调用语法如下：

单页模板内直接调用：

``` {$page.banner_img} {$page.contact_tel} ```

跨模板调用自定义字段：

``` {php $page = dr_get_page(3);} {$page.banner_img} {$page.contact_tel} ```

注意：自定义字段名必须和后台创建的字段别名完全一致，严格区分大小写，拼写错误会导致输出空白。

3.2 调用全部单页栏目列表

如果需要制作单页聚合导航，比如关于我们板块下的公司简介、发展历程、企业文化等多个单页的导航列表，使用以下标签：

```

{loop dr_category(1, 'pid=2') $t}
• {$t.name}
{/loop}

```

参数说明：dr_category第一个参数1代表调用栏目类型为单页，pid参数为筛选的父级栏目ID，不需要筛选父级可直接删除pid参数。

3.3 调用单页内容部分截取

如果需要在导航列表、首页推荐位展示单页内容摘要，不需要输出全部正文，可使用以下语法截取指定字数：

``` {dr_strcut(dr_clearhtml($page.content), 100, '...')} ```

参数说明：100为截取的字符数，后面的'...'为超出部分的后缀，可根据需求自定义修改。

四、常见问题排查

4.1 标签调用后输出空白

• 检查对应单页后台是否填写了对应的内容，内容为空时输出空白为正常情况
• 跨模板调用时是否先执行了{php $page = dr_get_page(单页ID);}代码，漏写会导致变量不存在
• 检查自定义字段名是否和后台一致，是否存在拼写错误、大小写错误
• 检查模板是否生成了缓存，到后台「系统」-「更新缓存」选择更新全站缓存后再刷新页面

4.2 调用单页内容带有多余HTML标签

如果不需要正文的HTML格式，调用时用dr_clearhtml()函数包裹内容变量即可，示例：

``` {$page.content|dr_clearhtml} ```

4.3 调用的单页URL打不开

首先检查后台「URL规则」中单页的规则是否配置正确，默认规则为page/{id}.html，如果配置无误仍打不开，到后台「更新URL缓存」后重试即可。

五、完整可复用模板示例

以下为完整的单页模板代码，可直接复制修改后使用：

``` ```

使用说明：替换代码中的自定义字段名、父栏目ID为自己的实际配置，上传到对应单页的模板路径后，更新全站缓存即可生效。