Vodič za WordPress hooks: actions i filters

Šta su WordPress hookovi

WordPress hook sistem je fundament koji omogućava proširivanje i modifikaciju WordPress sistema bez direktnog menjanja izvornog koda. Hookovi su tačke u WordPress kodu gde možete zakačiti svoje funkcije koje će se izvršiti u određenom trenutku ili modifikovati podatke koji prolaze kroz sistem. Bez hookova, svaka prilagodba bi zahtevala direktnu izmenu WordPress core fajlova koja bi bila izgubljena pri svakom ažuriranju.

Postoje dva tipa hookova - actions (akcije) i filters (filteri). Actions vam omogućavaju da izvršite kod u određenom trenutku WordPress-ovog životnog ciklusa, dok filters omogućavaju modifikaciju podataka pre nego što budu prikazani ili sačuvani. Razumevanje ova dva koncepta je ključno za svakog WordPress developera jer su temelj za kreiranje tema, plugina i prilagođenih funkcionalnosti.

Actions - izvršavanje koda u pravom trenutku

Kako funkcionišu actions

Action hook je mesto u WordPress kodu gde je postavljen poziv do_action funkcije. Kada WordPress stigne do tog mesta tokom izvršavanja, on proverava da li postoje funkcije zakačene na taj hook i izvršava ih redom po prioritetu. Na primer, wp_head action se okida unutar head taga svake stranice, wp_footer pre zatvaranja body taga, a init na početku svakog učitavanja WordPress-a nakon što su svi plugini učitani.

Korišćenje add_action

Funkcija add_action prima četiri parametra - naziv hook-a, callback funkciju, prioritet i broj argumenata. Prioritet određuje redosled izvršavanja kada je više funkcija zakačeno na isti hook, sa podrazumevanom vrednošću 10 gde niži broj znači ranije izvršavanje. Na primer, ako želite da dodate Google Analytics kod u header sajta, zakačite funkciju na wp_head hook sa prioritetom 1 da se izvrši među prvima. Ako želite da dodate CSS nakon svih plugina, koristite prioritet 99.

Najčešći action hookovi

• init: Okida se na početku svakog zahteva nakon učitavanja plugina. Idealan za registrovanje custom post tipova, taksonomija i shortcode-ova.
• wp_enqueue_scripts: Pravilan način za dodavanje CSS i JavaScript fajlova na frontend. Koristi wp_enqueue_style i wp_enqueue_script funkcije za upravljanje zavisnostima i izbegavanje duplikata.
• admin_init: Okida se na početku svake admin stranice. Koristite za registrovanje plugin podešavanja, proveru permisija ili redirekcije.
• save_post: Okida se kada se post sačuva ili ažurira. Idealan za čuvanje custom meta podataka, validaciju sadržaja ili slanje notifikacija.
• wp_login i wp_logout: Okidaju se pri prijavi i odjavi korisnika. Koristite za logiranje aktivnosti, redirekcije ili čišćenje keša.
• template_redirect: Okida se pre učitavanja template-a. Idealan za prilagođene redirekcije ili proveru pristupa stranicama.

Filters - modifikacija podataka

Kako funkcionišu filters

Filter hook funkcioniše slično action hook-u ali sa ključnom razlikom - filter prima podatke, modifikuje ih i vraća modifikovane podatke. WordPress koristi apply_filters funkciju da propusti podatke kroz sve zakačene filter funkcije. Svaka filter funkcija mora vratiti vrednost jer u suprotnom podatak postaje prazan. Na primer, the_content filter propušta sadržaj posta kroz sve zakačene funkcije pre prikazivanja, omogućavajući pluginima da dodaju social share dugmad, related posts ili reklame unutar sadržaja.

Korišćenje add_filter

Funkcija add_filter ima identičnu sintaksu kao add_action - naziv hook-a, callback funkciju, prioritet i broj argumenata. Ključna razlika je da callback funkcija mora primiti barem jedan argument koji predstavlja podatak za filtriranje i mora vratiti modifikovani ili originalni podatak. Ako vaša filter funkcija ne vrati vrednost, podatak će biti izgubljen što može slomiti sajt. Uvek testirajte filter funkcije da se uverite da vraćaju ispravnu vrednost čak i za granične slučajeve.

Najčešći filter hookovi

• the_content: Filtrira sadržaj posta pre prikazivanja. Plugini za formatiranje, shortcode-ovi i content modifikacije koriste ovaj filter.
• the_title: Filtrira naslov posta. Koristite za dodavanje prefiksa, sufiksa ili formatiranje naslova programatski.
• wp_mail: Filtrira email parametre pre slanja. Možete modifikovati primaoce, subjekt, sadržaj ili zaglavlja emaila.
• login_redirect: Filtrira URL na koji se korisnik preusmerava nakon prijave. Koristite za prilagođene redirekcije bazirane na korisničkoj ulozi.
• excerpt_length: Filtrira dužinu automatski generisanog excerpt-a. Podrazumevana vrednost je 55 reči.
• upload_mimes: Filtrira dozvoljene tipove fajlova za upload. Koristite za dodavanje podrške za SVG ili druge formate.

