钩子文档

post_states_html

💡 云策文档标注

概述

post_states_html 是一个 WordPress 过滤器,用于修改文章状态显示的 HTML 字符串。它允许开发者自定义文章状态(如草稿、置顶)的 HTML 输出。

关键要点

  • 过滤器名称:post_states_html
  • 参数:$post_states_html(HTML 字符串)、$post_states(状态映射数组)、$post(WP_Post 对象)
  • 用途:过滤文章状态的 HTML 显示,常用于自定义状态标签或样式

代码示例

$post_states_html = apply_filters( 'post_states_html', $post_states_html, $post_states, $post );

📄 原文内容

Filters the HTML string of post states.

Parameters

$post_states_htmlstring
All relevant post states combined into an HTML string for display.
E.g. <span class='post-state'>Draft, </span><span class='post-state'>Sticky</span>.
string> $post_states A mapping of post state slugs to translated post state labels.
E.g. array( 'draft' => __( 'Draft' ), 'sticky' => __( 'Sticky' ), ... ).
$postWP_Post
The current post object.

Source

$post_states_html = apply_filters( 'post_states_html', $post_states_html, $post_states, $post );

Changelog

Version Description
6.9.0 Introduced.