如何利用AnQiCMS的`archiveDetail`标签，精细化获取和展示指定文档的详细内容及自定义字段？
在AnQiCMS中管理和展示网站内容，archiveDetail标签无疑是核心利器之一。它允许我们深入到每一个具体的文档，无论是文章、产品还是其他自定义类型，从而提取并呈现其详尽信息，甚至包括那些根据业务需求量身定制的自定义字段。理解并灵活运用这个标签，能让我们的网站内容展示更加精准和丰富。
archiveDetail标签的基础与进阶使用
当我们处在一个文档的详情页面时，AnQiCMS会自动识别当前文档的ID。此时，若要获取该文档的标题或内容，通常可以直接使用诸如{{archive.Title}}或{{archive.Content}}这样的变量。然而，archiveDetail标签提供了更强大的控制力，尤其是在需要指定特定文档或获取其特定字段时。
使用archiveDetail标签的基本语法是{% archiveDetail 变量名 with name="字段名称" %}。这里的“变量名”是可选的，如果你直接在标签内部获取并输出内容，可以省略它；但若希望将获取到的值赋给一个变量以便后续复用或进行更复杂的逻辑处理，指定一个变量名会非常方便。
指定文档的两种方式：
archiveDetail标签不仅仅局限于当前页面。如果我们需要展示某个特定ID的文档内容，或者根据其URL别名（token）来获取，可以通过id或token参数来实现。例如，若想获取ID为1的文档标题，可以这样写：{% archiveDetail with name="Title" id="1" %}。
多站点环境下的数据调用：
对于部署了多个站点的AnQiCMS系统，如果需要在当前站点调用其他站点的数据，siteId参数就派上用场了。通过指定目标站点的ID，我们能够跨站点获取内容，这对于资源整合或展示关联内容非常有用。
深入挖掘文档的标准字段
AnQiCMS的每个文档都包含一系列标准字段，如标题、内容、链接、浏览量、创建时间等。archiveDetail标签可以让我们逐一精确地获取这些信息。
- 文档标题 (
Title) 和描述 (Description)： 这是最基础的展示元素。例如，{% archiveDetail with name="Title" %}可以获取当前文档的标题。 - 文档内容 (
Content)： 这是文档的核心部分。值得注意的是，如果文档内容包含HTML标签，为了确保它们能被浏览器正确解析而非作为纯文本显示，我们需要配合使用|safe过滤器，如{{archiveContent|safe}}。此外，如果你的文档使用了Markdown编辑器，Content字段还支持通过render=true参数在前端渲染为HTML，提供更灵活的展示方式。 - 图片资源 (
Logo,Thumb,Images)： 文档通常配有封面图或组图。Logo通常指封面首图，Thumb是缩略图，而Images则可能是一组图片。当获取Images时，它会返回一个图片URL的数组，这时就需要通过for循环来遍历并展示所有图片。 - 时间信息 (
CreatedTime,UpdatedTime)： 文档的创建和更新时间可以清晰地展示内容的“新鲜度”。archiveDetail标签允许你通过format参数直接对时间戳进行格式化，例如{% archiveDetail with name="CreatedTime" format="2006-01-02 15:04" %}，这样就能以我们习惯的日期时间格式显示。 - 浏览量 (
Views)： 这是一个衡量内容受欢迎程度的直观指标，可以直接获取并展示给用户。 - 文档所属分类 (
Category)： 通过archiveDetail获取到的文档对象中，包含其所属分类的详细信息。我们可以利用这些信息，或者结合categoryDetail标签，展示分类名称和链接，增强内容的导航性。
灵活运用自定义字段，打造专属内容展示
AnQiCMS的强大之处在于其“灵活的内容模型”功能，它允许我们根据业务需求自定义文档字段。这些自定义字段是实现“精细化”内容展示的关键。
在后台的内容模型设置中，我们可以为文章、产品等模型添加各种类型的自定义字段，例如“作者”、“来源”、“产品参数”、“额外图集”等。一旦这些字段被定义并填充了内容，我们就能在模板中通过archiveDetail标签来获取它们。
获取所有自定义字段：
如果想遍历一个文档所有的自定义字段及其值，archiveParams标签是理想选择。它会返回一个包含字段名称和值的数组对象，我们可以通过for循环来动态展示，这在产品参数列表等场景非常实用。
{# 假设我们有一个名为'product'的产品模型，其中定义了自定义参数 #}
{% archiveParams params %}
<div>
{% for item in params %}
<div>
<span>{{item.Name}}：</span>
<span>{{item.Value}}</span>
</div>
{% endfor %}
</div>
{% endarchiveParams %}
精准获取特定自定义字段：
更常见且灵活的做法是，直接通过自定义字段的“调用字段名”（即在后台定义时使用的英文小写字段名）来获取其内容。例如，如果你自定义了一个名为author的字段，可以直接这样调用：
<div>作者：{% archiveDetail with name="author" %}</div>
如果自定义字段是图片组（如一个名为product_gallery的字段），它同样会返回一个URL数组，需要进行循环展示：
{% archiveDetail productGallery with name="product_gallery" %}
<div class="product-images">
{% for imgUrl in productGallery %}
<img src="{{imgUrl}}" alt="产品图片" />
{% endfor %}
</div>
结合实例，构建丰富详情页
将上述功能组合起来，我们可以轻松构建出内容丰富、结构清晰的文档详情页。
一个典型文章详情页的结构可能包含：
- 文章标题：
<h1>{% archiveDetail with name="Title" %}</h1> - 发布信息：
- 分类链接与名称：
分类：<a href="{% categoryDetail with name='Link' %}">{% categoryDetail with name='Title' %}</a> - 发布时间：
发布于：{% archiveDetail with name="CreatedTime" format="2006年01月02日" %} - 浏览量：
阅读量：{% archiveDetail with name="Views" %} - 相关标签：通过
tagList标签循环展示当前文档的标签。
- 分类链接与名称：
- 文章内容：
<div>{% archiveDetail content with name="Content" %}{{content|safe}}</div>
而一个产品详情页可能需要：
- 产品主图：
<img src="{% archiveDetail with name='Logo' %}" alt="{% archiveDetail with name='Title' %}" /> - 产品名称：
<h2>{% archiveDetail with name="Title" %}</h2> - 产品参数（自定义字段）：利用
archiveParams标签循环展示所有参数，或者精准调用特定参数如{% archiveDetail with name="color" %}。 - 产品简介：
<p>{% archiveDetail with name="Description" %}</p> - 产品详细描述：
<div>{% archiveDetail productContent with name="Content" %}{{productContent|safe}}</div> - 联系方式：可结合
contact标签直接显示电话或微信等。
通过这种方式，archiveDetail标签不仅是获取文档内容的工具，更是AnQiCMS灵活定制和精细化运营策略的基石。
常见问题 (FAQ)
我能在非文档详情页面使用
archiveDetail标签吗？ 当然可以。archiveDetail标签的主要优势之一就是其灵活性。只要你知道目标文档的ID或者其URL别名（token），你就可以在网站的任何页面——无论是首页、列表页还是其他单页面——通过id或token参数来指定并获取该文档的详细内容。例如，在首页展示一个“推荐文章”的完整详情，就可以指定其ID。如何确保通过
archiveDetail获取到的HTML内容（如Content字段）安全显示，避免XSS风险？ AnQiCMS的模板引擎在默认情况下会对所有输出的变量进行HTML实体编码，以防止XSS攻击。但当你需要显示文档中的富文本内容（如Content字段），这些内容本身就包含HTML标签时，就需要使用|safe过滤器来告诉模板引擎，这部分内容是安全的，不需要进行编码，可以直接作为HTML输出。虽然这提供了灵活性，但也意味着你需要确保输入到这些字段的内容是可信的，或者在后端对用户输入进行了严格的过滤和验证，以最大程度降低潜在风险。**如果我的自定义字段是长文本，但只想