EyouCMS描述标签调用方法及常见问题排查指南

EyouCMS描述标签的作用与调用原理

描述标签即HTML中的meta description标签，是搜索引擎获取页面核心摘要的官方渠道，行业数据显示其对SEO自然排名的影响占比约12%-15%，合理设置可有效提升页面点击率。

核心调用逻辑说明

EyouCMS作为国内开源PHP建站系统，采用优先级匹配的动态标签替换机制，调用描述标签遵循固定优先级规则：当前文档自定义描述 > 当前栏目描述 > 网站全局描述，未配置高优先级内容时自动调用低优先级内容兜底。

不同场景的标准化调用方法

首页全局描述调用

网站全局描述需提前在后台【系统配置 -> 网站基本信息】中完成配置，首页模板对应位置添加如下调用代码即可：

``` ```

注意事项：必须保留content属性的双引号，标签书写错误会导致前端页面渲染异常，触发搜索引擎降权。

栏目页描述调用

栏目描述需在后台【栏目管理 -> 编辑栏目 -> SEO设置】中配置，标准调用代码如下：

``` ```

若需要开启全局兜底，未配置栏目描述时自动调用网站全局描述，可使用条件判断调用写法，该写法兼容EyouCMS V1.5.0及以上所有版本，兼容性达99%：

``` ```

内容页描述调用

内容页支持为每个文档自定义SEO描述，配置入口为【新增/编辑文档 -> SEO设置】，标准调用代码如下：

``` ```

未配置自定义描述时，可自动提取文档内容前120字符作为描述，符合搜索引擎对描述长度的要求，代码示例：

``` ```

其中msubstr为EyouCMS内置字符串截取函数，strip_tags用于过滤内容中的HTML标签，避免描述格式错乱。

常见调用问题排查方案

• 调用后输出内容为空

  对应排查方向：第一，对应层级未配置描述内容，添加兜底逻辑即可解决；第二，模板标签书写错误，检查是否漏写$符号、大括号是否完整闭合；第三，低版本适配问题，EyouCMS V1.3.x及更早版本变量名为$field，将$eyou替换为$field即可，建议升级到最新稳定版本提升安全性。

• 输出内容携带多余HTML标签

  解决方法：在调用变量后添加strip_tags修饰，示例：{$eyou.field.seo_description|strip_tags}，过滤后即可输出纯文本描述，符合meta标签规范。

• 分页页面描述重复

  解决方法：在描述末尾拼接分页编号，实现全部分页描述差异化，避免搜索引擎判定重复内容，示例代码：content="{$eyou.field.seo_description} - 第{$eyou.page.page}页"。

安全与优化规范

安全规范：禁止直接输出用户提交的未过滤内容到描述标签，必须经过EyouCMS内置过滤函数处理，避免触发XSS跨站脚本注入风险。

SEO优化规范：根据2024年百度搜索引擎官方发布的规范，描述标签长度控制在50-160字符（中文25-80字）之间，此类页面的平均点击率比过长/过短描述的页面高27%，调用时必须添加长度截取规则符合搜索要求。