{
  "name": "bricks/dynamic_data/user_value",
  "kind": "filter",
  "url": "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-dynamic_data-user_value/",
  "scraped_at": "2026-08-29",
  "hook_name": "bricks/dynamic_data/user_value",
  "description": {
    "en": "Filters the value returned by {wp_user_...} dynamic data tags (e.g., {wp_user_email} , {wp_user_role} ).",
    "zh": "通过此筛选器修改元素的根属性（例如 ID、class）。"
  },
  "parameters": [
    {
      "name": "value",
      "type": "mixed",
      "type_zh": null,
      "description": {
        "en": "The value of the user field.",
        "zh": "user 字段的值。"
      }
    },
    {
      "name": "field_type",
      "type": "string",
      "type_zh": null,
      "description": {
        "en": "The specific user field being retrieved (e.g., email , login , first_name , last_name , bio , picture , role , registered_date ).",
        "zh": "正在被检索的特定 user 字段（例如 email、login、first_name、last_name、bio、picture、role、registered_date）。"
      }
    },
    {
      "name": "filters",
      "type": "array",
      "type_zh": null,
      "description": {
        "en": "Array of modifiers applied to the tag.",
        "zh": "应用于标签的修饰符数组。"
      }
    }
  ],
  "example_usage": "add_filter( 'bricks/dynamic_data/user_value', function( $value, $field_type, $filters ) {\n    // Example: Capitalize the user role\n    if ( $field_type === 'role' && is_string( $value ) ) {\n        return ucfirst( $value );\n    }\n\n\n    return $value;\n}, 10, 3 );"
}