Marcatore Template: wp_list_pages()

On this page... (hide)

  1. 1. Descrizione
  2. 2. Utilizzo
  3. 3. Stili CSS
  4. 4. Esempi di Utilizzo
    1. 4.1 Senza Intestazione
    2. 4.2 Senza Intestazione e non in forma di elenco
    3. 4.3 Mostrare l'elenco delle pagine secondo l'ordine di menu
    4. 4.4 Visualizzare le Pagine in base alla data di creazione
    5. 4.5 Escludere delle Pagine dall'Elenco
  5. 5. Parametri del Marcatore
  6. 6. Correlati

1.  Descrizione

Visualizza una lista puntata e annidata di tutte le Pagine create nella sezione amministrativa del blog. Questo marcatore è disponibile a partire dalla versione 1.5 di WordPress. I Temi inclusi nel pacchetto ufficiale usano questo marcatore nel file sidebar.php, ma è possibile usarlo dovunque si vuole.

2.  Utilizzo 

 <?php wp_list_pages('arguments'); ?>

3.  Stili CSS

Tutti gli elementi dell'elenco (<li>) generati da questo marcatore vengono associati alla classe CSS page_item. Quando viene mostrata una Pagina e viene invocato il marcatore wp_list_pages, al link corrispondente alla pagina visualizzata, viene associata la classe current_page_item. Tali classi possono essere personalizzate nel foglio di stile style.css del proprio tema grafico.

4.  Esempi di Utilizzo

4.1  Senza Intestazione

Questo esempio non visualizza l'intestazione p. es. "Pagine" in cima all'elenco. (Notare lo spazio dopo il segno = e prima dell'apice di chiusura). 

 <ul>
 <?php wp_list_pages('title_li='); ?> 
 </ul>

4.2  Senza Intestazione e non in forma di elenco

Non visualizza l'intestazione e la lista delle pagine non viene associata ai tag <li><ul>, </ul></li>. (Notare l'assenza di spazi dopo il segno =). 

 <ul>
 <?php wp_list_pages('title_li= '); ?>
 </ul>

4.3  Mostrare l'elenco delle pagine secondo l'ordine di menu

Mostra i link alle pagine secondo l'ordine specificato alla voce Ordine della Pagina nella pagina di scrittura / modifica delle Pagine. 

 <ul>
 <?php wp_list_pages('sort_column=menu_order'); ?>
 </ul>

Aggiungendo questo argomento, il marcatore verrà scritto nella barra laterale in questo modo: 

 <ul>
 <?php wp_list_pages('sort_column=menu_order&title_li=<h2>'. __('Pages') .'</h2>'); ?>
 </ul>

Aggiungendo questo argomento, per non visualizzare l'intestazione, il marcatore verrà scritto nella barra laterale in questo modo: 

 <ul>
 <?php wp_list_pages('sort_column=menu_order&title_li= '); ?>
 </ul>

4.4  Visualizzare le Pagine in base alla data di creazione

Mostra le Pagine ordinate secondo la data di creazione e visualizza la data vicino a ciascun link. 

 <ul>
 <?php wp_list_pages('sort_column=time_created&show_date=created'); ?> 
 </ul>

4.5  Escludere delle Pagine dall'Elenco

Se si vogliono escludere alcune pagine, ad esempio quelle che hanno ID 17 e 38, è sufficiente aggiungere l'argomento exclude in questo modo: 

 <ul>
 <?php wp_list_pages('exclude=17,38&title_li=<h2>'. __('Pages') .'</h2>'); ?>
 </ul>

Nota: La Pagina viene solo esclusa dall'indice e rimane comunque accessibile, sia dal pannello di amministrazione che digitando l'URI nel browser.

Nota: Se si esclude una Pagina dall'indice, verranno automaticamente escluse anche le eventuali Sottopagine.

5.  Parametri del Marcatore

child_of
(intero) Mostra solo le sottopagine della Pagina; usare l'ID numerico della Pagina Madre come valore. Il valore predefinito è 0 (mostra tutte le pagine).
sort_column
(stringa) Visualizza l'indice in base ad una delle seguenti opzioni:

  • 'post_title' - Ordina le pagine in ordine alfabetico secondo il titolo. (Predefinito).
  • 'menu_order' - Ordina le pagine secondo l'ordine da specificato al momento della creazione (o della modifica) della Pagina alla voce Ordine della Pagina.
  • 'time_created' - Ordina le pagine secondo la data di creazione.
  • 'time_modified' - Ordina le pagine secondo la data dell'ultimo aggiornamento.
  • 'ID' - Ordina le pagine secondo l'ID numerico.
  • 'post_author' - Ordina le pagine secondo l'ID numerico dell'autore della pagina.
  • 'post_name' - Ordina le pagine secondo l'abbreviazione, in ordine alfabetico.

sort_order
(stringa) Opzione per l'ordinamento. Valori validi:

  • 'ASC' - (valore predefinito) dal più piccolo al più grande
  • 'DESC' - dal più grande al più piccolo

exclude
(stringa) Lista separata da virgole degli ID numerici delle Pagine da escludere. Esempi: 'exclude=10, 20, 30'). Non c'è un valore predefinito.
depth
(intero) Valore numerico dei livelli gerarchici (sottopagine) da mostrare. Il valore predefinito è 0 (mostra tutte le pagine).
show_date
(stringa) Mostra la data di creazione o dell'ultima modifica, vicino a ciascuna Pagina. Valori validi:

  • '' - Nessuna data (predefinito).
  • 'modified' - Mostra la data dell'ultimo aggiornamento.
  • 'created' - Mostra la data di creazione.

date_format
(stringa) Formatta la data da visualizzare. Il valore predefinito è quello impostato nelle Opzioni del tuo Blog.
title_li
(stringa) Testo da mostrare come titolo dell'indice delle pagine. Il valore predefinito è '__('Pages')', e mostra "Pagine" (i caratteri __('') sono usati per la localizzazione del messaggio. Se non viene passato nessun valore, non viene mostrata nessuna intestazione e la lista non viene inserita tra i tag <ul><li>, </li></ul>.

6.  Correlati

bloginfo, wp_title, get_archives, wp_get_archives, get_calendar, wp_list_pages (1.5), wp_loginout (1.5), wp_register (1.5), query_posts (1.5), rss_enclosure (1.5)

Come passare Parametri ai Tag tramite parametri in stile PHP

Ultima modifica il 19/01/2006 ore 09:48