安企CMS的文档详情页如何自定义展示布局和内容？

在安企CMS中，文档详情页的自定义展示布局和内容是实现网站个性化和满足特定业务需求的关键。作为网站内容的最终呈现形式，详情页不仅承载着核心信息，更直接影响用户体验和搜索引擎优化效果。安企CMS提供了高度灵活的模板机制和丰富的数据标签，让用户可以根据自身创意，轻松打造独一无二的文档详情页。

理解安企CMS文档详情页的基础构成

安企CMS的模板系统采用类似Django模板引擎的语法，文件以.html为后缀，统一存放在/template目录下。对于文档详情页，系统默认会查找{模型table}/detail.html文件来渲染内容。其中{模型table}代表了该文档所属内容模型的表名，例如文章模型可能是article，产品模型可能是product。

这种默认机制提供了基础的通用性，但安企CMS的强大之处在于其支持更精细化的定制：

  • 文档ID级别定制： 如果您希望某个特定文档拥有完全不同的布局，可以创建一个名为{模型table}/detail-{文档ID}.html的模板文件。例如，一篇ID为100的文章，其详情页模板可以是article/detail-100.html。系统会优先使用这种更具体的模板。
  • 内容模型定制： 您可以在后台管理界面为某个内容模型（如文章、产品）设置自定义字段。这些字段会直接影响详情页可展示的数据类型。
  • 模板语言： 您将主要使用双花括号{{变量}}来输出数据，以及单花括号和百分号{% 标签 %}来控制逻辑流程（如条件判断、循环）。

核心数据调用：如何展示文档内容

文档详情页的核心在于展示文档本身的数据。安企CMS提供了archiveDetail标签，它是获取单个文档详情数据的万能钥匙。

  • 基本信息展示： 通过archiveDetail标签，您可以轻松获取文档的标题、描述、发布时间、浏览量等。例如，要显示文档标题，可以使用{% archiveDetail with name="Title" %}。对于时间信息，结合stampToDate过滤器（如{{stampToDate(archive.CreatedTime, "2006-01-02")}}）可以格式化成易读的日期。
  • 文档内容呈现： 文档正文是详情页的重中之重。使用{% archiveDetail archiveContent with name="Content" %}可以获取文档内容。值得注意的是，如果文档内容是富文本编辑器生成的HTML，需要添加|safe过滤器，即{{archiveContent|safe}}，以避免HTML代码被转义而直接显示。如果启用了Markdown编辑器，您还可以通过render=true参数让系统自动将Markdown格式转换为HTML，例如{% archiveDetail archiveContent with name="Content" render=true %}。
  • 图片与媒体：
    • 封面图和缩略图： Logo和Thumb字段分别对应文档的封面大图和缩略图，调用方式类似{% archiveDetail with name="Logo" %}。
    • 组图展示： 如果文档包含多张图片（如产品图集），Images字段会返回一个图片URL数组。您需要结合for循环标签来遍历并展示这些图片，例如： 
      
{% archiveDetail archiveImages with name="Images" %}
<ul>
{% for img in archiveImages %}
    <li><img src="{{img}}" alt="文档图片"></li>
{% endfor %}
</ul>
    • 图片懒加载： 为了优化页面加载速度，文档内容中的图片可以通过在archiveDetail标签中添加lazy="data-src"参数，让系统自动将图片src属性替换为data-src，配合前端懒加载库实现图片按需加载。

深度定制：利用内容模型自定义字段

安企CMS的内容模型功能是其高度灵活性的重要体现。您可以为不同的内容模型（如文章、产品）定义独有的字段，从而存储更丰富、更具针对性的数据。

  • 定义自定义字段： 在后台“内容管理”的“内容模型”中，您可以为文章模型或产品模型添加自定义字段，例如“作者”、“产品参数”、“下载链接”等。这些字段可以是单行文本、数字、多行文本、单选、多选或下拉选择。
  • 显示所有自定义字段： 如果您希望将文档所有自定义字段以列表形式展示，可以使用archiveParams标签： 
    
{% archiveParams params %}
<div>
    {% for item in params %}
    <div>
        <span>{{item.Name}}：</span>
        <span>{{item.Value}}</span>
    </div>
    {% endfor %}
</div>
{% endarchiveParams %}
  • 直接调用特定自定义字段： 知道自定义字段的名称（例如，后台定义的调用字段为author），您可以像调用内置字段一样直接获取它的值：{% archiveDetail with name="author" %}。这对于需要将特定自定义字段放置在固定位置的情况非常有用。

丰富展示：关联信息与动态逻辑

一个优秀的详情页不仅仅是展示主内容，还会提供丰富的关联信息和动态交互。

  • 关联分类信息： 使用categoryDetail标签可以获取当前文档所属分类的名称、链接、描述等。例如，显示分类名称和链接： 
    
<a href="{% categoryDetail with name='Link' %}">{% categoryDetail with name='Title' %}</a>
  • 相关标签展示： 通过tagList标签，可以列出与当前文档关联的所有标签，并为每个标签生成链接，方便用户探索更多相关内容： 
    
{% tagList tags %}
{% for item in tags %}
    <a href="{{item.Link}}">{{item.Title}}</a>
{% endfor %}
{% endtagList %}
  • 导航与推荐： prevArchive和nextArchive标签可以方便地在文档底部添加上一篇和下一篇文档的链接，引导用户继续浏览。archiveList标签结合type="related"参数，可以展示与当前文档内容相关的其他文档，进一步丰富推荐内容。
  • 动态逻辑控制：
    • 条件判断： {% if 条件 %}标签用于根据特定条件显示或隐藏内容，例如判断某个字段是否有值再显示对应模块。
    • 循环遍历： {% for item in 列表 %}标签在处理多图片、多标签等列表数据时不可或缺。
    • 变量赋值： {% set 变量 = 值 %}或{% with 变量 = 值 %}可以创建临时变量，使模板代码更整洁、易读。
  • 高级SEO元素： 为了提升搜索引擎友好度，您应在详情页的<head>区域使用tdk标签来设置页面的标题(Title)、关键词(Keywords)和描述(Description)。同时，如果有规范链接需求，tdk标签也能提供CanonicalUrl，确保搜索引擎正确识别页面权威性。

优化用户体验：图片处理与交互

除了内容的准确呈现，文档详情页的用户体验也至关重要。

  • 后台内容设置： 在安企CMS的后台“系统设置”下的“内容设置”中，您可以配置图片处理策略