`commentList`标签如何区分和显示“审核通过”与“待审核”的评论状态（`Status`字段）？

作为一名资深的网站运营专家，我们深知网站评论区的活跃度与内容质量对于用户参与度和品牌形象建设至关重要。安企CMS（AnQiCMS）在评论管理方面提供了灵活的控制，其中评论状态的区分显示是内容运营中一个非常实用的功能。今天，我们就来深入探讨一下，如何在利用 commentList 标签时，精细化地区分并显示“审核通过”与“待审核”的评论状态。

理解评论状态的 Status 字段

在安企CMS中，每一条用户评论都带有一个 Status 字段，这个字段是其审核状态的唯一标识。通常情况下，Status 字段的值为：

• Status = 1: 表示这条评论已经通过了审核，可以对外公开显示。
• Status = 0 (或非1的其它值): 表示这条评论处于待审核状态。根据运营策略，待审核评论可能不应该直接显示在前端，或者需要明确标示其为“待审核”。

对于内容运营人员来说，清晰地识别并控制这些状态，不仅能有效维护网站内容质量，防止不当信息传播，还能向用户传递网站对评论负责的态度。

commentList 标签的基础回顾

在安企CMS的模板系统中，commentList 标签是用于获取和循环展示评论数据的重要工具。它允许我们指定获取哪个文档（archiveId）的评论，以列表（type="list"）或分页（type="page"）的形式展示。当我们使用 {% commentList comments with ... %} 这样的语法时，comments 变量就会成为一个包含了多条评论对象的数组。

在循环遍历这个 comments 数组时，每条评论的数据都会被赋值给一个 item 变量（或其他您自定义的循环变量）。这个 item 对象中，除了评论ID、用户名、评论内容等常见信息外，就包含了我们今天关注的 Status 字段。

区分显示评论审核状态的实现

要区分并显示“审核通过”和“待审核”的评论，核心在于利用模板语言的条件判断 ({% if %} 标签) 来检测 item.Status 的值。

根据安企CMS的默认逻辑，Status = 1 是审核通过，而其他值（通常是 0）则是待审核。我们可以通过判断 item.Status != 1 来识别待审核的评论，并据此展示不同的内容或样式。

例如，您可能希望：

1. 审核通过的评论：正常显示评论内容、用户名、时间等。
2. 待审核的评论：显示一个“该评论正在审核中”的提示，或者只显示部分信息，如用户名，但不显示评论内容，甚至完全隐藏评论。

为了兼顾用户体验和管理需求，通常我们会选择在待审核的评论位置显示一个明确的提示，让用户知道他们的评论已经被接收，但仍在处理中。

详细代码示例与解析

让我们通过一个具体的模板代码片段来演示如何实现这一功能。假设我们正在一个文档详情页中展示评论列表：

