API-ul pentru setările WordPress, Partea 1 Ce este, de ce contează

Așa cum am menționat de mai multe ori aici pe WP Tuts (și după cum ați văzut fără îndoială), nu a fost niciodată un moment mai bun pentru a fi un WordPress Developer. Fie că este vorba de o activitate client sau de dezvoltare a produsului (fie cu teme sau pluginuri), începerea ecosistemului WordPress este aproape o chestiune de "unde" mai degrabă decât de "cum".

WordPress are o documentație stelară API pentru dezvoltatori, indiferent de nivelul de experiență. Dar o comunitate de dezvoltare activă și un API bine documentat nu fac o platformă imună la practici de dezvoltare proastă.

Ca și în cazul majorității aspectelor dezvoltării web, doar pentru că lucrurile nu înseamnă că a fost construit calea cea bună. Dar, în calitate de dezvoltatori și meșteșugari, suntem însărcinați să ne asigurăm că lucrarea pe care o lansăm funcționează și este construită în mod corespunzător. Vărsarea codului sursă pentru o varietate de teme sau pluginuri arată că dezvoltatorii eliberează produse care funcționează dar care nu sunt arhitecturale în cel mai bun mod posibil. Acest lucru este valabil mai ales în cazul opțiunilor tematice, al paginilor de meniu, al validării și așa mai departe.

Și vrem să oprim asta.

În această serie, vom face o adâncă scufundare în API-ul WordPress Settings. Vom analiza ceea ce este, de ce contează și cum să-l folosim în munca noastră.

Scopul nostru final este ca această serie să fie o referință solidă pentru API-ul Setări fără deosebire din nivelul dvs. de experiență. Până la urmă, ar trebui să aveți o înțelegere clară a API și exemple solide de a face lucrurile corect.

Pentru a fi complet, trebuie să începem la zero zero. Deci, înainte de a scrie orice cod sau de a lucra prin orice exemple, trebuie să introducem API-ul Settings, ce este și de ce contează.


Setarea API pentru setări

La nivelul cel mai de bază, setările API reprezintă un set de funcții oferite de WordPress, care simplifică procesul de introducere a meniurilor, paginilor de opțiuni și salvarea, validarea și preluarea intrărilor de utilizatori.

Destul de ușor, corect?

De-a lungul acestei serii, vom fi scufundări în fiecare aspect, dar acest lucru ar trebui să ofere o definiție simplă, din care să putem lucra pe tot restul articolelor.

De ce ar trebui să folosim API-ul Setări?

Acum că înțelegem ce înseamnă API-ul pentru setări este, trebuie să ne uităm de ce am vrea să folosim acest lucru, spre deosebire de manipularea intrării, serializării și validării de către utilizatori, toate pe cont propriu.

Comunica cu WordPress Core

API-ul pentru setări este furnizat de dezvoltatorii platformei WordPress pentru a facilita extinderea aplicației. Ca atare, nu ar fi logic să se utilizeze funcțiile furnizate de autori ai platformei în sine?

Sigur, este complet posibil să se eludeze aceste funcții și "forța bruta" propria noastră funcționalitate și nimeni altcineva nu-l poate opri cu adevărat, dar acest lucru necesită o muncă inutilă în numele nostru, ignoră recomandările echipei WordPress Core și poate în cele din urmă să spargă experiența coezivă din tabloul de bord.

Optați să utilizați funcționalitatea furnizată pentru dezvoltatorii de dezvoltatorii se asigură că vom comunica corect cu aplicația de bază.

Lucruri gratuite out-of-the-box

Folosind API-ul Setări nu trebuie să vă asigurați că ne apropiem de dezvoltarea prin canalele recomandate. De asemenea, trebuie să ne asigurăm că interfețele utilizatorilor respectă cele mai bune practici ale platformei și că datele noastre sunt dezinfectate folosind aceleași mecanisme pe care le utilizează restul de WordPress. Nu doare că nu ne poate salva prea mult timp.

Când începeți să vă construiți interfețele în așa fel încât să utilizeze stilurile WordPress existente și utilizând API-ul Setări, munca dvs. va arăta mult mai strâns integrată cu restul sistemului.

Acest lucru înseamnă că atunci când utilizatorii încep să-ți folosească munca, nu vor simți ca și cum ar folosi o utilitate terță parte atunci când lucrează cu blogul lor. În schimb, lucrează cu un accesoriu (spre deosebire de, de exemplu, o adăugare) la platforma de bază.

Desigur, utilizarea stilurilor WordPress native nu este o parte adevărată a setărilor API, iar cele de mai sus sunt oarecum o perspectivă subiectivă, dar aspectele API-ului Setări - cum ar fi introducerea paginilor de meniu - leagă stilurile WordPress native. Nu are sens atunci că restul muncii tale ar trebui să urmeze exemplul?

Mai sigur, mai rezistent

Profitând de funcțiile care sunt originale pentru WordPress, și nu cu utilizarea propriilor dvs., puteți fi siguri că salvarea, recuperarea și validarea setărilor este gestionată corect. La urma urmei, API-ul Setări oferă o mare parte din aceleași funcționalități pe care se bazează aplicația de bază.

În plus, API-ul pentru setări se supune acelorași reguli ca restul API-ului WordPress. Astfel, atunci când aplicația este actualizată și / sau sunt introduse modificări, funcțiile vor trebui să treacă prin procesul obișnuit de depreciere. Acest lucru vă oferă timp suficient pentru a lucra la îmbunătățirea proiectului înainte de pauze de compatibilitate. Acest lucru nu este neapărat cazul în cazul în care doriți să vă rolați funcționalitatea proprie.

Foaie de parcurs viitoare

În acest moment, ar trebui să aveți o înțelegere clară a ceea ce este Setarea API și de ce ar trebui să îl utilizați în tema și plugin-ul de lucru.

Bineînțeles, acest lucru este puțin argumentativ - totuși, de fapt, trebuie să ne uităm la exemple practice. În restul seriei vom analiza următoarele:

  • Meniuri, secțiuni și navigare cu file
  • Înregistrarea setărilor secțiunilor
  • Elemente elementare (intrări, textare, selectează, butoane radio și casete de selectare)
  • Un exemplu simplu, de lucru

Până la sfârșitul seriei, trebuie să aveți tot ce aveți nevoie pentru a începe să creați produse WordPress solide.

Cod