Do_action () - створює подія (зачіпку для довільної функції)
Створює подія (зачіпку для довільної функції). Щоб функція спрацювала в момент події її потрібно підключити до цієї події за допомогою функції add_action ().
Крім подій в WP є ще фільтри (filters), принцип роботи такий же. Різниці лише в тому, що фільтр повинен повернути отриману змінну, тобто він фільтрує (змінює) дані, а подія дозволяє запустити призначену для користувача функцію в момент спрацьовування цієї події. Фільтри запускаються функцією apply_filters ()
✈ 1 раз = 0.00007с = дуже швидко | 50000 раз = 0.03с = швидкість світла
повертає
Нічого не повертає.
Використання
$ Tag (рядок) (обов'язковий) Назва створюваного хука. $ Arg_a (рядок / масив / число / об'єкт / логічний) Значення аргументу, який буде переданий.
За замовчуванням: аргумент не існує $ arg_b (рядок / масив / число / об'єкт / логічний) Значення ще одного аргументу.
За замовчуванням: аргумент не існує $ arg_с (рядок / масив / число / об'єкт / логічний) Функції можна передавати нескінченно багато аргументів.
# 1. приклад використання
do_action потрібно використовувати у функціях, плагинах, темах і т.д. де можливо знадобиться вселиться в процес виконання коду, звідки-небудь з іншого місця. Наприклад, "зачіпку" (хук) (do_action) ми встановили в плагіні, а "чіплятися" за неї будемо з файлу functions.php в той момент, коли буде спрацьовувати наша "зачіпка".
Припустимо, ми використовували такий код в плагіні:
Тепер ми може зробити будь-яка дія в момент спрацьовування функції do_action і при цьому описати наше дію можна, наприклад, з файлу functions.php, розмістивши в ньому такий код:
Дії відрізняються від фільтрів, тим що передаються дією дані, не повертаються назад в функцію і не використовуються там надалі, а всього-лише передаються для використання у функції хука.