在安企CMS中管理和展示内容是核心功能，而文章详情页作为用户获取信息、与网站互动的重要界面，其显示布局和元素的设计直接影响着用户体验和信息传达效率。安企CMS提供了高度的灵活性，让用户能够根据自身需求，深度定制文章详情页的展现方式。

要自定义文章详情页，首先需要了解安企CMS的模板系统。它采用类似于Django模板引擎的语法，模板文件通常以.html为后缀，并统一存放在系统根目录下的/template文件夹中。与模板相关的样式、JavaScript脚本和图片等静态资源，则位于/public/static/目录。这种分离的设计使得内容与表现层可以独立管理，方便开发者进行二次开发和个性化调整。

确定并创建你的文章详情页模板文件

安企CMS的模板遵循一定的命名约定。对于文章详情页，其默认模板路径是{模型table}/detail.html。这里的{模型table}通常是内容模型在后台设置时定义的表名，例如，如果你的文章模型表名是article，那么默认的文章详情页模板就是article/detail.html。

更灵活的方式是为特定文章或特定分类的文章指定专属的模板。系统支持按文档ID或分类ID来命名自定义模板：

  • 按文档ID命名： {模型table}/detail-{文档ID}.html。例如，如果你想为ID为10的文章制作一个独特的详情页，可以命名为article/detail-10.html。
  • 通过分类指定： 你可以在分类设置中，为该分类下的所有文章指定一个统一的文档模板，例如mycategory_detail.html。

这意味着你可以先从复制和修改默认的{模型table}/detail.html文件开始，然后将其保存为上述约定名称的文件，以便进行定制。

在后台指定自定义模板

创建好自定义模板文件后，还需要在安企CMS后台进行关联，让系统知道应该使用哪个模板来渲染特定的文章：

  1. 发布/编辑文档时指定： 在“内容管理”模块中，当你“发布文档”或“编辑文档”时，在“其他参数”部分，你会找到一个名为“文档模板”的选项。在这里填入你的自定义模板文件名（例如my_custom_article.html）。系统会优先使用这里指定的模板。
  2. 分类设置时指定： 在“内容管理”模块下的“文档分类”中，编辑某个分类时，在“其他参数”中，同样有“分类模板”和“文档模板”两个选项。“分类模板”用于控制该分类列表页的布局，而“文档模板”则用于控制该分类下所有文章的详情页布局。如果你想让某个分类下的所有文章都使用相同的自定义布局，可以在这里指定。

调用核心数据与控制显示元素

在文章详情页的模板文件中，你可以使用安企CMS提供的丰富标签来调用和展示数据，以及控制布局：

  • 获取文章自身数据： 使用{% archiveDetail %}标签。这是详情页最核心的标签，它可以让你获取文章的标题、内容、链接、描述、封面图片等几乎所有字段。

    • 例如，要显示文章标题：<h1>{% archiveDetail with name="Title" %}</h1>。
    • 显示文章内容：<div>{% archiveDetail with name="Content" render=true lazy="data-src" %}{{archiveContent|safe}}</div>。这里的render=true在开启Markdown编辑器时尤其有用，会将Markdown内容渲染成HTML；lazy="data-src"则方便集成图片懒加载功能；|safe过滤器用于避免内容中的HTML标签被转义。
    • 你可以通过name="字段名称"来获取单个字段，例如name="Logo"获取封面首图，name="Images"获取组图。

  • 显示自定义附加字段： 如果你在后台为内容模型添加了自定义字段（例如“作者”、“来源”），可以使用{% archiveParams %}标签来调用。

    • 例如，循环显示所有自定义字段： 
      
{% archiveParams params %}
    {% for item in params %}
        <p>{{item.Name}}：{{item.Value}}</p>
    {% endfor %}
{% endarchiveParams %}
    • 或者直接通过字段名调用：<div>作者：{% archiveDetail with name="author" %}</div>。

  • 调用分类信息： 使用{% categoryDetail %}标签，可以获取文章所属分类的名称、链接、描述等。

    • 例如：所属分类：<a href="{% categoryDetail with name='Link' %}">{% categoryDetail with name='Title' %}</a>。

  • 显示相关标签： {% tagList tags %}标签可以获取当前文章关联的所有标签。

    • 通过循环，你可以显示这些标签的链接和名称，例如： 
      
{% tagList tags %}
    {% for tag in tags %}
        <a href="{{tag.Link}}">{{tag.Title}}</a>
    {% endfor %}
{% endtagList %}

  • 导航至上一篇/下一篇文章： {% prevArchive %}和{% nextArchive %}标签可以方便地在文章详情页底部添加导航链接。

    • 例如： 
      
