Aggiunge un nuovo widget per il cruscotto.

Parametri

$widget_id

(stringa)(Richiesto)ID del widget (usato nell'attributo 'id' del widget).

$nome_widget

(stringa)(Richiesto)Titolo del widget.

$callback

(richiamabile)(Richiesto)Funzione che riempie il widget con il contenuto desiderato. La funzione deve fare eco al suo output.

$control_callback

(richiamabile)(Opzionale) Funzione che emette i controlli per il widget.

Valore predefinito: null

$callback_args

(array)(Opzionale) Dati da impostare come proprietà $args dell'array di widget (che è il secondo parametro passato al callback).

Valore predefinito: null

$contesto

(stringa)(Opzionale) Il contesto dello schermo in cui deve essere visualizzato il riquadro. Accetta 'normale', 'laterale', 'colonna3' o 'colonna4'.

Valore predefinito: "normale".

$priorità

(stringa)(Opzionale) La priorità all'interno del contesto in cui il riquadro deve essere visualizzato. Accetta 'alta', 'centrale', 'predefinita' o 'bassa'.

Valore predefinito: "core".

Fonte

File: wp-admin/includes/dashboard.php

functionwp_add_dashboard_widget($widget_id,$widget_name,$callback,$control_callback=null,$callback_args=null,$context='normal',$priority='core'){$screen=get_current_screen();global$wp_dashboard_control_callbacks;$private_callback_args=array('__widget_basename'=>$widget_name);if(is_null($callback_args)){$callback_args=$private_callback_args;}elseif(is_array($callback_args)){$callback_args=array_merge($callback_args,$private_callback_args);}if($control_callback&&current_user_can('edit_dashboard')&&is_callable($control_callback)){$wp_dashboard_control_callbacks[$widget_id]=$control_callback;if(isset($_GET['edit'])&&$widget_id==$_GET['edit']){list($url)=explode('#',add_query_arg('edit',false),2);$widget_name.=' .esc_url($url).'">'.__('Cancel').'';$callback='_wp_dashboard_control_callback';}else{list($url)=explode('#',add_query_arg('edit',$widget_id),2);$widget_name.=' .esc_url("$url#$widget_id").'">'.__('Configure').'';}}$side_widgets=array('dashboard_quick_press','dashboard_primary');if(in_array($widget_id,$side_widgets,true)){$context='side';}$high_priority_widgets=array('dashboard_browser_nag','dashboard_php_nag');if(in_array($widget_id,$high_priority_widgets,true)){$priority='high';}if(empty($context)){$context='normal';}if(empty($priority)){$priority='core';}add_meta_box($widget_id,$widget_name,$callback,$screen,$context,$priority,$callback_args);}

Correlato

Utilizzi

Usi Descrizione
wp-admin/includes/screen.php: get_current_screen()

Ottiene l'oggetto schermo corrente

wp-admin/includes/template.php: add_meta_box()

Aggiunge un meta-box a una o più schermate.

wp-includes/capabilities.php: current_user_can()

Restituisce se l'utente corrente ha la capacità specificata.

wp-includes/l10n.php: __()

Recupera la traduzione di $testo.

wp-includes/formatting.php: esc_url()

Controlla e pulisce un URL.

wp-includes/functions.php: add_query_arg()

Recupera una stringa di query URL modificata.

Utilizzato da

Usato da Descrizione
wp-admin/includes/dashboard.php: wp_dashboard_setup()

Registra i widget della dashboard.

Changelog

Versione Descrizione
5.6.0 Il $context e $priority sono stati aggiunti.
2.7.0 Introdotto.