在网站内容运营中，评论区无疑是用户互动与内容深度的重要体现。一个设计精良、信息呈现清晰的评论列表，不仅能显著提升用户的浏览体验，更能有效激发社区的活跃度。AnQiCMS强大的模板系统为我们提供了灵活的工具，让我们可以轻松实现评论内容、评论者、回复对象以及发布时间的条理化展示。

理解评论列表的核心要素

要构建一个既美观又实用的评论列表，我们需要确保以下几个核心信息能够直观、准确地传达给每一位访问者：

  • 评论内容： 这是用户思想和观点最直接的体现，是评论区的核心。
  • 用户名： 明确评论者的身份，建立互动氛围。
  • 回复对象： 当一条评论是对另一条评论的回应时，清晰地指出“回复了谁”，有助于用户理解对话的上下文。
  • 发布时间： 展示评论发布的时间，让用户能够了解信息的时效性，以及评论的先后顺序。

AnQiCMS的模板标签体系，尤其是commentList标签，能够帮助我们精准获取并组织这些评论数据。

利用 commentList 标签获取评论数据

commentList标签是获取评论数据的核心。它返回一个评论对象的集合，我们可以通过循环遍历这个集合来逐一展示每一条评论。例如，要获取当前文章的所有评论并进行分页展示，可以这样使用：

{% commentList comments with archiveId=archive.Id type="page" limit="10" %}
    {# 评论列表的展示逻辑将在这里展开 #}
{% endcommentList %}

在这段代码中，archive.Id通常用于指定当前页面文章的唯一标识符，确保获取的是针对本篇文章的评论。type="page"指示系统为我们提供分页数据，而limit="10"则设置了每页显示10条评论。comments是我们为获取到的评论数组定义的变量名。

深入解析评论对象的关键信息

在commentList标签的循环体内，每一次迭代中的item变量都代表了一条独立的评论数据。这个item对象承载着我们所需的全部信息：

  • 评论内容 (item.Content)： 这直接对应了用户输入的评论文本。为了确保内容的正确渲染和安全性，如果评论内容可能包含HTML标签或Markdown格式，我们通常会配合safe过滤器或render过滤器使用。
  • 用户名 (item.UserName)： 直接显示评论者的昵称或标识。
  • 发布时间 (item.CreatedTime)： 这是一个Unix时间戳。为了以用户友好的日期和时间格式呈现，我们需要借助stampToDate标签进行格式化。
  • 回复对象 (item.Parent)： 这是AnQiCMS评论系统的一个巧妙设计。如果当前评论是对另一条评论的回复，那么item.Parent将是一个包含了被回复评论完整信息的对象。通过简单地检查item.Parent是否存在，我们就能判断这条评论是否为回复，并进一步获取被回复评论的用户名 (item.Parent.UserName) 和内容 (item.Parent.Content)。

构建清晰的评论展示结构：实战示例

现在，让我们结合这些信息，创建一个既直观又具有良好用户体验的评论展示模板。以下是一个考虑了普通评论和回复评论不同展示需求，并加入了审核状态判断和内容截断处理的实用示例：

”`twig 

{% commentList comments with archiveId=archive.Id type="page" limit="10" %}
    {% for item in comments %}
        <div class="comment-item">
            <div class="comment-meta">
                <span class="user-name">
                    {# 根据评论状态显示用户名，如果未审核则提示 #}
                    {% if item.Status != 1 %}
                        <span class="status-pending">审核中：</span>{{item.UserName|truncatechars:6}}
                    {% else %}
                        {{item.UserName}}
                    {% endif %}
                </span>

                {# 如果是回复评论，