AnQiCMS如何获取并展示某个Tag标签下的所有文档列表？

在安企CMS中管理网站内容，Tag标签无疑是一个非常灵活且实用的工具，它能帮助我们把不同分类甚至不同模型的内容按照主题进行归类，极大地丰富了内容的组织方式和用户的浏览体验。那么，当我们想要在一个专门的页面上，集中展示某个特定Tag标签下的所有文档列表时，安企CMS提供了非常直观和强大的模板标签来帮助我们实现这一目标。

理解Tag标签在安企CMS中的作用

在深入代码之前，我们先简单回顾一下Tag标签在安企CMS里的定位。它就像是一个内容的“兴趣点”或“关键词”，可以横跨文章、产品等不同的内容模型，将所有提及或关联到这个“兴趣点”的文档汇集起来。这对于内容营销、SEO优化，以及为用户提供更精准的内容导航都非常有价值。

您可以在安企CMS后台的“内容管理”菜单下找到“文档标签”功能。在这里，您可以创建、编辑和管理所有的Tag标签，包括它们的名称、自定义URL（这对于SEO非常重要），以及描述信息。当您编辑一篇文档或一个产品时，可以在“Tag标签”字段中选择或创建新的标签，将其与相应内容关联起来。

准备Tag标签列表的展示页面

要获取并展示某个Tag标签下的所有文档，通常我们需要一个专门的模板文件来承载这些内容。在安企CMS的模板设计规范中，针对Tag标签列表页，通常会使用位于/template/{您的模板目录}/tag/list.html的模板文件。当然，您也可以根据实际需求自定义其他模板，并在后台进行相应的配置。

安企CMS的模板引擎采用了类似于Django的语法，使用{{变量}}来输出数据，而{% 标签 %}则用于实现逻辑控制和数据调用。

获取Tag标签的详细信息

在展示文档列表之前，我们通常希望在页面顶部显示当前Tag标签的名称或描述，让用户明确当前页面是关于哪个Tag的。这时，可以使用tagDetail标签来获取当前Tag的详细信息。

假设我们正在tag/list.html这个模板里，安企CMS会自动识别当前页面所对应的Tag ID。我们不需要额外传入id参数，tagDetail标签会自动获取当前Tag的标题、描述等。

一个简单的例子，要在页面上显示当前Tag的名称和描述：

<h1>{% tagDetail with name="Title" %}</h1>
<p>{% tagDetail with name="Description" %}</p>

这段代码会分别输出当前Tag的标题和描述。如果Tag没有描述，这里会显示为空。

获取并展示Tag标签下的所有文档列表

核心功能来了！要获取特定Tag标签下的所有文档，安企CMS提供了tagDataList标签。这个标签专门用于检索与某个Tag关联的所有文档。

当您在tag/list.html这样的Tag页面中使用tagDataList时，它会默认获取当前页面的Tag ID所关联的文档。您也可以通过tagId参数显式地指定某个Tag的ID来获取其下的文档，但这在Tag列表页通常不需要。

以下是一个获取并展示Tag标签下文档列表的常用代码片段，包含了分页功能：

{# 假设这里是页面顶部，展示Tag名称等信息 #}
<div class="tag-header">
    <h1>标签：{% tagDetail with name="Title" %}</h1>
    <p>{% tagDetail with name="Description" %}</p>
</div>

{# 文档列表区域 #}
<div class="document-list">
    {% tagDataList archives with type="page" limit="10" %} {# type="page" 开启分页，limit="10" 每页显示10条 #}
        {% for item in archives %}
        <article class="document-item">
            <a href="{{item.Link}}">
                {% if item.Thumb %}
                <div class="document-thumb">
                    <img src="{{item.Thumb}}" alt="{{item.Title}}">
                </div>
                {% endif %}
                <h2 class="document-title">{{item.Title}}</h2>
            </a>
            <p class="document-description">{{item.Description}}</p>
            <div class="document-meta">
                <span>发布日期：{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
                <span>阅读量：{{item.Views}}</span>
                {% if item.CategoryId %}
                <span>分类：<a href="{% categoryDetail with name='Link' id=item.CategoryId %}">{% categoryDetail with name='Title' id=item.CategoryId %}</a></span>
                {% endif %}
            </div>
        </article>
        {% empty %}
        <p>当前标签下没有任何文档。</p>
        {% endfor %}
    {% endtagDataList %}
</div>

{# 分页导航区域 #}
<div class="pagination-nav">
    {% pagination pages with show="5" %} {# show="5" 表示最多显示5个页码按钮 #}
        <ul>
            <li {% if pages.FirstPage.IsCurrent %}class="active"{% endif %}><a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a></li>
            {% if pages.PrevPage %}
            <li><a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a></li>
            {% endif %}
            {% for pageItem in pages.Pages %}
            <li {% if pageItem.IsCurrent %}class="active"{% endif %}><a href="{{pageItem.Link}}">{{pageItem.Name}}</a></li>
            {% endfor %}
            {% if pages.NextPage %}
            <li><a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a></li>
            {% endif %}
            <li {% if pages.LastPage.IsCurrent %}class="active"{% endif %}><a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a></li>
        </ul>
    {% endpagination %}
</div>

代码解析：

  1. {% tagDataList archives with type="page" limit="10" %}:
    • archives 是我们定义的一个变量名，用于存储从标签下获取到的文档列表数据。
    • type="page" 是关键参数，它告诉系统我们需要一个分页的文档列表。如果只想要固定数量的列表而不分页，可以使用type="list"。
    • limit="10" 设置了每页显示10条文档。
  2. {% for item in archives %}: 遍历archives变量中的每一篇文档，item代表当前的文档对象。
  3. {{item.Link}}，{{item.Title}}，{{item.Description}}，{{item.Thumb}}: 这些是文档对象的常用字段，分别对应文档的链接、标题、简介、缩略图等。您可以根据需要在文档对象中调用更多字段，例如item.Views（阅读量），item.CreatedTime（创建时间），等等。
  4. {{stampToDate(item.CreatedTime, "2006-01-02")}}: stampToDate是安企CMS内置的格式化时间戳的标签，可以将文档的创建时间戳转换为易读的日期格式。"2006-01-02"是Go语言特有的时间格式化模板。
  5. {% empty %}: 这是一个非常有用的块，当archives列表为空时（即当前标签下没有文档），{% empty %}内的内容会被显示出来，避免页面空白。
  6. {% pagination pages with show="5" %}:
    • pages是用于接收分页信息的变量。
    • show="5"表示在分页导航中最多显示5个页码按钮，例如 1 2 3 4 5。
    • pages.FirstPage.Link、pages.PrevPage.Link、pages.Pages（中间页码列表）、pages.NextPage.Link、pages.LastPage.Link等字段，可以帮助您构建完整的分页导航链接。

通过上述步骤和代码，您就可以在安企CMS中高效地获取并展示任何Tag标签下的所有文档列表了，无论是为了提升用户体验还是优化网站结构，这都是一项非常实用的技能。

常见问题 (FAQ)

1. 如何在网站其他非Tag列表页面，引用并展示特定Tag标签下的文档？

如果您不在Tag标签列表页（如`tag/list.