Wat zijn de WordPress PHP coderingsstandaarden?

Wat zijn de WordPress PHP coderingsstandaarden? In deze video van mijn cursus, Leer PHP voor WordPress, leer je alles over de coderingsstandaarden en waarom ze belangrijk zijn.

De WordPress PHP coderingsstandaarden

 

Wat zijn de WordPress PHP coderingsstandaarden?

U kunt de volledige WordPress PHP coderingsstandaarden vinden in het officiële WordPress handboek.

Het zijn in feite een reeks best practices voor het gebruik van PHP in WordPress. We zullen enkele voorbeelden doornemen van wat dat in de praktijk in de rest van deze tutorial betekent.

Zoals u kunt zien, zijn er normen niet alleen voor PHP, maar ook voor toegankelijkheid en voor de andere talen die u zou gebruiken binnen WordPress. 

Waarom zijn de PHP coderingsnormen belangrijk??

Waarom is het belangrijk dat we ons allemaal aan deze normen houden?? 

Welnu, er zijn twee redenen. Een ervan gaat over de kwaliteit van code, en de andere gaat over consistentie. 

Dus ten eerste, kwaliteit is belangrijk omdat het betekent dat iedereen die codeert in WordPress code maakt die zal werken, die zijn werk zal doen, en die zal worden geschreven in een up-to-date en hoogwaardige mode.

De tweede, die gaat over consistentie, is even belangrijk. Het is zeer waarschijnlijk dat u van tijd tot tijd met de code van andere mensen gaat werken. Als u bijvoorbeeld een kindthema maakt, moet u mogelijk een deel van de code van het bovenliggende thema kopiëren. En als u een plug-in maakt, kan die plug-in een vork zijn van een bestaande externe plug-in die u kopieert en extra functionaliteit toevoegt. Het is erg belangrijk dat de manier waarop je code in overeenstemming is met de manier waarop iedereen die PHP codeert voor WordPress zelf code schrijft. 

Voorbeelden van PHP coderingsstandaarden voor WordPress

Dus laten we eens kijken naar enkele van de PHP coderingsstandaarden. En ik zal je voorbeelden hiervan laten zien in sommige van de bestanden in mijn thema.

Overeenkomsten en cases benoemen

Laten we beginnen met conventies en cases benoemen. Wanneer u nadenkt over het benoemen van conventies, zijn er vier dingen om over na te denken:

  1. de functies binnen uw thema of uw plug-in
  2. de bestanden en de manier waarop u die noemt
  3. alle klassen die u schrijft
  4. alle variabelen die u maakt

Dus laten we beginnen met functies. Hier is het bestand functions.php in mijn thema als een voorbeeld. 

Je kunt zien dat ik een functie heb die ik heb gedefinieerd genoemd rachelmcc_register_widgets. Dat is allemaal in kleine letters geschreven en ik gebruik underscores tussen de woorden, en dat is hoe je altijd een functie in WordPress moet schrijven.

Zoals je ook zult zien, heb ik een voorvoegsel gebruikt. Dat is om ervoor te zorgen dat deze functie niet botst met andere functies die mogelijk worden geleverd door mijn thema of door een andere plug-in. Dus als ik een functie heb geschreven die zojuist is genoemd register_widgets en een van mijn plug-ins had ook een functie genaamd register_widgets, de twee van hen zouden kunnen botsen. Je zou kunnen merken dat een van hen de andere overschrijft of dat de plug-in niet werkt. 

Dus in plaats daarvan gebruik ik een unieke functie die relevant is voor mijn thema. Mijn thema is genoemd rachelmccollin, dus mijn functies hebben rachelmcc als een voorvoegsel. En het is ook belangrijk om onderstrepingstekens voor uw functies te gebruiken en geen koppeltekens te gebruiken.