Kreiranje sopstvenih hookova

Custom action hookovi

Kada razvijate plugin ili temu, kreiranje sopstvenih hookova omogućava drugim developerima da prošire vašu funkcionalnost bez menjanja vašeg koda. Postavite do_action pozive na mestima gde želite da omogućite proširenja - na primer pre i posle prikazivanja forme, pre čuvanja podataka ili nakon obrade narudžbine. Imenujte hookove sa prefiksom vašeg plugina da izbegnete konflikte sa drugim pluginima na primer mojplugin_pre_save_data. Dokumentujte dostupne hookove sa opisom kada se okidaju i koje argumente prosleđuju.

Custom filter hookovi

Koristite apply_filters na mestima gde želite da omogućite modifikaciju podataka. Na primer, ako vaš plugin generiše listu stavki, propustite niz stavki kroz filter pre prikazivanja. Drugi developeri mogu zakačiti filter da dodaju, uklone ili modifikuju stavke. Za svaki filter jasno dokumentujte tip podatka koji se filtrira, očekivani format povratne vrednosti i kontekst u kom se filter koristi. Ovo čini vaš plugin prijatnim za proširivanje i smanjuje potrebu za direktnim modifikacijama.

Plugin development sa hookovima

Struktura plugina

Svaki WordPress plugin počinje sa header komentarom koji sadrži ime plugina, opis, verziju, autora i licencu. Glavni fajl plugina tipično registruje hookove u konstruktoru klase ili u funkciji za inicijalizaciju. Organizujte kod u klase sa metodama za svaku funkcionalnost i koristite konstruktor za registrovanje svih hookova na jednom mestu. Ovo čini kod čitljivim i lakšim za održavanje jer možete videti sve hookove na jednom mestu.

Aktivacija i deaktivacija

WordPress pruža specijalne hookove register_activation_hook i register_deactivation_hook koji se okidaju pri aktivaciji i deaktivaciji plugina. Aktivacioni hook koristite za kreiranje tabela u bazi podataka, postavljanje podrazumevanih opcija i zakazivanje cron poslova. Deaktivacioni hook koristite za čišćenje zakazanih cron poslova i privremenih podataka. Za potpuno uklanjanje podataka pri brisanju plugina, kreirajte uninstall.php fajl koji briše opcije iz baze, custom tabele i uploadovane fajlove.

Best practices

Uvek koristite prefikse za nazive funkcija i klasa da izbegnete konflikte sa drugim pluginima. Proveravajte da li hook postoji pre registrovanja da izbegnete greške. Koristite has_action i has_filter da proverite da li je neko već zakačen na određeni hook. Uklanjajte hookove sa remove_action i remove_filter kada je potrebno modifikovati ponašanje drugog plugina ili teme. Prioritet je ključan kod uklanjanja - morate koristiti isti prioritet koji je korišćen pri dodavanju.

Debugging hookova

Alati za debugging

Query Monitor plugin je nezaobilazan alat za debugging hookova koji prikazuje sve registrovane hookove, redosled izvršavanja i vreme koje svaki hook troši. WP_DEBUG konstanta u wp-config.php omogućava prikaz PHP grešaka i upozorenja koja pomažu u otkrivanju problema sa hookovima. Debug Bar plugin dodaje panel u admin traci sa informacijama o hookovima, upitima baze podataka i memorijskoj potrošnji. Za napredni debugging, Xdebug sa VS Code-om omogućava postavljanje breakpoint-ova unutar hook callback funkcija.

Česte greške

Najčešća greška je filter funkcija koja ne vraća vrednost što rezultira praznim sadržajem. Druga česta greška je neusklađen broj argumenata između registracije hooka i callback funkcije. Beskonačna petlja nastaje kada filter modifikuje podatak na način koji ponovo okida isti filter. Koristite statičku promenljivu ili flag da sprečite rekurziju. Pogrešan prioritet može uzrokovati da vaša funkcija ne radi jer je prethodni hook promenio podatke na neočekivan način. Na BeoHosting WordPress hosting paketima imamo optimizovano okruženje za razvoj plugina sa podrškom za debugging alate i dovoljno PHP memorije za kompleksne hook lance.

Zaključak

WordPress hook sistem je moćan i elegantan mehanizam koji omogućava beskrajno proširivanje WordPress-a. Actions vam daju mogućnost da izvršite kod u pravom trenutku dok filters omogućavaju modifikaciju podataka na bilo kom mestu u sistemu. Razumevanje hookova je ključno za prelazak sa korisnika na developera i otvara vrata kreiranju profesionalnih plugina i tema. Počnite sa najčešće korišćenim hookovima, eksperimentišite sa prilagođavanjem i postepeno gradite kompleksnije funkcionalnosti. Ako tek instalirate WordPress, pogledajte naš vodič za instalaciju.