Tag Template: list_cats

Descrizione

Visualizza un elenco di categorie sottoforma di link. Funziona in maniera simile al tag wp_list_cats, con la differenza che queso utilizza un lunga stringa di interroggazione composta da una lunga tringa di argomenti, mentre l'altro utilizza una interrogazione basata su argomenti di tipo testo.

Utilizzo

 <?php list_cats(optionall,'all','sort_column',
              'sort_order','file', list, optiondates, 
                optioncount, hide_empty, use_desc_for_title, 
                children, child_of,'categories', recurse, 
              'feed','feed_img','exclude', 
                hierarchical); ?> =]

Esempi

Esempio 1

Visualizza un elenco di categorie utilizzando i valori predefiniti: 

 <?php list_cats(); ?>

Esempio 2

Visualizza una lista di categorie, senza link alle categorie e ordinata per nome: 

 <?php list_cats(FALSE,'','name'); ?>;

Parametri

optionall

(boleano) Imposta se visualizzare o meno tutte le categorie. Possibili valori sono:
  • TRUE (Valore predefinito)
  • FALSE

all

(stringa) Testo da visualizzare per la visualizzazione di tutte le categorie. Valore predefinito: 'All'.

sort_column

(stringa) Chiave secondo cui eseguire l'ordinamento. Possibili valori sono:
  • 'ID' (Valore predefinito)
  • 'name'

sort_order

(stringa) Opzione per l'ordinamento. Possibili valori sono:
  • 'asc' (Valore predefinito)
  • 'desc'

file

(stringa) Indica il file php in cui viene visualizzato un link di categoria. Valore predefinito: 'index.php'.

list

(boleano) Imposta se le categorie verranno racchiuse all'interno di una lista non ordinata (<ul><li>). Possibili valori sono:
  • TRUE (Valore predefinito)
  • FALSE

optiondates

(boleano) Imposta se visualizzare la data dell'ultimo articolo di ciascuna categoria. Possibili valori sono:
  • TRUE
  • FALSE (Valore predefinito)

optioncount

(boleano) Imposta se visualizzare il numero di articoli contenuti in ciascuna categoria. Possibili valori sono:
  • TRUE
  • FALSE (Valore predefinito)

hide_empty

(boleano) Imposta se nascondere (non visualizzare) le categorie senza articoli. Possibili valori sono:
  • TRUE (Valore predefinito)
  • FALSE

use_desc_for_title

(boleano) Imposta s la descrizione della categoria viene visualizzata come titolo del link (es. <a title="Descrizione Categoria" href="">). Possibili valori sono:
  • TRUE (Valore predefinito)
  • FALSE

children

(boleano) Imposta se visualizzare le categorie figlie. Possibili valori sono:
  • TRUE
  • FALSE (Valore predefinito)

child_of

(intero) Visualizza solo le categorie che sono figlie di questa categoria (ID). Non vi è un valore predefinito.

categories

(intero) Questo parametro doverebbe venir impostato a 0 (zero) quando si richiama questo tag. (Per i curiosi, altri valori vengono utilizzati solo internamente dal tag quando genera una lista gerarchica.)

recurse

(boleano) Visualizza la lista (FALSE) o la restituisce per venir utilizzata in (TRUE). Valore predefinito FALSE.

feed

(stringa) Testo da visualizzare, associato al link ai singoli feed RSS degli autori. Valore predefinito è un testo nullo, in questo caso non viene visualizzato alcun feed.

feed_img

(stringa) Percorso/nomefile per una immagine a cui associare il link a ciascuna categoria di feed RSS. Ha la precedenza sul parametro feed.

exclude

(stringa) Imposta quali categorie vanno escluse. Questo parametro deve essere fornito sotto forma di un array (es: '1, 2, 3').

hierarchical

(boleano) Determina se visualizzare le (sotto)categorie figlie in una lista gerarchica (dopo la categoria padre). Possibili valori sono:
  • TRUE (Valore predefinito)
  • FALSE
Nota:Il parametro hierarchical non è disponibile nelle versioni precedenti alla 1.5.

Correlati

Per utilizzare la stringa di interrogazione per passare i parametri con cui generare una lista di categorie si veda wp_list_cats

the_category, the_category_rss, the_category_ID (Sconsigliato), the_category_head (Sconsigliato), single_cat_title, category_description, dropdown_cats, list_cats, wp_list_cats, in_category

Come passare Parametri ai Tag

Marcatori Template

Ultima modifica il 20/03/2008 ore 05:51