wp │ хук-событие │ WP 2.1.0

Срабатывает сразу после того, как глобальный объект WP установлен: определена глобальная переменная $wp. Хук срабатывает в конце функции wp().

$wp объект передается в функцию обработчик в виде ссылки на сам объект (&$WP).

Этот хук-событие - первое место где параметры запроса распащены и основной запрос уже выполнен и проверен. См. WP::main().

  • Используйте do_parse_request, когда вы хотите сами обработать текущий запрос.

  • Используйте parse_request, когда нужно что-то сделать после того как основной запрос распарщен, но до того как он будет обработан (будет сделан сам запрос). Это самое эффективное место, когда можно изменить, проверить или отфильтровать основной запрос WP, сразу после того как он установлен, но до того, как WordPress произведет какие-либо операции связанные с основным запросом.

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

add_action( 'wp', 'wp_kama_wp_action' );

/**
 * Function for `wp` action-hook.
 * 
 * @param WP $wp Current WordPress environment instance (passed by reference).
 *
 * @return void
 */
function wp_kama_wp_action( $wp ){

	// action...
}
$wp(объект)
Установленный объект WP. Передается по ссылке.

Примеры

0

#1 Пример использования

Предположим, нам нужно перенаправить все вложения (attachment) на постоянную страницу /attach.

Используем для этого событие wp, так как это самое раннее событие, когда работают условные теги:

add_action( 'wp', 'attachment_redirect' );
function attachment_redirect( $wp ){
	if( is_attachment() ) {
		$location = get_home_url() . '/attach';
		wp_redirect( $location );
		exit;
	}
}

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

С версии 2.1.0 Введена.

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

WP::main()
wp
wp-includes/class-wp.php 830 
do_action_ref_array( 'wp', array( &$this ) );

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

wp-includes/class-wp-customize-widgets.php 357 
add_action( 'wp', array( $this, 'customize_register' ) );