Bricks 中文文档:bricks/query/force_run

标签TAGS: 

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

📄 原始资料  |  展开查看原始 JSON(bricks-query-force_run.json)
{
  "name": "bricks/query/force_run",
  "kind": "filter",
  "url": "https://academy.bricksbuilder.io/developer/hooks/filters/filter-bricks-query-force_run/",
  "scraped_at": "2026-08-29",
  "hook_name": "bricks/query/force_run",
  "description": {
    "en": "Bricks has enhanced query performance in 1.9.1. Now, each unique query is executed only once per page load, and subsequently, the query results are reused on the same page. Consequently, certain queries-related PHP filters will no longer be triggered multiple times. The following filters may be impacted: Nevertheless, developers can utilize this filter to disable this setting for certain queries under specific circumstances. Since 1.9.2, you can define $query_vars['bricks_force_run'] = true to achieve the same result as well. This will be handy if you are using the Bricks Query Editor or PHP filters like bricks/posts/query_vars etc.",
    "zh": "Bricks 在 1.9.1 中增强了查询性能。现在,每个唯一查询在每个页面加载中仅执行一次,随后查询结果在同一页面上被重用。因此,某些与查询相关的 PHP 筛选器将不再被多次触发。以下筛选器可能会受到影响:尽管如此,开发者可以使用此筛选器在特定情况下禁用此设置。从 1.9.2 起,你还可以定义 $query_vars['bricks_force_run'] = true 来达到相同效果。当你使用 Bricks Query Editor 或诸如 bricks/posts/query_vars 等 PHP 筛选器时,这会非常方便。"
  },
  "example_usage": null
}

前言

Bricks 在 1.9.1 中增强了查询性能。现在,每个唯一查询在每个页面加载中仅执行一次,随后查询结果在同一页面上被重用。因此,某些与查询相关的 PHP 筛选器将不再被多次触发。以下筛选器可能会受到影响:尽管如此,开发者可以使用此筛选器在特定情况下禁用此设置。从 1.9.2 起,你还可以定义 $query_vars[‘bricks_force_run’] = true 来达到相同效果。当你使用 Bricks Query Editor 或诸如 bricks/posts/query_vars 等 PHP 筛选器时,这会非常方便。

补充说明

更多细节可参考 官方文档