9 greșeli de evitat atunci când dezvoltați pluginuri sau teme WordPress

Doriți să construiți un plugin sau o temă WordPress? Rețineți că dezvoltarea de succes a pluginurilor și a temei include unele încercări și erori. Chiar și cei mai experimentați dezvoltatori își încurcă ocazional codul și, deși este imposibil să eviți complet greșelile, există unele erori comune pe care le poți evita cu ușurință. Pentru a vă ajuta, am adunat nouă greșeli comune de evitat atunci când vă dezvoltați pluginul sau tema WordPress.

Greșeala #1: Sacrificarea calității în favoarea soluțiilor rapide

Unii dezvoltatori încearcă să găsească o comandă rapidă atunci când dezvoltă un mic plugin sau o temă. Ei codifică inconsecvent și încearcă să găsească cele mai simple și mai rapide soluții.

Cu toate acestea, adevărul este că nu există o modalitate ușoară de a dezvolta un plugin sau o temă avansată, care funcționează bine. Unele plugin-uri și teme pot fi dezvoltate relativ rapid și ușor. De exemplu, nu va dura mult timp pentru a dezvolta un plugin care ascunde toate notificările de administrator sau un plugin care injectează un fragment JavaScript. Cu toate acestea, atunci când vine vorba de pluginuri sau teme mai complexe, „înșelarea” sau copierea poate duce la funcționalitate slabă, precum și poate provoca diverse erori și defecte de performanță.

Este esențial să urmați cele mai bune practici de codare organizată chiar dacă doar construiți un prototip de plugin/temă. Amintiți-vă, multe dintre cele mai populare produse au început ca prototipuri. Dacă alegeți o abordare „rapidă și murdară”, veți începe să acumulați datorii tehnice din prima zi.

Dezvoltarea unui cod curat, bine scris și optimizat vă va crește timpul de dezvoltare cu 10-30%, dar cu siguranță merită pe termen lung. La sfârșitul zilei, veți obține un plugin sau o temă care poate fi întreținută, performantă și funcțională.

Greșeala nr. 2: Eșecul în urmărirea modificărilor codului

Eșecul de a urmări modificările codului este o altă greșeală comună pe care toți dezvoltatorii WordPress ar trebui să o evite. Toate temele și pluginurile ar trebui gestionate sub controlul versiunilor, indiferent dacă sunteți sau nu singurul dezvoltator al proiectului.

Toate temele și pluginurile ar trebui gestionate sub controlul versiunilor, indiferent dacă sunteți sau nu singurul dezvoltator al proiectului.Tweet

Sistemele de control al versiunilor vă ajută prin înregistrarea și urmărirea tuturor modificărilor. Acest lucru vă permite dvs. și altor dezvoltatori să lucrați la același proiect pe măsură ce o temă sau un plugin se dezvoltă în continuare. De asemenea, sistemele de control al versiunilor, cum ar fi Git, înregistrează toate modificările efectuate de fiecare dintre dezvoltatori, ceea ce este deosebit de convenabil atunci când lucrați la un proiect mare. Dacă alegeți să utilizați Git, vă recomand să utilizați GitFlow ca flux de lucru sănătos de ramificare pentru gestionarea versiunilor.

Greșeala #3: Eșecul în utilizarea spațiilor de nume

Spațiile de nume sunt utile dacă trebuie să creați regiuni separate pentru grupuri de variabile, clase și funcții. Acest lucru previne conflictele de plugin care au fost prezente înainte de versiunile PHP 5.6 și mai recente care nu au putut fi controlate folosind spațiile de nume.

Iată un exemplu de cod sursă care ilustrează spațiul de nume numit geometrie pentru JavaScript. Această definiție a unui pachet permite o modalitate de diferențiere a clasei Circle de alte clase care ar putea fi definite de alți programatori.

namespace Geometry;

class Circle {
    private $radius;

    public circle($r) {
        $radius = $r;
    }

    public get_radius() {
        return $radius;
    }
   
    public get_area() {
        return pi() * $radius * $radius;
    }
}

Greșeala #4: Nu folosiți nonces WordPress

Respectarea practicilor moderne de securitate este la fel de importantă ca și asigurarea funcționalității pluginului sau temei dvs. WordPress folosește nonces pentru a oferi un anumit nivel de protecție pentru a valida autenticitatea solicitărilor. Nonces-urile sunt deosebit de utile în prevenirea atacurilor Cross-Site Request Forgery (CSRF).

Pentru a crea un nonce, utilizați următoarea funcție.

$nonce= wp_create_nonce( 'name');

Consultați această referință de cod WordPress dacă nu sunteți familiarizat cu non-uri.

Abonați-vă și obțineți o copie gratuită a documentului nostru

Cartea de afaceri cu pluginul WordPress

Exact cum să creezi o afacere prosperă cu pluginuri WordPress în economia abonamentului.

Distribuie unui prieten

Introdu adresa de e-mail a prietenului tău. Le vom trimite prin e-mail doar această carte, onoarea cercetașului.

Vă mulțumesc pentru partajarea

Minunat - tocmai a fost trimisă o copie a „Cartea de afaceri cu pluginuri WordPress”. . Vrei să ne ajuți să răspândim și mai mult cuvântul? Continuă, împărtășește cartea cu prietenii și colegii tăi.

Multumesc pentru abonare!

- tocmai v-am trimis copia „The WordPress Plugin Business Book” către .

