Tag Template: get_linksbyname

Descrizione

Questo tag, alla stessa maniera di wp_get_linksbyname(), 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_linksbyname('cat_name','before','after',  
                    'between', show_images,'orderby',
                      show_description, show_rating, 
                      limit, show_updated); ?>

Esempi

Utilizzo Predefinito

Il comportamento predefinito di questo tag:

  • Se non viene specificata nessuna categoria, vengono mostrate tutte le categorie
  • Vengono mostrati tutti i link appartenenti alle categorie
  • Inserisce un'interruzione di riga dopo ciascun link
  • Inserisce uno spazio tra l'immagine e il link (se si associano le immagini ai link)
  • Se ci sono, mostra le immagini dei link
  • Mostra i link ordinati secondo il loro ID
  • Mostra la descrizione dei link
  • Non mostra il punteggio
  • Mostra tutti i link
  • Non mostra la data di aggiornamento 

 <?php get_linksbyname(); ?>

Una categoria specifica, visualizzata in base al nome

Mostra i link della categoria "Amici" in un elenco puntato, ordinato secondo il nome del link e visualizza le descrizioni sulla riga successiva di ciascun link. 

 <ul>
 <?php get_linksbyname('Friends','<li>','</li>','<br />', FALSE, 'name', TRUE); ?>
 </ul>

Con Immagini e Punteggio, senza Descrizioni

Mostra tutti i link, uno per riga senza descrizioni, usa delle immagini per i link, li ordina in base al nome e mostra anche il punteggio. 

 <?php get_linksbyname('', '','<br />', '', TRUE,'name', FALSE, TRUE); ?>

Parametri

cat_name
(stringa) Il nome della categoria dei link di cui si vogliono mostrare i link. Se non viene specificata nessuna categoria, vengono mostrati tutti i link. Il valore predefinito è 'nessuno' (tutti i link).
before
(stringa) Testo da inserire prima di ogni link. Nessun valore predefinito.
after
(stringa) Testo da inserire dopo ogni link. Il valore predefinito è '<br />'.
between
(stringa) Testo da inserire tra il link/imagine e la sua descrizione. Il valore predefinito è '' (spazio).
show_images
(boleano) Indica se devono essere mostrate le immagini dei link (TRUE) oppure no (FALSE). Il valore predefinito è TRUE.
orderby
(stringa) Valore secondo il quale ordinare i link. Il valore predefinito è 'id'. Le opzioni valide sono:

  • 'id'
  • 'url'
  • 'name'
  • 'target'
  • 'category'
  • 'description'
  • 'owner' - L'utente che ha aggiunto il link tramite il Gestore di Link.
  • 'rating'
  • 'updated'
  • 'rel' - Relazione tra 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 la descrizione (TRUE) oppure no (FALSE). Funziona se show_images è settata a FALSE o se l'immagine non viene specificata. Il valore predefinito è TRUE.
show_rating
(boleano) Indica se devono essere visualizzati i caratteri o le stelle che mostrano il punteggio (TRUE) oppure no (FALSE). Il valore predefinito è FALSE.
limit
(intero) Il numero massimo di link da mostrare. Il valore predefinito è -1 (all links).
show_updated
(boleano) Indica se deve essere visualizzata la data dell'ultimo aggiornamento (TRUE) oppure no (FALSE). Il valore predefinito è FALSE.

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