📄 原始资料 | 展开查看原始 JSON（bricks-woocommerce-predefined_elements-remote_payload.json）{ “name”: “bricks/woocommerce/predefined_elements/remote_payload”, “kind”: “filter”, “url”: “https://academy.bricksbuilder.io/developer/hooks/filters/bricks-woocommerce-predefined_elements-remote_payload/”, “…
📄 原始资料 | 展开查看原始 JSON（bricks-woocommerce-predefined_elements-remote_payload.json）
{
"name": "bricks/woocommerce/predefined_elements/remote_payload",
"kind": "filter",
"url": "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-woocommerce-predefined_elements-remote_payload/",
"scraped_at": "2026-08-29",
"hook_name": "bricks/woocommerce/predefined_elements/remote_payload",
"description": {
"en": "Filters the remote WooCommerce predefined elements payload after Bricks decodes the response and before it validates/caches the payload.",
"zh": "在 Bricks 解码响应之后以及验证/缓存载荷之前，筛选远程 WooCommerce 预定义元素载荷。"
},
"parameters": [
{
"name": "remote_payload",
"type": "array|mixed",
"type_zh": null,
"description": {
"en": "Decoded remote payload data.",
"zh": "已解码的远程载荷数据。"
}
}
],
"example_usage": "add_filter( 'bricks/woocommerce/predefined_elements/remote_payload', function( $remote_payload ) {\n return $remote_payload;\n} );"
}
前言
在 Bricks 解码响应之后以及验证/缓存载荷之前，筛选远程 WooCommerce 预定义元素载荷。
用法
将代码加入子主题的 functions.php：
add_filter( 'bricks/woocommerce/predefined_elements/remote_payload', function( $remote_payload ) {
return $remote_payload;
} );
参数
$remote_payload (array|mixed)：已解码的远程载荷数据。
示例代码
筛选返回值
add_filter( 'bricks/woocommerce/predefined_elements/remote_payload', function( $remote_payload ) {
return $remote_payload;
} );
根据条件短路返回原值
根据条件跳过或修改返回值：
add_filter( 'bricks/woocommerce/predefined_elements/remote_payload', function( $value, $remote_payload ) {
if ( is_admin() ) { return $value; }
// TODO: custom logic here
return $value;
} );
补充说明
更多细节可参考 官方文档。