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

Usi Descrizione
wp-includes/category-template.php: wp_generate_tag_cloud()

Genera una nuvola di tag (heatmap) dai dati forniti.

wp-includes/category-template.php: wp_tag_cloud

Filtra l'output della nuvola di tag.

wp-includes/functions.php: wp_parse_args()

Unisce i parametri definiti dall'utente nell'array dei valori predefiniti.

wp-includes/taxonomy.php: get_term_link()

Genera un permalink per un archivio di termini della tassonomia.

wp-includes/taxonomy.php: get_terms()

Recupera i termini di una determinata tassonomia o di un elenco di tassonomie.

wp-includes/link-template.php: get_edit_term_link()

Recupera l'URL per la modifica di un dato termine.

wp-includes/plugin.php: applica_filtri()

Richiama le funzioni di callback che sono state aggiunte a un gancio per i filtri.

wp-includes/load.php: is_wp_error()

Verifica se la variabile data è un errore di WordPress.

Utilizzato da

Usato da Descrizione
wp-includes/widgets/class-wp-widget-tag-cloud.php: WP_Widget_Tag_Cloud::widget()

Emette il contenuto dell'istanza corrente del widget Tag Cloud.

Changelog

Versione Descrizione
4.8.0 Aggiunge l'opzione show_count .
2.8.0 Aggiunto l'argomento taxonomy .
2.3.0 Introdotto.