在安企CMS中，网站链接的构建方式对于SEO和用户体验都至关重要。虽然系统提供了多种预设的伪静态规则和自动生成的链接，但在某些特定场景下，我们可能需要更精细地控制URL结构，比如在自定义URL模式下，将内容模型（{module}）和内容ID（{id}）变量拼接起来形成独特的链接。

这并非难事，安企CMS强大的模板引擎结合其灵活的过滤器机制，能让我们轻松实现这一目标。今天，我们就来探讨如何在自定义URL模式下，利用add过滤器拼接{module}和{id}变量来构建链接。

理解安企CMS的URL机制与自定义需求

安企CMS非常注重SEO友好性，内置了伪静态功能，允许您将动态链接（如/?article_id=123）转换为更具可读性和搜索引擎友好性的静态化链接（如/article/123.html）。在“功能管理”下的“伪静态规则”中，您可以选择数字模式、模型命名模式等多种预设规则，甚至进入“自定义模式”来完全掌控链接结构。

在自定义模式下，安企CMS提供了像{module}（通常是内容模型的URL别名或表名）、{id}（内容的唯一ID）、{filename}（自定义链接名）等丰富的变量供我们组合。例如，一条伪静态规则可能是archive===/{module}/{id}.html，这意味着一篇文档的链接将由其模型别名和ID组成，如/news/123.html。

然而，仅仅设置了伪静态规则，并不意味着模板中就能直接显示出符合这种新规则的链接。默认情况下，当我们使用{{item.Link}}来输出文章列表中的链接时，安企CMS会根据当前生效的伪静态规则自动生成。但如果我们需要在特定位置，或以更复杂的逻辑来构建这些链接，例如在不使用{{item.Link}}的情况下手动构建，或者需要将{module}和{id}与其他固定文本或变量拼接，那就需要手动操作了。

核心工具：add过滤器

在安企CMS的Django模板引擎中，add过滤器是一个非常实用的工具，它主要用于数字或字符串的相加与拼接。

它的使用方法很简单，通常是{{ 变量 | add: 值 }}。这里的“值”可以是另一个变量、数字或字符串字面量。

举个例子：

  • 如果我们要将数字相加：{{ 5 | add: 2 }} 会显示 7。
  • 如果我们要将字符串拼接：{{ "安企" | add: "CMS" }} 会显示 安企CMS。
  • 它甚至可以混合类型，在自动转换失败时会忽略相应部分：{{ 5 | add: "CMS" }} 会显示 5CMS。

正是这种字符串拼接的能力，让add过滤器成为我们构建自定义URL的利器。

构建自定义链接：拼接{module}和{id}

现在，我们有了理论基础，可以开始实际操作了。假设我们的伪静态规则是archive===/detail/{module}-{id}.html，我们希望在模板中手动构建这样的链接。

首先，我们需要获取{module}和{id}这两个变量的值。

  • {id}：通常可以直接从当前循环的文档对象中获取，例如{{item.Id}}。
  • {module}：内容模型的URL别名，可以这样获取：先通过item.ModuleId获取到当前文档所属的模型ID，然后使用moduleDetail标签获取该模型的详情，从中提取UrlAlias字段。

让我们看一个在文档列表（archiveList）中构建自定义链接的示例：

{% comment %}
假设后台伪静态规则设置为：archive===/detail/{module}-{id}.html
例如：/detail/article-123.html
{% endcomment %}

{% archiveList archives with type="page" limit="10" %}
    {% for item in archives %}
        {% comment %} 获取当前文档所属模型的URL别名 {% endcomment %}
        {% moduleDetail currentModule with id=item.ModuleId %}
        {% set moduleAlias = currentModule.UrlAlias %}

        {% comment %} 使用add过滤器拼接字符串和变量来构建链接 {% endcomment %}
        {% set customLink = '/detail/'|add:moduleAlias|add:'-'|add:item.Id|add:'.html' %}

        <li>
            <a href="{{ customLink }}">
                <h5>{{item.Title}}</h5>
                <p>自定义链接: {{ customLink }}</p>
                <p>系统自动生成链接: {{ item.Link }}</p>
            </a>
        </li>
    {% empty %}
        <li>暂无内容。</li>
    {% endfor %}

    {% comment %} 分页代码（略，与链接构建无关） {% endcomment %}
    {% pagination pages with show="5" %}
    {# ... 分页链接通常也会自动生成，但也可使用类似方法定制 #}
    {% endpagination %}
{% endarchiveList %}

在上面的例子中，我们：

  1. 通过{% moduleDetail currentModule with id=item.ModuleId %}获取到当前文档（item）所属内容模型的详情，并将其赋值给currentModule变量。
  2. 从currentModule中提取出UrlAlias，它代表了{module}的值，并赋值给moduleAlias。
  3. 然后，我们利用set标签结合add过滤器，将固定字符串'/detail/'、moduleAlias、固定连接符'-'、文档ID item.Id 和固定后缀.html 一步步拼接起来，最终形成完整的自定义链接customLink。

这样，您就可以在模板中灵活地构建出符合您自定义伪静态规则的链接了。

实际应用中的考量

在自定义URL时，有几个重要的点需要注意：

  • 与后台伪静态规则保持一致： 最关键的一点是，您在模板中手动拼接的URL结构，必须与安企CMS后台“功能管理”->“伪静态规则”中设置的“自定义模式”规则完全一致。如果模板中生成的是/detail/news-123.html，但后台规则是/article/{id}.html，那么生成的链接将无法访问。确保两者同步是成功的关键。
  • 链接的可读性与SEO： 自定义URL的初衷之一就是为了SEO和用户友好。请确保您的{module}和{id}或其他变量组合后的链接具有语义化、简洁且易于记忆的特点。
  • 变量的可用性： 在拼接链接时，请确保所有用到的变量（如item.Id, currentModule.UrlAlias）在当前模板上下文中是可用的。如果某个变量不存在，拼接可能会出错或生成不完整的链接。
  • 编码问题： 如果您的URL中可能包含中文或其他特殊字符（尽管{module}和{id}通常是英文或数字），可以考虑使用urlencode过滤器对URL中的部分参数进行编码，以避免潜在的链接解析问题。不过对于{module}和{id}这种系统变量，通常不需要手动编码。

总结

安企CMS的灵活性体现在