Codifica e registrazione del tuo widget WordPress

Questa è la seconda parte di una serie che mostra come creare il tuo primo widget WordPress. Nella prima parte hai appreso dell'API dei widget e del WP_Widget classe. In questa parte imparerai come avviare il processo di creazione del tuo widget creando la classe per tenerla e registrarla.

Per intero, questa serie comprende cinque parti:

• Introduzione ai widget e all'API dei widget
• Codifica e registrazione del tuo widget
• Costruire il tuo widget
• Costruire il modulo per il tuo widget
• Visualizzazione del widget nell'area del widget corretta

Cosa ti serve

Per seguire questa serie, avrai bisogno di:

• Un'installazione di sviluppo di WordPress
• Un editor di codice

Impostazione del plugin

Per prima cosa devi configurare il tuo plugin. Crea un nuovo file nel tuo wp-content / plugins directory. Ho chiamato il mio tutsplus-list-sottopagine-widget.php.

Aggiungi il seguente al file:

Ovviamente vorrai cambiare il nome dell'autore e l'URL, ma questo dà a WordPress ciò di cui ha bisogno per visualizzare il plugin nella schermata Plugin.

Salva il tuo file di plugin.

Creazione della classe Widget

Il prossimo passo è creare una nuova classe per estendere il WP_Widget classe.

Digita questo codice nel tuo file plugin:

Diamo un'occhiata a cosa consiste in questa classe:

• il __costruire la funzione farà ciò che ti aspetti: costruirà la funzione. All'interno di questa funzione definirai cose come l'ID del widget, il titolo e la descrizione.
• il modulo la funzione creerà il modulo nella schermata Widget che consente agli utenti di personalizzare o attivare il widget.
• il aggiornare la funzione garantisce che WordPress aggiorni tutte le impostazioni che gli utenti inseriscono nella schermata Widget.
• il widget di la funzione definisce cosa viene generato dal widget sul front-end del sito.

Gli ultimi tre di questi hanno parametri che spiegherò più dettagliatamente nei tutorial pertinenti.

Registrazione del widget

Il tuo widget non funzionerà se non lo registri con WordPress. Sotto la tua classe, aggiungi la funzione e aggancia per farlo:

Il register_widget () la funzione è una funzione di WordPress il cui singolo parametro è il nome della classe appena creata.

Quindi agganci la tua funzione a widgets_init gancio per assicurarsi che venga prelevato da WordPress.

Nota: il widget non funzionerà ancora e non verrà visualizzato nella schermata Widget, quindi non preoccuparti di attivare il plug-in ancora. Dovrai completare tutti i passaggi di questa serie affinché funzioni.

Sommario

Ora hai iniziato il processo di creazione del tuo primo widget WordPress. Hai creato un plug-in per il widget, creato una classe per costruire il widget e registrato.

Nel prossimo tutorial imparerai come costruire il widget usando il tuo __costruire funzione.