In questa serie, stiamo passando attraverso una delle funzionalità fondamentali di WordPress: i tag condizionali. In questa quinta parte, continueremo a introdurre e rivedere i tag condizionali. Assicurati di controllare le parti precedenti, se non l'hai ancora fatto.
Cominciamo!
is_main_site ()
Se stai sviluppando per WordPress Multisite, alla fine arriverà un momento in cui è necessario rilevare il sito principale. Il tag condizionale is_main_site
ti aiuterà quindi: Determina se l'ID sito specificato è il sito principale della rete.
Questo tag condizionale ha un solo parametro:
$ site_id
(intero, facoltativo): l'ID del sito da verificare. (Predefinito: ID sito corrente)has_nav_menu ()
Durante la creazione di un menu di navigazione personalizzato, è necessario specificare una "posizione del menu" con i due parametri di register_nav_menu (s)
funzione (s). Il tag condizionale has_nav_menu ()
controlla se c'è un menu personalizzato che l'utente ha assegnato alla posizione specificata.
Questo tag condizionale ha un solo parametro:
$ location
(stringa, facoltativo): Slug della posizione del menu. (Predefinito: Nessuno)has_nav_menu ()
Supponiamo che una delle posizioni del menu personalizzato del tuo tema abbia bisogno di un piccolo file JavaScript per funzionare correttamente, quindi vuoi accodare lo script solo se il menu viene utilizzato dall'utente. Ecco cosa fai:
is_plugin_active_for_network ()
Simile a is_plugin_active ()
, il tag condizionale is_plugin_active_for_network ()
rileverà se il plugin dato è attivo ... in un'installazione Multisito. Questo potrebbe essere utile se il tuo codice ha bisogno di sapere se un altro plugin è attivo attraverso l'intera rete, piuttosto che un singolo sito.
Questo tag condizionale ha un solo parametro:
$ plug-in
(stringa, obbligatorio): nome del plug-in o della sottodirectory. (Predefinito: Nessuno)comments_open ()
Uno dei tag condizionali più comunemente usati è comments_open ()
. Con questa funzione nel tuo Se
dichiarazione, è possibile determinare se i commenti sono abilitati nel post corrente.
Questo tag condizionale ha un solo parametro:
$ post_id
(intero, facoltativo): l'ID post. (Predefinito: 0)comments_open ()
Supponiamo che tu voglia echeggiare un avvertimento prima della sezione commenti, se i commenti sono abilitati per il post. Ecco cosa fai:
'. __ ("Avviso", "dominio di traduzione"). ': '. __ ('Tutti i commentatori sono responsabili delle proprie parole!', 'Dominio di traduzione'). '
is_dynamic_sidebar ()
Molti temi di WordPress utilizzano le barre laterali per visualizzare il contenuto del widget. Ma se stai sviluppando un plugin o un tema e vuoi determinare le barre laterali inutilizzate, puoi usare il Tag condizionale is_dynamic_sidebar ()
-controlla se una barra laterale è attiva e contiene tutti i widget.
Questo tag condizionale non accetta alcun parametro.
is_multi_author ()
La maggior parte dei siti web WordPress, penso, funziona con un solo utente. I siti web aziendali di solito non hanno bisogno di più di un utente, e Internet è pieno di "blog personali" (che è una buona cosa, non fraintendetemi). Tuttavia, potresti voler verificare se più di un autore ha pubblicato post. Se è il caso, is_multi_author ()
può aiutarti a rilevare le installazioni di WordPress con più autori.
Questo tag condizionale non accetta alcun parametro.
is_multi_author ()
Supponiamo che tu stia creando un plug-in solo per i blog con più autori e vuoi avvisare i singoli autori che il plug-in non funzionerà per loro. Ecco cosa fai:
'. __ ('Scusa amico, questo plugin funziona solo per i blog con più autori!', 'Dominio di traduzione'). '
pings_open ()
Se tu ancora usa i trackback per qualche motivo (o hai bisogno del tuo plugin per lavorare su blog molto vecchi), puoi determinare se trackback e ping sono abilitati in un post specifico (o il post che viene visualizzato) con l'aiuto del pings_open ()
Tag condizionale.
Questo tag condizionale ha un solo parametro:
$ post_id
(intero, facoltativo): l'ID post. (Predefinito: 0)is_feed ()
Amo ancora i feed, ma sono un obsoleto parte del web al giorno d'oggi. Anche WordPress li usa: supporta quattro diversi tipi di feed nel suo nucleo. Se vuoi che la tua funzione sappia quando è in esecuzione in un feed, puoi utilizzare il comando is_feed ()
Tag condizionale: controlla se la query corrente è per un feed.
Questo tag condizionale ha un solo parametro:
$ feed
(stringa / array, facoltativo): tipi di feed. (Predefinito: Nessuno)is_feed ()
Supponiamo che tu voglia pubblicare contenuti extra in ogni post per i tuoi feed (per incoraggiare più persone a iscriversi). Avrai bisogno di uno shortcode. Ecco cosa fai:
is_year ()
Nei blog che non scrivi frequentemente, potrebbe essere una buona idea promuovere archivi annuali piuttosto che archivi mensili. E se vuoi aggiungere funzionalità diverse o mostrare un design diverso, puoi usare is_year ()
per rilevare le pagine di archivio basate sull'anno.
Questo tag condizionale non accetta alcun parametro.
is_user_logged_in ()
È una cosa comune eseguire codice diverso per gli utenti che hanno effettuato l'accesso: potrebbe essere una nuova voce di menu, potrebbe essere un campo di commento aggiuntivo o potrebbe essere una progettazione di siti Web completamente diversa. In ogni caso, è possibile rilevare gli utenti registrati con is_user_logged_in ()
Tag condizionale.
Questo tag condizionale non accetta alcun parametro.
is_user_logged_in ()
Diciamo che vuoi salutare i tuoi utenti in modo diverso dai visitatori. Ecco cosa fai:
nome da visualizzare . '!'; else _e ('Benvenuti nel nostro sito Web!', 'dominio di traduzione'); ?>
wp_attachment_is_image ()
Il lavoro di questo tag condizionale è molto semplice: si passa l'ID post come parametro e viene restituito il tag condizionale VERO
se l'allegato del post è un file JPG, JPEG, GIF o PNG (e FALSE
se non lo è).
Questo tag condizionale ha un solo parametro:
$ post_id
(numero intero, potenzialmente richiesto, tecnicamente facoltativo): il post ID. (Predefinito: 0)Perché "virtualmente richiesto" e "tecnicamente facoltativo"? Perché è impostato su 0, il che significa che se si utilizza questo tag condizionale senza il suo parametro, proverà a restituire un post che non esiste.
post_type_exists ()
In alcuni scenari, potrebbe essere una buona idea controllare se un certo tipo di post personalizzato è già in uso. (Se si sta creando un plug-in di portfolio, ad esempio, si potrebbe voler provare a duplicare i post da un nome di tipo di post comunemente utilizzato per i portfolio.) Per fare ciò, è possibile utilizzare il post_type_exists ()
Tag condizionale.
Questo tag condizionale ha un solo parametro:
$ post_type
(stringa, obbligatorio): nome del tipo di post. (Predefinito: Nessuno)post_type_exists ()
Supponiamo che tu stia sviluppando un plug-in "portfolio" e hai scelto il nome del tipo di post personalizzato "portfolio" (naturalmente). Ma molti sviluppatori usano lo stesso nome per i tipi di portfolio, quindi devi avvisare l'utente se un altro plugin o tema ha già registrato il tipo di messaggio:
'. __ ("Avviso", "dominio di traduzione"). ': '. __ ('Un tipo di post con il nome "portfolio" è già stato registrato da un altro plugin o tema. Questo probabilmente causerà conflitti.', 'Translation-domain'). '
is_new_day ()
Alcune funzioni di WordPress risolvono i problemi più piccoli, e is_new_day ()
è uno di questi: questo particolare tag condizionale ritorna VERO
se il giorno del post corrente è diverso da quello precedente.
Questo tag condizionale non accetta alcun parametro.
In questa parte, abbiamo esaminato un altro batch dei 65 tag condizionali documentati in WordPress. Nella parte successiva, esamineremo i rimanenti 13. Se hai domande o commenti, riprendili qui sotto e se ti è piaciuto questo articolo, non dimenticarti di condividerlo!
Ci vediamo nella prossima parte!