Distribuie unui prieten Retrimite e-mail

Ai o greșeală de scriere în e-mail? faceți clic aici pentru a edita adresa de e-mail și a trimite din nou.

Descarca

Greșeala #5: Nu folosiți funcționalitatea de bază WordPress

Mulți dezvoltatori nu reușesc să utilizeze întregul potențial al funcționalității de bază WordPress existente. Unele teme și pluginuri au fișiere care corespund fișierelor de bază WordPress, cum ar fi Color Pickers și jQuery.

Crearea de fișiere suplimentare va crește dimensiunea finală a pachetului și timpul de încărcare. Va trebui să mențineți și să actualizați aceste fișiere în mod regulat, ceea ce necesită, de asemenea, timp și efort.

Utilizând ceea ce WordPress are de oferit, puteți crea teme sau plugin-uri mai ușoare și funcționale.

Greșeala #6: Punerea în coadă a fișierelor JavaScript și CSS

Punerea în coadă a fișierelor JavaScript și CSS atunci când nu sunt necesare este o altă greșeală comună. Acest lucru poate duce la un timp de încărcare mai lent și la scăderea clasamentului motorului de căutare, deoarece fiecare fișier pus în coadă adaugă o solicitare HTTP suplimentară.

Greșeala #7: Plasarea codului JavaScript într-un singur fișier principal pentru teme avansate

Dacă dezvoltați o temă avansată, care necesită JavaScript, este mai bine să vă abțineți de la plasarea codului JavaScript într-un singur fișier principal. Mulți dezvoltatori aleg să plaseze codul JavaScript pentru tema WordPress într-un fișier principal numit main.js, theme.js sau custom.js. Există mai multe motive pentru care nu vrei să faci asta. În primul rând, pe măsură ce tema dvs. va crește în cele din urmă, dimensiunea fișierului va crește și ea. Deoarece acest fișier va fi încărcat pe tot site-ul, încărcarea fiecărei pagini va dura mai mult.

În al doilea rând, crearea unui singur fișier va îngreuna gestionarea codului. De exemplu, nu veți putea plasa funcții, cum ar fi wp_dequeue_script() pentru a descărca codul în unele pagini pentru a îmbunătăți viteza.

Iată un videoclip care explică puțin mai multe despre acest subiect:

Rețineți că această greșeală este relevantă numai pentru temele avansate cu o structură JavaScript complexă. Dacă tema dvs. este mai simplă și mai ușoară în JavaScript, plasarea codului JavaScript în fișierul principal nu va afecta funcționalitatea temei.

Greșeala #8: Eșecul de a crea opțiuni suplimentare pentru modificarea codului

Când o actualizare automată este efectuată direct asupra codului, toate modificările manuale ale codului se vor pierde dacă nu sunt modificate prin acțiuni și filtre. De aceea este atât de important să activați acțiuni și filtre pentru modificări.

În acest fel, dumneavoastră și alți dezvoltatori veți putea modifica funcțiile fără a edita pluginul în sine sau tema părinte. În plus, veți putea folosi filtrele și acțiunile pentru a adăuga funcționalități suplimentare, cum ar fi extensii sau suplimente, pluginului sau temei părinte.

Greșeala #9: Eșecul în utilizarea practicilor moderne de proiectare a codului

Eșecul de a folosi practicile corecte de proiectare a codului este ultima greșeală care închide lista noastră. Organizarea corectă a codului trebuie aleasă în funcție de dimensiunea și natura pluginului dvs.

Dacă intenționați să construiți un mic plugin cu un singur scop care nu necesită o extensie suplimentară, mai târziu, nu este nevoie să utilizați arhitectura complicată cu diferite clase.

Dacă construiți o extensie de plugin care funcționează cu alte pluginuri sau un plugin care necesită mult cod, este mai bine să utilizați abordarea de programare orientată pe obiecte (OOP). Ideea principală din spatele OOP este aranjarea codului în bucăți, cum ar fi clasele pentru o mai bună organizare.

De asemenea, nu recomand să amestecați codul PHP și codul HTML împreună. Este mai bine să le țineți separate folosind modelul Model-View-Controller (MVC), mai ales dacă pluginul dvs. este întreținut de mai mulți dezvoltatori.

Concluzii

După cum ați învățat mai sus, cele mai frecvente greșeli sunt de obicei neintenționate, dar pot duce la consecințe destul de dezamăgitoare.

În revizuire, cele mai frecvente greșeli sunt:

1. Sacrificarea calității în favoarea soluțiilor rapide
2. Nu se pot urmări modificările codului
3. Nu se utilizează spațiile de nume
4. Nu se utilizează WordPress non-uri
5. Nu se utilizează funcționalitatea de bază WordPress
6. Pune în coadă fișiere JavaScript și CSS
7. Plasarea codului JavaScript într-un singur fișier principal pentru teme avansate
8. Nu se creează opțiuni suplimentare pentru modificarea codului
9. Neutilizarea practicilor moderne de proiectare a codului

Deși să faci greșeli este inevitabil, acum că știi care sunt acestea, va fi mai ușor să le eviți.

Ați făcut și alte greșeli când v-ați creat tema sau pluginul? Vă rugăm să împărtășiți experiența dumneavoastră în comentariile de mai jos și să nu ratați aceste alte 5 greșeli de evitat.

Cu contribuții de la Alyse Falk.