如何显示网站的所有独立页面列表？

在安企CMS（AnQiCMS）中，网站的独立页面扮演着重要的角色，它们通常承载着“关于我们”、“联系方式”、“隐私政策”等核心信息，是构建网站信任度和完善信息架构不可或缺的一部分。本文将详细介绍如何在安企CMS中有效地管理和显示这些独立页面列表。

理解安企CMS中的“独立页面”

在安企CMS的语境中，我们所说的“独立页面”对应着系统中的“单页面”功能。这些页面与文章、产品等内容模型不同，它们通常是独立的、内容相对固定且不依赖于分类体系的页面。安企CMS提供了直观便捷的后台管理界面，让您可以轻松创建、编辑和维护这些单页面。

要管理这些页面，您只需登录安企CMS后台，导航至左侧菜单的“页面资源”，然后点击“页面管理”。在这里，您可以为每个单页面设置独立的标题、关键词、描述、自定义URL，甚至为特定页面应用不同的模板，以满足个性化的展示需求。

获取与展示独立页面的核心标签：pageList

要在网站前端显示这些单页面的列表，安企CMS的模板引擎提供了一个专门的标签：pageList。这个标签能够帮助您轻松获取所有已发布的单页面数据，并允许您在模板中通过循环的方式将其内容呈现在网页上。

pageList 标签的使用方式非常简洁。它会默认获取当前站点下的所有单页面数据。通常情况下，您无需为其设置复杂的参数。如果您是在一个多站点环境中，并且需要获取其他站点下的单页面列表，这时才可能需要用到 siteId 参数来指定站点的ID。但在大多数单站点场景下，保持默认即可。

当您在模板中使用 {% pageList pages %} ... {% endpageList %} 这样的结构时，pages 变量将包含一个单页面对象的数组。您可以通过 for 循环遍历这个数组，并提取每个单页面的详细信息进行展示。

每个单页面（例如，在循环中的 item 变量）都提供了以下常用的数据字段，您可以根据网站设计的需要灵活调用：

  • Id: 单页面的唯一标识符。
  • Title: 单页面的标题，通常用于列表中的链接文本。
  • Link: 单页面的访问URL地址。
  • Description: 单页面的简短描述。
  • Content: 单页面的详细内容。请注意，当展示此字段时，如果内容包含HTML标签，务必使用 |safe 过滤器，以确保HTML内容能够正确解析并显示，而不是作为纯文本输出。
  • Logo: 单页面的大尺寸缩略图地址。
  • Thumb: 单页面的标准缩略图地址。

在模板中实际操作：显示独立页面列表

让我们通过一个具体的代码示例，看看如何在您的网站模板中显示所有独立页面的列表。这在网站的导航菜单、底部链接区域或站点地图中都非常常见。

<nav class="page-list-nav">
    <ul>
    {% pageList pages %}
        {% for item in pages %}
        <li>
            <a href="{{ item.Link }}" title="访问{{ item.Title }}页面">
                {{ item.Title }}
            </a>
            {# 如果您希望在列表项中显示简要描述，可以取消以下行的注释 #}
            {# {% if item.Description %} <p>{{ item.Description }}</p> {% endif %} #}
            {# 如果页面配置了缩略图并想在列表中展示，可以这样添加 #}
            {# {% if item.Thumb %} <img src="{{ item.Thumb }}" alt="{{ item.Title }}缩略图" /> {% endif %} #}
        </li>
        {% endfor %}
    {% endpageList %}
    </ul>
</nav>

这段代码会生成一个无序列表，其中每个列表项都是一个指向独立页面的链接，链接文本即为单页面的标题。您可以根据自己网站的设计风格，灵活调整HTML结构和应用CSS样式，使其与整体页面布局和谐统一。

进阶技巧：排除特定页面与自定义页面模板

  • 排除特定页面: 有时候，您可能不希望所有单页面都出现在列表中，例如某个仅供内部访问的页面或者特定的功能性页面。您可以在 for 循环内部添加条件判断 (if) 来排除这些页面。例如，如果您想排除ID为5的页面：

    <ul>
{% pageList pages %}
    {% for item in pages %}
        {% if item.Id != 5 %} {# 排除ID为5的页面，您也可以根据item.Title或其他字段进行判断 #}
        <li>
            <a href="{{ item.Link }}" title="{{ item.Title }}">{{ item.Title }}</a>
        </li>
        {% endif %}
    {% endfor %}
{% endpageList %}
</ul>

  • 自定义单页面模板: 安企CMS允许为单个页面指定独立的模板文件。例如，如果您有一个“关于我们”页面，并且希望它拥有一个独特的布局，您可以在后台的页面管理中为其选择或创建一个名为 about-us.html 的专属模板。当用户点击这个页面的链接时，系统将自动渲染您指定的 about-us.html 文件。系统默认的单页面详情模板通常是 page/detail.html，或者根据页面ID自定义为 page/{单页ID}.html，这为页面的个性化展示提供了极大的灵活性。

小结

安企CMS通过其简洁明了的“单页面”功能和强大的 pageList 模板标签，为我们提供了高效且灵活的独立页面管理和展示方案。无论是构建网站导航、底部链接区域，还是创建其他需要列出独立页面的内容模块，这些工具都能帮助您轻松实现，从而提升网站的用户体验和信息完整性。

常见问题 (FAQ)

  1. Q: 我在后台创建了新的单页面，但网站前台的列表并没有显示出来，这是为什么？ A: 首先请确认您在后台“页面管理