WordPress-kodningsstandarderna En introduktion

När det gäller att bygga WordPress-baserade produkter, är vi något förbannad (eller välsignad beroende på hur du ser det), med ett dubbelkantat svärd: Eftersom WordPress är skrivet i PHP är det relativt enkelt att få WordPress - eller Projekt själv - att göra vad det är vi vill göra samtidigt som vi undviker bästa praxis.

Men det här ställer frågan: Vad är meningen med API eller formella kodningsstandarder om vi helt enkelt kommer att ignorera dem?

Vi har skrivit en hel del om WordPress-API: erna i tidigare artiklar, och vi har berört WordPress-kodningsstandarderna, men vi har aldrig riktigt tagit ett djupt dykk i kodningsstandarderna, förstår varje aspekt av dem och varför de materia.

Så i den här serien ska vi bara göra det.


Varför bry sig om kodningsstandarder?

Innan vi tittar på allt som vi ska täcka, tycker jag att det är viktigt att förstå varför kodningsstandarden spelar roll.

WordPress används ofta av mycket av personer som använder mycket av webbplatser. Det finns mycket kod som används där ute, som är alla byggda ovanpå kärnansökan. Det innebär att det finns utvecklare och designers som arbetar för att behålla dessa kodbaser.

Utmaningen kommer när den person som inte ursprungligen skrev koden fastnar med att förbättra, hantera och fixa buggar för projektet. Låt oss säga att den första personen inte följde kodningsstandarderna, men den som nu håller koden används för att följa bästa praxis.

De måste nu hantera kod som inte ser ut som vilken WordPress-kod som ska se ut.

Och det är verkligen kärnan i frågan: Koden som utgör våra teman, våra plugins och i våra applikationer borde helst se ut som en enda utvecklare skrev koden.

det är vilka kodningsstandarder verkställs.

Tyvärr ignoreras normerna eller de är inte evangeliserade nog trots att de är väl dokumenterade. Det är här denna serie artiklar kommer in i spel: Vi ska titta på varje standard för att evangelisera, förstå och uppmuntra varandra att börja göra ett bättre jobb.


En titt på kodningsstandarderna

Denna serie kommer att innehålla sju artiklar utöver denna introduktionsdel.

Här är där vi är på väg med den här serien:

  1. Namngivna konventioner och funktionsargument - Vi tar en titt på hur vi ska namnge våra variabler, metoder och klasser så att de är klara, lätta att förstå och följa för oss själva och andra utvecklare.
  2. Användningen av enkla citat och dubbla citat - Enkla citat och dubbla citat resulterar i olika beteenden i PHP och det finns en tid och plats för när du ska använda som i WordPress. I den här artikeln tar vi en titt på exempel på varje och motiveringen bakom vad vi gör.
  3. Inryckning, utrymmeanvändning och bakomliggande utrymmen - Vitt utrymme lägger stor roll i att skriva WordPress-baserad kod. Den här artikeln kommer att undersöka orsakerna till att inrymmet och rymden är viktiga samt när du ska använda flikar och när du ska använda mellanslag.
  4. Brace Style, Regular Expressions och PHP Tags - Olika språk i C-stil använder olika syntaxer. Denna artikel kommer att undersöka rätt sätt att placera hängslen i din WordPress-baserade kod. Vi ska också undersöka det korrekta sättet att inkludera reguljära uttryck, liksom några av gotchas och bästa praxis när det gäller att använda PHP-taggar.
  5. Ternary Operator och Yoda villkor - Villkorliga uttalanden är en hörnsten i programmeringen och de används generellt genom WordPress. PHP erbjuder en genväg för om / annat uttalanden, och WordPress väljer att utvärdera villkor som skiljer sig från vad andra språk ofta stöder. Här tittar vi på allt ovan.
  6. Databasfrågor och formatering av SQL-frågor - Det finns ett fullständigt API för att köra frågor mot WordPress-databasen, men det finns också sätt att köra raw SQL. Om du någonsin behöver gå den vägen är det rätt sätt att göra det. Denna artikel kommer att ta en titt på exakt det.
  7. Hämta allt tillsammans - Slutligen ska vi sammanfatta allt som vi har diskuterat i serien för att se till att vi är alla på samma sida och att uppmana oss att gå vidare med att göra ett bättre jobb att följa standarderna.

Slutsats

När det gäller bloggar antas det ofta att författaren är en expert på ämnet till hands, men sanningen är fastän jag bestämt tror att vi ska följa kodningsstandarderna och att jag försöker följa dem till min bästa förmåga , Jag lär mig saker varje vecka.

Jag har brutit mot kodningsstandarden många gånger, och jag är säker på att några av er har det också.

Poängen i denna serie är att gå igenom standarderna tillsammans så att vi alla kan komma ut som bättre utvecklare när vi är färdiga.