In questa serie, stiamo passando attraverso una delle funzionalità fondamentali di WordPress: i tag condizionali. In questa quarta parte, continueremo a introdurre e rivedere i tag condizionali. Assicurati di controllare le parti precedenti, se non l'hai ancora fatto.
Cominciamo!
is_month ()
In WordPress, il tipo di archivio basato sulla data più comunemente utilizzato è probabilmente l'archivio mensile. Quando è necessario rilevare se il codice è in esecuzione in una pagina di archivio mensile, il Tag condizionale is_month ()
ti aiuterò.
Questo tag condizionale non accetta alcun parametro.
current_theme_supports ()
Durante lo sviluppo di plug-in, potrebbe essere necessario verificare se il tema attivo consente le miniature, i formati dei post, le intestazioni personalizzate o persino i widget. Con l'aiuto di current_theme_supports ()
, puoi verificare se il tema in uso supporta la funzione specificata.
Questo tag condizionale ha un solo parametro:
caratteristica $
(stringa, facoltativo): nome delle funzioni. (Predefinito: Nessuno)Nomi di caratteristiche:
current_theme_supports ()
Supponiamo che tu stia sviluppando un plug-in specifico per temi WordPress con la funzione "sfondi personalizzati". Il tuo plugin sarà inutile per i temi che non supportano sfondi personalizzati, quindi devi visualizzare un messaggio di errore nel pannello di amministrazione per informare l'utente. Ecco cosa fai:
'. __ ('Questo plugin richiede un tema con la funzione "sfondi personalizzati" abilitata.', 'Dominio di traduzione'). '
is_plugin_active ()
Funzionando solo nel pannello di amministrazione, il tag condizionale is_plugin_active ()
aiuta il tuo codice a sapere se il dato plugin è attivo. Questo tag condizionale può essere utile se stai scrivendo "plug-in addon" per plugin popolari (come WooCommerce) o framework di base installati come plugin (come il Redux Framework).
Questo tag condizionale ha un solo parametro:
$ plug-in
(stringa, obbligatorio): nome del plug-in o della sottodirectory. (Predefinito: Nessuno)is_local_attachment ()
Gli allegati WordPress sono una benedizione se usati correttamente, ma come fai a sapere se un URL è in realtà un allegato? Se stai lavorando con URL durante lo sviluppo, il tag condizionale is_local_attachment ()
potrebbe essere molto utile per te: controlla se l'URL specificato è caricato nella stessa installazione di WordPress come allegato.
Questo tag condizionale ha un solo parametro:
$ url
(stringa, obbligatorio): URL da verificare. (Predefinito: Nessuno)is_local_attachment ()
Poiché questo tag condizionale è piuttosto semplice, anche l'esempio sarà semplice. Immagina di sviluppare un plug-in e di aver bisogno degli URL (generati da un'altra funzione che hai creato) per verificare se si tratta di allegati locali o meno:
è tempo()
Sapevi che WordPress ha archivi basati su ore, minuti e anche secondari? (Per essere onesti, non sapevo che si potesse creare questo tipo di archivi prima di scrivere questa serie: scrivere su Tuts + può anche essere un viaggio educativo!)
Non esce dalla scatola, il che significa che non puoi digitare mywebsite.com/2014/02/22/18/30/
e ottenere archivi per 18:30 il 22 febbraio 2014; ma puoi crearne uno con l'aiuto di WP_Query
classe. In ogni caso: se si desidera rilevare questo tipo di archivi basati sul tempo, è possibile utilizzare il è tempo()
Tag condizionale.
Questo tag condizionale non accetta alcun parametro.
is_rtl ()
In alcune lingue, principalmente nei paesi del Medio Oriente, il testo viene scritto da destra a sinistra anziché da sinistra a destra. Come sviluppatore WordPress, devi considerare tutti gli utenti di WordPress e se vuoi che il tuo tema o plugin funzioni bene con i siti Web WordPress con testo RTL, dovresti usare is_rtl ()
per determinare se la localizzazione è RTL.
Questo tag condizionale non accetta alcun parametro.
is_rtl ()
La maggior parte dei web designer crea fogli di stile separati per localizzazioni RTL: è una pratica comune. E se vuoi caricare il tuo foglio di stile RTL in modo condizionale, ecco cosa fai:
is_tax ()
Il tag condizionale is_tag ()
può rilevare archivi di tag, ma non può funzionare con tassonomie personalizzate. Per determinare se viene visualizzata una pagina di archivio di tassonomia, è possibile utilizzare is_tax ()
. Per impostazione predefinita, include tutte le pagine di archivio di tassonomia, inclusi i tag regolari. Ma ha due parametri, quindi puoi scegliere come target pagine di archivio di tassonomia specifiche o anche termini specifici.
Questo tag condizionale ha un solo parametro:
$ tassonomia
(array / stringa, facoltativo): slug della tassonomia o una serie di lumache. (Predefinito: Nessuno)$ termine
(array / stringa / intero, facoltativo): ID, nome, slug o un array di termini. (Predefinito: Nessuno)is_attachment ()
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 non accetta alcun parametro.
is_attachment ()
Supponiamo che tu voglia visualizzare un link "Torna al post" sopra l'allegato. Ecco cosa fai:
term_exists ()
Questo è il secondo tag condizionale che non ritorna VERO
e FALSE
, ma più informazioni utili: il tag condizionale term_exists ()
controlla se esiste un termine di tassonomia e restituisce il termine ID (se non è specificata alcuna tassonomia) o un array della tassonomia e dell'associazione dei termini anziché VERO
. Se il termine specificato non esiste, restituisce 0
o NULLO
.
Questo tag condizionale ha tre parametri:
$ termine
(stringa / intero, obbligatorio): nome o ID del termine. (Predefinito: Nessuno)$ tassonomia
(stringa, facoltativo): nome della tassonomia. (Predefinito: vuoto)$ genitore
(intero, facoltativo): ID del termine padre (per limitare la ricerca al di sotto di esso). (Predefinito: 0)has_term ()
Abbiamo visto che potremmo usare has_tag ()
se volessimo trovare un tag in un post. E se volessimo fare la stessa cosa, ma con il termine di una tassonomia personalizzata? Facile: il tag condizionale has_term ()
ha un terzo parametro (secondo in ordine) che ci permette di specificare una tassonomia personalizzata.
Fatto divertente: anche il tag condizionale has_tag ()
usi has_term ()
ritornare VERO
o FALSE
! E come con il has_tag ()
funzione, has_term ()
consente anche di specificare più di un termine (ma in una sola tassonomia).
Questo tag condizionale ha tre parametri:
$ termine
(array / stringa / intero, facoltativo): nome, ID, slug o una matrice di tali termini. (Predefinito: vuoto)$ tassonomia
(stringa, obbligatorio): nome della tassonomia. (Predefinito: vuoto)$ postale
(oggetto / numero intero, facoltativo): post da verificare. (Predefinito: NULLO
)has_term ()
Supponiamo che tu gestisca un sito di e-commerce e cambierai il tuo fornitore per i laptop Dell, quindi vuoi informare i tuoi utenti che le spedizioni saranno posticipate alla prossima settimana. Ecco cosa fai:
'. __ ("Avviso", "dominio di traduzione"). ': '. __ ('Stiamo cambiando fornitore per portatili Dell, quindi le spedizioni verranno posticipate alla prossima settimana. Mi dispiace per questo!', 'Dominio di traduzione'). '
is_trackback ()
Saluti, veterano! Vuoi scoprire se un commento è un "trackback"? Il is_trackback ()
Tag condizionale ti aiuterà in questo!
Questo tag condizionale non accetta alcun parametro.
is_multisite ()
Pur essendo una caratteristica non molto popolare di WordPress, Multisite è molto utile quando necessario. Se si desidera che il codice venga eseguito in normali installazioni di WordPress e si comportino in modo diverso nelle installazioni Multisito, il Tag condizionale is_multisite ()
può aiutarti a rilevare se il supporto multisito è abilitato.
Questo tag condizionale non accetta alcun parametro.
is_multisite ()
Supponiamo che tu stia sviluppando un plug-in e, se Multisite è abilitato, il plug-in richiede un'altra classe dal tuo plug-in. Ecco cosa fai:
is_post_type_archive ()
A volte, potresti volere che il tuo codice sappia se una pagina di archivio per un tipo di post personalizzato (o un paio di tipi di post personalizzati, o qualunque tipo di messaggio personalizzato) viene visualizzato. Il tag condizionale is_post_type_archive ()
fa esattamente questo: controlla se la query è per una pagina di archivio per un tipo di messaggio personalizzato.
Questo tag condizionale ha un solo parametro:
$ post_types
(array / stringa, facoltativo): nome del tipo di post o una matrice di nomi di tipi di post. (Predefinito: Nessuno)In questa parte, abbiamo esaminato un altro batch dei 65 tag condizionali documentati in WordPress. Nelle prossime parti, passeremo ai rimanenti 26. Se hai domande o commenti, riprendili qui sotto e se ti è piaciuto questo articolo, non dimenticarti di condividerlo!
Ci vediamo nella prossima parte!