Описание функции add_action()
Функция add_action() используется для добавления пользовательских функций (обратных вызовов) к определенным хукам действий в WordPress. Это позволяет расширять функциональность сайта, выполняя код в определенные моменты, такие как при загрузке страницы, сохранении записи и т.д.
Функция принимает имя хука, приоритет выполнения и функцию обратного вызова, которая будет вызвана при срабатывании хука
Параметры
$hook
Тип: string
Обязательный: Да
Описание: Имя хука, к которому будет добавлена функция обратного вызова
$callback
Тип: callable
Обязательный: Да
Описание: Функция обратного вызова, которая будет вызвана при срабатывании хука
$priority
Тип: int
Обязательный: Нет
По умолчанию: 10
Описание: Приоритет выполнения функции обратного вызова (чем меньше число, тем раньше выполняется)
Возможные значения:
$accepted_args
Тип: int
Обязательный: Нет
По умолчанию: 1
Описание: Количество аргументов, передаваемых в функцию обратного вызова
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
Примеры использования
Регистрация функции my_custom_function для выполнения при инициализации WordPress
add_action('init', 'my_custom_function');
function my_custom_function() {
// Ваш код здесь
}
Добавление текста в подвал сайта с приоритетом 20
add_action('wp_footer', 'my_footer_function', 20);
function my_footer_function() {
echo '<p>Текст в подвале</p>';
}
Проверка существования функции перед ее вызовом
if (function_exists('add_action')) {
add_action('init', 'my_custom_function');
}
function my_custom_function() {
// Ваш код
}
Подключение стилей темы при загрузке скриптов
add_action('wp_enqueue_scripts', 'enqueue_my_styles');
function enqueue_my_styles() {
wp_enqueue_style('custom-style', get_template_directory_uri() . '/style.css');
}
Безопасность
Валидация входных данных: Параметры проверки типов, однако пользовательские функции должны быть безопасными
Санитизация: Необходимость проверки и фильтрации данных внутри функции обратного вызова
Рекомендации: Избегайте выполнения небезопасных операций в функциях обратного вызова
— Связанные функции
Удаляет функцию обратного вызова, зарегистрированную для указанного хука
Вызывает все функции, зарегистрированные для указанного хука
— Примечания
– Ограничения
Некоторые хуки могут не поддерживать определенные функции обратного вызова
– Частые проблемы
- Ошибки при неправильном именовании хуков
- Неисполнение функций при неверных параметрах
