在安企CMS中管理网站内容,并确保其在前端页面上得到准确而美观的展示,是日常运营工作的核心。对于每一个文档详情页来说,清晰地呈现文档的标题、发布时间和浏览量,不仅能有效提升用户体验,也是内容信息传达的重要一环。安企CMS提供了强大且灵活的模板标签,让我们可以轻松实现这些需求。

定位文档详情页模板

要修改文档详情页的显示内容,我们首先需要找到对应的模板文件。在安企CMS的模板结构中,文档详情页的默认模板通常位于 template/{你的模板目录}/{模型table}/detail.html。例如,如果你的模板目录是 default,文章模型(通常是 archive)的详情页模板可能是 template/default/archive/detail.html

在进行任何修改之前,建议先备份你的模板文件,以防操作失误。

获取并显示文档标题

文档的标题是用户了解内容主题的第一步。在文档详情页的模板中,你可以直接通过 archive 对象来获取标题,因为它代表了当前正在查看的文档。

要显示文档标题,可以在 detail.html 中找到适当的位置(通常是 <h1> 标签内),然后使用以下代码:

<h1 class="document-title">{{ archive.Title }}</h1>

archive.Title 会直接输出当前文档的标题。

显示文档发布时间

文档的发布时间能够帮助用户了解内容的及时性。在安企CMS中,文档的创建时间 (CreatedTime) 是以时间戳的形式存储的。为了将其显示为人类可读的日期格式,我们需要借助 stampToDate 这个格式化时间戳的标签。

同样地,你可以通过 archive 对象获取到 CreatedTime,并用 stampToDate 进行格式化。例如,要显示为“2023年10月27日 10:30”这样的格式:

<span class="document-publish-time">发布时间:{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}</span>

这里,“2006年01月02日 15:04”是Go语言中用于定义日期时间格式的特殊布局字符串。你可以根据需要调整这个字符串,比如只显示日期 ("2006年01月02日"),或者显示完整的年月日时分秒 ("2006-01-02 15:04:05")

显示文档浏览量

浏览量是衡量一篇文档受欢迎程度的直观指标。在安企CMS中,文档的浏览量同样可以直接从 archive 对象中获取。

要显示文档的浏览量,你可以这样添加代码:

<span class="document-views">浏览:{{ archive.Views }} 次</span>

你可以根据偏好在数字前后添加“次”、“阅读”等单位。

将所有信息整合到模板中

通常,文档的标题、发布时间和浏览量会一起显示在内容的顶部,作为重要的元信息。下面是一个将上述元素整合到 detail.html 模板中的示例代码片段。我们还会额外添加文档所属的分类和标签,以提供更全面的信息展示。

”`twig

{# 文档标题 #}
<h1 class="document-title">{{ archive.Title }}</h1>

<div class="document-meta">
    {# 文档所属分类 #}
    <span class="meta-item">分类:<a href="{{ archive.Category.Link }}" class="category-link">{{ archive.Category.Title }}</a></span>
    {# 文档发布时间 #}
    <span class="meta-item">发布时间:{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}</span>
    {# 文档浏览量 #}
    <span class="meta-item">浏览:{{ archive.Views }} 次</span>

    {# 文档标签,通过 tagList 标签获取并循环显示 #}
    {% tagList tags with itemId=archive.Id limit="10" %}
        {% if tags %}
        <span class="meta-item">标签:
        {% for item in tags %}
            <a href="{{