作为一名资深的安企CMS网站运营人员，我深知内容详情页是网站的核心组成部分，它承载着向用户展示产品、文章等关键信息的重要使命。一个设计良好、信息全面的详情页，不仅能有效传递内容价值，更是提升用户体验和SEO表现的关键。安企CMS提供了强大且灵活的模板标签，让我们能够轻松地在页面上精确控制每一项内容的展示。
理解安企CMS内容详情页的数据呈现机制
在安企CMS中，无论是文章、产品还是其他自定义模型的内容，它们的数据最终都会通过模板标签呈现在前端页面上。核心在于利用 archiveDetail 这个万能标签来获取当前页面的详细数据。这个标签设计得非常灵活，可以根据你的需求获取单个字段的值，也可以获取整个内容对象，以便进行更复杂的处理。它能够智能地识别当前访问的文档ID或URL别名，并拉取相应的内容数据。
获取核心内容信息
最基础的需求莫过于显示内容的标题、简介和主体内容。利用 archiveDetail 标签，我们可以直接通过 name 参数指定要获取的字段名称。
例如，要显示当前内容的标题，你可以使用：
<h1>{% archiveDetail with name="Title" %}</h1>
如果需要展示内容的描述或简介，可以使用 Description 字段：
<p>{% archiveDetail with name="Description" %}</p>
而内容详情的主体部分，则是通过 Content 字段获取。值得注意的是，Content 字段可能会包含HTML或其他富文本格式，为了确保这些内容能正确解析为HTML，通常需要配合 |safe 过滤器一起使用。此外，如果内容使用了Markdown编辑器，你可以通过 render=true 参数让CMS自动将其转换为HTML。
<div>
{% archiveDetail articleContent with name="Content" render=true %}
{{ articleContent|safe }}
</div>
对于内容的内部小标题，安企CMS还提供了 ContentTitles 字段，它会返回一个数组，包含文章内容中各级标题的标签、层级和文本，这对于生成文章目录或导航非常有用。你可以通过循环遍历这个数组来构建动态目录。
{% archiveDetail contentTitles with name="ContentTitles" %}
<nav class="article-toc">
<ul>
{% for item in contentTitles %}
<li class="level-{{ item.Level }}"><a href="#{{ item.Prefix }}">{{ item.Title }}</a></li>
{% endfor %}
</ul>
</nav>
展示内容的图片和媒体资源
图片是内容详情页不可或缺的一部分。安企CMS为内容图片提供了多个字段：Logo 用于获取内容的首图或主图，Thumb 用于获取缩略图，而 Images 则可以获取内容的所有关联图片（例如产品详情的组图）。
要显示主要图片或缩略图，你可以这样操作：
<img src="{% archiveDetail with name="Logo" %}" alt="{% archiveDetail with name="Title" %}">
<img src="{% archiveDetail with name="Thumb" %}" alt="{% archiveDetail with name="Title" %}">
对于多图展示，例如产品详情页的轮播图，Images 字段会返回一个图片URL数组，你需要通过 for 循环来遍历并显示它们：
<div class="product-gallery">
{% archiveDetail galleryImages with name="Images" %}
{% for imageUrl in galleryImages %}
<img src="{{ imageUrl }}" alt="{% archiveDetail with name="Title" %}">
{% endfor %}
</div>
如果需要对图片进行懒加载处理，Content 字段在调用时还支持 lazy 参数，例如 lazy="data-src"，这会使得内容中的 src 属性被替换为 data-src，方便前端脚本进行懒加载优化。
关联信息与自定义字段的灵活应用
除了核心内容和图片，详情页往往还需要展示发布时间、浏览量、所属分类、相关标签，甚至是模型特有的自定义字段。
要显示内容的发布时间或更新时间，你可以使用 CreatedTime 和 UpdatedTime 字段，并结合 stampToDate 标签进行格式化：
<span>发布时间：{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}</span>
archive.CreatedTime 这里的 archive 是通过 {% archiveDetail archive with name="Id" %} 提前定义好的变量名，或者如果页面本身就是详情页，可以直接使用内置的 archive.CreatedTime。
内容的浏览量可以通过 Views 字段获取：
<span>浏览量：{% archiveDetail with name="Views" %}</span>
要获取内容所属分类的详细信息，例如分类名称和链接，可以直接在详情页使用 categoryDetail 标签，因为它默认会获取当前内容的所属分类。
<a href="{% categoryDetail with name='Link' %}">所属分类：{% categoryDetail with name='Title' %}</a>
对于与内容关联的标签（Tags），则可以使用 tagList 标签来获取并遍历展示：
<div class="article-tags">
{% tagList tags with itemId=archive.Id limit="10" %}
{% for tagItem in tags %}
<a href="{{ tagItem.Link }}">{{ tagItem.Title }}</a>
{% endfor %}
{% endtagList %}
</div>
安企CMS最强大的功能之一是灵活的内容模型和自定义字段。如果你为文章或产品模型定义了额外的字段，例如“作者”、“产地”、“产品规格”等，你可以通过 archiveParams 标签来遍历所有自定义字段，也可以通过 archiveDetail with name="你的自定义字段名" 直接获取特定字段的值。
<div class="custom-fields">
{% archiveParams params %}
{% for paramItem in params %}
<p><span>{{ paramItem.Name }}：</span><span>{{ paramItem.Value }}</span></p>
{% endfor %}
{% endarchiveParams %}
</div>
或者，如果我定义了一个名为 ProductWeight 的自定义字段：
<p>产品重量：{% archiveDetail with name="ProductWeight" %}</p>
实战案例：构建一个标准文章详情页
综合以上标签，一个典型的文章详情页模板骨架可能如下所示，它清晰地展示了文章的标题、所属分类、发布时间、标签、阅读量和主要内容：
<article class="article-detail">
<h1 class="article-title">{% archiveDetail with name="Title" %}</h1>
<div class="article-meta">
<span class="category">所属分类：<a href="{% categoryDetail with name='Link' %}">{% categoryDetail with name='Title' %}</a></span>
<span class="pub-time">发布时间：{{ stampToDate(archive.CreatedTime, "2006年01月02日") }}</span>
<span class="views">阅读量：{% archiveDetail with name="Views" %}</span>
<div class="article-tags">
{% tagList tags with itemId=archive.Id %}
{% for tagItem in tags %}
<a href="{{ tagItem.Link }}">{{ tagItem.Title }}</a>
{% endfor %}
{% endtagList %}
</div>
</div>
{% if archive.Logo %}
<div class="article-thumbnail">
<img src="{% archiveDetail with name="Logo" %}" alt="{% archiveDetail with name="Title" %}">
</div>
{% endif %}
<div class="article-content">
{% archiveDetail articleBody with name="Content" render=true lazy="data-src" %}
{{ articleBody|safe }}
</div>
</article>
这个示例展示了如何将多个标签组合起来，共同渲染一个完整的文章详情。通过对 archiveDetail、categoryDetail 和 tagList 等标签的灵活运用，我们可以根据设计稿的需求，精确地控制页面上每一个元素的展示。安企CMS的这种设计理念，极大地提升了内容展示的灵活性和可维护性。
常见问题解答
我的自定义字段在详情页模板中没有显示，是怎么回事？
请首先检查你是否在后台为该内容模型添加了自定义字段，并且在发布内容时填写了相应的数据。其次，确认你在模板中使用的 name 参数是否与自定义字段的“调用字段”名称完全匹配（例如，如果调用字段是 product_sku，则应使用 {% archiveDetail with name="product_sku" %}）。如果仍不显示，可以尝试使用 {% archiveParams params %} 标签来遍历所有参数，检查你的自定义字段是否包含在 params 数组中，以便调试。
我想在详情页显示上一篇和下一篇文章的链接，应该用什么标签？
安企CMS为此提供了专门的标签：prevArchive 用于获取上一篇文章，nextArchive 用于获取下一篇文章。它们会根据当前文章的ID自动判断并获取相应的数据。你可以这样使用它们：
<nav class="post-navigation">
{% prevArchive prevArticle %}
{% if prevArticle %}
<a href="{{ prevArticle.Link }}">上一篇：{{ prevArticle.Title }}</a>
{% else %}
<span>没有上一篇了</span>
{% endif %}
{% endprevArchive %}
{% nextArchive nextArticle %}
{% if nextArticle %}
<a href="{{ nextArticle.Link }}">下一篇：{{ nextArticle.Title }}</a>
{% else %}
<span>没有下一篇了</span>
{% endif %}
{% endnextArchive %}
</nav>
如何确保内容中的HTML代码（如视频嵌入代码）能够正常显示而不是被转义？
当你使用 archiveDetail with name="Content" 获取内容主体时，如果内容中包含HTML标签（例如 <iframe> 视频嵌入代码），默认情况下，Django模板引擎出于安全考虑可能会对这些标签进行转义，导致它们无法正常渲染。为了解决这个问题，你需要在输出 Content 变量时，加上 |safe 过滤器，明确告诉模板这个内容是安全的，不需要进行转义。例如：
<div>
{% archiveDetail articleBody with name="Content" render=true %}
{{ articleBody|safe }}
</div>