`commentList`标签如何判断评论是否正在审核中，并进行条件显示？

在网站运营中，评论是提升用户互动和社区活力的重要元素。然而，为了保障网站内容的健康与质量，对用户提交的评论进行审核是不可或缺的环节。在安企CMS中，我们如何灵活地展示这些评论，尤其是在它们尚处于审核阶段时，成为了许多运营者关心的问题。好在安企CMS的模板标签体系为我们提供了强大的控制力，特别是commentList标签，能够帮助我们轻松实现评论的条件显示。

理解commentList标签的评论状态

commentList标签是安企CMS中用于获取指定文档评论列表的核心工具。当我们使用这个标签来循环展示评论时，每个评论项（通常命名为item）都包含了一系列详细信息，其中一个至关重要的字段就是Status。

Status字段是判断评论当前审核状态的关键。它的取值通常有两种情况：

• Status = 1：表示该评论已经通过审核，可以正常显示给所有访问者。
• Status = 0：表示该评论正在审核中，尚未通过管理员的批准。

了解了Status字段的含义，我们就可以在模板中运用逻辑判断，根据评论的不同状态进行差异化显示。

实战：利用Status字段条件显示评论

在模板中，我们可以结合安企CMS提供的if逻辑判断标签，对item.Status字段进行条件判断。这种方式让我们能够精确控制每条评论在不同审核状态下的展示方式，从而优化用户体验。

假设我们希望在评论区显示所有评论，但对于正在审核中的评论，给予明确的提示，而不是完全隐藏。我们可以这样编写模板代码：

