From abc3bd1459ba325d4489ab9e205b40c67dbb1005 Mon Sep 17 00:00:00 2001 From: Sandip Baikare Date: Tue, 28 Apr 2026 13:34:03 +0530 Subject: [PATCH 1/8] fix: comments params and improve documentation --- src/wp-includes/class-wp-network-query.php | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index 15600998adf4e..811a249b6bccf 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -21,7 +21,7 @@ class WP_Network_Query { * SQL for database query. * * @since 4.6.0 - * @var string + * @var string SQL statement for the last performed network query. */ public $request; @@ -29,7 +29,15 @@ class WP_Network_Query { * SQL query clauses. * * @since 4.6.0 - * @var array + * @var array{ + * select: string, + * from: string, + * where: array, + * groupby: string, + * orderby: string, + * limits: string + * } + * Associative array of SQL query clauses used to build the request. */ protected $sql_clauses = array( 'select' => '', @@ -44,7 +52,7 @@ class WP_Network_Query { * Query vars set by the user. * * @since 4.6.0 - * @var array + * @var array Query variables for the current query. */ public $query_vars; @@ -52,7 +60,7 @@ class WP_Network_Query { * Default values for query vars. * * @since 4.6.0 - * @var array + * @var array Default values for query variables. */ public $query_var_defaults; @@ -60,7 +68,7 @@ class WP_Network_Query { * List of networks located by the query. * * @since 4.6.0 - * @var array + * @var WP_Network[]|int[] Array of WP_Network objects or network IDs, depending on 'fields' parameter. */ public $networks; @@ -68,7 +76,7 @@ class WP_Network_Query { * The amount of found networks for the current query. * * @since 4.6.0 - * @var int + * @var int Number of networks found for the current query. */ public $found_networks = 0; @@ -76,7 +84,7 @@ class WP_Network_Query { * The number of pages. * * @since 4.6.0 - * @var int + * @var int Number of pages of results for the current query. */ public $max_num_pages = 0; From e8d80037be81c4e42008503d9c2c785dabf7caf4 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:22:38 +0530 Subject: [PATCH 2/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index 811a249b6bccf..ed4cd941f6286 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -52,7 +52,7 @@ class WP_Network_Query { * Query vars set by the user. * * @since 4.6.0 - * @var array Query variables for the current query. + * @var array */ public $query_vars; From 6bc7c1e31ac984c4a2c7a402743e4e95588b4c24 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:23:11 +0530 Subject: [PATCH 3/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index ed4cd941f6286..5c6815171f1d9 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -60,7 +60,7 @@ class WP_Network_Query { * Default values for query vars. * * @since 4.6.0 - * @var array Default values for query variables. + * @var array */ public $query_var_defaults; From 14a451810ab4762db6acbe0078653424e59ec1a2 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:23:29 +0530 Subject: [PATCH 4/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index 5c6815171f1d9..f56ce7d5b392e 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -68,7 +68,7 @@ class WP_Network_Query { * List of networks located by the query. * * @since 4.6.0 - * @var WP_Network[]|int[] Array of WP_Network objects or network IDs, depending on 'fields' parameter. + * @var WP_Network[]|int[] */ public $networks; From 88c0de323a65d1ae5088dafe0edfa6da75f95ca9 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:23:45 +0530 Subject: [PATCH 5/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index f56ce7d5b392e..fb539812e486b 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -76,7 +76,7 @@ class WP_Network_Query { * The amount of found networks for the current query. * * @since 4.6.0 - * @var int Number of networks found for the current query. + * @var int */ public $found_networks = 0; From 04f7360737f285ae639cbe039c54b647e4a24642 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:23:58 +0530 Subject: [PATCH 6/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index fb539812e486b..c81ea1b562277 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -84,7 +84,7 @@ class WP_Network_Query { * The number of pages. * * @since 4.6.0 - * @var int Number of pages of results for the current query. + * @var int */ public $max_num_pages = 0; From 64faa17a4d2e7c7de03cd03d9aacbe7869b9e737 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:24:15 +0530 Subject: [PATCH 7/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 1 - 1 file changed, 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index c81ea1b562277..684cbeb8ed310 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -37,7 +37,6 @@ class WP_Network_Query { * orderby: string, * limits: string * } - * Associative array of SQL query clauses used to build the request. */ protected $sql_clauses = array( 'select' => '', From 3abfb03900d79674c3e9d6ac65778bf8269c6168 Mon Sep 17 00:00:00 2001 From: Baikare Sandip Date: Thu, 30 Apr 2026 10:24:30 +0530 Subject: [PATCH 8/8] Update src/wp-includes/class-wp-network-query.php Co-authored-by: Weston Ruter --- src/wp-includes/class-wp-network-query.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index 684cbeb8ed310..22a1b74688161 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -21,7 +21,7 @@ class WP_Network_Query { * SQL for database query. * * @since 4.6.0 - * @var string SQL statement for the last performed network query. + * @var string */ public $request;