在数字时代，网站不仅仅是信息发布的平台，更是用户交流和互动的重要空间。用户评论作为网站内容生态中不可或缺的一部分，能够有效提升用户参与度，为内容创作者提供宝贵的反馈，甚至驱动搜索引擎优化（SEO）的积极效应。作为一名资深的网站运营专家，我深知一套高效、灵活的评论管理系统对网站运营的重要性。今天，我们将深入探讨如何在 AnQiCMS 网站中管理和显示用户评论，让您的网站充满活力。

AnQiCMS 作为一款基于 Go 语言开发的企业级内容管理系统，以其高效、安全和易扩展的特性，为中小企业和内容运营团队提供了强大的支持。在不断迭代更新中，AnQiCMS 从 v1.0.0-alpha 版本开始便新增了文章评论和评论管理功能，持续致力于完善用户互动体验。

评论管理的艺术：后台操作详解

高效的评论管理是网站健康运营的基础。AnQiCMS 在后台提供了直观且功能丰富的评论管理界面，让您能够轻松应对各类用户评论。

在 AnQiCMS 的后台，您可以轻松导航至“功能管理”菜单，并在其中找到“内容评论管理”项。这里便是您掌控所有用户评论的核心枢纽。评论列表将清晰地展示每条评论的详细信息，包括评论者、评论内容、所属文章、发布时间以及最为关键的——审核状态。

AnQiCMS 的评论管理允许您执行以下主要操作：

  • 查看评论详情：深入了解每条评论的上下文，包括回复关系。
  • 审核与发布：您可以选择批准合法评论，使其在前端显示；对于不合规或恶意评论，您可以拒绝发布。
  • 编辑评论：在特定情况下，例如修正错别字或调整措辞，您可以在后台对评论内容进行修改。
  • 删除评论：对于垃圾信息或违规内容，您可以将其彻底删除，保持评论区的清洁与秩序。
  • 回复评论：直接在后台对用户评论进行回复，促进与用户的互动。

为了进一步保障评论区的健康，AnQiCMS 也提供了多重安全机制。通过配置敏感词过滤，您可以有效拦截不当言论。同时，结合前端评论提交时使用的验证码机制（我们将在前端展示部分详述），能够大幅降低恶意灌水和机器人评论的风险，确保评论内容的真实性和有效性。这些内置的防采集和内容安全管理功能，为网站的稳定运行提供了坚实保障。

将评论呈现在用户眼前：前端展示的灵活策略

评论后台管理得再好，最终还是要展现在用户面前。AnQiCMS 提供了强大的模板标签，让您能够高度定制评论在网站前端的展示方式。

核心标签：commentList 掌控评论数据

在 AnQiCMS 的模板设计中，commentList 标签是展示用户评论的核心。这个标签具有极高的灵活性，可以根据您的需求调用特定文章的评论，并以列表或分页的形式呈现。

使用 commentList 标签时，您需要指定以下关键参数：

  • archiveId：这是必需的参数，用于指定您希望显示评论的文章 ID。例如，archiveId=archive.Id 表示获取当前文章的评论。
  • type：评论的显示类型，可以选择 list（列表形式，一次性显示指定数量）或 page（分页形式，结合 pagination 标签实现分页浏览）。
  • limit：当 type 为 list 时，此参数决定要显示的评论数量；当 type 为 page 时，则用于定义每页显示的评论数量。
  • order：您可以根据评论的 ID 进行排序，例如 order="id desc" 表示按 ID 倒序排列。
  • siteId：如果您启用了多站点管理，可以通过此参数调用特定站点的评论数据。

通过 commentList 标签获取到的每条评论数据，都会包含丰富的字段，如评论 ID (Id)、评论者名称 (UserName)、评论内容 (Content)、发布时间 (CreatedTime)、审核状态 (Status) 以及上级评论信息 (Parent)。

例如，一段基本的评论列表展示代码可能看起来像这样，它能够清晰地显示评论内容，并处理审核中的评论：

{% commentList comments with archiveId=archive.Id type="list" limit="6" %}
    {% for item in comments %}
    <div>
      <div>
        <span>
          {% if item.Status != 1 %} 审核中：{{item.UserName|truncatechars:6}}
          {% else %} {{item.UserName}}
          {% endif %}
        </span>
        {% if item.Parent %}
        <span>回复</span>
        <span>
          {% if item.Status != 1 %} 审核中：{{item.Parent.UserName|truncatechars:6}}
          {% else %} {{item.Parent.UserName}}
          {% endif %}
        </span>
        {% endif %}
        <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
      </div>
      <div>
        {% if item.Parent %}
        <blockquote>
          {% if item.Parent.Status != 1 %} 该内容正在审核中：{{item.Parent.Content|truncatechars:9}}
          {% else %} {{item.Parent.Content|truncatechars:100}}
          {% endif %}
        </blockquote>
        {% endif %}
        {% if item.Status != 1 %} 审核中：{{item.Content|truncatechars:9}}
        {% else %} {{item.Content}}
        {% endif %}
      </div>
      <div class="comment-control" data-id="{{item.Id}}" data-user="{{item.UserName}}">
        <a class="item" data-id="praise">赞(<span class="vote-count">{{item.VoteCount}}</span>)</a>
        <a class="item" data-id=reply>回复</a>
      </div>
    </div>
    {% endfor %}
{% endcommentList %}

评论分页展示：优化用户体验

当评论数量较多时，将其分页显示能够显著提升页面加载速度和用户体验。通过将 commentList 标签的 type 参数设置为 page，并结合 pagination 标签，您可以轻松实现评论的分页功能。

pagination 标签会根据 commentList 提供的数据生成首页、上一页、页码列表、下一页和末页等分页导航元素。您可以自定义显示页码的数量，例如 show="5" 会显示当前页附近的最多 5 个页码链接。

互动无限：评论提交与点赞功能

为了构建一个真正活跃的社区，用户不仅能阅读评论，还能参与其中。AnQiCMS 为此提供了评论提交表单和评论点赞功能。

评论提交表单：用户可以通过表单提交他们的评论。这个表单通常需要以下字段：

  • archive_id：当前文章的 ID，让评论知道它属于哪篇文章。
  • user_name：评论者的昵称。
  • content：评论的具体内容。
  • parent_id：如果这是一个回复评论，则需要填写被回复评论的 ID，以建立评论间的层级关系。
  • return：您可以指定提交后后台返回的格式，例如 html 或 json。

表单提交的后端接收地址为 /comment/publish。为了增强安全性，我们强烈建议为评论表单集成验证码。tag-captcha.md 文档中详细介绍了如何通过 JavaScript 调用 /api/captcha 接口获取验证码图片和 ID，并将其嵌入评论表单中，有效防范机器人提交。

评论点赞功能：用户可以通过点赞表达对某条评论的认可。点赞功能通常通过异步 JavaScript 请求实现，向 /comment/praise 地址提交评论的 id。后端会处理点赞计数，并返回 JSON 格式的结果，前端可以根据结果实时更新点赞数。

精细化评论运营，提升用户参与度

管理和展示评论只是第一步，要让评论区真正成为网站的亮点，还需要精细化的运营：

  1. 及时审核与互动：确保评论能够