20.01.2025

Acțiuni în WordPress

În WordPress, acțiunile fac parte din API-ul Hooks, care permite dezvoltatorilor să injecteze cod personalizat în puncte specifice în timpul execuției WordPress. Acțiunile vă permit să efectuați sarcini sau să executați funcții la anumite evenimente sau etape, cum ar fi atunci când o postare este publicată, o pagină este încărcată sau o temă este activată.

Acțiunile sunt deosebit de utile pentru extinderea funcționalității WordPress fără a modifica fișierele de bază, făcând site-ul dvs. mai ușor de întreținut și mai rezistent la viitor.

Cum funcționează acțiunile WordPress

O acțiune este declanșată atunci când are loc un anumit eveniment în WordPress, cum ar fi încărcarea unei postări sau publicarea unui comentariu. Atunci când o acțiune este declanșată, toate funcțiile care sunt conectate la acea acțiune sunt executate.

De exemplu:

Atunci când un utilizator se conectează, WordPress declanșează acțiunea wp_login, care vă permite să executați cod personalizat ori de câte ori un utilizator se conectează.
Atunci când o postare este salvată, este declanșată acțiunea save_post, care vă permite să adăugați funcționalități personalizate, cum ar fi trimiterea unui e-mail atunci când o postare este publicată.

Înregistrarea acțiunilor cu add_action()

Pentru a conecta o funcție la o acțiune, utilizați funcția add_action(). Această funcție îi spune lui WordPress să execute o anumită funcție atunci când este declanșată o acțiune.

Sintaxă:

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

$hook: Numele cârligului de acțiune (de exemplu, wp_login, save_post).
$function_to_add: Numele funcției pe care doriți să o executați atunci când acțiunea este declanșată.
$priority (opțional): Utilizat pentru a specifica ordinea în care funcțiile ar trebui să fie executate. Numerele mai mici înseamnă prioritate mai mare. Valoarea implicită este 10.
$accepted_args (opțional): Numărul de argumente acceptate de funcție. Valoarea implicită este 1.

Exemplu:

function my_custom_function() { // Codul personalizat aici echo “Utilizatorul s-a logat!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

În acest exemplu, atunci când un utilizator se conectează, funcția my_custom_function() se va executa, afișând un mesaj.

Acțiuni comune WordPress

Iată câteva acțiuni utilizate frecvent în WordPress:

wp_enqueue_scripts: Utilizată pentru a prelua scripturi și stiluri pe partea frontală.
init: Declanșată după ce WordPress a terminat încărcarea, dar înainte ca orice antet să fie trimis. Adesea utilizat pentru a înregistra tipuri de post sau taxonomii personalizate.
wp_head: Declanșat în secțiunea head a temei, util pentru adăugarea de metaetichete, stiluri sau scripturi.
save_post: Declanșat atunci când o postare este salvată. Acesta poate fi utilizat pentru a efectua acțiuni suplimentare, cum ar fi actualizarea metadatelor postului.
admin_init: Declanșat atunci când un utilizator accesează tabloul de bord al administratorului, util pentru adăugarea de setări personalizate sau inițializarea funcțiilor pentru zona de administrare.

Crearea de acțiuni personalizate

De asemenea, vă puteți crea propriile acțiuni personalizate. Acest lucru permite altor dezvoltatori (sau dvs.) să conecteze funcții în puncte specifice din tema sau pluginul dvs. personalizat.

Exemplu:

function my_custom_action() { // Faceți ceva echo “Acțiune personalizată declanșată!”; } do_action( ‘my_custom_action’ );

În acest caz, declanșați cârligul my_custom_action oriunde este plasat do_action( ‘my_custom_action’ ); și puteți cârliga funcții la acesta astfel:

add_action( ‘my_custom_action’, ‘my_custom_function’ );

Înțelegerea do_action() și do_action_ref_array()

do_action(): Această funcție declanșează executarea funcțiilor atașate unei anumite acțiuni.

Exemplu:

do_action( ‘wp_footer’ );

do_action_ref_array(): Această funcție transmite o matrice de argumente prin referință către funcțiile agățate, utilă atunci când lucrați cu obiecte sau matrici pe care doriți să le modificați direct.

Exemplu:

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

Concluzie

Acțiunile WordPress oferă o modalitate puternică de a extinde funcționalitatea WordPress prin conectarea funcțiilor personalizate la evenimente specifice. Prin utilizarea acțiunilor, dezvoltatorii pot personaliza teme, plugin-uri și caracteristici de bază fără a modifica nucleul WordPress, asigurând actualizări și întrețineri ușoare. Înțelegerea modului de utilizare și creare a acțiunilor este esențială pentru orice dezvoltator WordPress care dorește să creeze site-uri web mai dinamice și mai bogate în funcții.