Share
Care sunt standardele WordPress de codare PHP? În acest videoclip din cursul meu, Invata PHP pentru WordPress, veți afla totul despre standardele de codare și de ce sunt importante.
Puteți găsi standardele complete de codare WordPress PHP în manualul oficial WordPress.
Sunt în esență un set de cele mai bune practici privind utilizarea PHP în WordPress. Vom trece prin câteva exemple despre ceea ce înseamnă acest lucru în practică în restul acestui tutorial.
După cum puteți vedea, există standarde nu numai pentru PHP, ci și pentru accesibilitate și pentru celelalte limbi pe care le-ați folosi în WordPress.
De ce este important să respectăm toate aceste standarde?
Există două motive. Unul dintre ele se referă la calitatea codului, iar celălalt este vorba de consistență.
În primul rând, calitatea este importantă deoarece înseamnă că toată lumea care codifică în WordPress creează un cod care va funcționa, care își va face treaba și care va fi scris într-o manieră actuală și de înaltă calitate.
Cel de-al doilea, care este vorba despre consistență, este la fel de important. Este foarte probabil ca din când în când să lucrați cu codul altor persoane. De exemplu, dacă creați o temă de copil, este posibil să copiați un anumit cod din tema părinte. Și dacă creați un plugin, acest plugin ar putea fi o furcă a unui plugin terță parte existent pe care îl copiați și adăugând funcții suplimentare. Este foarte important ca modul în care codați să fie compatibil cu modul în care toți ceilalți care codifică PHP pentru WordPress scriu ei înșiși codul.
Deci, să aruncăm o privire asupra unora dintre standardele de codare PHP. Și vă voi arăta exemple de acest lucru în unele dintre fișierele din tema mea.
Să începem cu convențiile de numire și cu cazurile. Când vă gândiți să numiți convenții, trebuie să vă gândiți la patru lucruri:
Deci, să începem cu funcții. Iată fișierul functions.php din tema mea ca exemplu.
Puteți vedea că am o funcție pe care am definit-o numită rachelmcc_register_widgets. Toate acestea sunt scrise cu litere mici, iar eu folosesc subliniere între cuvinte, care este modul în care trebuie să scrieți întotdeauna o funcție în WordPress.
După cum veți vedea, am folosit un prefix. Asta pentru a vă asigura că această funcție nu contravine altor funcții care ar putea fi furnizate de tema mea sau de un alt plugin. Deci, dacă am scris o funcție care tocmai a fost chemată register_widgets și unul dintre pluginurile mele a avut de asemenea o funcție numită register_widgets, cei doi se puteau ciocni. S-ar putea să găsiți că unul dintre ele suprascrie celălalt sau că plugin-ul nu funcționează.
Deci, în schimb, folosesc o funcție unică care este relevantă pentru tema mea. Tema mea este numită rachelmccollin, astfel încât funcțiile mele au rachelmcc ca prefix. Și este, de asemenea, important să utilizați subliniere pentru funcțiile dvs. și să nu utilizați cratime.
Tu do utilizați cratime în două locuri. În primul rând, utilizați cratime atunci când definiți clasele CSS. Deci, puteți vedea că în widgeturile mele, eu definesc clasele CSS pentru mine h3 element și, de asemenea, pentru id din acea zonă widget. Și aici, utilizați cratime.
Celălalt loc pe care îl utilizați în cratime este numele dvs. de fișier. Deci, aceasta este front-page.php.
Ar trebui să utilizați întotdeauna cratime în numele fișierelor în cadrul temelor și pluginurilor; nu utilizați sublinieri. Deci aici este un apel folosind locate_template. Și loop-frontpage.php este un fișier, o parte de șablon pe care o sun, și puteți vedea că are o cratimă și nu o subliniere.
Pe de altă parte, ID-ul meu tip post, care este un tip de post personalizat pe care l-am înregistrat, folosește o subliniere: rmcc_blurb.
Acum, de asemenea, ar trebui să vă gândiți la variabilele din cadrul temei. Să ne uităm la loop-frontpage.php:
În cadrul acestui fișier special, care este cel pe care l-am sunat din acel fișier anterior, am definit câteva variabile, una numită numara și unul a sunat titlu. Și puteți vedea că folosesc litere mici pentru ambele.
Celălalt loc unde trebuie să te gândești la subliniere și capitalizare este când folosești o clasă. Să ne întoarcem la front-page.php:
Și puteți vedea aici, eu folosesc WP_Query clasă. Deci, o clasă are o literă mare după subliniere, precum și la început. Deci, acolo folosiți capitalizarea atunci când definiți o clasă. Îi ajută pe cei care lucrează cu codul să identifice instantaneu că este o clasă și nu o funcție.
Acum, să aruncăm o privire asupra modului în care ați folosi citatele single și duble în PHP pentru WordPress.
Puteți utiliza fie citate simple, fie ghilimele duble, în funcție de care funcționează cel mai bine pentru codul specific cu care lucrați.
Motivul pentru care citatele duble pot fi uneori mai utile este că ele fac mai ușor să lucrezi cu caractere speciale. Iată un exemplu:
Spuneți că scrieți un fișier de șablon de căutare, search.php. În acest caz, dacă nu s-ar găsi nimic, ați pune un paragraf care spune: "Îmi pare rău, căutarea dvs. nu a găsit nimic. De ce nu încercați din nou?"
Am pus acest lucru în ghilimele duble deoarece textul conține apostrofuri. Permiteți-mi să vă arăt cum ar funcționa dacă am face-o în citate simple.
Trebuie să puneți un backslash înaintea apostrofelor pentru ca acestea să fie afișate corect în HTML-altfel, vă va oferi erori. Acum nu știu despre tine, dar aș prefera să scriu în mod normal în citate dublă decât să fac toate acestea în cadrul citatelor simple.
Celălalt lucru pe care trebuie să-l amintiți este că dacă aveți nevoie să puneți citate în citate, fie puneți citate unice în ghilimele duble, fie invers. Nu contează în ce mod, dar nu puteți pune citate singulare în citate simple sau în citate duble în ghilimele duble.
Iată un exemplu care se întoarce la fișierul meu funcții.php.
În interiorul meu, am citate singulare pentru valoarea lui before_widget, și apoi, în interiorul meu, am ghilimele duble pentru ID-ul și clasa aia. Nu am putut folosi citate duble aici și apoi am pus citate în interiorul ei, de aceea folosesc citate simple acolo, pentru că este mai bine să folosiți citate duble cu CSS.
Acum, să ne uităm la indentare. Și să continuăm să ne uităm la fișierul functions.php, care este un exemplu destul de bun pentru că am încadrat un număr de linii de cod în el.
Puteți vedea că numele funcției se află în partea stângă și apoi în interiorul căruia este register_sidebar funcția este indentată la un nivel. Și conținutul aia este din nou indentat.
Deci, de fiecare dată când puneți conținut în bretele sau bretele curl, tot ceea ce trebuie să fie îndoit în interior. Și, de asemenea, pentru indentare, ar trebui să utilizați pauze de linie.
Deci, să aruncăm o privire la un alt fișier în care există linii unice, precum și linii duble.
Deci, aici puteți vedea că am unul dacă afirmația că are două linii de cod în el. Așa că am pus o ruptură de linie deasupra și dedesubtul celor două linii de cod.
Dacă ar exista o singură linie de cod înăuntru, nu ar fi trebuit să pun acele spații de linie înăuntru - aș pune doar acea dreaptă în coatele mele.
Folosind spații ca aceasta ajută să fie clar unde sunt blocurile de cod. Și puteți vedea, de asemenea, că indentarea a fost folosită. Deci, există mai multe straturi de indentare.
Celălalt lucru pe care trebuie să-l aveți în vedere este locul în care deschideți și închideți eticheta dvs. PHP și dacă aceasta se află pe aceeași linie ca și codul dvs. sau o altă linie. Și asta depinde și de faptul dacă codificați un bloc de cod sau o singură linie.
În cazul în care aveți un bloc de cod, introduceți eticheta de deschidere pe o linie și eticheta de închidere pe altă linie. Acest lucru ajută la a face evident că este un bloc de PHP și că totul în aceste etichete este PHP.
Celălalt lucru pe care trebuie să vă asigurați că faceți este să utilizați o etichetă PHP de deschidere completă. Deci, nu folosiți doar un semn de întrebare, așa cum ați fi făcut în alte sisteme care utilizează PHP, deoarece în WordPress trebuie să utilizați eticheta completă PHP.
Dacă am scris ceva PHP care se afla pe o singură linie, aș pune etichetele de deschidere și închidere PHP pe aceeași linie.
Puteți vedea că avem niște PHP care se află într-o singură linie, iar după aceea am HTML. Deci, etichetele de deschidere și de închidere merg pe aceeași linie cu codul meu.
Aceasta este o introducere la unele dintre elementele standardelor de codare WordPress PHP și ți-am arătat niște exemple de ele în fișierele mele și le-ai schimbat pe unele, așa cum am făcut-o, pentru a-ți arăta cum se fac lucrurile în mod corect.
Dacă doriți să aflați mai multe despre standardele de codificare, există documentație pe site-ul WordPress. De asemenea, puteți verifica această serie Envato Tuts +, care detaliază în detaliu toate elementele standardelor de codificare.
În cursul complet, aflați PHP pentru WordPress, veți afla totul despre PHP, limbajul de programare în care WordPress este construit.
Vă voi oferi o prezentare generală a ceea ce este PHP și modul în care este folosit pentru teme și pluginuri WordPress, cu exemple. Veți continua să învățați cum să creați un fișier PHP și să îl utilizați pentru a afișa codul HTML. Apoi veți învăța să utilizați funcții, bucle și dacă declarații pentru codarea temelor și pluginurilor personalizate WordPress.
Puteți lua acest curs imediat cu un abonament la Envato Elements. Pentru o singură taxă lunară redusă, veți avea acces nu numai la acest curs, ci și la biblioteca noastră în creștere de peste 1.000 de cursuri video și cărți electronice de vârf din industria Envato Tuts+.
În plus, obțineți descărcări nelimitate de la imensa bibliotecă Envato Elements de 580.000 de bunuri creative. Creează cu fonturi, fotografii, grafică și șabloane unice și oferă proiecte mai bune mai rapid.
Accentsconagua