pre_get_site_by_path │ хук-фильтр │ WP 3.9.0

Determines a site 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 site can be found at the requested domain and path. Otherwise, return a site object.

Использование

add_filter( 'pre_get_site_by_path', 'wp_kama_pre_get_site_by_path_filter', 10, 5 );

/**
 * Function for `pre_get_site_by_path` filter-hook.
 * 
 * @param null|false|WP_Site $site     Site 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    The paths to search for, based on $path and $segments.
 *
 * @return null|false|WP_Site
 */
function wp_kama_pre_get_site_by_path_filter( $site, $domain, $path, $segments, $paths ){

	// filter...
	return $site;
}

$site(null|false|WP_Site)

Site value to return by path.
По умолчанию: null to continue retrieving the site

$domain(строка)

The requested domain.

$path(строка)

The requested path, in full.

$segments(int|null)

The suggested number of paths to consult.
По умолчанию: null, meaning the entire path was to be consulted

$paths(string[])

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

Список изменений

Где вызывается хук

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

Где используется хук в WordPress