Som vi har nämnt många gånger här på WP Tuts (och som du säkert har noterat) har det aldrig varit en bättre tid att vara en WordPress-utvecklare. Var det klientarbete eller produktutveckling (med antingen teman eller plugins) är det nästan mer en fråga om "var" istället för "hur" som börjar med WordPress-ekosystemet.
WordPress har stellar API-dokumentation för utvecklare oavsett erfarenhetsnivå. Men en aktiv utvecklingssamhälle och ett väl dokumenterat API gör inte en plattform immun mot fattiga utvecklingsmetoder.
Som med de flesta aspekterna av webbutveckling, bara för att något fungerar betyder det inte att det byggdes på rätt sätt. Men som utvecklare och hantverkare har vi till uppgift att se till att det arbete vi släpper ut fungerar och är byggt korrekt. Att hälla över källkoden för en mängd olika teman eller plugins visar att utvecklarna släpper ut produkter som fungerar men det är inte byggt på bästa möjliga sätt. Detta gäller särskilt inom temaalternativ, menysidor, validering och så vidare.
Och vi vill stoppa det.
I denna serie kommer vi att ta ett djupt dykk i WordPress Settings API. Vi ska titta på vad det är, varför det spelar roll och hur vi kan utnyttja det i vårt arbete.
Vårt yttersta mål är att denna serie ska vara en solid referens för inställnings API oavsett av din erfarenhetsnivå. I slutet bör du ha en tydlig förståelse för API: n och solida exempel på hur man gör saker på rätt sätt.
För att vara komplett måste vi börja vid grunden noll. Så innan vi skriver någon kod eller arbetar igenom några exempel behöver vi introducera API-inställningarna, vad det är och varför det är viktigt.
På den mest grundläggande nivån är inställnings API en uppsättning funktioner som tillhandahålls av WordPress som förenklar processen att införa menyer, alternativsidor och spara, validera och hämta användarinmatning.
Lätt nog, höger?
Under hela denna serie kommer vi att dyka in i varje aspekt men det borde ge en enkel definition av vilken vi kan arbeta i hela resten av artiklarna.
Nu när vi förstår vad Inställnings API faktiskt är, vi måste titta på varför vi skulle vilja använda det här i motsats till att hantera användarinmatning, serialisering och validering på egen hand.
Inställnings API tillhandahålls av utvecklarna av WordPress-plattformen för att göra det enkelt att förlänga applikationen. Som sådan skulle det inte vara meningsfullt att använda funktionerna som tillhandahålls av upphovsmännen till själva plattformen?
Visst är det helt möjligt att kringgå dessa funktioner och "brute force" vår egen funktionalitet, och ingen annan kan verkligen stoppa det, men det kräver onödigt arbete på våra vägnar, ignorerar rekommendationer från WordPress Core-teamet och kan slutligen bryta samman den sammanhållna upplevelsen på instrumentpanelen.
Väljer att utnyttja den funktion som tillhandahålls för utvecklare av utvecklare säkerställer att vi kommunicerar med kärnanvändningen på rätt sätt.
Använda inställnings API handlar inte bara om att se till att vi närmar oss utveckling via de rekommenderade kanalerna. Det handlar också om att se till att våra användargränssnitt följer plattformens bästa praxis och att våra data är saniterade med samma mekanismer som resten av WordPress använder. Det gör inte ont så att det kan spara oss mycket tid heller.
När du börjar bygga ut dina gränssnitt på ett sådant sätt att de utnyttjar befintliga WordPress-stilar och använder inställnings API, kommer ditt arbete att se mycket mer tätt integrerade med resten av systemet.
Det innebär att när användare börjar använda ditt arbete, känner de inte ut som om de använder ett tredjepartsprogram när de arbetar med sin blogg. Istället arbetar de med en förbättring (i motsats till, säg, ett tillägg) till kärnplattformen.
Med hjälp av inbyggda WordPress-stilar är det givetvis inte en sann del av Inställnings API, och ovanstående är något av ett subjektivt perspektiv, men aspekter av Inställnings API - som att införa menysidor - utnyttjar inbyggda WordPress-stilar. Det är inte så vettigt att resten av ditt arbete ska följa efter?
Genom att utnyttja funktioner som är inbyggda i WordPress istället för att utnyttja din egen, kan du vara säker på att spara, hämta och validera inställningar hanteras korrekt. När allt kommer omkring ger API-inställningen mycket av samma funktionalitet som kärnprogrammet bygger på.
Utöver det är API-inställningarna föremål för samma regler som resten av WordPress API. Som sådan, när applikationen uppdateras och / eller ändringar införs, måste funktionerna gå igenom den vanliga avskrivnings processen. Detta ger dig tillräckligt med tid att arbeta med att uppgradera ditt projekt före kompatibilitetsavbrott. Detta är inte nödvändigtvis fallet om du ska rulla din egen funktionalitet.
Vid denna tidpunkt borde du ha en klar förståelse för vad inställnings API är och varför ska du använda det i temat och plugin-arbete.
Det här är givetvis allt argumenterande - vi har ännu inte faktiskt tittat på några praktiska exempel. Under resten av denna serie tar vi en titt på följande:
I slutet av serien bör du ha allt du behöver för att börja skapa solida WordPress-baserade produkter.