Bricks 中文文档：bricks/dynamic_data/format_value

前言

筛选单个动态数据标签的图标。可用于为自定义标签设置自定义图标。

用法

将代码加入子主题的 functions.php：

add_filter( 'bricks/dynamic_data/format_value', function( $value, $tag, $post_id, $filters, $context ) {
    // Example: Add a suffix to the post title when used in text context
    if ( $tag === 'post_title' && $context === 'text' ) {
        return $value . ' | My Site';
    }


    return $value;
}, 10, 5 );

参数

• $value (mixed)：动态标签的处理值。
• $tag (string)：动态数据标签（例如 post_title、my_custom_tag）。
• $post_id (int)：文章上下文的 ID。
• $filters (array)：应用于标签的修饰符/参数数组（例如 [‘fallback’ => ‘…’]）。
• $context (string)：标签被渲染所处的上下文（例如 text、link、image、video、object、media）。

示例代码

筛选返回值

add_filter( 'bricks/dynamic_data/format_value', function( $value, $tag, $post_id, $filters, $context ) {
    // Example: Add a suffix to the post title when used in text context
    if ( $tag === 'post_title' && $context === 'text' ) {
        return $value . ' | My Site';
    }


    return $value;
}, 10, 5 );

根据条件短路返回原值

根据条件跳过或修改返回值：

add_filter( 'bricks/dynamic_data/format_value', function( $value, $value ) {
    if ( is_admin() ) { return $value; }
    // TODO: custom logic here
    return $value;
} );

补充说明

更多细节可参考 官方文档。