add_action()

Описание

Подключает функцию к определенному действию (событию). Таким образом, в момент когда сработает нужное событие, будет вызвана пользовательская функция.

События в wordpress создаются (регистрируются) при помощи функции do_action().

Создатели CMS предусмотрели в какой участок кода ядра может понадобиться "внедриться" разработчикам тем и плагинов и зарегистрировали в этих местах хуки, к которым может быть подключена сторонняя функция. Это позволяет расширять и кастомизировать функционал движка без необходимости изменять основной код. Это значит, что при обновлениях wordpress пользовательский код не будет затронут.

Сигнатура

add_action( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 );

Параметры

$tag

(string) (Required) Название действия (action) к которому должна быть прикреплена функция $function_to_add

$function_to_add

(callable) (Required) Имя функции которую необходимо вызвать.

$priority

(int) (Optional) Используется для указания порядка, в котором выполняются функции, связанные с конкретным действием. Более низкие номера соответствуют более раннему исполнению, а функции с одинаковым приоритетом выполняются в том порядке, в котором они были добавлены в действие. Чем выше указанное число, тем позднее будет выполнена функция.

По умолчанию: 10

$accepted_args

(int) (Optional) Количество аргументов, которые принимает функция.

По умолчанию: 1

Возвращаемое значение

(true/false) Вернет true если функция была удачно добавлена к хуку.

Журнал изменений

1.2.0

Исходный файл

wp-includes/plugin.php

Добавить комментарий