De WordPress coderingsstandaarden een inleiding

Als het gaat om het bouwen van op WordPress gebaseerde producten, zijn we enigszins vervloekt (of gezegend, afhankelijk van hoe je het ziet), met een tweesnijdend zwaard: omdat WordPress in PHP is geschreven, is het relatief eenvoudig om WordPress te krijgen - of de project zelf - om te doen wat het ook is dat we willen doen, terwijl we best practices vermijden.

Maar dit roept de vraag op: wat is het nut van een API of formele coderingsnormen als we ze gewoon negeren?

We hebben nogal wat geschreven over de WordPress API's in eerdere artikelen, en we hebben de WordPress coderingsstandaarden aangeroerd, maar we hebben nooit echt een diepe duik genomen in de coderingsstandaarden, elk aspect ervan begrepen en waarom ze er toe doen.

Dus in deze serie gaan we precies dat doen.


Waarom moeite doen met coderingsnormen?

Voordat ik een blik werp op alles wat we gaan behandelen, denk ik dat het belangrijk is om te begrijpen waarom coderingsnormen er zelfs toe doen.

WordPress wordt veel gebruikt door veel van mensen die gebruiken veel van sites. Er wordt veel code gebruikt die allemaal is gebouwd bovenop de kernapplicatie. Dit betekent dat er ontwikkelaars en ontwerpers zijn die werken aan het onderhouden van die codebases.

De uitdaging komt wanneer de persoon die de code oorspronkelijk niet heeft geschreven, vastzit aan het verbeteren, beheren en oplossen van bugs voor het project. Laten we zeggen dat de eerste persoon de coderingsstandaarden niet heeft gevolgd, maar de persoon die nu de code onderhoudt, is gewend om de volgende praktische tips te volgen.

Ze hebben nu te maken met code die niets lijkt op hoe de WordPress-code eruit zou moeten zien.

En dat is echt de essentie: de code waaruit onze thema's, onze plug-ins en onze applicaties bestaan, zou er idealiter uit moeten zien als een enkele ontwikkelaar die de code heeft geschreven.

dat is welke coderingsnormen afdwingen.

Helaas worden normen genegeerd of zijn ze niet voldoende geëvangeliseerd ondanks het feit dat ze goed gedocumenteerd zijn. Dat is waar deze serie artikelen in het spel komt: we gaan naar elk van de normen kijken die diepgaand zijn om te evangeliseren, elkaar te begrijpen en elkaar aan te moedigen om een ​​beter werk te gaan doen.


Een blik op de coderingsnormen

Deze serie zal naast dit inleidende stuk zeven artikelen bevatten.

Dit is waar we naartoe gaan met deze specifieke serie:

  1. Naamconventies en functieargumenten - We zullen kijken hoe we onze variabelen, methoden en klassen zodanig moeten benoemen dat ze duidelijk, gemakkelijk te begrijpen en te volgen zijn voor onszelf en andere ontwikkelaars..
  2. Het gebruik van enkele offertes en dubbele aanhalingstekens - Enkele aanhalingstekens en dubbele aanhalingstekens resulteren in ander gedrag in PHP en er is een tijd en een plaats voor wanneer te gebruiken in WordPress. In dit artikel bekijken we voorbeelden van elk en de reden achter wat we doen.
  3. Inspringen, Ruimtegebruik en achterliggende spaties - Witte ruimte speelt een grote rol bij het schrijven van op WordPress gebaseerde code. Dit artikel gaat de redenen onderzoeken waarom inspringen en ruimte ertoe doen, wanneer tabbladen moeten worden gebruikt en wanneer spaties moeten worden gebruikt.
  4. Brace-stijl, reguliere expressies en PHP-tags - Verschillende talen in C-stijl gebruiken verschillende syntaxis. In dit artikel wordt de juiste manier onderzocht om accolades in uw op WordPress gebaseerde code te plaatsen. We gaan ook de juiste manier onderzoeken om reguliere expressies op te nemen, evenals enkele van de gotchas en best practices in verband met het gebruik van PHP-tags.
  5. De voorwaarden van de Ternary-operator en Yoda - Voorwaardelijke uitspraken vormen een hoeksteen van programmeren en ze worden royaal gebruikt in WordPress. PHP biedt een snelkoppeling voor if / else-instructies en WordPress kiest ervoor om conditionals anders te evalueren dan andere talen vaak ondersteunen. Hier zullen we al het bovenstaande bekijken.
  6. Databasequery's en SQL-query's opmaken - Er is een volledige API voor het uitvoeren van query's tegen de WordPress-database, maar er zijn ook manieren om onbewerkte SQL uit te voeren. Als je ooit die weg moet gaan, is er een goede manier om het te doen. Dit artikel zal daar precies naar kijken.
  7. Alles samenbrengen - Ten slotte gaan we alles wat we in de serie hebben besproken samenvatten om ervoor te zorgen dat we allemaal op dezelfde pagina staan ​​en om ons aan te sporen verder te gaan door beter te voldoen aan de normen.

Conclusie

Als het gaat om bloggen, wordt er vaak van uitgegaan dat de auteur een expert is in het onderwerp, maar de waarheid is, hoewel ik er vast van overtuigd ben dat we de coderingsnormen moeten volgen en dat ik ernaar probeer te handelen naar mijn beste vermogen , Ik leer dingen elke week.

Ik heb de coderingsnormen vaak overtreden en ik weet zeker dat sommigen van jullie dat ook hebben gedaan.

Het doel van deze serie is om samen door de normen te lopen, zodat we allemaal uitkomen als betere ontwikkelaars als we klaar zijn.