{% prevArchive prev %}
    {% if prev %}<a href="{{prev.Link}}">上一篇：{{prev.Title}}</a>{% else %}没有了{% endif %}
{% endprevArchive %}

  • 显示相关文章列表： 同样使用{% archiveList %}标签，通过设置type="related"，可以获取与当前文章相关的其他文章列表。

    • 例如： 
      
{% archiveList relatedArchives with type="related" limit="5" %}
    {% for item in relatedArchives %}
        <li><a href="{{item.Link}}">{{item.Title}}</a></li>
    {% endfor %}
{% endarchiveList %}

  • 面包屑导航： {% breadcrumb %}标签用于生成网站的导航路径，帮助用户了解当前位置。

    • 例如： 
      
{% breadcrumb crumbs %}
    {% for item in crumbs %}
        <span><a href="{{item.Link}}">{{item.Name}}</a></span>{% if not forloop.Last %} > {% endif %}
    {% endfor %}
{% endbreadcrumb %}

  • 集成评论功能： {% commentList %}标签用于展示文章的评论列表，你还可以结合{% pagination %}标签实现分页显示。

    • 别忘了在评论表单中加入captcha_id和captcha字段以及相应的JavaScript代码来支持验证码功能，以防止垃圾评论。

  • 结构与逻辑控制：

    • {% include "partial/header.html" %}：用于引入可复用的模板片段，如页头、页脚。
    • {% extends "base.html" %}：实现模板继承，你可以定义一个基础骨架模板，然后在详情页模板中重写特定的内容块（{% block content %}）。
    • {% if 条件 %}、{% for 循环 %}：进行条件判断和循环遍历，控制内容的显示逻辑。

布局与样式文件的管理

除了在模板文件中调用数据，文章详情页的最终布局和视觉效果是通过HTML结构和CSS样式共同实现的。你可以将自定义的CSS和JS文件放在/public/static/你的模板目录/css/和/public/static/你的模板目录/js/等目录下，然后在模板中使用{% system with name="TemplateUrl" %}标签获取模板静态文件地址来引用它们。例如：

<link href="{% system with name="TemplateUrl" %}/css/custom.css" rel="stylesheet">

通过这些标签和灵活的文件管理方式，你完全可以打造出满足特定内容展示需求的文章详情页，无论是简洁的博客文章、图文并茂的产品介绍，还是复杂的案例展示页面，都能通过安企CMS轻松实现。

常见问题 (FAQ)

1. 如何为不同类型的内容模型（如文章、产品）的文章详情页设置不同的布局？ 你可以在安企CMS后台定义多个内容模型，例如“文章”模型和“产品”模型。然后，为每个内容模型创建独立的详情页模板文件。按照安企CMS的模板命名约定，你可以创建article/detail.html作为文章模型的默认详情页，以及product/detail.html作为产品模型的默认详情页。这样，不同模型的内容将自动应用其对应的模板布局。你也可以在发布或编辑单篇文章/产品时，在“文档模板”选项中为单个内容项指定更具体的模板文件。

2. 我在文章详情页中添加了自定义字段，如何在前端显示它们？ 如果你在后台的“内容模型”中为某个模型（例如文章模型）添加了自定义字段，比如author（作者）和source（来源），那么在文章详情页的模板中，可以通过两种方式显示这些字段： a. 直接调用： <div>作者：{% archiveDetail with name="author" %}</div>。 b. 循环遍历： 如果你想显示所有自定义字段，可以使用{% archiveParams params %}{% for item in params %}<p>{{item.Name}}：{{item.Value}}</p>{% endfor %}{% endarchiveParams %}。这种方式特别适用于字段数量不固定或需要统一展示格式的场景。

3. 我上传了自定义模板文件，但在网站前台却没有生效，这是为什么？ 有几个常见原因可能导致自定义模板不生效： a. 模板文件路径或命名错误： 请仔细检查你的模板文件是否存放在/template/你的模板主题目录/下，并且命名是否符合安企CMS的约定（例如{模型table}/detail.html或my_custom_article.html）。 b. 后台未指定模板： 确保你在文章发布/编辑页面，或对应分类的设置页面，正确地选择了或填写了你的自定义模板文件名。 c. 系统缓存未更新： 在后台的“更新缓存”功能中点击清理缓存。 d. 浏览器缓存： 尝试清除浏览器缓存或使用无痕模式访问，因为浏览器可能会缓存旧的页面资源。