L'API delle impostazioni di WordPress, parte 1 cos'è, perché è importante

Come abbiamo menzionato numerose volte qui su WP Tuts (e come senza dubbio notato), non c'è mai stato un momento migliore per diventare uno sviluppatore WordPress. Sia che si tratti di lavoro del cliente o di sviluppo del prodotto (con temi o plug-in), iniziare nell'ecosistema di WordPress è quasi più una questione di "dove" piuttosto che di "come".

WordPress ha una documentazione API stellare per gli sviluppatori indipendentemente dal livello di esperienza. Ma una comunità di sviluppo attiva e un'API ben documentata non rendono una piattaforma immune a pratiche di sviluppo scadenti.

Come per la maggior parte degli aspetti dello sviluppo web, solo perché qualcosa funziona non significa che sia stato costruito nel modo giusto. Ma come sviluppatori e artigiani, abbiamo il compito di assicurarci che il lavoro che rilasciamo funzioni e sia costruito correttamente. Il riversamento sul codice sorgente per una varietà di temi o plugin mostra che gli sviluppatori stanno rilasciando prodotti che funzionano ma che non sono architettati nel miglior modo possibile. Ciò è particolarmente vero nelle aree delle opzioni del tema, delle pagine dei menu, della convalida e così via.

E vogliamo fermarlo.

In questa serie, faremo un tuffo nell'API delle impostazioni di WordPress. Daremo un'occhiata a cosa è, perché è importante e come sfruttarlo nel nostro lavoro.

Il nostro obiettivo finale è che questa serie sia un solido riferimento per l'API Settings senza riguardo del tuo livello di esperienza. Alla fine, dovresti avere una chiara comprensione dell'API e dei solidi esempi di come fare le cose nel modo corretto.

Per essere completi, dobbiamo iniziare dal punto zero. Quindi, prima di scrivere qualsiasi codice o elaborare esempi, è necessario introdurre l'API Settings, che cos'è e perché è importante.


L'API delle impostazioni definita

Al livello più elementare, l'API Settings è un insieme di funzioni fornite da WordPress che semplifica il processo di introduzione di menu, pagine di opzioni e il salvataggio, la convalida e il recupero dell'input dell'utente.

Abbastanza facile, giusto?

In questa serie, ci immergeremo in ogni aspetto, ma questo dovrebbe fornire una semplice definizione da cui possiamo lavorare per il resto degli articoli.

Perché dovremmo usare l'API Settings?

Ora capiamo che cos'è l'API delle impostazioni è, dobbiamo vedere perché vorremmo usare questo invece di gestire l'input, la serializzazione e la convalida dell'utente tutto da soli.

Comunica con WordPress Core

L'API Settings è fornita dagli sviluppatori della piattaforma WordPress per facilitare l'estensione dell'applicazione. In quanto tale, non avrebbe senso utilizzare le funzioni fornite dagli autori della piattaforma stessa?

Certo, è completamente possibile aggirare queste funzioni e "forza bruta" le nostre stesse funzionalità e nessun altro può davvero fermarlo, ma ciò richiede un lavoro non necessario per nostro conto, ignora le raccomandazioni del team di WordPress Core e può alla fine rompere l'esperienza coesiva della Dashboard.

Optando per sfruttare la funzionalità fornita per sviluppatori di gli sviluppatori assicurano che comunicheremo con l'applicazione di base nel modo corretto.

Contenuto gratuito Out-Of-The-Box

L'utilizzo dell'API delle impostazioni non significa solo che ci stiamo avvicinando allo sviluppo attraverso i canali consigliati. Si tratta anche di assicurarsi che le interfacce utente seguano le best practice della piattaforma e che i nostri dati siano disinfettati utilizzando gli stessi meccanismi utilizzati dal resto di WordPress. Non fa male che può farci risparmiare molto tempo.

Quando inizi a costruire le tue interfacce in modo da sfruttare gli stili WordPress esistenti e utilizzare l'API Settings, il tuo lavoro sembrerà molto più strettamente integrato con il resto del sistema.

Ciò significa che quando gli utenti iniziano a utilizzare il tuo lavoro, non si sentiranno come se stessero utilizzando un'utilità di terze parti quando lavorano con il loro blog. Invece, stanno lavorando con un miglioramento (al contrario, per esempio, un'aggiunta) della piattaforma principale.

Indubbiamente, l'uso di stili nativi di WordPress non è una parte reale dell'API Settings e quanto sopra è in qualche modo una prospettiva soggettiva, ma aspetti dell'API Settings - come l'introduzione di pagine di menu - sfruttano stili nativi di WordPress. Non ha senso, quindi, che il resto del tuo lavoro segua l'esempio?

Più sicuro, più resistente

Sfruttando le funzioni native di WordPress piuttosto che sfruttando le tue, puoi essere certo che il salvataggio, il recupero e la convalida delle impostazioni sono gestite correttamente. Dopotutto, l'API Settings fornisce molte delle stesse funzionalità su cui si basa l'applicazione principale.

Inoltre, l'API Settings è soggetta alle stesse regole del resto dell'API di WordPress. Pertanto, quando l'applicazione viene aggiornata e / o vengono introdotte modifiche, le funzioni dovranno passare attraverso il solito processo di deprecazione. Questo ti dà il tempo sufficiente per lavorare sull'upgrade del tuo progetto prima delle interruzioni di compatibilità. Questo non è necessariamente il caso se devi implementare le tue funzionalità.

Prossima tabella di marcia

A questo punto, dovresti avere una chiara comprensione di cosa sia l'API delle impostazioni e del motivo per cui dovresti utilizzarlo nel lavoro su temi e plug-in.

Certo, tutto ciò è un po 'argomentativo: dobbiamo ancora dare un'occhiata a qualche esempio pratico. Per il resto di questa serie, daremo un'occhiata a quanto segue:

  • Menu, sezioni e navigazione a schede
  • Registrazione delle impostazioni delle sezioni
  • Elementi primitivi (input, aree di testo, selezioni, pulsanti di opzione e caselle di controllo)
  • Un esempio semplice e funzionante

Entro la fine della serie, dovresti disporre di tutto ciò di cui hai bisogno per iniziare a creare solidi prodotti basati su WordPress.