In the Safe CMS, one of the core aspects of content management is to control the document status, which directly relates to the visibility of website content and the review process. When you go througharchive/listThe document list returned by the interface, in the returned data,statusThe field bears this critical responsibility. Understanding the meaning of this field can help you manage website content more efficiently and ensure that information is presented to visitors correctly.

status字段：Document Visibility and Approval Status Weather Map

Inarchive/listEach document (archive item) in the return result of the interface will include a field namedstatusThe integer field.The purpose of this field is to explicitly indicate the display status of the current document and the review stage it is in.In simple terms, it tells you whether this document has been publicly released, is under review, or is in some other non-public status.

According to the document description of AnQi CMS,statusthe fields mainly have two core values, representing the most common two states of the document:

  • statusThe value is1:This indicates that the document has passed review and is in a "published" or "normal display" status. When you see a document'sstatusWhen it is 1, it can be confirmed that it is visible to front-end users, will appear on the corresponding list page and detail page of the website, and can be normally indexed by search engines.This is the final public status that the content publisher wishes to achieve.
  • statusThe value is0:statusthe value has been updated to1.

Considerations in practical application

UnderstandingstatusThe meaning of these fields is of great practical value for the daily operation and development of the website:

  1. Front-end display logic:For front-end developers,statusThe field is the key to controlling content display. When building a website, it is usually set to display onlystatusresponse for1The document, to ensure that users can only see approved and published content. This effectively prevents incomplete drafts, sensitive content, or incorrect information from being accidentally leaked.

  2. Content review process:For content editors and operators,statusthe field is a direct reflection of the internal workflow. After a new content submission,statusThe default is0English prompt for reviewers to review. Once the content meets the release standards, reviewers willstatusUpdate to1Thus, the publishing process is completed. This ensures the quality and compliance of the website content.

  3. Data Analysis and Management:By processingstatusThe analysis of the field can quickly understand the proportion of content that has been published and content to be published on the website, thereby evaluating the efficiency of content production and review. For example, if a large number of documents remain unchanged for a long time,status=0It may mean that there are bottlenecks in the review process.

It is worth mentioning that in Anqi CMS, not only documents, but also modules such as comments, categories, tags, and even uploaded attachments, have adopted a similar approach.statusField indicates their respective visibility or review status. This unified design concept makes it very consistent and intuitive to manage and understand content status throughout the CMS system.

In short,archive/listReturned by the interface.statusThe field is not just a simple number, it is an effective tool for understanding and controlling the lifecycle of the AnQi CMS website content, ensuring the quality of publication and user experience.

Common Questions (FAQ)

Q1:archive/listReturned by the interface.statusField has other possible values besides 0 and 1?

A1:According to the document description of AnQi CMS, for the visibility or review status of documents,statusthe field mainly manifests as0Under review/Not published and1(Reviewed/Published). In certain cases, there may be other status values internally in the system (for example, items taken down or deleted by administrators), but for public content interfaces,0and1It is the most common and core state that needs to be paid attention to. It is recommended to take the document as the standard in actual development and make compatibility handling for possible unknown state values.

Q2: Can I directly througharchive/listInterface filters specificstatusdocument? For example, only get published documents?

A2:checkarchive/listrequest parameters for the interface, which currently do not provide direct filtering bystatusThe parameter for filtering fields. Anqi CMS usually returns published documents by default in design. If you need to filter out the documents thatstatusresponse for0or1Perform precise filtering of the document, usually after obtaining the complete list of documents, and traversing and filtering in your application layer code so that you can base onstatusThe value determines which content needs to be displayed or processed.

Q3: If I visit astatusdetail page of a document with a value of 0, what will I see?

A3:In most cases, if the document'sstatusresponse for0(Under review or not published), frontend users cannot access the details page through regular links. Anqi CMS will base its processing on the content of thestatusMake a judgment.This means you may see prompts such as 'Page not found', 'Content under review', or 'Access denied', etc., the specific content displayed depends on your website template configuration and the system settings of the Anqi CMS backend.This is an important security mechanism, ensuring that only content that has passed the review can be accessed by the public.