钩子文档

found_networks_query

💡 云策文档标注

概述

found_networks_query 是一个 WordPress 过滤器钩子,用于修改检索网络计数时使用的 SQL 查询。它允许开发者在 WP_Network_Query 实例中自定义查询逻辑。

关键要点

  • found_networks_query 是一个过滤器钩子,用于过滤检索网络计数的 SQL 查询。
  • 参数包括 $found_networks_query(SQL 查询字符串,默认值为 'SELECT FOUND_ROWS()')和 $network_query(WP_Network_Query 实例)。
  • 在 WP_Network_Query::set_found_networks() 方法中使用,用于填充 found_networks 和 max_num_pages 属性。
  • 该钩子从 WordPress 4.6.0 版本开始引入。

📄 原文内容

Filters the query used to retrieve found network count.

Parameters

$found_networks_querystring
SQL query. Default ‘SELECT FOUND_ROWS()’.
$network_queryWP_Network_Query
The WP_Network_Query instance.

Source

$found_networks_query = apply_filters( 'found_networks_query', 'SELECT FOUND_ROWS()', $this );

Changelog

Version Description
4.6.0 Introduced.