функция
since 1.2.0
add_action()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
add_action( string $hook_name, callable $callback, int $priority = 10, int $accepted_args = 1 ): trueОписание
Действия — это хуки, которые ядро WordPress запускает в определённые моменты выполнения или при наступлении определённых событий. С помощью Action API плагины могут указать, что одна или несколько их PHP-функций выполняются в этих точках.
Оригинал (английский)
Actions are the hooks that the WordPress core launches at specific points during execution, or when specific events occur. Plugins can specify that one or more of its PHP functions are executed at these points, using the Action API.
Параметры
$hook_name
string
обязательный
Имя действия, к которому добавляется функция обратного вызова.
$callback
callable
обязательный
Функция обратного вызова, которая будет запущена при вызове действия.
$priority
int
необязательный
= 10
Задаёт порядок, в котором выполняются функции, связанные с конкретным действием.
Меньшие числа соответствуют более раннему выполнению, а функции с одинаковым приоритетом выполняются в том порядке, в котором были добавлены к действию.
$accepted_args
int
необязательный
= 1
Число аргументов, которое принимает функция.
Возвращаемое значение
true
Исходный код
wp-includes/plugin.php:446
function add_action( $hook_name, $callback, $priority = 10, $accepted_args = 1 ) {
return add_filter( $hook_name, $callback, $priority, $accepted_args );
}История изменений
| Версия | Описание |
|---|---|
| 1.2.0 | Introduced. |
