Una panoramica sui tag condizionali in WordPress da 40 a 52

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!

40. Verifica se il blog è il "sito principale" della rete: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

  • $ site_id (intero, facoltativo): l'ID del sito da verificare. (Predefinito: ID sito corrente)

41. Verifica della posizione di un menu con un menu assegnato: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

  • $ location (stringa, facoltativo): Slug della posizione del menu. (Predefinito: Nessuno)

Esempio di utilizzo per 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:

42. Verifica dell'attivazione del plug-in specificato in multisito: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

  • $ plug-in (stringa, obbligatorio): nome del plug-in o della sottodirectory. (Predefinito: Nessuno)

43. Verifica se i commenti sono abilitati: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

  • $ post_id (intero, facoltativo): l'ID post. (Predefinito: 0)

Esempio di utilizzo per 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'). '
'; ?>

44. Verifica se una barra laterale contiene dei widget: 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

45. Verifica della presenza di più di un autore nel blog: 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

Esempio di utilizzo per 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'). '

'; ?>

46. ​​Controllare se i ping sono aperti: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

47. Verifica della visualizzazione di un feed: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

Esempio di utilizzo per 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:

48. Verifica se la pagina è una pagina di "Archivi annuali": 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

49. Verifica se il visitatore è un utente connesso 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

Esempio di utilizzo per 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'); ?>

50. Verifica se l'allegato è un'immagine: 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 è).

Parametri accettati

Questo tag condizionale ha un solo parametro:

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.

51. Verifica dell'esistenza del tipo di post specificato: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

Esempio di utilizzo per 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'). '

'; ?>

52. Verifica della pubblicazione del post corrente in un nuovo giorno: 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

Conclusione

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!

Codice