Wordpress wp_tag_cloud()

Visualizza una nuvola di tag.

Descrizione

Visualizza un elenco di tag in una cosiddetta "nuvola di tag", dove la dimensione di ciascun tag è determinata dal numero di volte in cui quel particolare tag è stato assegnato ai post.

Parametri

$args

(array|stringa)(Opzionale)Array o stringa di argomenti per la visualizzazione di una tag cloud. Vedere wp_generate_tag_cloud() e get_terms() per l'elenco completo degli argomenti che possono essere passati. $args.

• 'numero'
  (int) Il numero di tag da visualizzare. Accetta qualsiasi numero intero positivo o zero per restituire tutto. Valore predefinito 45.
• 'link'
  (stringa) Se visualizzare i link di modifica dei termini o i permalink dei termini. Accetta "modifica" e "visualizza". Predefinito "vista".
• 'tipo_di_post'
  (stringa) Il tipo di post. Si usa per evidenziare il menu del tipo di post appropriato nella pagina di modifica collegata. Per impostazione predefinita, il primo tipo di post associato alla tassonomia.
• 'eco'
  (bool) Se fare o meno l'eco del valore di ritorno. Valore predefinito: true.

Valore predefinito: ''

Ritorno

(nullo|stringa|stringa[]) Vuoto se l'argomento 'echo' è vero, o in caso di fallimento. Altrimenti, tag cloud come stringa o array, a seconda dell'argomento 'formato'.

Fonte

File: wp-includes/category-template.php

functionwp_tag_cloud($args=''){$defaults=array('smallest'=>8,'largest'=>22,'unit'=>'pt','number'=>45,'format'=>'flat','separator'=>"n",'orderby'=>'name','order'=>'ASC','exclude'=>'','include'=>'','link'=>'view','taxonomy'=>'post_tag','post_type'=>'','echo'=>true,'show_count'=>0,);$args=wp_parse_args($args,$defaults);$tags=get_terms(array_merge($args,array('orderby'=>'count','order'=>'DESC',)));// Always query top tags.if(empty($tags)||is_wp_error($tags)){return;}foreach($tagsas$key=>$tag){if('edit'===$args['link']){$link=get_edit_term_link($tag->term_id,$tag->taxonomy,$args['post_type']);}else{$link=get_term_link((int)$tag->term_id,$tag->taxonomy);}if(is_wp_error($link)){return;}$tags[$key]->link=$link;$tags[$key]->id=$tag->term_id;}// Here's where those top tags get sorted according to $args.$return=wp_generate_tag_cloud($tags,$args);/**
	 * Filters the tag cloud output.
	 *
	 * @since 2.3.0
	 *
	 * @param string|string[] $return Tag cloud as a string or an array, depending on 'format' argument.
	 * @param array           $args   An array of tag cloud arguments. See wp_tag_cloud()
	 *                                for information on accepted arguments.
	 */$return=apply_filters('wp_tag_cloud',$return,$args);if('array'===$args['format']||empty($args['echo'])){return$return;}echo$return;}

Correlato

Utilizzi

Utilizzato da

Changelog