Una panoramica sui tag condizionali in WordPress da 1 a 13

Nella prima parte di questa serie, abbiamo esaminato i fondamenti dei tag condizionali: cosa sono, come usarli e alcuni scenari in cui i tag condizionali sono utili.

In questa seconda parte, inizieremo a esaminare 13 Tag condizionali e in cinque articoli (incluso questo), finiremo per esaminare tutti i 65 Tag condizionali documentati nel Codex. Assicurati di controllare la prima parte se non l'hai ancora fatto.

Cominciamo!

1. Verifica se siamo nella "Pagina dell'indice dei blog": è casa()

Questo mal chiamato Il tag condizionale controlla se viene visualizzata la pagina dell'indice dei post del blog. Nei tempi passati, quando WordPress era solo una "piattaforma di blogging", la "home page" significava l'elenco dei tuoi ultimi post sul blog. Ma dopo WordPress è diventato un sistema di gestione dei contenuti, il nome è casa() è diventato un po 'obsoleto.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

Esempio di utilizzo per è casa()

Diciamo che vuoi salutare i tuoi visitatori sulla home page. Ecco cosa fai:

2. Verifica se il tema corrente è un tema figlio: is_child_theme ()

Durante lo sviluppo con WordPress, potrebbe essere necessario verificare se un tema figlio è in uso. Se questo è il caso, il tag condizionale is_child_theme () ti aiuterà tornando VERO o FALSE quando un tema figlio viene utilizzato o meno.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

3. Verificare se il post è nella categoria data: in_category ()

In un progetto WordPress, potresti volere che i post di diverse categorie si comportino diversamente. Ad esempio, potresti voler aggiungere classi a determinati post o nascondere completamente i post degli elenchi di post generali. Il tag condizionale in_category () ti consente di determinare i post pubblicati in una determinata categoria o categoria.

Parametri accettati

Questo tag condizionale ha due parametri:

• $ categoria (array / stringa, obbligatorio): ID di categoria, nome, slug o un array di quelli. (Predefinito: Nessuno)
• $ postale (oggetto / numero intero, facoltativo): il post (ID o oggetto) da verificare. (Predefinito: post corrente)

Esempio di utilizzo per in_category ()

Supponiamo che tu abbia un blog con molte categorie, tra cui "Annunci" e desideri che gli aggiornamenti vengano visualizzati tra gli altri post, quindi desideri aggiungere una classe personalizzata al post wrapper. Ecco cosa fai:

 
  
  
 "> 
 
  
 
 '. __ ('Spiacente, nessun post corrisponde ai tuoi criteri.', 'Dominio di traduzione'). '
'; ?>

4. Verifica se è in uso un "modello di pagina": is_page_template ()

Page Templates è una funzione di WordPress che ti consente di scegliere come visualizzare determinate pagine. Con l'aiuto del tag condizionale is_page_template (), è possibile rilevare se un determinato modello di pagina (o qualunque Modello di pagina) è in uso.

Parametri accettati

Questo tag condizionale ha un solo parametro:

• $ template (stringa, facoltativo): nome del modello, con estensione. (Predefinito: Nessuno)

5. Verifica se la pagina è una pagina di archivio: is_archive ()

Esistono molti tipi di archivi in ​​un sito Web di WordPress: archivi di date, archivi di categorie, archivi di tag, archivi di autori, archivi di tassonomia personalizzati ... Ma se si desidera rilevare le pagine di archivio in generale, is_archive () è tuo amico: controlla se viene visualizzata una pagina di archivio.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

Esempio di utilizzo per is_archive ()

Diciamo che vuoi anteporre i titoli dei post con del testo nelle pagine di archivio. Ecco cosa fai:

6. Verifica se la pagina è una pagina "Data Archive": is_date ()

Come ho detto prima, ci sono molti tipi di pagine di archivio e gli archivi di date sono uno di questi. Gli archivi delle date possono essere separati in archivi annuali, mensili e giornalieri; ma se si desidera rilevare le pagine di archivio di date in generale, è possibile utilizzare il is_date () Tag condizionale.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

