Crear una extensión widget en PHP

Configurar la extensión

Para crear un widget, como para cualquier creación de una extensión, debe crear una subcarpeta en la carpeta wp-content/plugins y darle un nombre. Para el ejercicio, llámela "widget-post".

Dentro de la carpeta widget-post, cree un archivo widget-post.php. Inserte los archivos readme.txt, licence.txt e index.php (vacío) en la carpeta, si lo desea.

En la parte superior del archivo widget-post.php, agregue un comentario en el encabezado con información sobre la extensión, y active la extensión. Luego, verifique que aparezca en la administración con la información correcta.

El comentario es el siguiente:

<?php 
/* 
Plugin Name: Widget post 
Description: widget que permite mostrar una lista de artículos 
según la categoría. 
Version: 1.0 
License: GPLv2 
This program is free software; you can redistribute it and/or 
modify it under the terms of the GNU General Public License 
as published by the Free Software Foundation; either version 2 
of the License, or (at your option) any later version. 
 
This program is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
GNU General Public License for more details. 
 
You should have received a copy...

La clase WP_Widget

La API de los widgets de WordPress permite administrar, crear y modificar widgets gracias a varios métodos, y permite extender la clase WP_Widget, para crear widgets de una manera muy intuitiva.

La clase WP_Widget ha sido especialmente diseñada para facilitar el desarrollo de widgets. Permite la creación de una clase extendida, que le permitirá utilizar sus métodos.

Para crear la clase de su propio widget, usará la clase WP_Widget de la siguiente manera:

class Mi_clase extends WP_Widget {} 

Este sistema permite simplificar la creación de un widget, por lo que deberá familiarizarse con su implementación y los métodos de la clase WP_Widget.

Para desarrollar un widget, su clase deberá contener cuatro métodos específicos:

Configurar el widget

Para configurar el widget, debe crear una instancia del objeto padre del método constructor __construct(), de esta manera: parent::__construct(). Esto le permite configurar el widget e indicar a WordPress que hay un nuevo widget.

    public function __construct(){ 
        parent::__construct($id_base , $name, $widget_ops, $control_ops ); 
    } 

Este es el detalle para instanciar el padre del método __construct():

parent::__construct($id_base, $name, $widget_ops, $control_ops ); 

Ejemplo

$widget_ops =array(‘classname' => 'your_class', 'description' => 
'your_description'); 

Ejemplo

$control_ops = array(‘width' =>'your_width', 'height' 
=>'your_height', 'id_base' => 'your_id'); 

El método __construct() tiene el siguiente código:

public function __construct() { 
  $widget_ops = array(‘classname' => 'widget-post', 
                'description' => 'widget que permite la visualización de una 
 ...

Guardar el widget con la función register_widget()

Antes de usar el widget, guárdelo fuera de la clase, usando la función WordPress register_widget().

<?php register_widget($widget_class ); ?> 

Existe una función inversa que permite eliminar el registro de un widget:

<?php unregister_widget($widget_class ); ?> 

Estos son los nombres de las clases de los widgets nativos de WordPress:

Crear el formulario del widget

public function form($instance) { ?> 
<p> 
   <label for="">Título:</label> 
   <input type="text" id="" name="" value="" style="width:100%;" /> 
</p> 
<p> 
   <label for="">Categoría: 
   </label> 
   <select id="" name="" value="" style="width:100%;" > 
    <option>todas las categorías</option> 
<?php 
 foreach((get_categories()) as $cat) { 
    echo '<option value="'.$cat->cat_ID.'">'.$cat->cat_name.'</option>'; 
 } 
?> 
 </select> 
</p> 
<?php 
} 

Mostrar el widget en la sidebar

Para mostrar el widget en el sitio web, solo queda alimentar el método de visualización widget().

En primer lugar, use la función PHP extract() en la tabla $args, para extraer las claves de la tabla como variables y asignarles automáticamente el valor asociado. Recuerde que $args es una tabla que contiene información de la sidebar. Por lo tanto, las variables se definen directamente de acuerdo con la configuración de la sidebar (consulte el capítulo Personalizar el sitio con el archivo functions.php - sección Crear barras laterales y zonas para ellas).

Ejemplo

$args=array('before_title'=>'<h1>','after_title'=>'</h1>'); 
extract($args); 
echo $before_title.'mi título'.$after_title; 

El título estará rodeado por etiquetas HTML <h1></h1>, las claves de la tabla se pueden usar directamente como variables, por lo que la clave before _title se puede usar en la forma $before_title, gracias a la función PHP extract().

Este es el código del método widget:

public function widget($args,$instance) { 
 extract($args); 
 
} 

En su caso, la tabla $args tiene las variables...