In website operation, user comments are undoubtedly an important way to enhance website interactivity, accumulate community content, and obtain user feedback.For AnQiCMS users, it is crucial to understand which core fields are required for comment submission form, as this not only concerns whether the comment can be successfully published, but also directly affects user experience and the richness of website content.As an experienced website operation expert, today I will deeply analyze the necessary fields and their logic behind the AnQiCMS comment submission form.

The comment submission mechanism of AnQiCMS is designed to be intuitive and efficient, it receives comment data from the front-end page through a unified interface.To make a comment successfully settle on your AnQiCMS website, your submission form must meet several basic requirements.

Firstly, and most fundamentally, all comment data must pass throughPOSTThe request method sends to the preset comment release interface of AnQiCMS:/comment/publish. This is the first threshold for receiving data in the comment system.

Next, let's take a look at the indispensable fields in the form:

The core fields of the 'Iron Triangle' for comment submission

  1. archive_id(Corresponding document ID)This is the key for comments to 'find home'.Each comment must clearly indicate which article, product, single page, or other content it is aimed at.If this ID is not present, AnQiCMS will not know which specific content item this comment belongs to, and the comment will naturally fail to be published successfully.archiveDetailTag to dynamically get the document ID of the current page. For example,{% archiveDetail with name="Id" %}You can easily get the ID of the current content and add it as a hidden field to the form.

  2. user_name(Username of the comment)Whether your website requires users to log in to comment or not, each comment needs an identifier of the poster. Even if it's just a simple nickname,user_nameThe field also assigns the 'speaker' attribute to comments. This is the most basic form of identification, ensuring that comments have ownership.

  3. content(Comment content)This is the soul of the comment, carrying all the text information that the user wants to express. Without content, the comment loses its meaning. Therefore,contentThe field is absolutely necessary, it receives the actual user input text.

These fields -archive_id/user_nameandcontent——It constitutes the "Iron Triangle" of AnQiCMS comment submission, which is the foundation for successful comment publication and cannot be missing.

An auxiliary field to enhance the interactive experience

In addition to the above core fields, AnQiCMS also provides several optional fields that can help you build a richer and more interactive comment feature:

  1. parent_id(Parent Comment ID)When you want to implement the reply feature of comments, so that users can follow up or supplement a specific comment,parent_idThe field comes into play. By carrying the replied comment in the reply comment formIDasparent_id，AnQiCMS can associate this comment with the parent comment, forming a clear comment hierarchy structure, greatly enhancing the depth of discussion and the participation of users.

  2. return(submit after returning the format)This field is very useful for developers who need to highly customize frontend interactions.returnThe field allows you to specify the format of the data returned by the AnQiCMS backend after the comment submission. You can set it tohtml(Default value, returns a rendered HTML fragment, convenient for direct insertion into the page) orjson(Returns JSON formatted data, convenient for frontend for more complex processing and rendering).

Ensure the dynamic field of comment security: captcha

In terms of website security and anti-spam comments, the Captcha mechanism is an important feature provided by AnQiCMS.It is worth noting that the fields related to the captcha are not always required, their presence depends on whether you have enabled the comment captcha feature in the AnQiCMS backend (usually under the "Function Management" under the "Content Comment" settings).

Once the background has enabled the comment captcha, then the following two fields must be additionally included in your submission form:

  1. captcha_idThis is the unique identifier for the captcha, the backend uses it to recognize and verify whether the captcha entered by the user is correct.This ID is usually dynamically obtained from the AnQiCMS captcha API via JavaScript.

  2. captchaThis is the character that the user sees in the front-end captcha image and manually inputs. The backend will compare it withcaptcha_idthe correct answer associated with it.

If the backend has enabled the captcha and the front-end form has not submitted these two fields correctly, the comment cannot be published.Therefore, when the captcha feature is enabled, these two fields become dynamic 'required fields'.

Comprehensive example: a typical comment submission form structure

To give everyone a more intuitive understanding, here is a simplified example of an HTML form structure that includes core fields: 

<form method="post" action="/comment/publish">
  <!-- 必需字段：对应内容的ID，通常作为隐藏字段 -->
  <input type="hidden" name="archive_id" value="{% archiveDetail with name="Id" %}" />

  <!-- 必需字段：评论者的名称 -->
  <label for="user_name">您的昵称:</label>
  <input type="text" id="user_name" name="user_name" placeholder="请输入您的昵称" required />

  <!-- 必需字段：评论内容 -->
  <label for="comment_content">评论内容:</label>
  <textarea id="comment_content" name="content" rows="5" placeholder="请在此输入您的评论" required></textarea>

  <!-- 可选字段：如果这是回复评论，需要提供被回复评论的ID -->
  <!-- <input type="hidden" name="parent_id" value="[被回复评论的ID]" /> -->

  <!-- 可选字段：指定返回格式，通常在需要自定义JS处理时使用 -->
  <!-- <input type="hidden" name="return" value="json" /> -->

  <!-- 验证码字段：如果后台启用了验证码，这两个字段和对应的JS是必需的 -->
  <!-- <input type="hidden" name="captcha_id" id="captcha_id"> -->
  <!-- <input type="text" name="captcha" id="captcha_input" placeholder="请输入验证码" required> -->
  <!-- <img src="" id="get-captcha" alt="验证码图片" style="cursor: pointer;"> -->
  <!-- 对应的JavaScript代码来获取和显示验证码图片 -->

  <button type="submit">提交评论</button>
</form>

Summary

In summary, the core of the AnQiCMS comment submission form isarchive_id/user_nameandcontentthese three fields. On this basis,parent_idit can realize hierarchical interaction of comments,returnThe field provides flexibility in backend responses. When the website is enabled with secure verification,captcha_idandcaptchait will also become a required item.

Understanding and correctly configuring these fields will ensure that your AnQiCMS website's comment function runs smoothly, providing users with a good interactive experience and bringing valuable user-generated content to the website.

Frequently Asked Questions (FAQ)

  1. Ask: Why can't I see my comment on the page after submitting it?There are several possible reasons. First, please check if your form includesarchive_id/user_nameandcontentThese three fields are required.Secondly, the AnQiCMS backend usually enables comment review functionality, your comment may be waiting for administrator review.You can log in to the backend to view the "Content Comments" list under "Function Management" and confirm the comment status.captcha_idandcaptchathe field has been submitted correctly.

  2. How do I implement the reply feature for comments?To implement comment replies, you need to add an additional hidden field to the form for submitting reply comments.parent_idAnd set its value to the comment you want to reply toIDWhen the user clicks the "Reply" button, the front-end JS can capture the ID of the replied comment and fill it into the reply form.parent_idIn the field, so that AnQiCMS can recognize it as a reply.

  3. Question:archive_idWhere should the value of this field be obtained?Answer:archive_idIt usually represents the unique identifier of the current article, product, or page. In the AnQiCMS front-end template, you can usearchiveDetailLabel to easily get the current content ID, for example, on the article detail page{% archiveDetail with name="Id" %}. This value should be placed as a hidden field in the comment submission form to ensure that each comment can be correctly associated with its content.