Crear un Widget personalizado para tu blog WordPress

Los plugins son parte del éxito de WordPress, esas pequeñas piezas de código hacen que crear un sitio web con WordPress y añadirle funcionalidades sea algo trivial. Ahora bien, no siempre vas a depender de los demás, sobre todo porque es posible, a pesar de los mas de 18 mil que hay, que no exista uno que haga exactamente lo que tu necesitas.

En este tutorial veremos como crear un Widget para WordPress.

Comenzamos creando un directorio con el nombre de nuestro Widget en el directorio «wp-content/plugins/». Aquí es donde WordPress almacena los plugins. Recomiendo crear un directorio siempre que se crea un Widget, aunque éste contenga sólo un archivo, ya que más tarde podrías incorporarle más archivos y te verías obligado a tocar porciones del código del Widget. En nuestro caso vamos a crear el directorio «prueba» y dentro de él un archivo llamado «prueba.php». En este nuevo archivo deberemos rellenarlo con lo siguiente:

/*
Plugin Name: Primer Plugin
Plugin URI: https://www.jose-aguilar.com/blog/wordpress
Description: Se trata de un plugin de muestra
Version: 1.0
Author: Jose Aguilar
Author URI: https://www.jose-aguilar.com/
*/

Toda esta información se utilizará para identificar nuestro Widget en la administración de plugins para WordPress, como podemos ver en la siguiente imagen.

En el mismo archivo debemos seguir rellenándolo con la siguiente clase y funciones:

// Cuando se inicializa el widget llamaremos al metodo register de la clase Prueba que creamos a continuación
add_action( "widgets_init", array( "Prueba", "register" ) );

class Prueba
{
    // Panel de control que se mostrara abajo de nuestro Widget en el panel de configuración de Widgets
    function control()
    {
        echo "Hola, soy el panel de control.";
    }

    // Metodo que se llamara cuando se visualize el Widget en pantalla
    function widget($args)
    {
        echo $args["before_widget"];
        echo $args["before_title"] . "Titular en portada" . $args["after_title"];

        echo "Hola soy tu Widget";
        echo $args["after_widget"];
    }

    // Meotodo que se llamara cuando se inicialice el Widget
    function register()
    {
        // Incluimos el widget en el panel control de Widgets
        register_sidebar_widget( "Widget de prueba", array( "Prueba", "widget" ) );

        // Formulario para editar las propiedades de nuestro Widget
        register_widget_control( "Widget de prueba", array( "Prueba", "control" ) );
    }
}

Una vez guardado nos dirigiremos al Panel de Control de plugins y lo activaremos. Una vez activado, vamos a las opciones de los Widgets, dentro del submenú apariencia, y lo añadiremos a nuestro sidebar. En nuestro template aparecerá nuestro Widget.

 Ver más información