20.01.2025

Działania w WordPress

W WordPress Akcje są częścią interfejsu API Hooks, który umożliwia programistom wstrzykiwanie niestandardowego kodu w określonych punktach podczas wykonywania WordPress. Akcje umożliwiają wykonywanie zadań lub wykonywanie funkcji w określonych zdarzeniach lub etapach, takich jak publikacja posta, ładowanie strony lub aktywacja motywu.

Akcje są szczególnie przydatne do rozszerzania funkcjonalności WordPressa bez modyfikowania podstawowych plików, dzięki czemu witryna jest łatwiejsza w utrzymaniu i przyszłościowa.

Jak działają akcje WordPress

Akcja jest uruchamiana, gdy w WordPressie wystąpi określone zdarzenie, takie jak załadowanie postu lub opublikowanie komentarza. Po uruchomieniu akcji wykonywane są wszystkie funkcje, które są z nią powiązane.

Na przykład:

Gdy użytkownik się loguje, WordPress uruchamia akcję wp_login, która pozwala uruchomić niestandardowy kod za każdym razem, gdy użytkownik się loguje.
Gdy post jest zapisywany, uruchamiana jest akcja save_post, która pozwala na dodanie niestandardowych funkcji, takich jak wysyłanie wiadomości e-mail po opublikowaniu postu.

Rejestrowanie akcji za pomocą add_action()

Aby podłączyć funkcję do akcji, użyj funkcji add_action(). Funkcja ta nakazuje WordPressowi wykonanie określonej funkcji po uruchomieniu akcji.

Składnia:

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

$hook: Nazwa haka akcji (np. wp_login, save_post).
$function_to_add: Nazwa funkcji, która ma zostać uruchomiona po wyzwoleniu akcji.
$priority (opcjonalnie): Służy do określania kolejności, w jakiej funkcje powinny być wykonywane. Niższe liczby oznaczają wyższy priorytet. Domyślnie jest to 10.
$accepted_args (opcjonalne): Liczba argumentów akceptowanych przez funkcję. Domyślnie 1.

Przykład:

function my_custom_function() { // Custom code here echo “Użytkownik zalogował się!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

W tym przykładzie, gdy użytkownik zaloguje się, funkcja my_custom_function() zostanie wykonana, wyświetlając komunikat.

Typowe działania WordPress

Oto kilka często używanych akcji w WordPress:

wp_enqueue_scripts: Służy do kolejkowania skryptów i stylów na interfejsie użytkownika.
init: Uruchamiana po zakończeniu ładowania WordPressa, ale przed wysłaniem jakichkolwiek nagłówków. Często używane do rejestrowania niestandardowych typów postów lub taksonomii.
wp_head: Wyzwalane w sekcji head motywu, przydatne do dodawania metatagów, stylów lub skryptów.
save_post: Wyzwalane, gdy post jest zapisywany. Może być używany do wykonywania dodatkowych czynności, takich jak aktualizacja metadanych posta.
admin_init: Uruchamiany, gdy użytkownik uzyskuje dostęp do panelu administracyjnego, przydatny do dodawania niestandardowych ustawień lub inicjowania funkcji obszaru administracyjnego.

Tworzenie akcji niestandardowych

Można również tworzyć własne niestandardowe akcje. Dzięki temu inni programiści (lub ty sam) mogą podłączyć funkcje do określonych punktów w niestandardowym motywie lub wtyczce.

Przykład:

function my_custom_action() { // Do something echo “Custom action triggered!”; } do_action( ‘my_custom_action’ );

W tym przypadku uruchamiasz hak my_custom_action wszędzie tam, gdzie znajduje się do_action( ‘my_custom_action’ ); i możesz podpiąć do niego funkcje w następujący sposób:

add_action( ‘my_custom_action’, ‘my_custom_function’ );

Zrozumienie funkcji do_action() i do_action_ref_array()

do_action(): Ta funkcja wyzwala wykonanie funkcji dołączonych do określonej akcji.

Przykład:

do_action( ‘wp_footer’ );

do_action_ref_array(): Ta funkcja przekazuje tablicę argumentów przez odniesienie do zahaczonych funkcji, przydatnych podczas pracy z obiektami lub tablicami, które chcesz bezpośrednio modyfikować.

Przykład:

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

Wnioski

Akcje WordPress zapewniają potężny sposób na rozszerzenie funkcjonalności WordPressa poprzez podłączenie niestandardowych funkcji do określonych zdarzeń. Korzystając z akcji, programiści mogą dostosowywać motywy, wtyczki i podstawowe funkcje bez modyfikowania rdzenia WordPressa, zapewniając łatwe aktualizacje i łatwość konserwacji. Zrozumienie, jak używać i tworzyć akcje, jest niezbędne dla każdego programisty WordPress, który chce budować bardziej dynamiczne i bogate w funkcje strony internetowe.