如何在 AnQiCMS 模板中显示指定单页面的详细内容？

在AnQiCMS的网站运营中，单页面（Page）功能是一个非常实用的模块，它允许我们创建和管理独立于文章或产品等动态内容之外的静态页面，例如“关于我们”、“联系方式”或“服务介绍”等。这些页面通常包含相对固定且重要的信息，需要以清晰、直接的方式呈现给访问者。作为一名AnQiCMS的资深运营人员，我深知如何有效地利用模板机制来精准控制这些单页面的显示，以满足多样化的设计和内容需求。

核心概念：pageDetail 标签

AnQiCMS 提供了一个专门的模板标签 pageDetail，用于在模板中获取和显示单页面的详细信息。这个标签是控制单页面内容输出的核心。通过 pageDetail 标签，我们可以根据页面的唯一标识（ID）或自定义URL别名（token）来精确指定要展示的单页面，并从中提取出我们所需的各种字段，如标题、内容、链接、图片等。

在模板中显示指定的单页面内容

要在一个AnQiCMS模板中显示指定的单页面内容，最常见的方法是利用pageDetail标签的id或token参数。

例如，如果您想在网站的某个特定位置展示ID为1的“关于我们”页面，您可以在您的模板文件中使用以下语法来获取其标题和内容：

{% pageDetail aboutPage with id="1" %}
    <h1 class="page-title">{{ aboutPage.Title }}</h1>
    <div class="page-content">
        {{ aboutPage.Content|safe }}
    </div>
    <a href="{{ aboutPage.Link }}" class="page-link">了解更多</a>
{% endpageDetail %}

在这段代码中：

  • pageDetail aboutPage with id="1" 指示系统获取ID为1的单页面数据，并将其赋值给名为 aboutPage 的变量。
  • {{ aboutPage.Title }} 用于显示该单页面的标题。
  • {{ aboutPage.Content|safe }} 用于显示单页面的主体内容。需要注意的是，|safe 过滤器在这里至关重要，它告诉模板引擎将内容作为安全的HTML输出，而不是进行转义，这对于包含富文本编辑器的内容是必要的。
  • {{ aboutPage.Link }} 则会输出该单页面的访问链接。

除了通过ID，您也可以通过页面的自定义URL别名（token）来指定单页面。例如，如果您的“联系我们”页面的别名设置为 contact-us，您可以这样调用：

{% pageDetail contactPage with token="contact-us" %}
    <h2 class="section-title">{{ contactPage.Title }}</h2>
    <p>{{ contactPage.Description }}</p>
    <div>
        {{ contactPage.Content|safe }}
    </div>
{% endpageDetail %}

在不指定id或token参数的情况下，pageDetail 标签会默认尝试获取当前URL对应的单页面数据。这在单页面本身的详情模板（如page/detail.html）中使用时非常方便，无需额外参数即可直接显示当前页面的信息。

自定义单页面模板

AnQiCMS 提供了灵活的模板自定义机制，允许您为不同的单页面应用独特的设计。在后台的“页面管理”中，当您编辑或创建单页面时，会有一个“单页面模板”字段。默认情况下，所有单页面都会使用 /template/{你的模板目录}/page/detail.html 这个文件。

但是，如果您希望某个特定的单页面拥有完全不同的布局或样式，您可以为其创建一个专属的模板文件。例如，如果您有一个ID为5的“服务流程”页面，并希望它使用一个名为 service-flow.html 的特殊模板，您可以按照以下步骤操作：

  1. 在您当前使用的模板目录（例如 /template/default/）下，创建一个名为 service-flow.html 的文件。该文件可以包含完全自定义的HTML结构和样式。
  2. 在AnQiCMS后台，进入“页面管理”，找到ID为5的“服务流程”页面进行编辑。
  3. 在“单页面模板”字段中，填写 service-flow.html。
  4. 保存页面。

这样，当用户访问“服务流程”页面时，系统将不再加载默认的page/detail.html，而是使用您指定的service-flow.html来渲染内容。AnQiCMS还支持按照ID进行模板命名，例如 page/detail-5.html，系统会自动识别并应用。这种方式尤其适用于需要为少数几个重要页面提供独特展示的情况。

处理内容渲染

正如前面提到的，单页面的内容通常通过富文本编辑器输入，可能包含HTML标签。为了确保这些内容能够正确地在页面上渲染，