AnQiCMS 模板如何使用 `yesno` 过滤器来指示内容是否已发布或处于草稿状态？

在网站内容管理中，清晰地标识内容的发布状态是至关重要的一环，它能帮助运营人员和访问者快速了解信息的时效性。AnQiCMS 提供了灵活的模板系统，让我们可以便捷地实现这一需求。今天，我们将探讨如何巧妙运用 AnQiCMS 模板内置的 yesno 过滤器，来优雅地呈现内容的发布或草稿状态。

理解 AnQiCMS 中的内容发布状态

在 AnQiCMS 系统中，您创建的每一条内容（无论是文章、产品，还是单页面）通常都会关联一个状态字段。这个字段在后台控制着内容是否在前台可见。通常，当内容被设置为“已发布”时，其状态值会是 true，而当内容处于“草稿”或“待审核”状态时，其状态值则可能为 false 或 nil（空值）。了解这一点，是我们利用 yesno 过滤器的基础。

yesno 过滤器的工作原理

yesno 过滤器是 AnQiCMS 模板系统提供的一个实用工具，它能够根据变量的布尔值（true、false 或 nil/unknown）返回不同的字符串。它的基本语法是 {{ 变量 | yesno }}。

默认情况下，yesno 过滤器会返回以下三种状态：

• 如果变量为 true，则返回 "yes"。
• 如果变量为 false，则返回 "no"。
• 如果变量为 nil 或无法识别的布尔值，则返回 "maybe"。

然而，仅仅显示 “yes” 或 “no” 显然不符合我们展示发布状态的需求。yesno 过滤器真正的强大之处在于它允许您自定义这三种状态所对应的输出字符串。您可以像这样传递参数：{{ 变量 | yesno:"真值,假值,未知值" }}。

巧用 yesno 过滤器呈现内容发布状态

现在，我们将 yesno 过滤器应用于内容的发布状态。假设我们正在遍历一个内容列表，或者在内容的详情页中，我们希望显示该内容的发布状态。通常，内容的状态字段在 AnQiCMS 模板中可以表示为 archive.Status 或 item.Status（取决于您在 archiveList 等标签中定义的变量名）。

基本用法和默认输出： 如果我们直接使用 {{ archive.Status|yesno }}，可能会得到 “yes”、”no” 或 “maybe” 这样的结果。这虽然表达了状态，但不够直观。

自定义输出，清晰呈现状态： 为了更好地用户体验，我们可以自定义输出文本。例如，将 true 对应为“已发布”，false 对应为“草稿”，将 nil 或未知状态对应为“待审核”或“未知状态”。

{# 假设 archive.Status 为 true 代表已发布，false 代表草稿 #}
{# 在内容详情页或循环中的每一项内容（item）都可以这样使用 #}

<p>内容标题：{{ archive.Title }}</p>
<p>发布状态：
    <span class="status-indicator">
        {{ archive.Status|yesno:"已发布,草稿,待审核" }}
    </span>
</p>

{# 在一个内容列表的循环中 #}
{% archiveList archives with type="list" limit="10" %}
    {% for item in archives %}
        <div>
            <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
            <p>
                当前状态：
                <span class="content-status content-status-{{ item.Status|yesno:"published,draft,pending" }}">
                    {{ item.Status|yesno:"已发布,草稿,待审核" }}
                </span>
            </p>
            <p>{{ item.Description }}</p>
        </div>
    {% empty %}
        <p>暂无内容。</p>
    {% endfor %}
{% endarchiveList %}

在上面的代码示例中，我们不仅利用 yesno 过滤器直接输出了友好的中文状态描述，还巧妙地将其返回值（”published”、”draft”、”pending”）作为 CSS 类名的一部分。这样，您就可以通过 CSS 样式为不同状态的内容添加不同的颜色或视觉效果，进一步提升界面的直观性。

yesno 过滤器与 if 标签的选择

您可能会问，既然 {% if archive.Status %}已发布{% else %}草稿{% endif %} 也能实现类似效果，为什么要选择 yesno 过滤器呢？

这两者各有侧重：

• if 标签： 主要用于控制模板中不同 HTML 结构的显示或执行复杂的条件逻辑。例如，如果已发布就显示一个按钮，如果是草稿就显示另一个不同的按钮。
• yesno 过滤器： 更适用于简洁地将一个布尔值（或可转换为布尔值的值）转换为文本输出。当您只需要根据状态显示不同的文字，而不需要改变 HTML 结构或执行复杂逻辑时，yesno 过滤器让模板代码更简洁、更易读，尤其是在表格列、卡片视图等需要在一行内快速展示状态的场景。

总结

yesno 过滤器是 AnQiCMS 模板系统中一个虽小但功能强大的工具。通过灵活自定义其输出值，您可以将后台的内容发布状态直观、友好地呈现在网站前台，无论是用于列表概览还是内容详情页，都能有效提升网站的可用性和用户体验。掌握这个过滤器，将帮助您更高效地进行内容运营和模板开发。

常见问题 (FAQ)

Q1: yesno 过滤器能处理非布尔值吗？例如，我的状态字段是数字 (0/1) 或字符串 (“true”/“false”) 怎么办？ A1: 是的，yesno 过滤器具有一定的智能转换能力。它会尝试将非布尔值（如数字 0/1、字符串 “true”/“false”）转换为布尔值处理。通常，非零数字或字符串 “true” 会被视为 true，而数字 0 或字符串 “false” 则会被视为 false。其他无法识别的非空值或 nil 值则会触发“未知状态”的返回。所以，即便您的状态字段存储的是数字或特定字符串，yesno 通常也能正常工作。

Q2: 如果我只需要“是”或“否”两种状态，不想处理“未知”状态，yesno 过滤器还能用吗？ A2: 当然可以。如果您只关心 true 和 false 两种情况，并且不希望处理或显示 nil 或未知状态，您可以只提供两个自定义值。例如：{{ archive.Status|yesno:"上线中,下线" }}。在这种情况下，如果 archive.Status 为 nil 或无法转换为布尔值，yesno 将返回第二个值，即