AnQiCMS是否支持在前端展示特定Tag下的文档列表？
在安企CMS中，您当然可以轻松地在前端展示特定Tag（标签）下的文档列表。这不仅是内容管理系统的一项基本功能，安企CMS更通过其灵活的模板标签体系，让您能够以非常精细和友好的方式实现这一点，从而更好地组织内容，提升用户体验和网站的SEO表现。
从安企CMS v2.1.0版本开始，系统就引入了强大的文章和产品Tag标签功能，这意味着您现在可以为您的内容（无论是文章还是产品）添加一个或多个标签，将不同分类但主题相关的文档关联起来。这些标签不仅仅是后台管理的工具，它们被设计为可以直接在前端展示和交互，成为用户发现内容的重要途径。
要实现前端展示特定Tag下的文档列表，主要会用到安企CMS内置的几个模板标签：tagList、tagDetail 和 tagDataList。它们协同工作，让您能够构建出功能完善的标签页面。
首先，tagList标签主要用于获取您网站上的所有标签列表，或者限定数量的常用标签。您可以利用它在网站的侧边栏、页脚或者专门的标签云页面，展示用户可能感兴趣的各种标签。
而当用户点击某个具体的标签，希望查看该标签下的所有文档时，tagDetail标签就能派上用场。它允许您获取到该特定标签的详细信息，比如标签的名称、描述以及其专属链接等。这些信息可以用于构建标签页面的标题和简介，告诉访问者当前页面是关于哪个主题的。
真正的核心功能，也就是获取特定Tag下的文档列表，则是由tagDataList标签来实现的。这个标签专为显示与某个标签关联的文档而设计，它的使用方式非常直观和强大。
在您制作标签列表页面时（通常是 tag/list.html 这样的模板），tagDataList 会自动检测当前页面的URL中包含的Tag ID，并以此为依据来获取相应的文档列表。当然，您也可以通过 tagId 参数明确指定要获取哪个Tag下的文档。
例如，如果您想展示某个标签下的文章列表，并且希望每页显示10篇：
{# 假设这是标签列表页，系统会自动获取当前Tag的ID。我们先获取Tag的详情信息 #}
{% tagDetail currentTag with name="Title" %}
<h1>标签：{{ currentTag }}</h1>
{% tagDetail tagDescription with name="Description" %}
{% if tagDescription %}
<p>{{ tagDescription }}</p>
{% endif %}
<p>此标签下的相关文档：</p>
{% tagDataList archives with type="page" limit="10" %}
{% for item in archives %}
<article class="document-item">
<h2><a href="{{ item.Link }}">{{ item.Title }}</a></h2>
<p>{{ item.Description }}</p>
<div class="meta-info">
<span>发布日期：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
<span>阅读量：{{ item.Views }}</span>
{# 可以在这里显示文档所属分类等信息 #}
{% categoryDetail categoryTitle with name="Title" id=item.CategoryId %}
<span>分类：{{ categoryTitle }}</span>
</div>
{% if item.Thumb %}
<div class="document-thumb">
<a href="{{ item.Link }}"><img src="{{ item.Thumb }}" alt="{{ item.Title }}"></a>
</div>
{% endif %}
</article>
{% empty %}
<p>这个标签下暂时还没有文档哦！</p>
{% endfor %}
{# 如果需要分页，可以接着使用 pagination 标签 #}
<div class="pagination-wrapper">
{% pagination pages with show="5" %}
{# 这里是分页链接的展示代码，您可以根据自己的样式需求进行调整 #}
{% if pages.FirstPage %} <a href="{{ pages.FirstPage.Link }}">首页</a> {% endif %}
{% if pages.PrevPage %} <a href="{{ pages.PrevPage.Link }}">上一页</a> {% endif %}
{% for p in pages.Pages %}
<a href="{{ p.Link }}" class="{% if p.IsCurrent %}active{% endif %}">{{ p.Name }}</a>
{% endfor %}
{% if pages.NextPage %} <a href="{{ pages.NextPage.Link }}">下一页</a> {% endif %}
{% if pages.LastPage %} <a href="{{ pages.LastPage.Link }}">末页</a> {% endif %}
{% endpagination %}
</div>
{% endtagDataList %}
在上面的代码片段中，tagDataList 会返回一个名为 archives 的文档数组，您可以使用 for 循环遍历这个数组，取出每篇文档的标题、链接、描述、发布时间、阅读量等信息，并按照您设计的前端样式进行展示。如果当前标签下没有文档，empty 块中的内容就会被显示出来。同时，type="page" 参数配合 pagination 标签，还能够实现列表的分页功能，让内容管理更加便捷，避免单页内容过长影响加载速度和用户体验。
此外，tagDataList 还支持 moduleId 参数，这意味着您可以指定只获取某个内容模型（例如“文章”模型或“产品”模型）下的标签文档列表，这对于拥有多种内容类型的网站来说，提供了极大的灵活性。
总之，安企CMS在前端展示特定Tag下的文档列表功能是完善且易于操作的。通过灵活运用其提供的模板标签，您不仅能够高效地管理和展示内容，还能极大地增强网站内容的组织结构，提升用户在您网站上的内容发现体验，并有助于改善搜索引擎对网站内容的抓取和理解。
常见问题（FAQ）
1. 如何确保Tag列表页面的URL对SEO友好？
安企CMS提供了伪静态规则管理功能，您可以为标签页面配置自定义的URL结构，例如 /tag/标签名称.html 或 /tags/标签别名/。在后台“功能管理”中的“伪静态规则”里进行设置，并确保您的模板文件（如 tag/list.html）与这些规则相匹配，从而生成清晰、易读且利于搜索引擎收录的URL。
2. 除了文档列表，我还能在Tag页面上展示哪些信息？
在Tag页面上，除了文档列表，您还可以利用tagDetail标签获取当前Tag的更多元信息，比如其SEO标题、关键词和描述。这些信息可以用于页面的<head>部分，提升页面的SEO表现。此外，您也可以通过tagList标签展示“相关热门标签”或“标签云”，引导用户发现更多相关内容。
3. 如果我的网站有多种内容模型（如文章和产品），Tag列表能区分展示吗？
是的，完全可以。tagDataList标签支持 moduleId 参数。您可以通过设置 moduleId="1" 来获取文章模型下与当前Tag关联的文档，或者设置 moduleId="2" 来获取产品模型下的文档。这意味着您可以在同一个Tag页面上，根据需求灵活地分别或合并展示来自不同内容模型的文档列表。