WordPress Coding Standards En introduksjon

Når det gjelder å bygge WordPress-baserte produkter, er vi litt forbannet (eller velsignet, avhengig av hvordan du ser det), med et dobbeltkantet sverd: Fordi WordPress er skrevet i PHP, er det relativt enkelt å få WordPress - eller prosjektet selv - å gjøre hva det er, vi vil gjøre hele tiden, og unngå beste praksis.

Men dette reiser spørsmålet: Hva er poenget med en API eller formell kodingsstandard hvis vi bare skal ignorere dem?

Vi har skrevet litt om WordPress-APIer i tidligere artikler, og vi har rørt WordPress-kodningsstandardene, men vi har aldri tatt et dypt dykk inn i kodingsstandardene, forstår hvert aspekt av dem, og hvorfor de saken.

Så i denne serien skal vi bare gjøre det.

Hvorfor bry deg med kodingsstandarder?

Før du tar en titt på alt som vi skal dekke, synes jeg det er viktig å forstå hvorfor kodingsstandardene selv betyr noe.

WordPress er mye brukt av mye av folk som bruker mye av nettsteder. Det er mye kode som er ansatt der ute, som alle er bygget på toppen av kjerneprogrammet. Dette betyr at det er utviklere og designere som arbeider for å opprettholde disse kodebasene.

Utfordringen kommer når personen som ikke opprinnelig skrev koden, står fast med å forbedre, administrere og fikse feil for prosjektet. La oss si at den første personen ikke fulgte kodingsstandardene, men personen som nå opprettholder koden, pleier å følge de beste rutene.

De har nå å håndtere kode som ikke ser noe ut som hvilken WordPress-kode skal se ut.

Og det er egentlig kjernen i saken: Koden som utgjør våre temaer, våre plugins og i våre applikasjoner, bør ideelt sett se ut som en enkelt utvikler skrev koden.

det er hvilke kodingsstandarder håndheves.

Dessverre er standarder enten ignorert eller de er ikke evangelisert nok til tross for at de er veldokumenterte. Det er her denne serien av artikler kommer inn i spillet: Vi skal se på hver av standardene i dybden for å evangelisere, forstå og oppmuntre hverandre til å begynne å gjøre en bedre jobb.

En titt på kodningsstandardene

Denne serien kommer til å inkludere syv artikkelen i tillegg til dette introduksjonsstykket.

Her er hvor vi er ledet med denne serien:

Oppgi konvensjoner og funksjonsargumenter - Vi tar en titt på hvordan vi skal navngi våre variabler, metoder og klasser slik at de er klare, enkle å forstå, og følger for oss selv og andre utviklere.
Bruken av enkle sitater og doble tilbud - Enkle sitater og dobbelte anførselstegn resulterer i forskjellig oppførsel i PHP, og det er en tid og et sted for når du skal bruke som i WordPress. I denne artikkelen tar vi en titt på eksempler på hver og begrunnelsen bak det vi gjør.
Indrykk, plassbruk og etterspørsel - Hvit plass legger stor vekt på å skrive WordPress-basert kode. Denne artikkelen kommer til å undersøke årsakene til at innrykk og mellomrom betyr så vel som når du skal bruke faner og når du skal bruke mellomrom.
Brace Style, Regular Expressions, og PHP Tags - Ulike språk i C-stil bruker forskjellig syntaks. Denne artikkelen vil undersøke den riktige måten å plassere braces på WordPress-basert kode på. Vi skal også undersøke den riktige måten å inkludere vanlige uttrykk, samt noen av gotkasene og beste praksis som det gjelder å bruke PHP-koder.
Ternary Operator og Yoda betingelser - Betingede utsagn er en hjørnestein av programmering, og de brukes generelt gjennom WordPress. PHP tilbyr en snarvei for if / else setninger, og WordPress velger å evaluere betingelsene forskjellig fra hva andre språk ofte støtter. Her ser vi på alt ovenfor.
Databasespørsmål og formatering av SQL-spørringer - Det er en full API for å kjøre spørringer mot WordPress-databasen, men det finnes også måter å kjøre rå SQL på. Hvis du noen gang trenger å gå den ruten, er det en riktig måte å gjøre det på. Denne artikkelen tar en titt på akkurat det.
Ta med alt sammen - Til slutt skal vi oppsummere alt vi har diskutert gjennom serien for å sikre at vi er alle på samme side, og å oppfordre oss til å gå videre med å gjøre en bedre jobb med å overholde standardene.

Konklusjon

Når det gjelder blogging, antas det ofte at forfatteren er ekspert i emnet som er til stede, men sannheten er selv om jeg fast tror på at vi skal følge kodningsstandardene, og at jeg prøver å følge dem til beste av min evne , Jeg lærer ting hver uke.

Jeg har krenket kodningsstandardene mange ganger, og jeg er sikker på at noen av dere også har det.

Poenget med denne serien er å gå gjennom standardene sammen slik at vi alle kan komme ut som bedre utviklere når vi er ferdige.

Kode