In questa serie, abbiamo dato uno sguardo alle tassonomie di WordPress: cosa sono, come funzionano, come distinguerli tra i diversi tipi esistenti e come sono memorizzati nel database sottostante.
L'unica cosa che dobbiamo ancora fare è mettere insieme un plugin che dimostri come utilizzare l'API per implementare le nostre tassonomie personalizzate. Quindi in questo post, faremo esattamente questo.
Ricorda dal primo post di questa serie:
Tassonomia è una di quelle parole che la maggior parte delle persone non ascolta o non usa mai. Fondamentalmente, una tassonomia è un modo per raggruppare le cose.
E in tutta questa serie, abbiamo utilizzato la fotografia e la videografia come esempi di classificazioni. Quindi per il plug-in che creeremo, includeremo tassonomie sia gerarchiche che non gerarchiche relative a entrambe queste classificazioni.
Infine, il plugin funzionerà con il tipo di post standard esistente fornito con WordPress. Ciò dovrebbe dare la massima flessibilità in relazione alla creazione di un plug-in, alla dimostrazione dei concetti e al suo utilizzo nella propria installazione.
Per gli scopi del plugin di esempio, lo chiameremo Le mie tasse tassonomiche personalizzate e lo costruiremo nelle seguenti fasi:
Prima di fare qualsiasi altra cosa, vai avanti e crea una directory in wp-content / plugins
chiamato my-custom-tassonomie
e presenta un file chiamato my-custom-taxonomies.php
.
All'interno del file, aggiungi il seguente blocco di commento del codice:
A questo punto, dovresti essere in grado di accedere al dashboard di WordPress, vedere il nome del plugin e attivarlo. Naturalmente, non accadrà nulla poiché non abbiamo ancora fatto nulla con il codice sorgente.
Successivamente, abbiamo bisogno di creare un altro file che verrà utilizzato per alimentare effettivamente il plugin. Questo sarà basato su principi di programmazione orientati agli oggetti, quindi creeremo un file chiamato
class-my-custom-taxonomies.php
.Non preoccuparti di popolarlo con qualsiasi codice sorgente ancora. Torniamo a
my-custom-taxonomies.php
e aggiungi un condizionale per assicurarti che il file del core plug-in non possa essere eseguito al di fuori dell'ambiente WordPress.Metti questo direttamente sotto il commento del codice che abbiamo fornito sopra.
2. Esecuzione del Core Plugin
A questo punto, siamo pronti per scrivere codice che in realtà guiderà il plugin. Quindi definiamo la classe e una funzione di base per l'inizializzazione:
* / class My_Custom_Taxonomies / ** * Inizializza il plugin registrando gli hook necessari * per creare le nostre tassonomie personalizzate all'interno di WordPress. * * @since 1.0.0 * / public function init ()Dopo, torniamo a
my-custom-taxonomies.php
e aggiungi un codice per includere il file e un metodo che creerà un'istanza della classe e la eseguirà:dentro(); custom_taxonomies_run ();Ora abbiamo tutto ciò di cui abbiamo bisogno per iniziare a impostare i nostri hook e callback per creare le nostre tassonomie personalizzate.
3. Presentare fotografie e video
A questo punto, siamo pronti per iniziare a introdurre le nostre tassonomie. Ci concentreremo innanzitutto sulle nostre due tassonomie gerarchiche - fotografie e video.
Nel corpo della classe di
class-my-custom-taxonomies.php
file, aggiungere la seguente funzione:'Photographs', 'singular_name' => 'Photograph', 'edit_item' => 'Modifica foto', 'update_item' => 'Aggiorna foto', 'add_new_item' => 'Aggiungi nuova foto', 'menu_name' => ' Fotografie »); $ args = array ('hierarchical' => true, 'labels' => $ labels, 'show_ui' => true, 'show_admin_column' => true, 'rewrite' => array ('slug' => 'foto') ); register_taxonomy ('photograph', 'post', $ args);Questa funzione è responsabile della creazione di fotografie tassonomia e sarà chiamato dall'interno della funzione init quando è il momento giusto.
Ora, facciamo la stessa cosa per video:
"Video", "singular_name" => "Video", "edit_item" => "Modifica video", "update_item" => "Aggiorna video", "add_new_item" => "Aggiungi nuovo video", "menu_name" => " Video '); $ args = array ('hierarchical' => false, 'labels' => $ labels, 'show_ui' => true, 'show_admin_column' => true, 'rewrite' => array ('slug' => 'video') ); register_taxonomy ('video', 'post', $ args);Chiamiamo questi due dalla funzione init. Facciamo questo registrando queste funzioni con il
dentro
gancio come previsto da WordPress:Qui dovremmo essere in grado di andare Aggiungi nuovo post e vedere le nostre nuove opzioni di tassonomia visibili nella dashboard. In caso contrario, ricontrolla il tuo codice con quello condiviso sopra.
Ora che abbiamo introdotto le nostre tassonomie gerarchiche, passiamo all'introduzione del nostro Tipo di pellicola - o la nostra tassonomia non gerarchica.
4. Presentare Tipo di pellicola
Questo in realtà non è molto diverso dal codice che abbiamo scritto fino a questo punto. In realtà, la differenza principale è che invece di specificare
gerarchica
comevero
, lo imposteremo comefalso
.'Film Type', 'singular_name' => 'Film Type', 'edit_item' => 'Edit Film Type', 'update_item' => 'Update Film Type', 'add_new_item' => 'Aggiungi New Film Type', ' menu_name '=>' Film Type '); $ args = array ('hierarchical' => false, 'labels' => $ labels, 'show_ui' => true, 'show_admin_column' => true, 'rewrite' => array ('slug' => 'tipo film ')); register_taxonomy ('film-type', 'post', $ args);Ciò si tradurrà in un diverso tipo di elemento dell'interfaccia utente che assomiglia più ai tag piuttosto che alle opzioni di categoria che vedi sopra.
Infine, aggiungi la seguente riga al metodo init insieme al resto degli hook:
Si noti che è funzioni più come tag che categorie. Ancora una volta, per ribadire, questa è una delle principali differenze nelle tassonomie gerarchiche e non gerarchiche.
5. Test del plug-in completo
Ora siamo pronti a dare un giro al plug-in. Supponendo di aver seguito tutto correttamente durante questo tutorial, dovresti essere in grado di creare un nuovo post, stamparlo con un tipo di Fotografia o un tipo di video così come un tipo di Film e mantenerli inalterati dopo aver salvato o aggiornato il tuo post.
In caso contrario, ricontrolla il tuo codice con i riferimenti a questo e con i riferimenti nel repository GitHub associato.
Conclusione
Questo conclude la Guida per principianti alle tassonomie di WordPress. In tutta la serie, abbiamo dato uno sguardo ampio a una definizione di tassonomie, al ruolo che svolgono in WordPress e abbiamo persino implementato alcuni dei nostri.
A questo punto, dovresti avere una solida conoscenza del concetto e come procedere per includerli nel tuo prossimo progetto.
In caso contrario, non esitare a lasciare domande, commenti o commenti generali nel campo sottostante.