U do gebruik koppeltekens op twee plaatsen. Ten eerste gebruikt u koppeltekens wanneer u CSS-klassen definieert. Dus je kunt zien dat ik binnen mijn widgets CSS-klassen definieer voor mijn h3 element en ook voor de ID kaart van dat widgetgebied. En hier gebruik je koppeltekens.

De andere plaats waar u koppeltekens gebruikt, staat in uw bestandsnamen. Dus dit is voorpagina.php. 

Gebruik altijd koppeltekens in uw bestandsnamen binnen uw thema's en uw plug-ins; gebruik geen onderstrepingstekens. Dus hier is er een gesprek met locate_template. En lus-frontpage.php is een bestand, een sjabloongedeelte dat ik aanroep, en je kunt zien dat er een koppelteken en geen onderstrepingsteken is. 

Aan de andere kant gebruikt mijn post-type ID, een aangepast posttype dat ik heb geregistreerd, een onderstrepingsteken: rmcc_blurb

Nu moet u misschien ook denken aan variabelen binnen uw thema. Laten we lus-frontpage.php bekijken:

In dit specifieke bestand, dat ik heb gebeld uit dat vorige bestand, heb ik enkele variabelen gedefinieerd, één genaamd tellen en één geroepen titel. En je kunt zien dat ik kleine letters gebruik voor beide. 

De andere plaats waar je moet nadenken over hoofdletters en hoofdletters is wanneer je een les gebruikt. Laten we teruggaan naar de voorpagina.php:

En je kunt hier zien, ik gebruik de WP_Query klasse. Dus een klasse heeft een hoofdletter achter het onderstrepingsteken, evenals aan het begin. Dus dat is waar je hoofdletters gebruikt als je een klasse definieert. Het helpt mensen die met uw code werken meteen identificeren dat het een klasse is en geen functie.

Enkelvoudige en dubbele aanhalingstekens gebruiken

Laten we nu eens kijken hoe u enkele en dubbele aanhalingstekens in PHP voor WordPress zou gebruiken. 

U kunt enkele aanhalingstekens of dubbele aanhalingstekens gebruiken, afhankelijk van wat het beste werkt voor de specifieke code waarmee u werkt.

De reden dat dubbele aanhalingstekens soms nuttig kunnen zijn, is dat ze het gemakkelijker maken om met speciale tekens te werken. Hier is een voorbeeld:

Stel dat u een zoeksjabloonbestand aan het schrijven was, search.php. En daarbinnen, als er niets werd gevonden, zou je een alinea plaatsen die zegt: "Sorry, je zoekopdracht heeft niets gevonden." Waarom probeer je het niet nog een keer? "

Ik heb dat binnen dubbele aanhalingstekens geplaatst omdat de tekst apostrofs bevat. Laat me je laten zien hoe dat zou werken als we het in enkele aanhalingstekens zouden doen. 

U moet een backslash vóór de apostrophes plaatsen om ze correct in de HTML uit te voeren, anders krijgt u fouten. Nu weet ik niets over u, maar ik typ het liever gewoon binnen dubbele aanhalingstekens dan dit alles in enkele aanhalingstekens.

Het andere dat u moet onthouden, is dat als u offertes tussen aanhalingstekens moet plaatsen, u enkele aanhalingstekens tussen dubbele aanhalingstekens plaatst, of omgekeerd. Het maakt niet uit welke kant op, maar je kunt geen enkele aanhalingstekens plaatsen met enkele aanhalingstekens of dubbele aanhalingstekens binnen dubbele aanhalingstekens.

Dus hier is een voorbeeld dat teruggaat naar mijn functions.php-bestand. 

Hierbinnen heb ik enkele aanhalingstekens voor de waarde van before_widget, en dan in dat, heb ik dubbele aanhalingstekens voor de ID en de klasse daarvan. Ik kon hier geen dubbele aanhalingstekens gebruiken en vervolgens dubbele aanhalingstekens erin plaatsen, dus daarom gebruik ik enkele aanhalingstekens daar, omdat het beter is om dubbele aanhalingstekens te gebruiken met uw CSS. 

