In questa serie, stiamo passando attraverso una delle funzionalità fondamentali di WordPress: i tag condizionali. In questa sesta parte, completeremo l'introduzione e la revisione dei tag condizionali. Assicurati di controllare le parti precedenti, se non l'hai ancora fatto.
Cominciamo!
is_singular ()
Non so perché, ma questo è il mio Tag Condizionale preferito: is_singular ()
in grado di rilevare quando viene visualizzato qualsiasi tipo di messaggio. È fondamentalmente una combinazione dei tag condizionali è single()
, is_attachment ()
e is_page ()
. Inoltre, se si imposta un tipo di post (o una serie di tipi di post) come parametro, è possibile rilevare solo i tipi di post impostati.
Questo tag condizionale ha un solo parametro:
$ post_types
(array / stringa, facoltativo): nome del tipo di post o un array di nomi di tipi di post. (Predefinito: Nessuno)nel loop()
Se dico che il Loop è il fondamento di WordPress in termini di codice, pochi non sarebbero d'accordo. Quindi, il tag condizionale nel loop()
è uno dei tag condizionali chiave e aiuta le tue funzioni a vedere se si trovano all'interno del Loop o meno.
Questo tag condizionale non accetta alcun parametro.
nel loop()
Supponiamo che il tuo plugin abbia una funzione simile deve eseguire nel Loop, ma si desidera anche visualizzare un errore nel codice sorgente della pagina se l'utente lo utilizza al di fuori del Loop. Ecco come si costruisce la funzione:
my_awesome_plugin_function () '. __ ('funzione del plugin "My Awesome Plugin" deve essere eseguita all'interno di WordPress Loops!', 'translation-domain'). '->'; else // Esegui il codice fantastico perché siamo nel loop! ?>
is_plugin_inactive ()
Puoi indovinare di cosa tratta questo Tag Condizionale con il suo nome: Definito come "la negazione logica di is_plugin_active ()
"nel codice, is_plugin_inactive ()
controlla se il plugin dato è installato, ma non attivato.
Questo tag condizionale ha un solo parametro:
$ plug-in
(stringa, obbligatorio): nome del plug-in o della sottodirectory. (Predefinito: Nessuno)is_author ()
Durante la creazione di un plug-in (o tema), potresti voler sapere quando viene visualizzata una pagina degli allegati. Il tag condizionale is_attachment ()
è quello che ti aiuterà: ritorna VERO
in una pagina di allegato e FALSE
da qualsiasi altra parte.
Questo tag condizionale ha un solo parametro:
$ autore
(stringa / intero, facoltativo): nome utente o ID dell'autore. (Predefinito: Nessuno)is_author ()
Supponiamo che tu stia sviluppando un plug-in relativo a Google Analytics e desideri impostare una "variabile personalizzata" per rilevare gli archivi degli autori. Ecco cosa fai:
is_paged ()
Nelle pagine di indice dei blog o nelle pagine di archivio, WordPress ci consente di utilizzare l'impaginazione per dividere gli elenchi dei post in pagine consecutive. Con l'aiuto del tag condizionale is_paged ()
, puoi far sì che il tuo codice rilevi se l'elenco è "impaginato" e il numero di pagina è maggiore di 1.
Questo tag condizionale non accetta alcun parametro.
is_admin_bar_showing ()
La barra degli strumenti di WordPress, precedentemente nota come Admin Bar, è considerata utile e fastidiosa tra la comunità di WordPress. Alcuni lo adorano, altri lo odiano, quindi il Tag Condizionale is_admin_bar_showing ()
potrebbe essere utile a tutti: determina se la barra degli strumenti viene visualizzata o meno.
Questo tag condizionale non accetta alcun parametro.
is_admin_bar_showing ()
Supponiamo che tu voglia estendere la barra degli strumenti con alcuni stili CSS, ma devi caricare il foglio di stile in modo condizionale. Ecco cosa fai:
is_day ()
Gli archivi quotidiani sono probabilmente i tipi di archivi basati sulla data più sottoutilizzati, ma ciò non significa che siano inutili: alcuni temi potrebbero persino avere modelli diversi per gli archivi quotidiani. Pertanto, se si desidera rilevare le pagine di archivio giornaliere, è possibile utilizzare il tag condizionale is_day ()
fare il lavoro.
Questo tag condizionale non accetta alcun parametro.
is_active_sidebar ()
Durante la creazione di un tema, dobbiamo prendere coloro che non utilizzano alcun widget in considerazione. Il tag condizionale is_active_sidebar ()
controlla se la barra laterale fornita ha dei widget in essa contenuti.
Questo tag condizionale ha un solo parametro:
$ barra laterale
(stringa / intero, obbligatorio): nome o ID della barra laterale. (Predefinito: Nessuno)is_active_sidebar ()
Questo esempio deriva dal tema Twenty Ten: utilizza il tag condizionale per caricare in modo condizionale la barra laterale fornita:
username_exists ()
Il terzo tag condizionale che restituisce qualcosa di diverso da VERO
quando ha successo username_exists ()
. Questo tag condizionale controlla il nome utente specificato e restituisce l'ID dell'utente se esiste un utente con lo stesso nome utente. Se non lo fa, ritorna NULLO
.
Questo tag condizionale ha un solo parametro:
$ username
(stringa, obbligatorio): il nome utente da verificare. (Predefinito: Nessuno)is_preview ()
Se hai alcuni elementi della pagina che non dovrebbero essere caricati nelle anteprime (come gli annunci basati sulle impressioni o qualche codice analitico sensibile), puoi rimuoverli con l'aiuto del Tag condizionale is_preview ()
.
Questo tag condizionale non accetta alcun parametro.
is_preview ()
È una buona pratica nascondere visualizza le pagine di anteprima da Google Analytics, quindi devi stare attento e includere il tuo script di Google Analytics in questo modo:
'; ?>
wp_script_is ()
Ciò è particolarmente utile per gli sviluppatori di plug-in che non desiderano che i loro script siano in conflitto con altri script accodati. Con questo tag condizionale, è possibile rilevare se lo script dato è registrato, accodato, accodato e stampato, o accodato ma non stampato ancora.
Questo tag condizionale ha due parametri:
$ maniglia
(stringa, obbligatorio): nome dello script (in lettere minuscole). (Predefinito: Nessuno)$ lista
(stringa, facoltativo): una delle quattro stringhe-"registrato", "Accodato", "fatto" (accodato e stampato), o "fare" (accodato ma non stampato). (Predefinito: "enqueued")wp_style_is ()
Questo tag condizionale è simile a suo fratello, wp_script_is ()
, ma fa lo stesso lavoro per i fogli di stile accodati. Con questo tag condizionale, è possibile rilevare se lo stile specificato è registrato, accodato, accodato e stampato, o accodato ma non stampato ancora.
Questo tag condizionale ha due parametri:
$ maniglia
(stringa, obbligatorio): nome dello stile (in lettere minuscole). (Predefinito: Nessuno)$ lista
(stringa, facoltativo): una delle quattro stringhe-"registrato", "Accodato", "fatto" (accodato e stampato), o "fare" (accodato ma non stampato). (Predefinito: "enqueued")wp_style_is ()
Supponiamo che tu stia creando un tema con il framework Bootstrap e che hai creato un tema Bootstrap personalizzato da includere. È necessario assicurarsi che i principali file CSS di Bootstrap siano prima accodati:
is_taxonomy_hierarchical ()
Sai che le categorie sono gerarchiche, puoi impostarle genitore e bambino categorie. Lo stesso vale per le tassonomie personalizzate, se lo fai così mentre lo crei. E se vuoi che il tuo codice sappia se una certa tassonomia è gerarchica, puoi usare il is_taxonomy_hierarchical ()
Tag condizionale.
Questo tag condizionale ha un solo parametro:
$ tassonomia
(stringa, obbligatorio): nome della tassonomia. (Predefinito: Nessuno)In questa parte, abbiamo analizzato l'ultimo batch dei 65 Tag Condizionati documentati in WordPress. Nella prossima (e ultima) parte della serie, finiremo esaminando ciò che abbiamo imparato e una piccola parte bonus che, si spera, ti piacerà.
Se hai domande o commenti, riprendili qui sotto e se ti è piaciuto questo articolo, non dimenticare di condividerlo!