如何在前台页面精确显示AnqiCMS特定文档的详细内容,包括标题、描述和图片?

📅 👁️ 83

安企CMS(AnQiCMS)凭借其灵活的内容模型和直观的模板标签系统,让您能够轻松驾驭网站前台内容的展示。当我们需要在前台页面精确地呈现某个特定文档的详细内容,例如标题、描述、完整的正文以及相关的图片,了解其核心机制和常用标签就显得尤为重要。

理解安企CMS的内容结构

在安企CMS中,所有的内容都基于“内容模型”进行组织,例如常见的文章模型、产品模型等。每个模型都包含一系列标准字段(如标题、内容、描述、缩略图)和您根据业务需求自定义的额外字段。这些字段是您在前台页面调取和展示内容的基础。

精确获取特定文档详情的核心标签:archiveDetail

要在前台页面精确显示某个特定文档的详细内容,archiveDetail 标签无疑是您的“万能钥匙”。这个标签专门用于获取单一文档的所有数据,无论是标准字段还是自定义字段。

如何指定要显示的文档

使用archiveDetail标签时,您可以根据文档的ID或URL别名(token)来指定要获取哪个文档的数据。

  • 通过文档ID指定:如果您知道文档的数字ID,可以使用 id="[文档ID]" 参数。例如,{% archiveDetail with name="Title" id="10" %} 将获取ID为10的文档标题。
  • 通过URL别名指定:如果您的文档URL使用了别名(通常是拼音或英文),可以使用 token="[文档别名]" 参数。例如,{% archiveDetail with name="Description" token="anqicms-features" %}

如果当前页面本身就是一个文档详情页,并且您想获取的就是当前文档的内容,那么idtoken参数甚至可以省略,系统会自动识别并加载当前文档的数据。

精准调用各项内容

一旦您通过archiveDetail标签锁定了目标文档,就可以通过name参数指定要显示的具体字段了。

  1. 显示文档标题 文档标题是内容的核心,您可以使用name="Title"来获取它。例如:

    <h1>{% archiveDetail with name="Title" id="1" %}</h1>
    

    如果您想显示SEO优化的标题,可以使用name="SeoTitle"

  2. 显示文档描述 文档的简要描述对用户和搜索引擎都非常重要。使用name="Description"即可:

    <p class="description">{% archiveDetail with name="Description" id="1" %}</p>
    
  3. 显示文档图片 安企CMS提供了多种图片类型供您选择:

    • 封面首图(Logo)或缩略图(Thumb):通常用于列表页或文档顶部的单张主图。
      
      <img src="{% archiveDetail with name="Logo" id="1" %}" alt="{% archiveDetail with name="Title" id="1" %}" />
      
    • 文档组图(Images):如果文档包含多张图片(例如产品展示图集),Images字段会返回一个图片URL数组。您需要使用for循环来遍历并显示它们。
      
      <div class="gallery">
          {% archiveDetail docImages with name="Images" id="1" %}
          {% for img in docImages %}
              <img src="{{ img }}" alt="文档图片" />
          {% endfor %}
      </div>
      
  4. 显示文档正文内容 文档的正文内容通常包含HTML格式,可能还有Markdown语法需要转换。在使用name="Content"获取正文时,请务必配合|safe过滤器,以确保HTML内容能够正确渲染而不是被转义。如果您的文档内容启用了Markdown编辑器,您还可以添加render=true参数让系统自动将其转换为HTML:

    <div class="article-content">
        {% archiveDetail docContent with name="Content" id="1" render=true %}
        {{ docContent|safe }}
    </div>
    
  5. 显示发布时间与更新时间 时间信息对于用户了解内容时效性很重要。CreatedTimeUpdatedTime字段返回的是时间戳,您需要使用stampToDate过滤器将其格式化为可读的日期时间:

    <span>发布于:{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}</span>
    <span>更新于:{{ stampToDate(archive.UpdatedTime, "2006-01-02") }}</span>
    

    这里的archive变量通常指当前页面的文档对象,或者您通过{% archiveDetail archive with ... %}定义的文档变量。

  6. 显示自定义字段 安企CMS的强大之处在于其灵活的内容模型,您可以为不同模型添加各种自定义字段(如作者、来源、产品参数等)。要显示这些字段,可以直接使用其调用字段名:

    <p>作者:{% archiveDetail with name="Author" id="1" %}</p>
    

    如果您想遍历显示文档的所有自定义参数,可以使用archiveParams标签:

    <ul class="custom-params">
        {% archiveParams params with id="1" %}
        {% for item in params %}
            <li>{{ item.Name }}:{{ item.Value }}</li>
        {% endfor %}
    </ul>
    

将它们组合起来:一个完整的示例

假设我们要显示ID为1的“关于安企CMS”文档,包括标题、描述、正文、主图和自定义的“版本号”字段:

