20.01.2025

Дії в WordPress

У WordPress дії є частиною API хуків, який дозволяє розробникам вставляти кастомний код у певні моменти під час виконання WordPress. Дії дозволяють виконувати завдання або функції під час певних подій або етапів, наприклад, коли публікується пост, завантажується сторінка або активується тема.

Дії особливо корисні для розширення функціональності WordPress без зміни основних файлів, роблячи ваш сайт більш зручним для обслуговування і перспективним.

Як працюють дії WordPress

Дія запускається, коли в WordPress відбувається певна подія, наприклад, завантаження публікації або публікація коментаря. Коли запускається дія, виконуються всі функції, підключені до цієї дії.

Наприклад:

Коли користувач входить в систему, WordPress запускає дію wp_login, яка дозволяє вам запускати кастомний код щоразу, коли користувач входить в систему.
Коли пост зберігається, запускається дія save_post, що дозволяє вам додавати кастомну функціональність, наприклад, надсилати імейл при публікації поста.

Реєстрація дій за допомогою add_action()

Щоб підключити функцію до дії, використовуйте функцію add_action(). Ця функція вказує WordPress виконати певну функцію, коли спрацьовує дія.

Синтаксис:

add_action( $hook, $function_to_add, $priority, $accepted_args );

$hook: Назва хука дії (наприклад, wp_login, save_post).
$функція_для_додавання: Назва функції, яку ви хочете запустити при спрацьовуванні дії.
пріоритет (необов’язково): Використовується для вказівки порядку виконання функцій. Менші числа означають вищий пріоритет. Значення за замовчуванням – 10.
$accepted_args (необов’язково): Кількість аргументів, які приймає функція. За замовчуванням дорівнює 1.

Приклад:

function my_custom_function() { // Тут кастомний код echo “User has logged in!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

У цьому прикладі, коли користувач авторизується, функція my_custom_function() виконається і виведе відповідне повідомлення.

Загальні дії WordPress

Ось кілька найпоширеніших дій у WordPress:

wp_enqueue_scripts: Використовується для постановки в чергу скриптів і стилів на інтерфейсі.
init: Виконується після завершення завантаження WordPress, але до відправки будь-яких заголовків. Часто використовується для реєстрації кастомних типів постів або таксономій.
wp_head: Спрацьовує в розділі заголовка теми, корисний для додавання мета-тегів, стилів або скриптів.
save_post: Спрацьовує при збереженні публікації. Він може бути використаний для виконання додаткових дій, таких як оновлення метаданих публікації.
admin_init: Спрацьовує, коли користувач отримує доступ до панелі адміністратора, корисний для додавання користувацьких налаштувань або ініціалізації функцій для адміністративної області.

Створення користувацьких дій

Ви також можете створювати власні кастомні дії. Це дозволяє іншим розробникам (або вам самим) підключати функції до певних пунктів вашої теми або плагіна.

Приклад:

function my_custom_action() { // Зробити щось echo “Кастомна дія запущена!”; } do_action( ‘my_custom_action’ );

У цьому випадку ви запускаєте хук my_custom_action скрізь, де розміщено do_action( ‘my_custom_action’ );, і можете під’єднувати до нього функції ось так:

add_action( ‘моя_кастомна_дія’, ‘моя_кастомна_функція’ );

Розуміння do_action() та do_action_ref_array()

do_action(): Ця функція запускає виконання функцій, прив’язаних до певної дії.

Приклад:

do_action( ‘wp_footer’ );

do_action_ref_array(): Ця функція передає масив аргументів за посиланням на підключені функції, що корисно при роботі з об’єктами або масивами, які ви хочете змінити безпосередньо.

Приклад:

$my_data = array( ‘key’ => ‘value’ ); do_action_ref_array( ‘my_custom_action’, array( &$my_data ) );

Висновок

Дії WordPress – це потужний спосіб розширити функціональність WordPress, прив’язуючи кастомні функції до певних подій. Використовуючи дії, розробники можуть налаштовувати теми, плагіни та основні функції без зміни ядра WordPress, забезпечуючи легке оновлення та зручність обслуговування. Розуміння того, як використовувати та створювати дії, є важливим для будь-якого розробника WordPress, який прагне створювати більш динамічні та багатофункціональні веб-сайти.