Wordpress

WordPress kodeketa estandarrei hurbilagotik begiratzea

W3tech-en arabera, edukiak kudeatzeko sistema erabiltzen duten webguneen % 65.1ak WordPress-en funtzionatzen du. PHP hizkuntzan idatzitako kode irekiko CMS ospetsua da. Gai eta plugin pertsonalizatuen sorta anitza dela eta, SaaS hornitzaile eta marketin digitaleko agentzia askok WordPress erabiltzen dute webguneak sortzeko.

Zergatik sartu zituen WordPress-ek kodeketa estandarrak?

WordPress kode irekiko software masiboa denez, exekutatzeko iturburu-kode handi batez osatuta dago. Hainbat garatzailek data honetarako egindako ekarpena dela eta. Kodeketa hainbat estilotan egin daitekeenez, garatzaileek ezagutzen duten edozein motatako kodea gehi dezakete WordPress plataformara. Horrek konplikazioak sor ditzake WordPress-en.

WordPress-en iturburu-kodean kodeketa-estilo anitz ezarriko balira, software-garatzaile ezberdinek softwarearen aplikazioak irakurtzea eta zabaltzea izango litzatekeen konplexua izango litzateke. DevOps-eko langileek kode-estilo desberdinak eskaneatzen dituztenak zaila izango litzateke akatsak identifikatzea. Horrek webguneak abiaraztean huts egitea eragin dezake, enpresei bezeroen galerari dagokionez kalteak eraginez.

Egoera horiek saihesteko, WordPress-ek kodeketa estandarrak sartu zituen. Garatzaileek WordPress-en funtzionaltasuna hedatzerakoan derrigorrezkoa den araudi multzoa zen.

Kodetze estandarrek kode-laginen bolumenak kudeatzeko eta ebaluatzeko prozesua errazten dute. Hau da, formatu-estilo berdinak jarraitzen dituztelako, garatzaile ezberdinek iturburu-kodean gertatzen dena ulertzea erraztuz. Orokorrean, kodetze estandarrek beste garatzaile batzuek emandako iturburu-kodeen kalitatea mantentzen laguntzen dute.

Zein kodetze estandar erabiltzen ditu WordPress-ek?

WordPress ez da PHP hizkuntzaren menpe soilik. HTML, CSS eta JavaScript ere erabiltzen ditu. Beraz, bere kodetze estandarrak programazio-lengoaia horien arabera aldatzen dira. Zure WordPress plugina sortzeko eta WordPress plataforma hobetzeko gogoz bazabiltza, hona hemen zure kodea sortzean jarraitu behar dituzun kodeketa estandarrak.

1. PHPrekin kodetzea

Kodetze uniforme, garbi eta ulergarriaren ekarpena egiteko, WordPress-ek PHP markaketarako kodeketa estandarrak sartu zituen. WordPress-en edozein proiektu egiten ari bazara PHP markaketaren bidez, jarraitu kodeketa-arau hauek.

  • Aipuen erabilera

WordPress-ek baldintza egokietan komatxo bikoitzak eta bakarrekoak erabiltzea gomendatzen du. Komatxo bakarrak kate baten barruan erabil daitezke ezer ebaluatzen ez denean. Komatxoak erabiltzean, erreserbatu aipamen estilo bat kate baten barruan erabiltzeko eta bestea kate osoa sartzeko.

Ez da gomendatzen kate bateko komatxoak ihes egitea.

  • koska

Koskak erabiltzean, WordPress-ek tabulazio-teklak erabiltzea azpimarratzen du zuriune-barra teklak erabiltzean kode-lerroak adierazteko. Honen abantaila da zure kodea plataforma ezberdinetan erabiltzen ari diren editore ezberdinekin bateragarria bihurtzen dela.

Koskak zure kodearen eremu logikoak nabarmentzen laguntzen du, argi eta ulergarri bihurtuz

Array elkartuak erabiltzen ari bazara eta hainbat elementu baditu, array horretako elementu bakoitzak bere lerro berria izan beharko luke. Zure array-aren azken elementuaren amaieran, gehitu koma. Horrek errazten du elementu berriak gehitzea arrayra edo haren ordena aldatzea.

  • PHP etiketak

HTML blokeetan PHP kode zatiak erabiltzean, PHP ireki eta ixteko etiketak lerro bereizi batean egon behar dira.

WordPress-ek debekatu egiten du PHP etiketa laburrak erabiltzea, zure kodea exekutatzen ari zaren bitartean arazoak sor ditzaketelako.

  • giltza

