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 mijenjanja izvornog koda. Hookovi su tačke u WordPress kodu gdje možete zakačiti svoje funkcije koje će se izvršiti u određenom trenutku ili modifikirati podatke koji prolaze kroz sistem. Bez hookova, svaka prilagodba bi zahtijevala direktnu izmjenu 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. Razumijevanje 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 funkcioniraju actions

Action hook je mjesto u WordPress kodu gdje je postavljen poziv do_action funkcije. Kada WordPress stigne do tog mjesta tokom izvršavanja, on provjerava da li postoje funkcije zakačene na taj hook i izvršava ih redom po prioritetu. Na primjer, 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štenje 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 podrazumijevanom vrijednošću 10 gdje niži broj znači ranije izvršavanje. Na primjer, 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 zahtijeva nakon učitavanja plugina. Idealan za registriranje 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 ovisnostima i izbjegavanje duplikata.
• admin_init: Okida se na početku svake admin stranice. Koristite za registriranje plugin podešavanja, provjeru 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 provjeru pristupa stranicama.

Filters - modifikacija podataka

Kako funkcioniraju filters

Filter hook funkcionira slično action hook-u ali sa ključnom razlikom - filter prima podatke, modifikira ih i vraća modifikirane podatke. WordPress koristi apply_filters funkciju da propusti podatke kroz sve zakačene filter funkcije. Svaka filter funkcija mora vratiti vrijednost jer u suprotnom podatak postaje prazan. Na primjer, 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štenje 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 modifikirani ili originalni podatak. Ako vaša filter funkcija ne vrati vrijednost, podatak će biti izgubljen što može slomiti sajt. Uvek testirajte filter funkcije da se uverite da vraćaju ispravnu vrijednost č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 modifikirati 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 generiranog excerpt-a. Podrazumijevana vrijednost je 55 reči.
• upload_mimes: Filtrira dozvoljene tipove fajlova za upload. Koristite za dodavanje podrške za SVG ili druge formate.

Kreiranje vlastitih hookova

Custom action hookovi

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

Custom filter hookovi

Koristite apply_filters na mjestima gdje želite da omogućite modifikaciju podataka. Na primjer, ako vaš plugin generira listu stavki, propustite niz stavki kroz filter pre prikazivanja. Drugi developeri mogu zakačiti filter da dodaju, uklone ili modifikiraju stavke. Za svaki filter jasno dokumentirajte tip podatka koji se filtrira, očekivani format povratne vrijednosti 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 registrira hookove u konstruktoru klase ili u funkciji za inicijalizaciju. Organizirajte kod u klase sa metodama za svaku funkcionalnost i koristite konstruktor za registriranje svih hookova na jednom mjestu. Ovo čini kod čitljivim i lakšim za održavanje jer možete videti sve hookove na jednom mjestu.

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 podrazumijevanih 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 uploadirane fajlove.

Best practices

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

Debugging hookova

Alati za debugging

Query Monitor plugin je nezaobilazan alat za debugging hookova koji prikazuje sve registrirane hookove, redosled izvršavanja i vrijeme 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 vrijednost š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 modifikira podatak na način koji ponovo okida isti filter. Koristite statičku promjenjivu ili flag da spriječite rekurziju. Pogrešan prioritet može uzrokovati da vaša funkcija ne radi jer je prethodni hook promijenio podatke na neočekivan način. Na BeoHosting WordPress hosting paketima imamo optimizirano 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 mjestu u sistemu. Razumijevanje 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štenim hookovima, eksperimentirajte sa prilagođavanjem i postepeno gradite kompleksnije funkcionalnosti. Ako tek instalirate WordPress, pogledajte naš vodič za instalaciju.