说明：用于获取文档的评论列表、评论分页列表

使用方法： 如将变量定义为 comments …

commentList 支持的参数有：

• 评论文档ID archiveId
archiveId 为指定的文档ID；
• 评论排序 order
order 可以指定显示的排序规则，支持依据 id正序排序 order=“id desc”、按id倒叙排序 order=“id desc”；
• 显示数量 limit数量的列表，比如limit=“10”则只会显示10条，limit 在不是分页列表的时候，支持offset模式，也就是 ,分隔模式，如想从第2条开始，获取10条数据，可以设置成 limit=“2,10”；
• 列表类型 type
type 支持按 page、list 方式列出。默认值为list，如果type=“page” 后续可用 分页标签 pagination 来组织分页显示 。
• 站点ID siteId
siteId 一般不需要填写，如果你使用后台的多站点管理创建了多个站点，并且想调用其他站点的数据，则可以通过指定 siteId 来实现调用指定站点的数据。

comments 是一个数组对象，因此需要使用 for 循环来输出

item 为 for循环体内的变量，可用的字段有：

• 评论ID Id
• 类型内容ID ArchiveId
• 用户名 UserName
• 用户ID UserId
• 用户IP Ip
• 点赞数量 VoteCount
• 评论内容 Content
• 上级评论ID ParentId
• 审核状态 Status Status = 1 表示审核通过， status = 0 时审核中，不要显示出来
• 上级评论的对象数据 Parent Parent 包含上级评论的完整 item，字段和评论item相同
• 添加时间 CreatedTime 时间戳，需要使用格式化时间戳为日期格式 }

常规评论列表

<div>


<div>
  <div>
    <span>

      审核中：}

      }

    </span>

    <span>回复</span>
    <span>

      审核中：}

      }

    </span>

    <span>}</span>
  </div>
  <div>

    <blockquote>

      该内容正在审核中：}

      }

    </blockquote>


      该内容正在审核中：}

    }

  </div>
  <div class="comment-control" data-id="}" data-user="}">
    <a class="item" data-id="praise">赞(<span class="vote-count">}</span>)</a>
    <a class="item" data-id=reply>回复</a>
  </div>
</div>


</div>

分页展示评论列表

<div>


<div>
  <div>
    <span>

      审核中：}

      }

    </span>

    <span>回复</span>
    <span>

      审核中：}

      }

    </span>

    <span>}</span>
  </div>
  <div>

    <blockquote>

      该内容正在审核中：}

      }

    </blockquote>


      该内容正在审核中：}

    }

  </div>
  <div class="comment-control" data-id="}" data-user="}">
    <a class="item" data-id="praise">赞(<span class="vote-count">}</span>)</a>
    <a class="item" data-id=reply>回复</a>
  </div>
</div>


</div>

<div>

<ul>
    <li>总数：}条，总共：}页，当前第}页</li>
    <li class="active"><a href="}">}</a></li>

        <li><a href="}">}</a></li>


        <li class="active"><a href="}">}</a></li>


        <li><a href="}">}</a></li>

    <li class="active"><a href="}">}</a></li>
</ul>


</div>

评论表单提交

评论使用form表单提交，提交后台接收的地址为：/comment/publish 。需要提交的字段有

表单代码示例

<form method=“post” action=“/comment/publish”>
  <input type=“hidden” name=“return” value=“html”>
  <input type=“hidden” name=“archive_id” value=“”>
  <div>


<label>用户名</label>
<div>
  <input type="text" name="user_name" required lay-verify="required" placeholder="请填写您的昵称" autocomplete="off">
</div>


</div>
  <div>

<label>评论内容</label>
<div>
  <textarea name="content" placeholder="" id="comment-content-field" rows="5"></textarea>
</div>


</div>
  <div>

<div>
  <button type="submit">提交评论</button>
  <button type="reset">重置</button>
</div>


</div>
</form>

评论内容点赞

可以给某条评论的内容点赞，点赞使用form表单提交，点赞提交后台接收地址为：/comment/praise 。点赞需要提交的字段有：

评论点赞只支持返回 json 格式的数据，因此需要用 js post 来提交。

示例代码

<div class=“comment-control”>
  <a class=“item vote-comment” data-id=“praise” data-id=“}”>赞(<span class=“vote-count”>}</span>)</a>
</div>

$(‘.vote-comment’).click(function(e) {


    let that = $(this);
    let commentId = $(this).data('id');

    //赞
    $.ajax({
        url: '/comment/praise',
        method: "post",
        data: ,
        dataType: "json",
        success: function (res) {
            if(res.code === 0) {
              alert(res.msg);
              that.find('.vote-count').text(res.data.vote_count)
            } else {
                alert(res.msg);
            }
        },
        error: function (err) {
            alert(res.msg);
        }
    });
});</code></pre></div>