Crear un widget para el administrador de Wordpress

Hace poco he actualizado los dos widgets para el panel de administración -o dashboard- de Wordpress que he creado (Meet your commenters y Berri Technorati Reactions on Dashboard), y lo he hecho más que nada porque la forma de añadir estos widgets cambió en Wordpress 2.7 y el método que usaba yo ya no valía. Así que aprovecho y os cuento como se hace.

Realmente esos widgets, al igual que los de las barras laterales, son plugins de wordpress por lo tanto lo que tenemos que hacer es un plugin que luego subiremos a su correspondiente carpeta y activaremos en el panel de administración. Además, podremos activar, desactivar o mover ese panel que crearemos para el dashboard, tal como se puede hacer con los que vienen por defecto. Nada mejor que un ejemplo y un poco de código para explicar como hacerlo:

<?php
/*

Plugin Name: Sample Dashboard Widget

Plugin URI: http://www.berriart.com/

Description: Sample code for creating a dashboard widget 

Author: Alberto Varela

Version: 1.0

Author URI: http://www.berriart.com
*/

// Función para mostrar el contenido del widget
function sampledashboardwidget_main_function() {
	echo "Hello World";
}

// Utilizamos la función wp_add_dashboard_widget para añadir el
// widget al panel
function sampledashboardwidget_register_dashboard_widget() {
	wp_add_dashboard_widget('sampledashboardwidget', // ID único del widget
	'Sample Dashboard Widget', // Título para el widget
	'sampledashboardwidget_main_function', // Función principal del wiget
	'sampledashboardwidget_setup');	// Este último parámetro es opcional y solo lo usaremos
					// en caso de necesitar una página de opciones, en ese
					// caso pondremos la función que corresponda
}

// Añadir finalmente el widget mediante el sistema 'hooks' de Wordpress
add_action('wp_dashboard_setup', 'sampledashboardwidget_register_dashboard_widget');

// Si se quiere hacer por ejemplo una página de administración, al estilo del widget 'stats',
// podemos añadirla mediante el cuarto parametro de la función 'wp_add_dashboard_widget'
function sampledashboardwidget_setup() {
	if( isset($_POST['sdw_option']) ) do_something();
	echo '<form><input type="text" name="sdw_option" /><input type="submit" /></form>';
}

?>

Creo que no hace falta dar muchas más explicaciones y con esto como inicio cualquiera que se anime y tenga una idea puede crear un nuevo widget para el dashboard. Por cierto, yo no sabía que se podía agregar una página de opciones al widget, pero el otro día Rick me iluminó.

Igual también te interesa leer estos posts:

• Berri Alianzo Widget
• Widget que muestra vídeos de YouTube
• Otro widget compatible con Wordpress 2.7
• Usar funciones de Wordpress externamente
• Berri Technorati Reactions on Dashboard