安企CMS如何实现内容详情页的完整信息（包括自定义字段）显示？
在网站运营中，内容详情页是访客了解产品或服务的核心入口，其信息展示的完整性和用户体验至关重要。安企CMS（AnQiCMS）在设计时充分考虑了内容展示的灵活性和定制性，即使是您定义的各种自定义字段，也能在内容详情页中优雅地呈现。
接下来，我们将一起探索如何在安企CMS中，从内容模型的建立到模板的调用，完整地展现内容详情页的所有信息，包括那些独具匠心的自定义字段。
构建内容骨架：理解内容模型与自定义字段
在安企CMS中，所有内容的展示都始于“内容模型”。您可以将其理解为不同类型内容的“蓝图”或“结构定义”。系统内置了“文章”和“产品”等模型，但安企CMS的强大之处在于，您可以根据业务需求，创建无限个自定义内容模型。
要实现内容详情页的完整信息显示，首先需要确保您的内容模型包含了所有您想要展示的字段。在后台的“内容管理”中找到“内容模型”选项，您可以编辑现有模型或创建新模型。在这里，您可以自由添加各种类型的自定义字段，例如：
- 单行文本：适用于短标题、作者名等。
- 数字：适用于价格、库存、阅读量等。
- 多行文本：适用于简介、副标题等，支持富文本编辑。
- 单项选择：如“地区”、“产品颜色”等，从预设选项中选择一个。
- 多项选择：如“产品特性”、“服务范围”等，可选择多个预设选项。
- 下拉选择：与单项选择类似，以下拉菜单形式呈现。
当您在内容模型中定义好这些自定义字段后，它们便成为了您内容的重要组成部分，等待被填充和展示。
内容录入与管理：丰富您的每一篇文章
定义好内容模型后，在“内容管理”下添加或编辑具体内容时，您会发现除了标题、内容、分类、标签等标准字段外，底部会有一个“其他参数”的折叠区域。这里就是您自定义字段大展身手的地方。
例如，如果您为“产品”模型定义了“产品材质”、“尺寸”、“保修期”等自定义字段，那么在录入具体产品信息时，这些字段会在此处一一呈现，供您填写相应的值。安企CMS的设计确保了后端数据录入的便捷性，让您能够轻松管理和丰富内容的每一个细节。
模板层面：将数据转化为生动展现
内容的存储只是第一步，如何将其美观、完整地展示给访客，则需要依赖模板设计。安企CMS采用类似Django模板引擎的语法，让模板制作既灵活又易于上手。
对于内容详情页，通常对应的模板文件是{模型table}/detail.html（例如，article/detail.html 或 product/detail.html）。在这个模板文件中，您将使用特定的标签和变量来调用您在后台录入的各种内容。
核心调用机制：
安企CMS的模板语言主要通过两种方式调用数据：
- 双花括号
{{变量}}：直接输出变量的值。 - 单花括号和百分号
{% 标签 %}：用于逻辑控制（如循环、条件判断）或调用特定功能模块（如文档详情、列表等）。
在内容详情页的模板中，系统会自动将当前文档的所有数据加载到一个名为 archive 的对象中，因此，大部分核心数据可以直接通过 {{archive.字段名}} 的方式调用。而对于更复杂的场景或需要显式获取某些数据时，则会用到专门的标签。
展示核心内容：标准字段的调用
在内容详情页的模板中，您可以轻松调用各种标准字段来构建页面的基本结构。以下是一些常用的调用示例：
- 文档标题：
<h1>{{archive.Title}}</h1>或{% archiveDetail with name="Title" %} - 主要内容：
<div>{{archive.Content|safe}}</div>。请注意这里的|safe过滤器，它非常重要。如果您的内容（特别是通过富文本编辑器录入的）包含HTML标签，|safe会告诉模板引擎不要转义这些HTML，而是将其作为真实的HTML代码解析并显示。 - 发布时间：
<span>发布日期：{{stampToDate(archive.CreatedTime, "2006-01-02")}}</span>。stampToDate是一个格式化时间戳的实用标签，您可以根据需求自定义时间显示格式。 - 浏览量：
<span>阅读量：{{archive.Views}}</span> - 分类链接与名称：您可以通过
archive.Category对象访问分类信息，如{{archive.Category.Title}}和{{archive.Category.Link}}。 - 缩略图/主图：
<img src="{{archive.Logo}}" alt="{{archive.Title}}"/>或{{archive.Thumb}}。 - 文档简介：
{{archive.Description}}
深度定制：自定义字段的灵活呈现
这是实现“完整信息（包括自定义字段）显示”的关键所在。安企CMS提供了多种方式来展示您在内容模型中定义的自定义字段。
1. 直接调用指定自定义字段：
如果您知道自定义字段的“调用字段”（在内容模型中设置的英文名称），可以直接像调用标准字段一样来显示它。
例如，如果您定义了一个名为 product_material 的单行文本自定义字段，在模板中可以直接这样调用：
<p>产品材质：{{archive.ProductMaterial}}</p>
{# 或者使用archiveDetail标签显式获取 #}
<p>产品材质：{% archiveDetail with name="ProductMaterial" %}</p>
请注意，模板中的变量名通常遵循驼峰命名法，即将后端定义的 product_material 转换为 ProductMaterial。
2. 循环显示所有自定义字段：
如果您希望动态地显示当前文档的所有自定义字段，而不需要逐一指定，可以使用 archiveParams 标签。这个标签会返回一个包含所有自定义字段名称和值的数组对象。
{% archiveParams params %}
<div class="custom-fields">
{% for item in params %}
<div class="field-item">
<span class="field-name">{{item.Name}}：</span> {# item.Name 是字段的中文名 #}
<span class="field-value">{{item.Value|safe}}</span> {# item.Value 是字段的值，可能需要|safe #}
</div>
{% endfor %}
</div>
{% endarchiveParams %}
3. 处理复杂类型的自定义字段：
对于像“组图”或“多项选择”这类自定义字段，它们的值可能是一个数组或更复杂的结构。这时，您需要在模板中进行额外的循环或处理。
例如，如果您有一个名为 product_gallery 的自定义字段，其值为一组图片URL（类似Images字段），您可以这样展示：
{% archiveDetail productGallery with name="ProductGallery" %}
{% if productGallery %}
<div class="product-gallery">
{% for imgUrl in productGallery %}
<img src="{{imgUrl}}" alt="产品图"/>
{% endfor %}
</div>
{% endif %}
对于多项选择字段，其值可能是一个逗号分隔的字符串或数组，您可能需要先用 |split 过滤器将其转换为数组再循环，或者直接显示。
综合示例：一篇完整的文章详情页片段
让我们将上述方法融会贯通，构建一个包含标准字段和自定义字段的文章详情页模板片段：
”`twig {# 假设这是您的内容详情页模板：{模型table}/detail.html #}
<!DOCTYPE html>
<meta charset="UTF-8">
<title>{% tdk with name="Title" siteName=true %}</title> {# 调用TDK标签显示标题，并附加网站名称 #}
<meta name="keywords" content="{% tdk with name="Keywords" %}">
<meta name="description" content="{% tdk with name="Description" %}">
<link rel="stylesheet" href="{% system with name="TemplateUrl" %}/css/style.css">
<header>
<nav>
{# 导航栏通常在这里调用 #}
{% navList navs %}
{# ... 循环展示导航项 ... #}
{% endnavList %}
</nav>
</header>
<main class="container">
{# 面包屑导航 #}
<