Cincizeci de acțiuni ale WordPress - o introducere

Motivul pentru care WordPress este cel mai popular sistem de management al conținutului din lume este, bineînțeles, flexibilitatea sa. Structura frumos simplă a "cârligelor" oferă WordPress această abilitate. Fără cârligele de filtrare și cârligele de acțiune, WordPress nu ar fi extensibil la fel de mult și nu am putea să avem un spectru atât de vast de pluginuri sau teme WordPress.

În această serie, vom trece prin acțiuni, unul dintre cele două tipuri de cârlige WordPress. În cursul seriei, vom acoperi aproape tot ce trebuie să știți despre acțiuni:

În prima parte,care, de asemenea, se întâmplă să fie acest articol, vom învăța ce acțiuni WordPress sunt și cum să utilizați acțiuni cu șapte funcții de bază.
În următoarele cinci părți, vom vedea un set impresionant de exemple despre acțiunile WordPress. În fiecare parte, vom trece prin 10 acțiuni prin aflarea a ceea ce sunt bune și făcând un exemplu pentru fiecare acțiune.
În finalul seriei, vom recapta ceea ce am învățat și cele 50 de exemple de acțiune pe care le-am făcut.

Va fi o plimbare lungă, incredibilă. Răsuciți-vă!

Ce este o acțiune WordPress?

În Cod, acțiunile sunt definite după cum urmează:

Acțiunile sunt declanșate de anumite evenimente care au loc în WordPress, cum ar fi publicarea unei postări, schimbarea temelor sau afișarea unui ecran de administrare. Acțiunea este o funcție personalizată PHP definită în pluginul (sau tema) și coroiat, adică să răspundă, la unele dintre aceste evenimente.

Deci, în esență, acțiunile sunt funcții declanșate de un eveniment WordPress și executate înainte sau după eveniment. Acțiunile sunt unul dintre cele două tipuri de "cârlige" din WordPress - cealaltă se numește "filtre" pe care le-am acoperit cu ceva timp în urmă - consultați "Cincizeci de filtre ale WordPress" dacă doriți să aflați mai multe despre filtrele WordPress.

Utilizarea acțiunilor în WordPress

Definirea acțiunilor este cel mai ușor lucru pe care îl vom face în această serie. Din fericire, învățarea modului de a crea și de a folosi acțiuni este aproape la fel de ușor. Să vedem cum asociem funcții la acțiuni, creează noi acțiuni, eliminăm cele existente și alte funcții legate de acțiune în nucleul WordPress.

Apelarea unei funcții la o acțiune

Probabil cea mai ușoară funcție dintre acestea este aceea: Este folosit pentru a ne încadra funcția în cârligul de acțiune pe care îl vom folosi:

Să vedem ce înseamnă acești parametri:

$ hook_name este numele cârligului de acțiune pe care îl vom folosi
$ FUNCTION_NAME este numele funcției noastre
prioritate $ este un număr întreg pe care îl specificăm pentru a stabili cât de devreme va funcționa funcția în cârligul de acțiune
$ argumente este numărul de argumente pe care funcția noastră le folosește și cârligul de acțiune permite

Să vedem un exemplu rapid:

Aproape prea ușor, corect?

Eliminarea funcțiilor dintr-un cârlig de acțiune

Avem două funcții pentru a elimina funcțiile de la cârligele de acțiune: remove_action () și remove_all_actions (). Să vedem cum le folosim:

remove_action () funcția are trei parametri: numele cârligului, numele funcției pe care o vom elimina din cârligul și prioritatea care a fost setată în timpul utilizării ADD_ACTION (). remove_all_actions () funcția nu are funcția $ FUNCTION_NAME , deoarece elimină toate funcțiile legate de acțiune.

Crearea unui cârlig de acțiune

Dacă dezvoltați pluginuri sau teme WordPress, bunele sale practici de a crea niște cârlige în codul dvs., astfel încât alți dezvoltatori să poată extinde pluginul sau tema. Pentru a face acest lucru, avem din nou două funcții: do_action () și do_action_ref_array (). Să vedem cum funcționează primul:

După cum puteți vedea, funcția are practic un număr infinit de parametri, deoarece puteți defini cât mai multe argumente de care aveți nevoie. Dacă trebuie să păstrați argumentele într-o matrice, trebuie să utilizați a doua funcție:

Recuperarea numărului de ori este declanșată o acțiune

Dacă vreodată trebuie să știți de câte ori este apelată o acțiune, puteți utiliza această funcție la îndemână pentru a număra apelurile de acțiune:

După cum puteți vedea, singurul parametru pe care îl are funcția este numele cârligului de acțiune.

Verificați dacă ceva este dependent de o acțiune

Imaginați-vă că dezvoltați o extensie pentru un plugin popular WordPress și trebuie să verificați dacă utilizatorul a instalat plugin-ul sau nu. (În fond, pluginul dvs. nu va funcționa dacă celălalt nu este instalat și activat.)

Pentru ao verifica, puteți utiliza funcția has_action () pentru a vă asigura că acțiunea pluginului popular este disponibilă:

La fel ca și did_action () funcția, has_action () funcția are un singur parametru: numele cârligului de acțiune.

Concluzie

Acum am acoperit destul de mult totul despre crearea și folosirea acțiunilor, putem continua o călătorie de cinci articole în exemple de acțiune. Vom revizui numai cincizeci dintre ei, dar dacă sunteți curioși, puteți găsi mai multe sute de miezuri.

Sper că vă veți bucura de această serie la fel de mult ca și când am creat totul. Dacă credeți că puteți să mă ajutați cu tutorialele sugerând mai multe acțiuni și cerând mai multe exemple, nu ezitați să-mi spuneți și împărtășiți gândurile dvs. comentând mai jos. Și dacă ți-a plăcut ce citești în această serie, nu uita să împărtășești articolele!

Ne vedem în tutorialul următor!

Cod