踩过N次迅睿的坑！迅睿CMS描述标签调用技巧全拿捏

别慌！先唠唠我为啥栽在“迅睿CMS描述标签调用”这茬

前阵子帮村口王哥的五金店搭个官网搜本地关键词，心想就用我摸过N次的开源框架迅睿CMS嘛，应该是分分钟搭完喝奶茶的事儿——结果差点把奶茶杯摔键盘上。

一开始调用首页描述、分类页描述都还行，轮到产品详情页调用自定义的SEO描述标签时，好家伙！要么空白一片像王哥五金店刚开张忘摆锤子剪刀，要么全是系统默认的“欢迎来到迅睿CMS网站”，翻了翻后台自带的帮助文档（那玩意儿写得跟我爷爷写的族谱备注似的，半懂不懂），又查了百度百家号里一堆“复制粘贴就能用”的垃圾代码，折腾到半夜两点半才整明白。

真的，过来人告诉你：技术细节不是洪水猛兽，但没人带你“走后门”踩对“迅睿CMS描述标签调用”的点，那就是在五金店找绣花针——纯纯瞎摸。

先给你递个“迅睿CMS描述标签调用”的万能钥匙包

别上来就塞一堆复杂代码哈，先把这个万能钥匙包里的几把基础钥匙摸透，啥场景都能开个缝：

• 第一把：全站首页SEO描述锁的钥匙——这钥匙最基础，就像王哥五金店的大门钥匙，插进去直接开。全站首页的SEO描述，后台「系统」→「网站设置」→「SEO优化」里填的，直接调用就行，不用搞那些花里胡哨的。
• 第二把：分类/单页内容页默认描述锁的钥匙——这钥匙是分类房门钥匙，插对对应分类的钥匙孔，就能把后台「内容」→「栏目管理」里给该分类填的默认SEO描述掏出来。
• 第三把：自定义字段SEO描述锁的钥匙——这钥匙是我那天找了半天才找到的“专属抽屉钥匙”，对应你给产品、文章啥的自定义的SEO描述字段，后台得先“配钥匙”（创建自定义SEO字段），才能“开锁调用”。

哦对了，“迅睿CMS描述标签调用”的底层逻辑，其实跟王哥卖东西的逻辑差不多：你得先知道仓库里有没有货（后台有没有填SEO内容），有货的话放在哪个货架上（内容属于哪个模块、哪个栏目、有没有自定义字段），然后喊“老王帮我拿XX货架的XX货”（对应写调用标签）——喊错了货架老王肯定拿不对，喊空货架老王只能两手一摊给你看。

重点来了！这几把钥匙的“开锁咒语”必须记牢

刚才说了喊错货架不行，喊错咒语（标签语法）更不行，迅睿CMS自带的标签系统虽然灵活，但也有它的“规矩”——就像王哥五金店进货不能随便堆在消防通道一样。

先给你说最常用的几把“开锁咒语”，都是我踩了无数坑后筛选出来的“必背款”，魔性重复三遍哈：迅睿CMS描述标签调用！迅睿CMS描述标签调用！迅睿CMS描述标签调用！

（土味正能量突然插入：别嫌麻烦，重复是成功他妈，当年王哥背五金工具型号背了三个月才当上老板的！）

全站首页SEO描述的“咒语”

刚才说了，后台大门锁的“咒语”最简单，直接用：

``` {dr_site_description()} ```

就这么一行！复制粘贴到首页模板的meta description标签的content属性里就行——我那天一开始脑抽加了一堆乱七八糟的参数，结果反而出不来，后来删了所有参数就好了。

分类/单页/文章列表默认SEO描述的“咒语”

这里要分两种情况哈：

第一种是当前页面正好是栏目首页（比如五金工具分类的首页），“咒语”是：

``` {dr_cat_value('description')} ```

第二种是列表页（比如按价格排序的五金工具列表）或者该栏目没有单独填默认SEO描述，这时候得用“备用钥匙”——调用全站首页的SEO描述当备胎，“咒语”是：

``` {dr_cat_value('description') ?: dr_site_description()} ```

这里解释下那个“?:”哈，它就像王哥卖东西的“二选一规则”：如果第一个顾客（分类默认SEO描述）有钱（有内容），就卖给第一个；如果第一个没钱（没内容），就卖给第二个备胎（全站首页SEO描述）——绝不让你的网站meta description空白！

（再插土味正能量：二选一不是渣，是让你的网站一直有“门面话”，给搜索引擎留个好印象，像王哥每次开门都先擦一遍柜台一样！）

产品/文章详情页自定义SEO描述的“咒语”——这是那天救了我大命的！

首先你得先“配钥匙”，也就是创建自定义SEO描述字段：

1. 后台「内容」→「内容模块」→找到你要加字段的模块（比如产品模块、文章模块）→点击「字段管理」
2. 点击「添加字段」→字段类型选「文本框」或者「多行文本框」（推荐多行文本框，能写更多SEO关键词）
3. 字段别名随便填（比如“SEO专属抽屉”），字段名称必须要注意！必须是纯英文、不能有空格、不能是系统保留词——我那天一开始填了个“description_seo”没问题，但后来试了试填“seo-description”（有横杠）就不行，踩了个小坑！
4. 然后勾选「SEO优化」里的「SEO描述字段」？不对不对，试运营的时候发现勾选这个反而有时候会冲突，过来人告诉你：别勾！就单纯当一个普通自定义字段用，反而更稳！
5. 最后保存，再去该模块的内容发布页看一眼，是不是多了一个你刚才配的“SEO专属抽屉”？

“配完钥匙”之后，“开锁咒语”也分两种“二选一规则”的情况哈：

第一种是当前文章/产品填了自定义SEO描述，“咒语”直接掏抽屉：

``` {dr_field_value('你刚才填的纯英文字段名称')} ```

第二种是没填自定义SEO描述，就掏该栏目的默认SEO描述当备胎，如果栏目也没填，就掏全站首页的当“超级备胎”：

``` {dr_field_value('seo_miaoshu') ?: dr_cat_value('description') ?: dr_site_description()} ```

哦对了，我刚才举的例子里纯英文字段名称是“seo_miaoshu”哈，你得换成你自己配的！

（再插土味正能量：三层备胎不是花心大萝卜，是给你的网站上了三道“门面保险”，搜索引擎一定会爱上你的！就像王哥五金店备了三把大门钥匙，一把给老婆一把给儿子一把自己带，绝不让生意跑掉！）

踩过的“迅睿CMS描述标签调用”的三大“致命坑”，别再跳了！

刚才说了万能钥匙和咒语，现在必须得给你唠唠我那天踩的三大“致命坑”——跳进去轻则meta description空白，重则整站SEO乱套，王哥五金店差点搜不到“老王村口五金店”！

• 第一坑：乱加系统保留参数——刚才说了，全站首页的SEO描述直接用{dr_site_description()}就行，别加什么catid、module这些乱七八糟的参数，加了反而会变成“某个分类的备用描述”或者“空白一片”，别问我怎么知道的！
• 第二坑：自定义字段名称有横杠、空格或者是系统保留词——系统保留词有哪些？比如title、keywords、description这些都是！别偷懒直接用description当自定义字段名称，会跟系统自带的冲突！字段名称也别加横杠或者空格，纯英文小写最好，比如seo_miaoshu、seo_desc都是ok的！
• 第三坑：忘记更新缓存！——这是我那天踩的最大的坑！折腾到半夜两点半，所有代码都改对了，结果刷新网站还是空白一片，差点砸键盘的时候，突然想起后台右上角有个「更新缓存」的按钮！点了一下，再刷新网站——完美！meta description全出来了！过来人告诉你：改完模板、改完字段、改完任何东西，都必须先更新全站缓存！更新全站缓存！更新全站缓存！魔性重复三遍！

最后唠唠“迅睿CMS描述标签调用”的小技巧，让你的SEO更上一层楼

虽然是小技巧，但就像王哥五金店给老顾客送的小螺丝小螺母一样，不起眼但很有用：

• 小技巧一：可以在调用标签里加一点自己的内容——比如产品详情页的meta description，可以写成{dr_field_value('seo_miaoshu')}，老王村口五金店正品保障，假一赔十！——这样既包含了自己填的SEO关键词，又加了一点吸引用户点击的内容，一举两得！
• 小技巧二：不同模块的“专属抽屉钥匙”可以不一样——比如产品模块用seo_miaoshu，文章模块用seo_wenzhang_miaoshu，这样管理起来更方便，不会搞混！
• 小技巧三：可以用迅睿CMS的“调试模式”看标签对不对——后台「系统」→「网站设置」→「开发调试」里打开「调试模式」，然后刷新网站，就能看到每个标签调用的是什么内容了，找坑特别快！不过调试模式打开后，网站会显示一些乱七八糟的调试信息，找完坑记得马上关掉！

好了好了，唠了这么多，也差不多了——总结一下哈：“迅睿CMS描述标签调用”其实不难，只要你先摸透底层逻辑（仓库有没有货？放在哪个货架？），然后记住万能钥匙和咒语，再避开那三大致命坑，最后用上那三个小技巧，分分钟就能搞定！

（最后再插土味正能量：加油加油加油！你一定能成为迅睿CMS的大神！就像王哥一样，从一个学徒工变成了村口有名的五金店老板！）

哦对了，如果还有不懂的，可以在评论区留言哈，过来人一定会帮你解答的！不过记得先点赞收藏转发三连哦！不然下次找不到我了！（手动狗头）