迅睿CMS图文混排标签调用全流程实操指南 代码可直接复制落地

前期准备说明

适用版本：迅睿CMS V4.6.x及以上所有官方正式版本，无需安装额外插件，所有标签均为系统内置。

操作路径：登录后台→【界面】→【模板管理】→选择对应站点的目标模板文件（.html后缀），直接在文件内插入对应标签即可。

单篇内容正文图文混排调用（详情页场景）

适用场景

文章、产品、案例等详情页的正文内容输出，正文为后台编辑器录入的图文混排内容，直接调用系统内置content字段即可。

可直接复制代码

``` ```

排版问题修复方案

如果出现图片溢出、文字排版错乱的问题，在模板头部的 ```

如果需要过滤正文内用户录入的冗余style、script标签，避免样式污染，将{$content}替换为{$dr_htmlclear($content)}即可。

自定义图文组字段调用（固定排版场景）

适用场景

首页轮播、服务展示、团队介绍、案例卡片等需要固定排版的多组图文组合，需要先在后台创建【图文组】类型的自定义字段。

第一步：后台字段配置确认

登录后台→【系统】→【字段管理】→选择对应模块/栏目的字段列表，创建字段：字段类型选「图文组」，字段名设置为custom_tuwen（可自定义，后续调用要对应），勾选「前端输出」权限，保存后给对应内容录入图文数据即可。

可直接复制调用代码

```

{if $custom_tuwen} {loop $custom_tuwen $item}
• 

  {$item.title}

  {$item.description}

  查看详情
{/loop} {/if}

```

参数调整说明

1. 图片裁切：如需固定尺寸不拉伸，将图片src替换为{dr_thumb($item.attachment, 320, 240, 1)}，其中320为宽度、240为高度，最后一位1为强制裁切，0为等比缩放。

2. 空值判断：外层的{if $custom_tuwen}判断可以避免字段为空时输出空的ul标签，不需要可删除。

跨栏目图文列表混排调用（聚合场景）

适用场景

首页推荐内容、相关内容推荐、全站内容聚合等场景，调用不同栏目的内容缩略图+标题+简介组合展示。

可直接复制调用代码

```

{module module=news catid=1,2,3 num=10 order=updatetime desc}
• 

  {$t.title}

  {dr_date($t.updatetime, 'Y-m-d')}

  {dr_strcut($t.description, 40)}

{/module}

```

参数修改说明

module=news：替换为对应模块的标识，文章模块为news、产品模块为product，自定义模块的标识可在后台【模块管理】列表查看。

catid=1,2,3：替换为要调用的栏目ID，多个用英文逗号分隔，留空则调用该模块下所有栏目的内容。

num=10：调用内容的条数，可根据需求调整。

order=updatetime desc：排序规则，按更新时间倒序，可替换为inputtime desc（发布时间倒序）、hits desc（点击量倒序）。

如果需要带分页的列表，将{module}标签替换为{page}标签，末尾加上{$pages}即可输出分页代码：

``` {page module=news catid=1 num=10 order=updatetime desc} {/page} {$pages} ```

常见卡壳问题排查

1. 标签调用后无内容输出

依次排查：① 对应栏目/内容是否有已发布的真实数据；② 调用的字段是否开启了「前端输出」权限；③ 标签内的模块标识、字段名是否和后台配置完全一致（大小写敏感）；④ 进入后台→【系统】→【清除缓存】，选择清除模板缓存后再刷新前端。

2. 图片无法正常显示

进入后台→【系统】→【系统配置】→【附件设置】，检查附件域名配置：本地测试环境可留空，线上环境必须填写完整的域名（带http/https前缀，末尾不要加斜杠）。

3. 移动端排版错乱

确认模板头部已经加入移动端适配的meta标签：，再配合前面的图片max-width样式即可解决。

通用注意事项

所有标签代码必须放在迅睿CMS的模板文件（.html后缀）内，不能放在静态HTML文件或者后台自定义富文本内容中，否则标签不会被解析；修改模板后必须清除模板缓存，否则会出现修改不生效的问题。