{# 假设archive.Id是当前文档的ID，且已通过archiveDetail等标签获取 #}
{% commentList comments with archiveId=archive.Id type="page" limit="10" %}
    {% for item in comments %}
    <div class="comment-item {% if item.Status != 1 %}comment-pending{% else %}comment-approved{% endif %}">
      <div class="comment-header">
        <span class="user-name">
          {% if item.Status != 1 %}
          <!-- 如果是待审核评论，显示“审核中”并截断用户名 -->
          待审核：{{item.UserName|truncatechars:6}}
          {% else %}
          <!-- 审核通过的评论，正常显示用户名 -->
          {{item.UserName}}
          {% endif %}
        </span>

        {% if item.Parent %}
        <!-- 如果是回复评论，显示回复对象 -->
        <span class="reply-indicator">回复</span>
        <span class="parent-user-name">
          {% if item.Parent.Status != 1 %}
          <!-- 如果被回复的评论也待审核，同样提示 -->
          待审核：{{item.Parent.UserName|truncatechars:6}}
          {% else %}
          {{item.Parent.UserName}}
          {% endif %}
        </span>
        {% endif %}
        <span class="comment-time">{{stampToDate(item.CreatedTime, "2006-01-02 15:04")}}</span>
      </div>

      <div class="comment-content">
        {% if item.Parent %}
        <!-- 如果是回复评论，可以引用上级评论内容 -->
        <blockquote class="parent-comment-quote">
          {% if item.Parent.Status != 1 %}
          <!-- 如果被回复的评论待审核，显示通用提示 -->
          被回复内容：该评论正在审核中...
          {% else %}
          {{item.Parent.Content|truncatechars:100}} <!-- 截断显示上级评论内容 -->
          {% endif %}
        </blockquote>
        {% endif %}

        {% if item.Status != 1 %}
          <!-- 待审核评论的主体内容，显示提示信息 -->
          <p class="pending-message">您的评论已提交，正在等待管理员审核。</p>
        {% else %}
          <!-- 审核通过评论的主体内容，正常显示 -->
          <p>{{item.Content}}</p>
        {% endif %}
      </div>

      <div class="comment-actions">
        {% if item.Status == 1 %}
        <!-- 只有审核通过的评论才显示点赞和回复按钮 -->
        <a class="action-btn" data-id="praise">赞(<span class="vote-count">{{item.VoteCount}}</span>)</a>
        <a class="action-btn" data-id="reply">回复</a>
        {% endif %}
      </div>
    </div>
    {% empty %}
    <p class="no-comments">还没有评论，快来发表您的看法吧！</p>
    {% endfor %}
{% endcommentList %}

{# 分页标签，如果type="page"模式开启分页，则需要这个 #}
{% pagination pages with show="5" %}
    <div class="pagination-controls">
        <a class="page-link {% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
        {% if pages.PrevPage %}<a class="page-link" href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>{% endif %}
        {% for page_item in pages.Pages %}<a class="page-link {% if page_item.IsCurrent %}active{% endif %}" href="{{page_item.Link}}">{{page_item.Name}}</a>{% endfor %}
        {% if pages.NextPage %}<a class="page-link" href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>{% endif %}
        <a class="page-link {% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
    </div>
{% endpagination %}

代码解析：

1. 外层 div 的样式控制：在评论的包裹 div 上，我们添加了 comment-item 类，并根据 item.Status 的值动态添加了 comment-pending 或 comment-approved 类。这为您通过CSS定制不同状态评论的视觉效果提供了便利。
2. 用户名显示逻辑：
   • {% if item.Status != 1 %}：这个条件判断是关键。如果评论状态不是 1（即待审核），则显示“待审核：”前缀，并且使用 truncatechars:6 过滤器截断用户名，以保护用户隐私。
   • {% else %}：如果评论状态是 1（审核通过），则正常显示用户名。
3. 回复评论的 Parent 对象：安企CMS允许评论回复，通过 item.Parent 可以访问到父级评论的信息。这里我们同样对 item.Parent.Status 进行了判断，确保引用的父级评论状态也被妥善处理。
4. 评论内容显示逻辑：
   • 对于待审核的评论，我们不再显示原始的评论内容，而是用一个友好的提示语：“您的评论已提交，正在等待管理员审核。”这既保护了网站内容质量，也向用户提供了反馈。
   • 对于审核通过的评论，我们直接显示 item.Content。
5. 评论操作按钮：点赞、回复等互动功能通常只对审核通过的评论开放，因此我们用 {% if item.Status == 1 %} 包裹这些操作按钮。
6. empty 标签：当没有评论时，{% empty %} 会显示“还没有评论，快来发表您的看法吧！”的提示。
7. stampToDate 过滤器：用于将时间戳格式化为可读的日期和时间。
8. truncatechars 过滤器：在显示用户名或引用父评论内容时，用于截断过长的字符串，保持页面整洁。

通过上述方法，您可以灵活地控制评论的展示，既保证了网站内容的质量，又提升了用户体验和运营效率。

常见问题 (FAQ)

**1. Q