The parse_network_query WordPress PHP action fires after the network query vars have been parsed.
Usage
add_action('parse_network_query', 'my_custom_parse_network_query'); function my_custom_parse_network_query($query) { // Your custom code here }
Parameters
$query
(WP_Network_Query) – The WP_Network_Query instance (passed by reference).
More information
See WordPress Developer Resources: parse_network_query
Examples
Modify the network query after parsing
Modify the network query after it has been parsed to filter out networks based on a custom criteria.
add_action('parse_network_query', 'my_custom_parse_network_query'); function my_custom_parse_network_query($query) { // Filter out networks with a certain ID $query->set('exclude', array(5, 9, 15)); }
Add a custom order to the network query
Change the order of the networks in the query results.
add_action('parse_network_query', 'my_custom_parse_network_query_order'); function my_custom_parse_network_query_order($query) { // Order networks by path in ascending order $query->set('orderby', 'path'); $query->set('order', 'ASC'); }
Limit the number of networks returned
Limit the number of networks returned by the query.
add_action('parse_network_query', 'my_custom_parse_network_query_limit'); function my_custom_parse_network_query_limit($query) { // Set the maximum number of networks to return $query->set('number', 5); }
Add a custom search parameter
Search networks based on a custom search parameter.
add_action('parse_network_query', 'my_custom_parse_network_query_search'); function my_custom_parse_network_query_search($query) { // Search for networks with 'example' in their domain $query->set('search', '*.example.*'); }
Combine multiple parameters for a custom network query
Modify the network query using multiple parameters for more specific results.
add_action('parse_network_query', 'my_custom_parse_network_query_combined'); function my_custom_parse_network_query_combined($query) { // Set custom query parameters $query->set('number', 5); $query->set('orderby', 'domain'); $query->set('order', 'DESC'); $query->set('search', '*.example.*'); }