do_action() WP 1.2.0

Создает событие (зацепку для произвольной функции). Чтобы функция сработала в момент события её нужно подключить к этому событию с помощью функции add_action().

add_action( 'action_name', function( $first ){
	var_dump( $first );
} );

do_action( 'action_name' ); // выведет> string(0) ""

Хуков нет.

Возвращает

Null. Ничего не возвращает.

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

do_action( $tag, $arg_a, $arg_b, ... );

$tag(строка) (обязательный)

Название создаваемого хука.

$arg_a(строка/массив/число/объект/логический)

Значение аргумента, который будет передан.
По умолчанию: аргумент не существует

$arg_b(строка/массив/число/объект/логический)

Значение еще одного аргумента...
По умолчанию: аргумент не существует

$arg_с(строка/массив/число/объект/логический)

Функции можно передавать бесконечно много аргументов...

Примеры

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

Эту функцию можно использовать в плагинах, темах и т.д., когда нужно внедрится в процесс выполнения кода, откуда-нибудь из другого места. Например, "зацепку" (хук) (do_action) мы установили в плагине, а "цепляться" за нее будем из файла functions.php в тот момент, когда будет срабатывать наша "зацепка".

Допустим, мы использовали такой код в плагине:

<?php 
// Определяем аргументы для хука action
$a = $defined; // $defined какая-нибудь динамическая логическая переменная
$b = 'А это значение второй переменной';

// Включаем хук. Здесь он будет выполняться
do_action( 'my_hook', $a, $b );

Теперь мы может сделать какое-нибудь действие в момент срабатывания функции do_action и при этом описать наше действие можно, например, из файла functions.php, разместив в нем такой код:

function do_my_hook( $a, $b ){
	// если переданная переменная $a равна true,
	// то, например, удалим запись 10
	if( $a===true )
		wp_delete_post(10);
	// а тут просто выведем переменную на экран
	echo '<br />'.$b; // выведет значение второй переменной
} 
// Регистрируем хук через
// add_action( $tag, $function_to_add, $priority, $accepted_args );
add_action( 'my_hook', 'do_my_hook', 10, 2 );

Заметки

• Global. Массив. $wp_filter Stores all of the filters and actions.
• Global. Массив. $wp_actions Increments the amount of times action was triggered.
• Global. Массив. $wp_current_filter Stores the list of current filters with the current one last.

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

Код do action: wp-includes/plugin.php ^{WP 5.4.1}

<?php
function do_action( $tag, ...$arg ) {
	global $wp_filter, $wp_actions, $wp_current_filter;

	if ( ! isset( $wp_actions[ $tag ] ) ) {
		$wp_actions[ $tag ] = 1;
	} else {
		++$wp_actions[ $tag ];
	}

	// Do 'all' actions first.
	if ( isset( $wp_filter['all'] ) ) {
		$wp_current_filter[] = $tag;
		$all_args            = func_get_args();
		_wp_call_all_hook( $all_args );
	}

	if ( ! isset( $wp_filter[ $tag ] ) ) {
		if ( isset( $wp_filter['all'] ) ) {
			array_pop( $wp_current_filter );
		}
		return;
	}

	if ( ! isset( $wp_filter['all'] ) ) {
		$wp_current_filter[] = $tag;
	}

	if ( empty( $arg ) ) {
		$arg[] = '';
	} elseif ( is_array( $arg[0] ) && 1 === count( $arg[0] ) && isset( $arg[0][0] ) && is_object( $arg[0][0] ) ) {
		// Backward compatibility for PHP4-style passing of `array( &$this )` as action `$arg`.
		$arg[0] = $arg[0][0];
	}

	$wp_filter[ $tag ]->do_action( $arg );

	array_pop( $wp_current_filter );
}

Cвязанные функции

Из метки: События (хуки)

Еще из раздела: Хуки: события, фильтры