Johan de Bruin » Plugin wordpress

Añadir opciones a un plugin wordpress

Johan — Thu, 18 Mar 2010 14:18:29 +0000

Consta de una variable para establecer un nombre de id para establecer las opciones en la base de datos, añadir la acción al hook del menu al construir el plugin, establecer como aparecerá en la pestaña las opcinones con add_options_page, y el código que mostrará y gestionará las opciones insertadas. Aquí un ejemplo básico de como quedaría:


class miPlugin()
{
	var $db_option = 'miPlugin_Options';
 
	function miPlugin()
	{
		//Línea para incluir el menú
		add_action('miMenu', array(&$this, 'admin_menu'));
	}
 
	function miMenu()
	{
		add_options_page('Opciones del plugin', 'Algun id', 8, basename(__FILE__), array(&$this, 'opciones'));
	}
 
	function opciones()
	{
		$options = $this->get_options();
 
		if (isset($_POST['submitted'])) {
		  check_admin_referer('nonce');
		  $options = array();
		  $options['a'] = $_POST['a'];
		  $options['b'] = $_POST['b'];
		  update_option($this->db_option, $options);
		}
		// Aquí establecemos algunas variables que usaremos en el form
		$action_url = $_SERVER['REQUEST_URI'];
		$a = $options['a'];
		$b = $options['b'];
		?>
 
       	 echo $action_url ?>" method="post">
             wp_nonce_field('nonce'); ?>
             echo $a ?> /> Show Posts  

             echo $b ?> /> Show Pages  

            
       	
        
	}
}
?>

Solo decir que que las opciones se obtienen con $options = $this->get_options(); y se establecen con update_option($this->db_option, $options); Además, sirve como parametro de seguridad para cercionarnos que se está empleando el formulario correcto. Esto luego se comprueba con check_admin_referer(‘nonce’);

Estructura de la clase php de un plugin de wordpress

Johan — Sun, 14 Mar 2010 15:31:58 +0000

Los buenos plugins de wordpress están desarrollados a través de una clase php con la que se optimiza el código. Aquí traigo un ejemplo de la estructura básica de la programación php para declarar la clase e insertar el constructor y un método que se autoejecutará al iniciar la clase que instalará el plugin.


/*
Plugin name: Nombre de mi plugin
Version: 0.1
Plugin URI: http://www.johandebuin.com/miplugin
Author: Johan de Bruin
Author URI: http://www.johandebruin.com
Description: una descripción sobre que hace el plugin en cuestión
*/

Ahora declaramos un if para comprobar si la clase ya existe, en caso contrario la definimos.

if ( !class_exists('clasePlugin') ) :
class clasePlugin
{
     //Esta variable sirve para obtener la url del plugin
     var $plugin_url;
 
     //Constructor del plugin
     function clasePlugin()
     {
          $this->plugin_url = trailingslashit( WP_PLUGIN_URL.'/'. dirname( plugin_basename(__FILE__) ));
          //Línea para incluir los scripts a la pagina
          add_action('wp_print_scripts', array(&$this, 'misScripts'));
     }
 
     function instalar()
     {
          //Sentencias como la creación de una BD
     }
 
     function misScripts()
     {
          //Añadimos un script en jquery
          wp_enqueue_script('jquery');
          wp_enqueue_script('clasePlugin', $this->plugin_url . '/rutaDeljquery.js', array('jquery'));
          //Añadimos un css
          echo '. $this->plugin_url . '/estilo.css" type="text/css" />';
     }
}
else :
     exit ("La clase clasePlugin ya esta declarada");
endif;

Por último creamos la instancia de la clase, emplearemos la función de wordpress register_activation_hook cuyos parametros son fichero del plugin y callback, para especificar que queremos que se ejecute la función instalar al activar el plugin.

$instanciaPlugin = new clasePlugin();
 
if(isset($instanciaPlugin))
{
     //Recuerda que la & sirve para que los cambios realizados en la variable en la función
     //surtan efecto a nivel global y no solo dentro de la variable.
     register_activation_hook(__FILE__, array(&$instanciaPlugin, 'instalar'));
}
?>

Y recuerda, el codigo es poesia .

Crear y configurar un widget de wordpress

Johan de Bruin — Fri, 29 Jan 2010 16:17:42 +0000

Para crear un widget con wordpress solo debemos definirlo en el archivo donde alojemos el plugin de wordpress, no obstante, un widget permite ajustar una serie de opciones, en el siguiente codigo de programación aprenderemos a aprovechar el potencia de widgets de wordpress para que podamos añadir facilmente aplicaciones en los sidebar de tu blog.

  function miplugin_Widget($args = array())
  {
      global $user_ID, $user_identity, $wp_wall_plugin_url;
      // extract the parameters
      extract($args);
 
      // get our options
      $options = get_option('miplugin');
      $titulo= $options['miplugin_titulo'];
 
      // Estas variables son por cuestión de compatibilidad del theme
      echo $before_widget;
      echo $before_title . $titulo. $after_title;
 
      // El texto y código que inluirá nuestro widget
      echo "HOLA MUNDO!";
 
      echo $after_widget;
  }
 
//Desarrollamos lo que debe hacer el plugin al activarse
function miplugin_init()
{
     register_sidebar_widget('Nombre plugin','miplugin_Widget');
     register_widget_control('Nombre plugin','miplugin_WidgetControl');
}
//Acción que indica la función de activación del plugin
add_action('init','miplugin_init');

Con estas lineas de código podemos cambiar las opciones del plugin con tal de que podamos establecer el título del widget que aparecerá en el sidebar.

function miplugin_WidgetControl()
{
      // Obtenemos los valores preestablecidos
      $options = get_option('miplugin');
      // Cambiamos las opciones en caso de que haya un post
      if ($_POST["miplugin_submit"]) {
          // retireve wall title from the request
          $options['miplugin_titulo'] = strip_tags(stripslashes($_POST["miplugin_titulo"]));
          // update the options to database
          update_option('miplugin', $options);
      }
      $titulo = $options['titulo'];
      // Lo que se imprime en las opciones del widget
      ?>

Titulo:  echo $titulo; ?>" />


     
}