WordPress Settings API, Del 1 Hva det er, hvorfor det gjelder

Som vi har nevnt mange ganger her på WP Tuts (og som du sikkert har lagt merke til), har det aldri vært en bedre tid å være en WordPress-utvikler. Det være seg klientarbeid eller produktutvikling (med enten temaer eller plugins), å komme i gang i WordPress-økosystemet er nesten mer et spørsmål om "hvor" enn "hvordan".

WordPress har stellar API-dokumentasjon for utviklere uansett nivå av erfaring. Men et aktivt utviklingssamfunn og en veldokumentert API gjør ikke en plattform immune mot dårlige utviklingspraksis.

Som med de fleste aspekter av webutvikling, bare fordi noe fungerer, betyr det ikke at det ble bygget på den riktige måten. Men som utviklere og håndverkere er vi opptatt av å sørge for at arbeidet vi slipper fungerer og er bygget riktig. Hulling over kildekoden for en rekke temaer eller pluginprogrammer viser at utviklere frigjør produkter som fungerer, men som ikke er arkitektert på best mulig måte. Dette gjelder spesielt for temaalternativer, menysider, validering og så videre.

Og vi vil stoppe det.

I denne serien skal vi ta et dypt dykk i WordPress Settings API. Vi skal se på hva det er, hvorfor det betyr noe, og hvordan å utnytte det i vårt arbeid.

Vårt ultimate mål er at denne serien skal være en solid referanse for Innstillinger API uansett av ditt erfaringsnivå. På slutten bør du ha en klar forståelse av API og solide eksempler på hvordan du gjør ting på riktig måte.

For å være komplett må vi starte med null null. Så før vi skriver noen kode eller arbeider gjennom noen eksempler, må vi presentere Innstillings-API, hva det er, og hvorfor det betyr noe.


Innstillings-API Definert

På det mest grunnleggende nivå er Innstillings-API et sett med funksjoner som tilbys av WordPress som forenkler prosessen med å introdusere menyer, tilleggssider og lagring, validering og gjenoppretting av brukerinngang.

Lett nok, rett?

Gjennom hele denne serien vil vi dykke i hvert aspekt, men dette bør gi en enkel definisjon av som vi kan jobbe gjennom resten av artiklene.

Hvorfor skal vi bruke Innstillinger API?

Nå som vi forstår hva Innstillinger API faktisk er, vi må se på hvorfor vi ønsker å bruke dette i motsetning til å håndtere brukerinngang, serialisering og validering alt på egen hånd.

Kommuniserer med WordPress Core

Innstillings-APIen er gitt av utviklerne av WordPress-plattformen for å gjøre det enkelt å utvide programmet. Som sådan ville det ikke være fornuftig å bruke funksjonene som ble gitt av forfatterne av selve plattformen?

Visst, det er helt mulig å omgå disse funksjonene og "brute force" vår egen funksjonalitet, og ingen andre kan virkelig stoppe det, men dette krever unødvendig arbeid på våre vegne, ignorerer anbefalingene fra WordPress Core-teamet, og kan i siste instans ødelegge den sammenhengende erfaringen på oversikten.

Velger å utnytte funksjonalitet som tilbys til utviklere av utviklere sørger for at vi kommuniserer med kjerneprogrammet på riktig måte.

Gratis ting utenom boksen

Ved hjelp av Innstillinger API handler det ikke bare om å sikre at vi nærmer oss utvikling gjennom de anbefalte kanalene. Det handler også om å sørge for at brukergrensesnittene følger plattformens beste praksis og at våre data er sanitert ved hjelp av de samme mekanismene som resten av WordPress bruker. Det gjør ikke vondt at det også kan spare oss mye tid.

Når du begynner å utarbeide grensesnittene dine på en slik måte at de utnytter eksisterende WordPress-stiler og bruker Innstillings-API, vil arbeidet ditt se mye mer tett integrert med resten av systemet.

Dette betyr at når brukerne begynner å bruke arbeidet ditt, vil de ikke føle seg som om de bruker et tredjepartsprogram når de jobber med bloggen sin. I stedet jobber de med en forbedring (i motsetning til, si, et tillegg) til kjerneplattformen.

Det er riktignok ikke bruk av innfødte WordPress-stiler som er en sann del av Innstillings-API-en, og ovenstående er noe av et subjektivt perspektiv, men aspekter av Innstillinger-API-en, for eksempel å innføre menysider, utnytter native WordPress-stiler. Det er ikke så fornuftig at resten av arbeidet ditt skal følge med?

Mer sikker, mer motstandsdyktig

Ved å utnytte funksjoner som er innfødt til WordPress, i stedet for å utnytte din egen, kan du være trygg på at lagring, gjenoppretting og validering av innstillinger styres riktig. Tross alt gir Innstillinger API mye av samme funksjonalitet som kjerneprogrammet bygger på.

Dessuten er Innstillings-API-en underlagt de samme reglene som resten av WordPress API. Som sådan, når applikasjonen er oppdatert og / eller endringer innføres, må funksjonene gå gjennom den vanlige avskrivningsprosessen. Dette gir deg tilstrekkelig tid til å jobbe med å oppgradere prosjektet ditt før kompatibilitetsbrudd. Dette er ikke nødvendigvis tilfelle hvis du skal rulle din egen funksjonalitet.

Kommende veikart

På dette tidspunktet bør du ha en klar forståelse av hva Innstillinger API er, og hvorfor du bør bruke det i tema og plugin-arbeid.

Selvfølgelig, dette er alt litt argumenterende - vi har ennå ikke å se på noen praktiske eksempler. Gjennom resten av denne serien tar vi en titt på følgende:

  • Menyer, seksjoner og tabbed Navigering
  • Registrere seksjonsinnstillinger
  • Primitive elementer (innganger, tekstområder, valg, radioknapper og avmerkingsbokser)
  • Et enkelt, fungerende eksempel

Ved slutten av serien bør du ha alt du trenger for å begynne å skape solide WordPress-baserte produkter.