EyouCMS全场景TAG标签调用实操方法及常见问题排查解决指南

一、前置准备

所有调用操作前需先完成基础配置，避免出现调用失效问题：

• 确认EyouCMS版本≥v1.5.3，低版本无完整TAG调用能力，版本过低可到官方升级包页面下载对应版本升级包覆盖安装，全新安装可直接下载官方最新稳定版
• 开启TAG功能：登录后台→功能开关→核心功能→找到【TAG标签功能】，勾选开启后点击保存并更新缓存
• 操作所有配置后必须点击后台右上角「更新缓存」，前台强制刷新（Ctrl+F5）查看效果

二、常用场景TAG调用实操

2.1 文档列表/详情页调用当前文档关联TAG

适合在文章页、列表页的标题下方或末尾展示当前文章绑定的TAG标签，可直接复制以下代码到对应模板位置：

``` {eyou:tag type='current' limit='5' titlelen='15' id='field'} {$field.tag} {/eyou:tag} ```

参数说明：limit='5'表示最多调用5个TAG，titlelen='15'表示TAG名称最多显示15个字符，超出自动截断，不需要截断可删除该参数。可自行给a标签添加CSS样式实现圆角、背景色等标签效果。

2.2 侧边栏调用全站热门TAG（按关联文档数排序）

适合在首页、列表页侧边栏展示站点热门TAG，按关联文章数量从高到低排序，代码如下：

``` {eyou:tag type='hot' orderby='count' orderway='desc' limit='10' id='field'}

{$field.tag} （{$field.count}篇）

{/eyou:tag} ```

参数说明：limit='10'表示调用前10个热门TAG，{$field.count}为该TAG关联的文档总数，不需要显示数量可直接删除span标签。如果要调用指定栏目下的热门TAG，添加参数typeid='栏目ID'即可，比如typeid='3'仅调用栏目ID为3的文档关联TAG。

2.3 TAG详情页自定义内容调用

点击TAG跳转的落地页默认模板为template/当前模板目录/tag_info.htm，可调用当前TAG基础信息和关联文档列表，代码如下：

首先调用当前TAG的基础信息：

``` {$eyou.field.tag}

该TAG下共有{$eyou.field.count}篇相关文档

```

调用当前TAG关联的文档列表+分页：

``` {eyou:list pagesize='10' titlelen='30' id='vo'}

{$vo.title} {$vo.add_time|MyDate='Y-m-d',}

{/eyou:list} ```

说明：tag_info.htm页面的list标签会自动识别当前TAG的关联文档，不需要额外添加筛选参数，pagesize='10'表示每页显示10条文档。

2.4 指定单个/多个TAG信息调用

适合在首页固定位置调用指定TAG的链接和关联数量，代码如下：

``` {eyou:tag type='指定' tags='运营干货,技术教程' id='field'} {$field.tag}（{$field.count}篇） {/eyou:tag} ```

参数说明：type='指定'为固定值，tags参数填写需要调用的TAG完整名称，多个TAG用英文逗号分隔即可。

三、进阶配置说明

3.1 TAG URL伪静态配置

默认TAG链接为动态格式，要改为伪静态可按以下步骤操作：

• 进入后台→SEO设置→URL伪静态→找到【TAG标签页】，勾选开启伪静态，规则填写tag/{$id}.html后保存
• Nginx环境需在站点配置的server块中添加以下规则，配置完成后重启Nginx：

  rewrite ^/tag/(.).html$ /index.php?m=home&c=Tags&a=index&tid=$1 last;

• Apache环境无需额外配置，官方自带的.htaccess文件已包含对应规则，未生效可手动添加：

  RewriteRule ^tag/(.).html$ index.php?m=home&c=Tags&a=index&tid=$1 [L]

3.2 发布文档自动生成TAG配置

不需要手动给每篇文档绑定TAG的话，可开启自动提取功能：进入后台→系统配置→文档设置→找到【发布文档自动提取关键字作为TAG】，勾选开启，设置最大提取数量（建议3-5个），后续发布文档时会自动从标题和内容中提取关键字作为TAG。已发布的旧文档可通过后台→批量更新→批量更新TAG工具一键生成关联TAG。

四、常见问题排查

4.1 调用TAG无内容显示

• 确认后台已开启TAG功能，且对应文档已经手动绑定或自动生成了TAG
• 确认EyouCMS版本≥v1.5.3，低版本不支持type='current'等参数
• 检查调用代码的id参数必须为id='field'，输出变量为{$field.tag}，拼写错误会导致无输出
• 配置修改后必须点击后台右上角「更新缓存」，清除浏览器缓存后再查看效果

4.2 点击TAG跳转404

• 确认后台伪静态规则和Web服务添加的规则完全一致，无多余空格或字符
• Nginx环境规则必须写在server块内，配置完成后必须重启Nginx服务
• 确认站点根目录没有名为tag的实体目录，否则会优先访问目录导致404

4.3 TAG详情页关联文档不显示

• 确认当前TAG已经绑定至少1篇已发布的公开文档，草稿、待审核文档不会被统计
• 检查list标签是否添加了typeid参数，该参数会限制仅调用指定栏目的文档，不需要可删除
• 如果关联文档属于会员权限栏目、付费栏目，需确认当前访问账号有对应查看权限

所有配置修改完成后，必须更新全站缓存并强制刷新前台页面，避免浏览器缓存导致看不到更新效果。