Pagina da rivedere e/o aggiornare

Tag Template: get_links

Descrizione

Questo tag, alla stessa maniera di wp_get_links(), mostra i link inseriti tramite il Gestore di Link ?, ma permette all'utente di scegliere come visualizzare i link tramite dei parametri, piuttosto che tramite l'interfaccia di amministrazione di WordPress, che si rivela utile per decidere la visualizzazione dei link se si fa uso di più temi grafici.

Utilizzo 

 <?php get_links(category,'before','after','between', 
                show_images,'order', show_description,
                show_rating, limit, show_updated, echo); ?>

Esempi

Utilizzo Predefinito

Il comportamento predefinito di questo tag:

Utilizzo Standard

Di base vengono visualizzati:

  • Tutti i link
  • Inserisce un'interruzione di riga dopo ciascun link
  • Se ci sono, mostra le immagini dei link
  • Inserisce uno spazio tra l'immagine e il link
  • La lista è ordinata per nome
  • Visualizza la descrizione del link
  • Non visualizza il punteggio
  • A meno di avere impostato un limite, i link vengono visualizzati tutti
  • Visualizza tutti i link come link e non come testo 

 <?php get_links(); ?>

Categoria Specifica Ordinata per URL

Visualizza i link per la categoria di link di ID 2 all'interno di un tag span, utilizza le immagini dei link, non visualizza la Descrizione, ordina la lista secondo l'URL. 

 <?php get_links(2,'<span>','</span>', '', TRUE,'url', FALSE); ?>

Visualizza il Punteggio ed il Timestamp

Visualizza tutti i link in una lista ordinata con le descrizioni su una nuova riga, non utilizza le immagini per i link, ordina secondo l'ID dei link, visualizzando i punteggi ed il timestamp dell'ultimo aggiornamento. 

 <ol>
 <?php get_links(-1,'<li>','<li>','<br />', FALSE,'id', TRUE, TRUE, -1, TRUE); ?>
 </ol>

Parametri

category
(intero) L'ID numerico di una categoria di link per la quale verranno visualizzati i link. Se non ne viene specificata nessuna verranno visualizzati tutti i link. Valore predefinito -1 (tutti i link).
before
(stringa) Testo da inserire prima di ciascun link. Nessun valore predefinito.
after
(stringa) Testo da inserire dopo ciascun link. Valore predefinito '<br />'.
between
(stringa) Testo da inserire fra ciascun link/immagine e la sua descrizione. Valore predefinito '' (spazio).
show_images
(boleano) Mostra (TRUE) o meno (FALSE) le immagini dei link. Valore predefinito TRUE.
orderby
(stringa) Valore di ordinamento dei link. Valore predefinito 'name' a meno che non si passi il valore '' (vuoto), in tal caso si utilizzerà 'id'. Valori validi sono:

  • 'id'
  • 'url'
  • 'name'
  • 'target'
  • 'category'
  • 'description'
  • 'owner' - L'utente che ha aggiunto il link tramite la Gestione Link.
  • 'rating'
  • 'updated'
  • 'rel' - Relazione fra i link (XFN).
  • 'notes'
  • 'rss'
  • 'rand' - Mostra i link in ordine causale.

Per visualizzare i link in ordine inverso basta aggiungere alle opzioni indicate il carattere underscore (p. es: '_id').

show_description
(boleano) Mostra (TRUE) o meno (FALSE) la descrizione. Valid o quando show_images è impostato a FALSE oq uando non è definita alcuna immagine. Valore predefinito TRUE.
show_rating
(boleano) Visualizza (TRUE) o meno (FALSE) il punteggio tramite stelle/caratteri. Valore predefinito FALSE.
limit
(intero) Numero massimo di link da visualizzare. Valore predefinito -1 (tutti i link).
show_updated
(boleano) Mostrare (TRUE) o meno (FALSE) l'ultima data di aggiornamento (timestamp). Valore predefinito FALSE.
echo
(boleano) Visualizzare i link (TRUE) o restituirli per utilizzarli in PHP (FALSE). Valore predefinito TRUE.

Correlati

get_links(), get_links_list(), get_linksbyname(), wp_get_links(), wp_get_linksbyname()

Come passare Parametri ai Tag tramite parametri in stile PHP

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