Bricks 中文文档：bricks/dynamic_data/user_value

前言

通过此筛选器修改元素的根属性（例如 ID、class）。

用法

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

add_filter( 'bricks/dynamic_data/user_value', function( $value, $field_type, $filters ) {
    // Example: Capitalize the user role
    if ( $field_type === 'role' && is_string( $value ) ) {
        return ucfirst( $value );
    }


    return $value;
}, 10, 3 );

参数

• $value (mixed)：user 字段的值。
• $field_type (string)：正在被检索的特定 user 字段（例如 email、login、first_name、last_name、bio、picture、role、registered_date）。
• $filters (array)：应用于标签的修饰符数组。

示例代码

筛选返回值

add_filter( 'bricks/dynamic_data/user_value', function( $value, $field_type, $filters ) {
    // Example: Capitalize the user role
    if ( $field_type === 'role' && is_string( $value ) ) {
        return ucfirst( $value );
    }


    return $value;
}, 10, 3 );

根据条件短路返回原值

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

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

补充说明

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