”`twig <!DOCTYPE html>

<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
{# 调用页面SEO标题和描述 #}
<title>{% tdk with name="Title" siteName=true %}</title>
<meta name="description" content="{% tdk with name="Description" %}">
<link rel="stylesheet" href="{% system with name="TemplateUrl" %}/css/style.css">

<header>{# 网站头部导航等内容 #}</header>

<main class="container">
    <article class="document-detail">
        {# 获取ID为1的文档所有数据,并赋值给archive变量,以便后续直接调用 #}
        {% archiveDetail archive with id="1" %}

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

        <div class="document-meta">
            <span>发布时间:{{ stampToDate(archive.CreatedTime, "2006年01月02日") }}</span>
            <span>浏览量:{{ archive.Views }}</span>
            {# 假设您的内容模型中有一个“Author”自定义字段 #}
            {% archiveDetail authorName with name="Author" id="1" %}
            {% if authorName %}
                <span>作者:{{ authorName }}</span>
            {% endif %}
        </div>

        {# 显示文档主图 #}
        {% if archive.Logo %}
        <div class="document-featured-image">
            <img src="{{ archive.Logo }}" alt="{{ archive.Title }}" />
        </div>
        {% endif %}

        <p class="document-description">{{

相关文章

如何使用AnqiCMS的文档列表标签,在前台展示最新、热门或指定分类的文章/产品?

在AnqiCMS中,灵活地展示网站内容是提升用户体验和满足运营需求的关键。无论是想要在首页突出最新的文章,还是在侧边栏显示热门产品,亦或是为特定栏目定制内容列表,AnqiCMS强大的文档列表标签都能助你一臂之力。通过巧妙运用这些标签,你可以轻松实现内容的多样化呈现,让你的网站更具活力和吸引力。 ### 核心标签:`archiveList`

2025-11-09

如何在前台页面调用并显示AnqiCMS特定单页的详细内容和图片?

在AnQiCMS中,想要在前台页面调用并展示特定单页的详细内容和图片,其实比您想象的要简单得多。AnQiCMS强大的模板标签体系,特别是针对单页设计的标签,能够让您轻松实现这一点。 ### 理解AnQiCMS的单页功能 首先,我们知道AnQiCMS提供了一个独立的“页面管理”模块,它允许我们创建像“关于我们”、“联系方式”或“服务介绍”这类独立的单页。这些单页的内容、图片、SEO信息等

2025-11-09

如何使用AnqiCMS的单页列表标签,在前台灵活展示“关于我们”等独立页面?

在现代网站运营中,像“关于我们”、“联系方式”、“服务条款”这类独立页面,它们承载着网站的基础信息和品牌形象,虽然不常更新,却至关重要。AnqiCMS 提供了一套灵活的“单页面”管理功能,结合其强大的模板标签系统,我们可以轻松地在前台展示这些独立页面,并根据需要进行个性化定制。 ### AnqiCMS中单页面的概念与作用 在AnqiCMS里,“单页面”特指那些内容独立、不属于任何分类

2025-11-09

如何在前台页面准确调用并显示AnqiCMS特定分类的详细信息,包括描述和Banner图?

在安企CMS(AnqiCMS)中,想要在前台页面精准地调用并展示特定分类的详细信息,比如分类的描述和它专属的Banner图片,是一个很常见的需求。这不仅能让网站内容结构更清晰,也能提升用户体验和网站的SEO表现。得益于AnqiCMS灵活的模板标签系统,实现这一目标其实非常直接。 我们主要会用到一个核心的模板标签——`categoryDetail`。这个标签专门用于获取分类的各种详细信息

2025-11-09

如何在前台页面显示当前文档的“上一篇”和“下一篇”文档,提升用户浏览体验?

在安企CMS(AnQiCMS)中,为前台页面的文档添加“上一篇”和“下一篇”导航链接,是提升用户浏览体验、延长用户停留时间的重要手段。当用户阅读完一篇内容时,这些链接能够引导他们自然而然地发现更多相关内容,避免页面浏览中断,从而有效降低跳出率,并有助于提升网站内容的整体权重。 安企CMS作为一款功能丰富的Go语言内容管理系统,内置了强大的模板标签系统,让网站运营者能够灵活地控制内容展示。其中

2025-11-09

如何在前台页面展示AnqiCMS的相关文档列表,以增加内容的关联性和用户停留时间?

在内容运营中,我们都希望用户能在网站上停留更长时间,浏览更多内容。一篇精心撰写的文章固然重要,但如何将它与其他相关内容连接起来,形成一个内容矩阵,才是提升用户体验、降低跳出率的关键。想象一下,用户阅读完一篇关于“安企CMS核心功能”的文章后,如果页面下方能自动推荐“如何使用安企CMS搭建电商站”或“安企CMS模板制作教程”,是不是更能吸引他们继续探索? 这正是我们今天要探讨的主题

2025-11-09

如何在前台页面显示AnqiCMS文档的自定义参数字段,如作者、来源等?

在网站运营中,内容管理系统(CMS)的灵活性至关重要。安企CMS以其强大的可定制性,允许我们为内容(如文章、产品等)添加各种自定义参数字段,以满足多样化的展示需求。这些自定义字段,如文章的“作者”、“来源”、产品的“型号”、“颜色”等,都能极大地丰富内容的维度和实用性。 那么,当我们在后台为文档添加了这些个性化的自定义参数后,如何在网站的前台页面上将它们优雅地呈现给访客呢

2025-11-09

如何在前台页面实现AnqiCMS文档参数筛选功能,帮助用户快速定位内容?

在内容日益丰富的网站上,如何帮助用户快速找到他们感兴趣的信息,是一项至关重要的运营挑战。用户常常需要根据特定的条件来筛选内容,而不是漫无目的地浏览。安企CMS(AnqiCMS)为此提供了强大的文档参数筛选功能,让您能够轻松在前台页面实现这一目标,极大提升用户体验和内容可发现性。 ### 理解筛选功能背后的逻辑 在深入前台实现之前,我们先来简单了解一下安企CMS筛选功能的设计理念

2025-11-09