As an experienced website operations expert, I know that how to efficiently and clearly present data status in a content management system is one of the keys to success in operations.AnQiCMS (AnQiCMS) provides an excellent solution in this aspect with its flexible template engine and rich built-in filters.filter-yesnoHow does it help AnQiCMS template handle the complex trinary logic of 'yes/no/unknown'.

Trinary logic in AnQiCMS template: filter-yesnoHow the filter helps you present data status accurately

In daily content operation, we often encounter a scenario where a data field is not just covered by simple 'yes' or 'no'.It may exist in a third state - neither explicitly "yes" nor explicitly "noif-else) to handle, often leads to code bloat, logic confusion, and even ambiguous information for users. AnQi CMS is well-versed in this, cleverly introducingfilter-yesnoFilter, providing an elegant solution for template developers and content operators.

Analysis of 'three-state logic': beyond the simple 'yes' and 'no'

In the traditional sense, Boolean values only have two states: True and False.However, in actual business scenarios, this simple binary judgment is often not enough.

  • Article publishing statusAn article can be 'Published' (yes), or 'Draft' (no), but there is also a case of 'Pending Review' or 'Scheduled Release' (unknown).
  • User Subscription Preferences: The user may explicitly subscribe (yes), explicitly unsubscribe (no), or may also be 'unspecified preference' or 'awaiting confirmation' (unknown).
  • Module switch function: A feature may be 'enabled' (yes), 'disabled' (no), but it may also be 'not configured' or 'default inherited' (unknown).

In this case, if the 'unknown' status is simply categorized as 'no', it may mislead users or cause a deviation in data presentation. Andfilter-yesnoIt is exactly born to solve such problems.

filter-yesnoFilter: The core of template processing trinary logic

filter-yesnoIs an Anqi CMS template engine a very practical built-in filter, the core function of which is to map the three different states of variables (truth value, false value, null/unknown value) to clear text output.Its design philosophy lies in simplifying conditional judgments in templates, making the presentation of data states more intuitive.

Basic usage and default output

filter-yesnoThe simplest usage is to filter a variable directly:

{{ obj|yesno }}

In this default mode,filter-yesnoIt will be based onobjThe actual value, output one of the following three results:

  • IfobjThe value is evaluated as:Trueit will output:"yes".
  • IfobjThe value is evaluated as:Falseit will output:"no".
  • Ifobjhas a value ofEmpty (Nil/None)Or undefined, it will output"maybe".

For example, if your article object has aIsPublishedField:

<p>文章状态：{{ article.IsPublished|yesno }}</p>
  • Whenarticle.IsPublishedWithtrueThen display: "Article status: yes"
  • Whenarticle.IsPublishedWithfalseWhen, display: "Article status: no"
  • Whenarticle.IsPublishedWithnilWhen, display: "Article status: maybe"

Custom output: accurately express business meaning

Although the default 'yes', 'no', 'maybe' are sufficient in many cases, in actual business scenarios, we may need more contextualized descriptions.filter-yesnoAllow you to customize the output text of these three states, just pass three strings separated by commas after the filter:

{{ obj|yesno:"自定义True值,自定义False值,自定义未知值" }}

Let's go back to the example of the article publishing status, in order to express the business meaning more clearly, we can customize it like this:

<p>文章状态：{{ article.IsPublished|yesno:"已发布,草稿,待审核" }}</p>
  • Whenarticle.IsPublishedWithtrueIt will display: "Article status: Published"
  • Whenarticle.IsPublishedWithfalseWhen, it displays: 'Article status: Draft'
  • Whenarticle.IsPublishedWithnilFor example, when the field is not set or NULL in the database, it displays: 'Article status: Pending review'

This approach greatly improves the readability and context adaptability of the template, making the data status displayed on the front end perfectly match the business logic of the background.

Practical exercise:filter-yesnoTypical application scenarios

In the template development of AnQi CMS,filter-yesnoThe application is everywhere, it can effectively replace complexif-elif-elsestructure, making template code more concise:

  1. status display in the management background listWhen displaying lists of articles, products, users, etc., it is necessary to quickly preview their status.

    {% for article in articles %}
    <tr>
        <td>{{ article.Title }}</td>
        <td>{{ article.IsPublished|yesno:"上线,下线,草稿" }}</td> {# 根据实际业务逻辑，nil可能代表草稿或待审 #}
        <td>{{ article.IsTop|yesno:"是,否,-" }}</td> {# '-' 表示未设置或不适用置顶 #}
    </tr>
{% endfor %}

    Here, we use a concise filter to clearly show the publication status and pinned status of the article, avoiding long conditional judgments.

  2. User Center Personalized Settings: Some user preferences on the website may not have been actively chosen by the user.

    <p>接收通知：{{ user.ReceiveNewsletter|yesno:"开启,关闭,未设置" }}</p>
<p>VIP会员：{{ user.IsVIP|yesno:"是,否,普通用户" }}</p> {# 假设nil或false都归为普通用户 #}

    Byfilter-yesnoUsers can clearly see their setting status, and the reminder of 'not set' can also guide users to perform operations.

  3. Function module enabled statusIn some areas of the website, whether a certain feature (such as comments, share buttons) is displayed or not may be decided by the backend configuration.

    <p>评论功能：{{ system.EnableComments|yesno:"已启用,已禁用,默认" }}</p>
<p>分享按钮：{{ system.EnableShare|yesno:"显示,隐藏,未配置" }}</p>

    here,system.EnableCommentsIf it isnilIt may indicate that the system default configuration is being used, or that no explicit enable/disable settings have been made in the background.

Why choosefilter-yesnoWhat is its value?

filter-yesnoThe filter is not just a means to implement 'yes/no/unknown', its real value lies in:

  • Enhance the simplicity and readability of the template: Encapsulate complex conditional judgment logic in a filter to make the template code cleaner, easier to understand, and reduce redundancy.if/elseNested.
  • Strengthen the clarity of logical expression.: Clearly distinguished boolean valuestrue/falsewithnil(Unknown) status makes the presentation of data status more accurate, avoiding possible misunderstandings due to information ambiguity
  • Optimize content operation efficiency: Operators can obtain the most accurate status information intuitively from the front end while viewing or configuring content, which reduces the cost of guessing and verification.
  • Easy to maintain and expandWhen you need to adjust the text description of the state, you only need to modify one filter parameter without changing multiple condition judgment statements, which greatly reduces the maintenance cost.

In short,filter-yesnoIt is a small but powerful tool in the AnQi CMS template, which reflects the meticulous consideration of AnQiCMS in detail, aiming to provide users with an efficient and clear content management and display solution.Master and flexibly use this filter to make your AnQiCMS template more expressive and present content with more layers.

Frequently Asked Questions (FAQ)

Q1:filter-yesnoDoes the filter only apply to boolean data types?A1:filter-yesnoThe filter can also be used for explicit boolean types (