WordPress-ek derrigorrezkoa da giltza erabiltzea zure kodean. Hasierako adierazpenaren lerroan irekitzeko giltza jarri behar da. Giltza baztertzen dira lerro bakarreko adierazpenetarako. Begizta adierazpenek giltza ere izan behar dute. Bloke anitzeko adierazpenak erabiltzen ari badira, giltzak beharrezkoak dira.

  • Espazioaren erabilera

Zuriunea jarri behar da esleipenaren, logikoaren, konparazioaren eta kate-operadoreen bi aldeetan eta komaren ondoren. Espazioa ere jarri behar da parentesiak ireki ondoren eta itxi aurretik, idazkerak izan ezik. Kode-lerro bakoitzaren amaierako zuriuneak ezabatu behar dira.

  • SQL instrukzioak

WordPress-en kodetze estandarrek SQL adierazpenak maiuskulaz idaztea bultzatzen dute. Adierazpen hauek lerro bakarrean idatz daitezke, laburrak eta irakurtzeko errazak badira. SQL kontsulta konplexuetarako, hainbat lerrotan banatzea gomendatzen du, SQL instrukzio bakoitza koskatuz.

  • Izendatzeko printzipioak

Garatzaileek WordPress araudia jarraitu behar dute funtzioak, klaseak eta fitxategiak izendatzen dituzten bitartean akats nahasiak saihesteko. Funtzioak edo aldagaiak sortzerakoan, izenak letra xehez idatzi behar dira, eta camelCase erabat debekatuta dago. Hitz bat izendatzerakoan hainbat hitz erabiltzen badira, bereiz itzazu azpimarra batekin.

Fitxategi-izenekin ere antzekoa gertatzen da, salbu eta hainbat hitz erabiltzen badira, marratxo batez bereizi behar dira. Zure fitxategia klase batez osatuta badago, fitxategi-izena klase-klase-izena formatuan idatzi behar da minuskulaz, azpimarra bakoitza marratxo batez ordezkatuta.

Txantiloi etiketaz osatutako fitxategiak wp-includes karpetan irakurtzen edo gehitzen ari badira, -txantiloia erantsi behar zaio fitxategi-izen horri.

Klaseak sortzerakoan, klaseen izenak letra larriz idatzi behar dira. Hainbat hitz erabiltzen badira, azpimarraz bereizi behar dira, eta hitz bakoitza letra larriz idatzi behar da.

2. HTMLrekin kodetzea

Kodetze-araudiak dio HTML kode zatiak W3C baliozkotzailearen bidez exekutatu behar direla kodearen eskuzko egiaztapena baino lehen. Horrek zure kodean markatutako akatsak antzematen eta konpontzen laguntzen du. HTML kodeketa gehitzerakoan ondorengo estandarrak jarraitu behar dira.

  • Auto ixteko etiketak

HTML-n auto-ixten diren etiketak kontu handiz kudeatu behar dira, batez ere tartearekin. W3C-k agintzen du espazioak auto-itxiera-barraren aurretik behar duela auto-itxiera etiketak erabiltzean.

  • Etiketak eta atributuak

Etiketak HTML orri baten egitura diseinatzen laguntzen du. Sarea inguratzen dute arakatzaileari zein eduki mota den zehazteko. Atributuak HTML elementuei buruzko xehetasun gehiago eskaintzen ditu.

WordPress-en kodetze-araudiak HTML etiketa eta atributu guztiak letra xehez idatzi behar direla aholkatzen du. Atributuen balioak minuskulaz ere idatzi behar dira makinaren interpretaziorako. Datuak gizakiak irakur daitezkeen kasuan, letra larria egokia erabil daiteke.

  • Aipamenak

Komatxo bikoitzak edo bakunak beharrezkoak dira XHTML-n atributuen balioak idaztean erabiltzeko. WordPress-en HTML kodetze estandarrek formatu bera gomendatzen dute HTML kodean segurtasun-arazoak saihesteko.

3. CSS bidez kodetzea

CSS zure web orrien diseinua eta gaia diseinatzeko ezinbesteko beste programazio-lengoaia bat da. WordPress-ek CSS kodeketaren kodeketa estandarrak sartu zituen garatzaileek proiektuetarako kode koherentea, garbia eta irakurgarria egin zezaten. Hona hemen gomendatutako jarraibideak.

  • egitura

 CSS-k zure estilo-orria diseinatzeko aukera asko eskaintzen ditu. Hala ere, WordPress-ek CSS-n oinarrizko jarraibideak eskaintzen ditu kode argi eta bereizia egiteko. Horrek beste garatzaileei zurekin elkarlanean aritzen laguntzen die zure dokumentuaren fluxua ulertzen.