{# 假设archive.Id是当前文档的ID #}
{% commentList comments with archiveId=archive.Id type="list" limit="10" %}
    {% for item in comments %}
    <div class="comment-item">
      <div class="comment-header">
        <span>
          {% if item.Status != 1 %} {# 如果评论未通过审核 #}
          <span style="color: gray;">[审核中]</span> {{item.UserName|truncatechars:6}}
          {% else %} {# 评论已通过审核 #}
          {{item.UserName}}
          {% endif %}
        </span>
        {% if item.Parent %} {# 如果是回复，显示回复对象 #}
        <span>回复</span>
        <span>
          {% if item.Parent.Status != 1 %}
          <span style="color: gray;">[审核中]</span> {{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 and item.Parent.Status != 1 %} {# 如果父级评论在审核中 #}
        <blockquote style="border-left: 3px solid #ccc; padding-left: 10px; margin-left: 20px; color: gray;">
          该回复的原始评论正在审核中...
        </blockquote>
        {% elif item.Parent %} {# 如果父级评论已通过审核 #}
        <blockquote style="border-left: 3px solid #ccc; padding-left: 10px; margin-left: 20px;">
          {{item.Parent.Content|truncatechars:100}} {# 截断显示父级评论内容 #}
        </blockquote>
        {% endif %}

        {% if item.Status != 1 %} {# 当前评论在审核中 #}
          <p style="color: orange;">您的评论已提交，正在等待审核中...</p>
          <p style="color: gray; font-style: italic;">{{item.Content|truncatechars:30}}</p> {# 审核中可以截断显示部分内容或完全隐藏 #}
        {% else %} {# 当前评论已通过审核 #}
          <p>{{item.Content}}</p>
        {% endif %}
      </div>
      <div class="comment-actions">
        {% if item.Status == 1 %} {# 只有已通过审核的评论才能点赞和回复 #}
        <a class="item" data-id="praise">赞(<span class="vote-count">{{item.VoteCount}}</span>)</a>
        <a class="item" data-id="reply">回复</a>
        {% endif %}
      </div>
    </div>
    {% endfor %}
{% endcommentList %}

在上面的示例中：

• 我们通过{% if item.Status != 1 %}来判断评论是否处于审核中。
• 对于审核中的评论，我们给用户名加上了[审核中]的提示，并用灰色文字显示，内容部分则显示“您的评论已提交，正在等待审核中…”的友好提示，并可以截断显示部分评论内容，让用户知道其评论已成功提交。
• 对于已通过审核的评论，则正常显示用户名和完整内容。
• 同时，对于回复（子评论），我们也考虑了其父级评论的审核状态，如果父级评论也在审核中，会给出相应的提示。
• 点赞和回复等互动操作，我们也仅允许对已通过审核的评论进行。

优化用户体验与高级应用

除了上述基础的条件显示外，我们还可以根据实际的运营策略进一步优化：

1. 完全隐藏审核中的评论：如果希望审核中的评论在前端完全不可见，只需将{% if item.Status == 1 %}作为评论项的外部包裹，只有通过审核的评论才会被渲染。

   
   {% commentList comments with archiveId=archive.Id type="list" limit="10" %}
       {% for item in comments %}
       {% if item.Status == 1 %} {# 仅显示已通过审核的评论 #}
       <div class="comment-item">
         {# 评论的正常显示内容 #}
       </div>
       {% endif %}
       {% endfor %}
   {% endcommentList %}
   

2. 个性化提示：除了简单的“审核中”，你可以在模板中自定义更详细、更具引导性的提示文字，例如“您的评论已提交成功，我们将在24小时内完成审核，请耐心等待。”
3. 结合用户角色：虽然安企CMS模板标签不直接提供前端判断当前用户是否为管理员的功能，但在实际应用中，如果配合后端逻辑或前端登录状态的判断，可以实现仅管理员可见所有评论（包括审核中的），而普通用户仅可见已通过评论的高级功能。但这通常需要更深入的二次开发来扩展模板上下文变量。

总结

安企CMS的commentList标签及其内置的Status字段，为我们提供了在网站前端精细化展示评论的强大能力。通过灵活运用if逻辑判断，我们可以轻松区分并处理审核中的评论，无论是选择完全隐藏、给出友好提示，还是截断部分内容，都能在保障内容质量的同时，有效提升用户体验。合理规划和使用这些功能，将有助于您构建一个健康、活跃且用户友好的在线社区。

常见问题解答 (FAQ)

Q1: 为什么我设置了Status == 0，但审核中的评论还是没有显示出来？ A1: commentList标签在默认情况下，只会返回并显示Status = 1（即已通过审核）的评论。如果你希望在前端展示Status = 0（审核中）的评论，你需要在模板中显式地添加{% if item.Status == 0 %}或{% if item.Status != 1 %}的判断逻辑来渲染这些评论，否则它们不会被标签直接输出。

Q2: 我能否自定义“审核中”的提示文字或样式？ A2: 当然可以。在模板中，当您使用{% if item.Status != 1 %}判断出评论处于审核中状态时，您可以自由地在相应的代码块中插入任何HTML结构、文本内容或CSS样式，以满足您的设计和用户体验需求。例如，您可以显示“评论已提交，等待管理员审核中，感谢您的参与！”或者为审核中的评论设置一个半透明的背景。

Q3: 如果我想在前端区分普通用户和管理员，让管理员能看到所有评论（包括审核中的），而普通用户只能看到已通过的，应该怎么实现？ A3: 在安企CMS的纯模板层面上，直接判断访问者是否为管理员的功能标签通常不直接提供，因为用户身份验证和权限管理更倾向于后端逻辑处理。如果您有这样的需求，可以考虑以下几种方案：

1. 后端处理：在调用commentList标签的后端控制器中，根据当前登录用户的角色，预先过滤评论列表。如果是管理员，则返回所有评论；如果是普通用户，则只返回已通过审核的评论。
2. 前端结合用户角色数据：如果您的网站已在前端通过其他方式（如JavaScript从localStorage或cookie中）获取到用户的角色信息，您可以在模板中结合JS逻辑进行判断和渲染，但这会增加前端的复杂性。
3. 模板标签扩展（二次开发）：通过二次开发安企CMS，您可以自定义一个额外的模板标签，用于判断当前用户是否具有管理员权限，并在commentList的循环中进行判断和显示。