Bricks 中文文档：bricks/query/fake_result

标签TAGS: 
2026年8月30日

📄 原始资料  |  展开查看原始 JSON（bricks-query-fake_result.json）{ “name”: “bricks/query/fake_result”, “kind”: “filter”, “url”: “https://academy.bricksbuilder.io/developer/hooks/filters/bricks-query-fake_result/”, “scraped_at”: “2026-08-29”, “hook_name”: “bricks/query/fake_result”, “description”: { “e…

📄 原始资料  |  展开查看原始 JSON（bricks-query-fake_result.json） 
{
  "name": "bricks/query/fake_result",
  "kind": "filter",
  "url": "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-query-fake_result/",
  "scraped_at": "2026-08-29",
  "hook_name": "bricks/query/fake_result",
  "description": {
    "en": "Filters the results of a “fake” query execution. Fake queries are auxiliary queries run by Bricks (e.g., to count total results for filters without pagination) that mirror the main query but with modified parameters (like posts_per_page = -1 ).",
    "zh": "筛选“伪”查询执行的结果。伪查询是由 Bricks 运行的辅助查询（例如用于计算筛选的总数而不分页），它镜像主查询但使用修改后的参数（如 posts_per_page = -1）。"
  },
  "parameters": [
    {
      "name": "results",
      "type": "array",
      "type_zh": null,
      "description": {
        "en": "The query results (e.g., array of WP_Post objects or IDs).",
        "zh": "查询结果（例如 WP_Post 对象或 ID 的数组）。"
      }
    },
    {
      "name": "query",
      "type": "object",
      "type_zh": null,
      "description": {
        "en": "The Bricks Query instance.",
        "zh": "Bricks 查询实例。"
      }
    }
  ],
  "example_usage": "add_filter( 'bricks/query/fake_result', function( $results, $query ) {\n    // Example: Manipulate the results for a specific query ID\n    if ( $query->id === 'my_filtered_loop' ) {\n        // Custom logic to modify results\n    }\n\n\n    return $results;\n}, 10, 2 );"
}

前言

筛选“伪”查询执行的结果。伪查询是由 Bricks 运行的辅助查询（例如用于计算筛选的总数而不分页），它镜像主查询但使用修改后的参数（如 posts_per_page = -1）。

用法

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

add_filter( 'bricks/query/fake_result', function( $results, $query ) {
    // Example: Manipulate the results for a specific query ID
    if ( $query->id === 'my_filtered_loop' ) {
        // Custom logic to modify results
    }


    return $results;
}, 10, 2 );

参数

  • $results (array)：查询结果（例如 WP_Post 对象或 ID 的数组）。
  • $query (object)：Bricks 查询实例。

示例代码

筛选返回值

add_filter( 'bricks/query/fake_result', function( $results, $query ) {
    // Example: Manipulate the results for a specific query ID
    if ( $query->id === 'my_filtered_loop' ) {
        // Custom logic to modify results
    }


    return $results;
}, 10, 2 );

根据条件短路返回原值

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

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

补充说明

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