Gidalerroak zure kodean erabiltzen diren propietate guztiak koska erabiltzeko fitxak erabiltzea gomendatzen du. Zati bereko kodetze-blokeek lerro huts bat izan behar dute bloke bakoitzaren artean. Kodetze-piezak bereizteko, kodetze-pieza bakoitzaren artean 2 lerro huts gehitu behar dira.

Arau multzo baterako hainbat hautatzaile zerrendatzen ari bazara, hautatzaile bakoitza lerro batean idatzi behar da. Jabetza-balio bikoteetarako, bakoitzak bere lerroa izan behar du, koska fitxa bat erabili eta puntu eta komarekin amaitu. Hautatzaile bakarra erabiltzean, irekitzeko giltza bat jarri behar da hautatzaile horren lerroan.

Bestela, irekitzeko giltza azken hautatzailearen lerroan gehitu behar da, eta ixteko giltza lerro bereizi batean jarri behar da irekiera hautatzailearen koska berean.

  • Hautatzaileak

Hautatzaileen kodeketa estandarra fitxategi-izenentzako PHP kodetze estandarraren antzekoa da. Hautatzaileak izendatzerakoan, minuskulaz idatzi behar dira, eta marratxoak erabili behar dira hainbat hitz bereizteko. Debekatuta dago camelCase eta azpimarra erabiltzea.

Hautatzaile-izenak gai izan beharko lukete zer elementuren estiloa deskribatzeko. Izen hauek gizakiek irakurtzeko modukoak izan behar dute. Atributu-hautatzaileetarako, komatxo bikoitzak jarri behar dira haien balioen inguruan.

  • Properties

WordPress-ek diseinuaren malgutasuna gutxitzea eragin dezaketen propietate zehatzak erabiltzea gomendatzen du. Bere kodeketa estandarrak propietate bakoitzari bi puntu bat eta zuriune bat jarraitu behar dituela aholkatzen du.

Propietateak eta balioak letra xehez idatzi behar dira, letra-tipoen izenak izan ezik. Koloreak gehitzeko, hex kodeak edo rgba() hobesten dira, eta letra xeheak erabili behar dira. Laburpen propietateak erabiltzea gomendatzen da atzeko planoa, ertza, letra-tipoa, zerrenda-estiloa, marjina eta betegarri balioetarako.

4. JavaScript-ekin kodetzea

JavaScript ezinbesteko programazio-lengoaia da WordPress aplikazioak sortzeko. WordPress-ek kodetze-arauak formulatu zituen, garatzaileek koherentzia izan dezaten JavaScript kodea diseinatzen duten bitartean. Kodetze estandar horietako gutxi aipatzen dira jarraian.

  • Iturburu-kodea birfactoring

WordPress-en JavaScript-erako kode-egituran dauden inkoherentziak direla eta, iturburu-kodeak birfactorizatzea garrantzitsua zen eguneratuta mantentzeko. WordPress pixkanaka arazo hau konpontzen ari da. JavaScript kodean lanean ari diren garatzaileek egungo beharrezko jarraibideak jarraitzea gomendatzen du. JavaScript fitxategi zaharretarako, berriz, birfactorizazioa ez da beharrezkoa.

  • Tartearen erabilera

WordPress-ek tarteak egoki erabiltzea gomendatzen du zure iturburu-kodearen irakurgarritasuna hobetzeko, arakatzaileek prozesatzeko optimizatuta.

Kodeketa-araudiak fitxa hori koska egiteko erabili behar dela onartzen du. Lerro zurietan eta lerroen amaieran zuriuneak kendu behar dira. Kode lerro bakoitzak ez du 80 karaktere baino gehiago izan behar. Giltzak erabili behar dira if/for/try blokeetarako eta hainbat lerrotan sartu behar dira.

Ondorioa

Kodetze estandarren helburua garatzaileei kode irakurgarria osatzen laguntzea da. Kodea zenbat eta garbiagoa izan, orduan eta errazagoa izango da besteek ulertzea eta ezartzea. WordPress kode irekiko aplikazio bat da, gero eta handiagoa den laguntzaileen komunitate baten ekarpenen bidez onartzen dena.

Beraz, zure WordPress proiektua sortzen duzun bitartean, gogoratu kodeketa araudia bete behar duzula, kalitatezko kodeketari ekarpena egin diezaiozun.   

Gaiarekin lotutako artikuluak

0 Comments
Lineako erantzunak
Ikusi iruzkin guztiak
Itzuli gora botoia