init

 

Событие срабатывает после того, как WordPress полностью загружен, но до того, как любые header заголовки были отправлены.

init — это популярное событие. Обычно используется плагинами для инициализации себя. Этот хук удобен по многим причинам: например, нужно определять пользователя, нужны таксономии, нужны функции установленные в теме (файл functions.php или другой).

К моменту срабатывания init текущий пользователь авторизован (global $current_user уже определена) и установлены все основные глобальные переменные и функции WordPress. Также функции темы уже подключены и все установки установлены: размеры картинок миниатюр, поддержка меню и т.д.

Вместо init можно использовать wp_loaded — это практически одинаковые события. wp_loaded срабатывает сразу после init и после проверки ms_site_check() (проверяет текущий блог в мультисайтовой сборке). wp_loaded не сработает, если текущий блок не пройдет проверку на работоспособность (не активен, удален, заспамлен, в архиве).
События которые срабатывают до init:
muplugins_loaded
registered_taxonomy
registered_post_type
plugins_loaded
sanitize_comment_cookies    
setup_theme 
load_textdomain
after_setup_theme
auth_cookie_malformed   
auth_cookie_valid   
set_current_user    
init

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

add_action( 'init', 'action_function_name_11' );
function action_function_name_11() {
	// Действие...
}

 

Примеры

#1 Обработка $_GET запроса

Допустим нам нужно перенаправить ссылку на страницу регистрации, если в запросе указана переменная register:

add_action('init', 'redirect_to_register');
function redirect_to_register(){
	if( isset( $_GET['register'] ) ) {
		wp_redirect( site_url() . 'wp-register.php');
		exit;
	}
}

#2 Подключение к другим событиям из init

add_action('init','all_my_hooks');
function all_my_hooks(){
	// подключение более поздних событий
	add_action('admin_init', 'my_function_name');
	add_action('admin_menu', 'my_function_name');
}

 

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

В файле: /wp-settings.php

wp-settings.php 523

do_action( 'init' );

 

Где используется хук (в ядре WP)

wp-includes/blocks/archives.php 143

add_action( 'init', 'register_block_core_archives' );
wp-includes/blocks/block.php 48

add_action( 'init', 'register_block_core_block' );
wp-includes/blocks/calendar.php 78

add_action( 'init', 'register_block_core_calendar' );
wp-includes/blocks/categories.php 120

add_action( 'init', 'register_block_core_categories' );
wp-includes/blocks/latest-comments.php 196

add_action( 'init', 'register_block_core_latest_comments' );
wp-includes/blocks/latest-posts.php 177

add_action( 'init', 'register_block_core_latest_posts' );
wp-includes/blocks/rss.php 160

add_action( 'init', 'register_block_core_rss' );
wp-includes/blocks/search.php 93

add_action( 'init', 'register_block_core_search' );
wp-includes/blocks/shortcode.php 37

add_action( 'init', 'register_block_core_shortcode' );
wp-includes/blocks/tag-cloud.php 78

add_action( 'init', 'register_block_core_tag_cloud' );
wp-includes/class-wp-customize-manager.php 371

remove_action( 'init', 'wp_cron' );
wp-includes/class.wp-scripts.php 143

add_action( 'init', array( $this, 'init' ), 0 );
wp-includes/default-filters.php 530

add_action( 'init', 'wp_widgets_init', 1 );
wp-includes/default-filters.php 445

add_action( 'init', 'rest_api_init' );
wp-includes/default-filters.php 511

add_action( 'init', 'create_initial_taxonomies', 0 ); // highest priority
wp-includes/default-filters.php 487

add_action( 'init', 'kses_init' );
wp-includes/default-filters.php 473

add_action( 'init', 'create_initial_post_types', 0 ); // highest priority
wp-includes/default-filters.php 301

add_action( 'init', 'check_theme_switched', 99 );
wp-includes/default-filters.php 397

add_action( 'init', '_show_post_preview' );
wp-includes/default-filters.php 367

add_action( 'init', 'wp_schedule_delete_old_privacy_export_files' );
wp-includes/default-filters.php 347

add_action( 'init', 'smilies_init', 5 );
wp-includes/default-filters.php 330

add_action( 'init', 'wp_cron' );
wp-includes/default-filters.php 131

add_action( 'init', 'wp_init_targeted_link_rel_filters' );
wp-includes/ms-default-filters.php 16

add_action( 'init', 'ms_subdomain_constants' );
wp-includes/ms-default-filters.php 25

add_action( 'init', 'maybe_add_existing_user_to_blog' );
wp-includes/update.php 835

add_action( 'init', 'wp_schedule_update_checks' );