Ghid pentru hooks, actions și filters în WordPress
Bine ai venit la „Ghid pentru hooks, actions și filters în WordPress”. În lumea vastă a dezvoltării pentru WordPress, înțelegerea hook-urilor, a actions și a filters este esențială pentru a valorifica întregul potențial al acestei platforme puternice.
Hook-urile sunt coloana vertebrală a personalizării WordPress: îți permit să modifici și să extinzi funcționalitatea platformei fără bătăi de cap. Cu actions execuți sarcini precise în momente-cheie din timpul rulării, iar cu filters prelucrezi datele și returnezi rezultate modificate. Fie că ești la început de drum, fie că ești un dezvoltator cu experiență, acest ghid complet îți oferă explicații utile și exemple practice, ca să folosești din plin flexibilitatea și posibilitățile de personalizare pe care le aduc hook-urile, actions și filters din WordPress. Hai să intrăm în subiect și să descoperim posibilitățile nelimitate ale dezvoltării pe WordPress.
Hook-uri
Hook-urile stau la baza dezvoltării de pluginuri și teme pentru WordPress. Sunt punctele în care dezvoltatorii își pot „agăța” propriul cod în WordPress, în locuri precise, și pot schimba modul în care funcționează WordPress fără să editeze fișierele core.
Există două tipuri de hooks în WordPress: actions și filters
Hook-urile din WordPress au două tipuri fundamentale, numite actions și filters. Actions îți permit să execuți anumite sarcini în puncte prestabilite din timpul rulării WordPress, în timp ce filters îți dau posibilitatea de a modifica și de a returna orice date procesate de WordPress.
Actions:
Cu ajutorul unui action poți personaliza comportamentul implicit al unei anumite funcții: extragi informații din WordPress și efectuezi operațiuni asupra lor. După ce un action a fost executat, nu mai este nevoie să transmiți date înapoi către WordPress.
Pentru a adăuga actions se folosește funcția add_action(). WordPress pune la dispoziție mai multe funcții care ușurează lucrul cu actions, iar acestea sunt cele mai des folosite:
- add_action(): atașează o funcție dată unui hook din cadrul procesului do_action.
- remove_action(): permite eliminarea unei funcții atașate unui anumit action hook.
- do_action(): aici sunt executate funcțiile conectate la hook.
- has_action(): verifică dacă un action a fost înregistrat sau nu.
În codul WordPress, actions sunt definite astfel:
do_action( 'action_name', );
Dacă te conectezi la action-ul do_action(‘wp_head’), poți executa cod propriu ori de câte ori WordPress procesează header-ul site-ului. Acest action nu are nevoie de argumente suplimentare.
Exemplu complet:
add_action( string $hook_name, callable $callback, int $priority = 10, int $accepted_args = 1 ): true
Referințe pentru toate actions:
https://codex.wordpress.org/Plugin_API/Action_Reference
https://developer.wordpress.org/reference/functions/add_action/
Filters:
Un filter modifică comportamentul implicit al unei anumite funcții. Face acest lucru prelucrând datele pe care le primește și returnându-le către WordPress înainte ca ele să fie afișate în browser.
Exemple:
- add_filter(): atașează o funcție unui hook
- remove_filter(): elimină o funcție atașată unui anumit filter hook
- doing_filter(): detectează orice filter aflat în execuție
- has_filter(): verifică dacă un filter a fost înregistrat
În codul WordPress, filters sunt definite astfel:
apply_filters( 'filter_name', 'value_to_be_filtered', );
Șirul filter_name este numele filtrului, variabila value_to_be_filtered este valoarea care trebuie filtrată și returnată, iar variabila suplimentară poate transmite argumente în plus, exact ca în cazul actions.
Exemplu: filtrul apply_filters( ‘admin_footer_text‘ , string $text ) poate fi folosit pentru a modifica textul afișat în subsolul zonei de administrare. Începând cu WordPress 5.4, valoarea sa implicită afișează în subsolul zonei de administrare propoziția Thank you for creating with WordPress.
|
Hook-uri WordPress |
|
| Actions | Filters |
| Actions se folosesc pentru a rula funcții proprii într-un anumit punct din execuția WordPress Core. | Filters se folosesc pentru a modifica sau a personaliza datele folosite de alte funcții. |
| Actions sunt definite/create în codul WordPress de funcția do_action( ‘action_name’ ). | Filters sunt definite/create în codul WordPress de funcția apply_filters( ‘filter_name’, ‘value_to_be_filtered’ ). |
| Actions se mai numesc și action hooks. | Filters se mai numesc și filter hooks. |
| Actions pot fi conectate doar prin funcții de tip action. De exemplu add_action(), remove_action(). | Filters pot fi conectate doar prin funcții de tip filter. De exemplu add_filter(), remove_filter(). |
| Funcțiile de tip action nu trebuie neapărat să transmită argumente către funcțiile lor callback. | Funcțiile de tip filter trebuie să transmită cel puțin un argument către funcțiile lor callback. |
| Funcțiile de tip action pot executa orice fel de sarcină, inclusiv schimbarea modului în care funcționează WordPress. | Funcțiile de tip filter există doar pentru a modifica datele pe care le primesc de la filtre. |
| Funcțiile de tip action nu ar trebui să returneze nimic. Pot însă să afișeze rezultatul cu echo sau să interacționeze cu baza de date. | Funcțiile de tip filter trebuie să returneze modificările ca rezultat. Chiar dacă o funcție de tip filter nu schimbă nimic, ea trebuie să returneze datele primite, nemodificate. |
| Actions pot executa aproape orice, atâta timp cât codul este valid. | Filters ar trebui să funcționeze izolat, ca să nu producă efecte secundare nedorite. |
În concluzie, dacă stăpânești hook-urile, actions și filters din WordPress, ai la dispoziție nenumărate moduri de a personaliza și îmbunătăți site-ul. Când înțelegi cum funcționează hook-urile, când folosești puterea actions și flexibilitatea filters, poți modela funcționalitatea și aspectul site-ului exact după nevoile tale. Cu ce ai aflat din acest ghid, ești pregătit să preiei controlul complet asupra propriului parcurs de dezvoltare pe WordPress. Așadar, experimentează și creează experiențe remarcabile pentru utilizatorii tăi. Profită de versatilitatea hook-urilor, actions și filters din WordPress și descoperă adevăratul potențial al site-ului tău. Spor la programat!
Te interesează viitorul WordPress? Citește acest articol!