Una panoramica sui tag condizionali in WordPress da 27 a 39

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!

27. Verifica se la pagina è una pagina "Archivi mensili": 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ò.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

28. Verifica delle caratteristiche del tema corrente: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

  • caratteristica $ (stringa, facoltativo): nome delle funzioni. (Predefinito: Nessuno)

Nomi di caratteristiche:

  • 'post-miniature'
  • 'post-formati'
  • 'Custom-header'
  • 'Custom-fondo'
  • 'menu'
  • 'automatico-feed-link'
  • 'Editor di stile'
  • 'widgets'
  • 'HTML5'

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

'; ?>

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

Parametri accettati

Questo tag condizionale ha un solo parametro:

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

30. Verifica se l'URL è un allegato locale: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

  • $ url (stringa, obbligatorio): URL da verificare. (Predefinito: Nessuno)

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

31. Verifica se la pagina è una pagina di archivio basata sul tempo: è 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

32. Verificare se le impostazioni internazionali correnti sono RTL: 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

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

33. Verifica della pagina "Archivi" di una Tassonomia personalizzata: 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.

Parametri accettati

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)

34. Verifica se la pagina è una pagina di allegato: 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

Esempio di utilizzo per is_attachment ()

Supponiamo che tu voglia visualizzare un link "Torna al post" sopra l'allegato. Ecco cosa fai:

35. Verifica dell'esistenza del termine specificato: 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.

Parametri accettati

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)

36. Verifica se la posta ha il termine dato: 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).

Parametri accettati

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)

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

37. Verifica se si tratta di un trackback (e siamo nel 2007): is_trackback ()

Saluti, veterano! Vuoi scoprire se un commento è un "trackback"? Il is_trackback () Tag condizionale ti aiuterà in questo!

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

38. Verifica se "WordPress Multisite" è in uso: 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.

Parametri accettati

Questo tag condizionale non accetta alcun parametro.

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

39. Verifica se la pagina è un archivio di tipi di post: 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.

Parametri accettati

Questo tag condizionale ha un solo parametro:

Conclusione

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!