20.01.2025

Действия в WordPress

В WordPress действията са част от приложния програмен интерфейс Hooks 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).
$function_to_add: Името на функцията, която искате да се изпълни при задействане на действието.
$priority (по избор): Използва се за определяне на реда, в който трябва да се изпълняват функциите. По-малките числа означават по-висок приоритет. По подразбиране е 10.
$accepted_args (по избор): Броят на аргументите, които функцията приема. По подразбиране е 1.

Пример:

function my_custom_function() { // Custom code here echo “User has logged in!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

В този пример, когато потребителят влезе в системата, функцията my_custom_function() ще се изпълни и ще покаже съобщение.

Общи действия на WordPress

Ето някои често използвани действия в WordPress:

wp_enqueue_scripts: Използва се за извикване на скриптове и стилове от предния край.
init: Задейства се, след като WordPress е завършил зареждането, но преди да бъдат изпратени каквито и да било заглавия. Често се използва за регистриране на потребителски типове публикации или таксономии.
wp_head: Задейства се в секцията head на темата, полезно за добавяне на мета тагове, стилове или скриптове.
save_post: Задейства се при запазване на публикация. Може да се използва за извършване на допълнителни действия, като например актуализиране на метаданните на публикацията.
admin_init: Изпълнява се, когато потребител получи достъп до таблото за управление на администрацията, полезно за добавяне на персонализирани настройки или инициализиране на функции за областта за управление.

Създаване на персонализирани действия

Можете също така да създавате свои собствени персонализирани действия. Това позволява на други разработчици (или на вас самите) да закачат функции в определени точки на вашата потребителска тема или плъгин.

Пример:

функция my_custom_action() { // Do something echo “Custom action triged!”; } do_action( ‘my_custom_action’ );

В този случай задействате куката my_custom_action навсякъде, където е поставена do_action( ‘my_custom_action’ );, и можете да закачите функции към нея по следния начин:

add_action( ‘my_custom_action’, ‘my_custom_function’ );

Разбиране на 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, който иска да изгради по-динамични и богати на функции уебсайтове.