deuk

Laten we nu eens kijken naar inspringen. En laten we verder kijken naar het functions.php-bestand, wat een goed voorbeeld is omdat ik een aantal regels code erin heb ingesprongen. 

U ziet dat de functienaam aan de linkerkant staat en vervolgens binnen dat register_sidebar functie is ingesprongen op één niveau. En de inhoud ervan is opnieuw ingesprongen. 

Dus elke keer dat u inhoud plaatst tussen accolades of accolades, moet alles daarbinnen ingesprongen zijn. En ook voor inspringen, moet u regeleinden gebruiken. 

Laten we dus een ander bestand bekijken met enkele regels en dubbele lijnen. 

Dus hier kun je zien dat ik een heb als verklaring die twee regels code bevat. Dus ik heb een regeleinde boven en onder die twee regels code gezet.

Als er maar één regel code in zat, hoefde ik die regelspaties niet in te voegen - ik zou dat gewoon in mijn accolades zetten. 

Met behulp van spatiëring op deze manier wordt het duidelijk waar uw codeblokken zijn. En je kunt ook zien dat die inspringing is gebruikt. Er zijn dus meerdere indentielagen. 

Het andere ding dat u in gedachten moet houden, is waar u uw PHP tag opent en sluit en of dat op dezelfde regel staat als uw code of een andere regel. En dat hangt er ook van af of je een codeblok codeert of een enkele regel.

Waar u een codeblok heeft, plaatst u uw openingstag op één regel en uw sluittag op een andere regel. Dat helpt om duidelijk te maken dat het een blok van PHP is en dat alles binnen die tags PHP is.

Het andere ding dat je moet doen om ervoor te zorgen dat je het doet is gebruik maken van een volledig openende PHP tag. Dus gebruik niet alleen een vraagteken, zoals je misschien hebt gedaan in sommige andere systemen die PHP gebruiken, omdat je in WordPress de volledige PHP-tag moet gebruiken. 

Als ik een PHP schreef die net op één regel stond, zou ik de PHP-openings- en sluitingstags op dezelfde regel plaatsen.

Je kunt zien dat we wat PHP hebben dat allemaal op één regel staat, en daarna heb ik HTML. Dus de openings- en sluitingstags gaan op dezelfde regel als mijn code. 

Conclusie

Dat is een inleiding tot enkele van de elementen van de WordPress PHP coderingsstandaarden, en ik heb je enkele voorbeelden van deze in mijn bestanden getoond en ik heb er een paar veranderd toen ik meegaf om je te laten zien hoe dingen correct worden gedaan. 

Als u meer wilt weten over de coderingsnormen, vindt u documentatie op de WordPress-website. En u kunt ook deze Envato Tuts + -serie bekijken, die in detail ingaat op alle elementen van de coderingsnormen.

Bekijk de volledige cursus

In de volledige cursus, Leer PHP voor WordPress, leert u alles over PHP, de programmeertaal waarin WordPress is ingebouwd.  

Ik zal u een overzicht geven van wat PHP is en hoe het wordt gebruikt voor WordPress-thema's en plug-ins, met voorbeelden. Je leert vervolgens hoe je een PHP-bestand maakt en gebruikt om HTML uit te voeren. Vervolgens leer je om functies, loops en if-statements te gebruiken voor het coderen van aangepaste WordPress-thema's en plug-ins.

Je kunt deze cursus meteen volgen met een abonnement op Envato Elements. Voor een enkel laag maandelijks bedrag krijg je niet alleen toegang tot deze cursus, maar ook tot onze groeiende bibliotheek met meer dan 1000 videocursussen en toonaangevende e-boeken over Envato Tuts+. 

Bovendien krijgt u nu onbeperkte downloads van de enorme Envato Elements-bibliotheek met 580.000+ creatieve items. Creëer met unieke lettertypen, foto's, afbeeldingen en sjablonen en lever sneller betere projecten.