7. Controllare se il widget dato è in uso: is_active_widget ()

Creare widget in WordPress è facile e divertente, ma potrebbe essere necessario determinare se il widget è in uso sul front end o meno. Il tag condizionale is_active_widget () fa esattamente questo: controlla se il widget viene visualizzato.

Parametri accettati

Questo tag condizionale ha quattro parametri:

• $ callback (stringa, facoltativo): Richiamata del widget da verificare. (Predefinito: FALSE)
• $ WIDGET_ID (intero, facoltativo): ID del widget. (Predefinito: Nessuno)
• $ id_base (stringa, facoltativo): ID base di un widget creato estendendo WP_Widget. (Predefinito: Nessuno)
• $ skip_inactive (booleano, facoltativo): se saltare i widget inattivi o meno. (Predefinito: VERO)

Esempio di utilizzo per is_active_widget ()

Supponiamo che un widget nel tema richieda l'esecuzione di jQuery e che sia necessario accodarlo in modo condizionale. Ecco cosa fai:

id_base, true)) wp_enqueue_script ('jquery'); ?>

8. Verifica se la pagina è una pagina di un blog singolo: è single()

Vuoi verificare se l'utente sta visitando un singolo post? Uno dei tag condizionali più popolari, è single(), posso aiutarti. Può rilevare qualsiasi tipo di messaggio, ad eccezione delle pagine di allegato e delle pagine. E se si specifica un post ID, post title o post slug (o un array di quelli), è possibile rilevare anche post specifici.

Parametri accettati

Questo tag condizionale ha un solo parametro:

• $ postale (array / stringa, facoltativo): post ID, titolo, slug o un array di quelli. (Predefinito: Nessuno)

9. Controllare se l'indirizzo email esiste nella tabella degli utenti: email_exists ()

Se è necessario controllare un indirizzo e-mail per vedere se è nella tabella utenti di WordPress, è possibile utilizzare il email_exists () Tag condizionale.

Questo particolare tag condizionale è uno dei tre tag condizionali che restituisce qualcosa di diverso da VERO-restituisce l'ID dell'utente che si è registrato con l'indirizzo email specificato.

Parametri accettati

Questo tag condizionale ha un solo parametro:

• $ e-mail (stringa, facoltativo): indirizzo email da verificare. (Predefinito: Nessuno)

Esempio di utilizzo per email_exists ()

Supponiamo che tu stia sviluppando un plug-in che crea un elenco e-mail dagli indirizzi e-mail degli utenti e ti consente di aggiungere e rimuovere più indirizzi e-mail con input personalizzati, ma di impedire l'eliminazione degli indirizzi email che appartengono agli utenti. Ecco cosa fai:

10. Verificare se il tipo di post è gerarchico: is_post_type_hierarchical ()

Come pagine e pagine secondarie, puoi definire gerarchia per i nuovi tipi di post personalizzati in WordPress. E il tag condizionale is_post_type_hierarchical () consente al tuo codice di sapere se il tipo di post specificato è gerarchico o meno.

Parametri accettati

Questo tag condizionale ha un solo parametro:

• $ post_type (stringa, obbligatorio): nome del tipo di messaggio. (Predefinito: Nessuno)

11. Verifica se il post è "appiccicoso": is_sticky ()

Un "post appiccicoso" è un post che rimane in cima agli elenchi dei post, non importa quando è stato pubblicato. E - sarò un po 'discriminatorio qui - meritano un trattamento diverso dagli altri, ordinario post. Quindi se vuoi aggiungere una post-classe ai post appiccicosi, o trattarli in un modo diverso, puoi far sì che il tuo codice li rilevi usando il is_sticky () Tag condizionale.

Parametri accettati

Questo tag condizionale ha un solo parametro:

• $ post_id (stringa, facoltativo): l'ID del post. (Predefinito: Nessuno)

Esempio di utilizzo per is_sticky ()

Diciamo che stai creando un tema e vuoi visualizzare un nastro "STICKY" in post appiccicosi. Ecco cosa fai: