安企CMS模板中，如何使用`add`过滤器构建动态的SEO友好URL路径？

在安企CMS的模板制作中，灵活且SEO友好的URL路径是提升网站搜索引擎表现的关键。虽然安企CMS在后台提供了强大的伪静态规则配置能力，通过定义如/{module}-{id}.html等模式来生成静态化URL，但在某些特定场景下，我们可能需要在模板内部更动态、更精细地控制或组合URL路径的局部，以满足独特的业务需求或营销策略。这时，add过滤器便成为了一个非常实用的辅助工具。

AnQiCMS URL路径的SEO基础

首先，了解安企CMS是如何构建SEO友好URL的非常重要。安企CMS的核心在于其强大的伪静态规则管理功能。在后台，我们可以针对文档详情页、分类列表页、单页面等设定一套统一的URL结构，例如：

• 文档详情：archive===/{module}/{id}.html 或 archive===/{module}/{filename}.html
• 分类列表：category===/{module}/{catid}/ 或 category===/{module}/{catname}/

这些规则定义了网站URL的基本骨架，搜索引擎会根据这些清晰的结构来抓取和索引页面。系统会自动将内容模型别名（{module}）、文档ID（{id}）、文件名（{filename}）、分类ID（{catid}）、分类名（{catname}）等动态数据填充到预设的URL模式中，生成静态化的访问路径。这大大简化了网站管理员的工作，同时确保了URL的结构化和易读性。

add过滤器是什么？

在安企CMS的模板语法中，add过滤器是一个非常基础但功能强大的工具，它主要用于执行数字或字符串的连接（相加）操作。就像在许多编程语言中一样，当用于数字时，它会执行数学上的加法；当用于字符串时，它会将两个字符串拼接起来。

例如：

• {{ 5|add:2 }} 将显示 7
• {{ "安企"|add:"CMS" }} 将显示 安企CMS

这个看似简单的功能，在与URL路径相关的场景中，却能发挥出意想不到的灵活性。

add过滤器在URL构建中的实用场景

虽然安企CMS的伪静态规则定义了网站大部分核心URL的结构，但add过滤器为我们提供了在模板层面“微调”或“扩展”这些URL的能力，尤其适用于以下几种情况：

1. 动态追加查询参数： 营销活动、A/B测试或用户行为追踪经常需要在URL后面追加动态的查询参数（如?utm_source=...、?ref=...）。这些参数通常不是伪静态规则的一部分，但对于数据分析至关重要。我们可以利用add过滤器将这些参数动态地拼接到文章、产品等链接的末尾。

   示例：为文章链接添加UTM追踪参数 假设我们有一个文章链接变量item.Link，其值为/article/anqi-cms-intro.html。我们想添加UTM追踪参数。

   <a href="{{ item.Link|add:'?utm_source=newsletter&utm_medium=email' }}">阅读详情</a>
   {# 生成的URL可能类似：/article/anqi-cms-intro.html?utm_source=newsletter&utm_medium=email #}
   

   如果参数值本身也是动态的：

   {% set campaign_source = "wechat" %}
   {% set article_id = item.Id %}
   <a href="{{ item.Link|add:'?source='|add:campaign_source|add:'&article_id='|add:article_id }}">查看文章</a>
   {# 如果item.Link是/article/123.html，article_id是123，campaign_source是wechat，则生成：/article/123.html?source=wechat&article_id=123 #}
   

2. 构建特定业务需求的自定义URL片段： 在某些非标准化的页面或功能模块中，可能需要根据多个数据字段来动态生成一个URL路径片段。虽然不建议将这种复杂逻辑用于网站核心内容的URL（应优先使用伪静态规则），但在一些特殊的辅助页面，如报告下载链接、特定筛选结果页面等，add过滤器能够灵活地组合不同的变量来构成路径。

   示例：构建一个组合查询的下载链接 假设我们有一个下载报告的页面，需要根据报告类型和年份动态生成路径。

   {% set report_type = "annual" %}
   {% set report_year = "2023" %}
   <a href="/downloads/reports/{{ report_type|add:'-'|add:report_year|add:'.pdf' }}">下载{{ report_year }}年{{ report_type }}报告</a>
   {# 生成的URL：/downloads/reports/annual-2023.pdf #}
   

   这里，add过滤器将字符串、变量和分隔符有效地连接起来，形成了完整的URL。

3. URL别名或SLUG的辅助拼接： 安企CMS在后台生成URL别名时，通常会基于标题自动生成拼音或英文。但在模板中，如果需要对这些别名进行进一步的拼接，例如添加一个语言前缀或者某个特定的标识符，add过滤器也能派