From WPWikiItaly

Main: TagCondizionali

Tag Condizionali

Introduzione

I Tag Condizionali possono venir utilizzati nei file di Template per modificare quale contenuto viene visualizzato e come il contenuto viene visualizzato su una pagina specifica in funzione di determinate condizioni a cui la pagina risponde. Ad esempio, si potrebbe voler visualizzare del testo prima di una serie di articoli, ma ciò solo sulla pagina principale del blog. Tramite il Tag Condizionale is_home() questa operazione è resa molto semplice.

Si noti la stretta relazione che questi tag hanno con Gerarchia dei Template di WordPress.

Le Condizioni Per...

Tutti i Tag Condizionali verificano se determinate condizioni vengono verificate e restituiscono TRUE (vero) o FALSE (falso). Le condizioni per le quali i vari tag restituiscono TRUE sono elencate di seguito. Quei tag che accettano parametri sono esplicitamente indicati.

La Pagina Principale

is_home()
Quando viene visualizzata la pagina principale.

Una Pagina di un Singolo Articolo

is_single()
Quando viene visualizzata una pagina di un singolo Articolo.
is_single('17')
Quando l'Articolo con ID 17 viene visualizzato come articolo singolo.
is_single('Stufato di Carne')
Quando l'articolo dal Titolo "Stufato di Carne" viene visualizzato come articolo singolo.
is_single('stufato-carne')
Quando l'articolo con Abbreviazione Articolo "stufato-carne" viene visualizzato come articolo singolo.

Una Pagina di tipo PAGINA

Questa sezione si riferisce alle Pagine di WordPress e non a generiche pagine web del blog.

is_page()
Quando viene visualizzata una qualsiasi pagina.
is_page('42')
Quando viene visualizzata la pagina con ID 42.
is_page('Chi Sono')
Quando viene visualizzata la pagina con Titolo "Chi Sono".
is_page('chi-sono')
Quando viene visualizzata la pagina con Abbreviazione di Pagina "chi-sono".

Una Pagina di Categoria

is_category()
Quando viene visualizzata una qualsiasi pagina di archivio di Categoria.
is_category('6')
Quando viene visualizzata la pagina archivio per la Categoria che ha ID 6.
is_category('Formaggi')
Quando viene visualizzata la pagina archivio per la Categoria di Nome "Formaggi".
is_category('formaggi')
Quando viene visualizzata la pagina archivio per la Categoria con Abbreviazione di Categoria "formaggi".

Si veda anche is_archive().

Una Pagina di un Autore

is_author()
Quando viene visualizzata una qualsiasi pagina di un qualsiasi Autore.
is_author('13')
Quando viene visualizzata la pagina di archivio per l'Autore che ha ID 13.
is_author('Elite Hacker')
Quando viene visualizzata la pagina di archivio per l'Autore con Nickname "Elite Hacker".
is_author('elite-hacker')
Quando viene visualizzata la pagina di archivio per l'Autore con Nicename "elite-hacker".

Si veda anche is_archive().

Una Pagina per una Data

is_date()
Quando viene visualizzata una qualsiasi pagina di archivio per data (es. un archivio mensile, annuale, giornaliero o basato sull'orario).
is_year()
Quando viene visualizzato un archivio annuale.
is_month()
Quando viene visualizzato un archivio mensile.
is_day()
Quando viene visualizzato un archivio giornaliero.
is_time()
Quando viene visualizzato un archivio orario, "minutario" o "secondario".

Si veda anche is_archive().

Qualsiasi Pagina di Archivio

is_archive()
Quando viene visualizzato un qualsiasi tipo di pagina di Archivio. Pagine di Categoria, Autore o di Data sono tutti tipi di Archivi.

Una pagina di Risultato di Ricerca

is_search()
Quando viene visualizzata una pagina di risultati di una ricerca.

A 404 Not Found Page

is_404()
Quando viene visualizzata una pagina dopo un errore "HTTP 404: Not Found".

Una Pagina "Paginata"

is_paged()
Quando viene visualizzata una pagina in modalità "paginata". Ci si riferisce ad un archivio o alla pagina principale che viene suddiviso in diverse pagine. Non si riferisce ad un Articolo o ad una Pagina i cui contenuti vengono suddivisi su più pagine utilizzando il QuickTag <!--nextpage-->.

Una Syndication

is_feed()
Quando al sito viene richiesta un Feed RSS. Questo tag non viene solitamente utilizzato dagli utenti; viene utilizzato internamente da WordPress ed è disponibile per gli Sviluppatori di Plugin.

Un Trackback

is_trackback()
Quando il sito richiesto viene agganciato dal motore di Trackback di WordPress. Questo tag non viene solitamente utilizzato dagli utenti; viene utilizzato internamente da WordPress ed è disponibile per gli Sviluppatori di Plugin.

Un Esempio Applicativo

Ecco un esempio funzionante che dimostra come utilizzare questi marcatori condizionali.

Una Sidebar a Contenuto Variabile

In questo esempio si visualizzeranno nella barra laterale del blog dei contenuti differenti in base al tipo di pagina che viene visualizzata.

 <div id="sidebar">
<?php
 // generiamo le opportune informazioni per la pagina visualizzata
 if (is_home()) {
         // siamo nella nome page
         // mostriamo l'elenco delle categorie principali
         echo "<ul>";
         wp_list_cats(
                   'optionall=0'
                   .'&sort_column=name'
                   .'&list=1&children=0'
                   );
         echo "</ul>";
 } elseif (is_category()) {
         // stiamo visualizzando una singola categoria,
         // mostriamo quindi tutte le categorie
         echo "<ul>";
         wp_list_cats(
                   'optionall=1'
                   .'&sort_column=name'
                   .'&list=1'
                   .'&children=1'
                   .'&hierarchical=1'
                   );
         echo "</ul>";
 } elseif (is_single()) {
         // stiamo visualizzando una singola pagina,
         // non mostriamo nulla sulla sidebar
 } elseif (is_page()) {
         // stiamo visualizzando una pagina statica. Quale?
         if (is_page('Info')) {
              // la pagina Info.
              echo "<p>Questa è la pagina Info!</p>";
         } elseif (is_page('Colophon')) {
              echo "<p>Questa è la pagina colophon, stiamo utilizzando WordPress "
              . bloginfo('version') . "</p>";
         } else {
               // Testo per tutte le altre pagine
               echo "<p>Vota Antonio! Vota Antonio!</p>";
         }
 } else {
         // per tutte le altre pagine (archivi, ricerche, 404, ecc)
         echo "<p>Antonio vi offre la sua protezione.</p>";
 } // È tutto gente!
 ?>
 <form id="searchform" method="get" action="<?php echo $_SERVER['PHP_SELF']; ?>">
 <div>
 <input type="text" name="s" id="s" size="15" />
 <input type="submit" value="<?php _e('Search'); ?>" />
 </div>
 </form>
 </div>
Retrieved from http://www.wordpress-it.it/wiki/Main/TagCondizionali
Ultima modifica il 19/01/2006 ore 09:48