pre_get_network_by_path │ filter-hook │ WP 3.9.0

Determine a network by its domain and path.

This allows one to short-circuit the default logic, perhaps by replacing it with a routine that is more optimal for your setup.

Return null to avoid the short-circuit. Return false if no network can be found at the requested domain and path. Otherwise, return an object from wp_get_network().

Usage

add_filter( 'pre_get_network_by_path', 'wp_kama_pre_get_network_by_path_filter', 10, 5 );

/**
 * Function for `pre_get_network_by_path` filter-hook.
 * 
 * @param null|false|WP_Network $network  Network value to return by path.
 * @param string                $domain   The requested domain.
 * @param string                $path     The requested path, in full.
 * @param int|null              $segments The suggested number of paths to consult.
 * @param string[]              $paths    Array of paths to search for, based on `$path` and `$segments`.
 *
 * @return null|false|WP_Network
 */
function wp_kama_pre_get_network_by_path_filter( $network, $domain, $path, $segments, $paths ){

	// filter...
	return $network;
}

$network(null|false|WP_Network)

Network value to return by path.
Default: null to continue retrieving the network

$domain(string)

The requested domain.

$path(string)

The requested path, in full.

$segments(int|null)

The suggested number of paths to consult.
Default: null, meaning the entire path was to be consulted

$paths(string[])

Array of paths to search for, based on $path and $segments.

Changelog

Where the hook is called

$pre = apply_filters( 'pre_get_network_by_path', null, $domain, $path, $segments, $paths );

Where the hook is used in WordPress