Domingos de WordPress. Creando tu primer plugin.

Tras los últimos artículos dedicados a la instalación de WordPress en Ubuntu, que comenzaron con el artículo “Como instalar un entorno de desarrollo de WordPress en Ubuntu”, he comenzado a darle vueltas al asunto, y he llegado a la conclusión de comenzar un nueva categoría en el blog sobre WordPress y todo lo relacionado con él.

Para ello, y he pensado en convertir en hacer días temáticos, y así empezaré con los Domingos de WordPress, a los que con casi toda seguridad se unirán los Miércoles, pero esto va a depender de la aceptación que le deis a esta nueva iniciativa.

La idea de estos artículos, es la de explicar como realizar determinadas acciones en WordPress, ya sea por tus propios medios, o bien a partir de los plugins que he implementado, o que voy a implementar.

Así para empezar a continuación, explicaré algo tan interesante como crear tu propio plugin o complemento.

wordpress_plugins.jpg

El primer plugin

Por ser el primer artículo referente a complementos o plugins para WordPress no me quiero extender en exceso, ni ser demasiado pesado. Por ello, voy a realizar lo básico, para que cada uno extraiga sus propias conclusiones.

Este primer plugin no tendrá la funcionalidad que esperas, por lo que no lo voy a dejar para descargar. Cuando esté completo, es decir, en el próximo artículo lo dejaré en el área de descargas e incluso lo subiré a la zona de complementos de WordPress para aquel que quiera lo descargue.

Por otro lado, también explicaré como puedes hacer la misma operación sin que sea necesario crear un plugin.

Lo mínimo

Cualquier complemento de WordPress se compone de un archivo, que en este caso lo he llamado ejemplo0.php en el que se definen en su encabezado los siguientes parámetros,

/**
* Plugin Name: Ejemplo 0
* Plugin URI: http://www.atareao.es
* Description: El primer ejemplo de como crear un plugin para WordPress.
* Author: El atareao
* Version: 0.1.0
* Author URI: http://www.atareao.es
* License: GPL3
*/

Esta parte es fundamental para que WordPress Entienda que es lo que le estamos ofreciendo. Así debemos definir,

  • Plugin Name, el nombre del plugin.
  • Plugin URI, la página del plugin (si es que existe).
  • Description, la descripción del plugin.
  • Author, el nombre del author
  • Version, la versión del plugin
  • Author URI, la dirección web del author
  • License, la licencia

Google Analytics Plugin

El objeto de este plugin es el de poner el código de Google Analytics en el encabezado de nuestra web, de forma automática para todas las páginas de nuestro sitio.

Como he comentado anteriormente, se trata de un primer paso, y por esta razón, para poder configurar el complemento para nuestro sitio, será necesario, modificarlo de forma manual. Espera a futuras versiones donde se podrá configurar según tus necesidades.

Así, en el archivo ejemplo0.php, que hemos definido anteriormente, además del encabezado añadiremos lo siguiente,

    function google_analytics_script(){    
        $id_seguimiento = 'UA-123456789-1';
        $output = '
        <!-- Google Analytics -->
        <script type="text/javascript">
            var _gaq = _gaq || [];
            _gaq.push(["_setAccount", "'.$id_seguimiento.'"]);
            _gaq.push(["_trackPageview"]);
            (function() {
                var ga = document.createElement("script"); ga.type = "text/javascript"; ga.async = true;
                ga.src = ("https:" == document.location.protocol ? "https://" : "http://") + "stats.g.doubleclick.net/dc.js";
                var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(ga, s);
            })();
        </script>
        <!-- Google Analytics -->
        ';
        echo $output;
    }
    add_action('wp_head', 'google_analytics_script');

Es necesario, que en esta primera versión de este plugin modifiques el ID de seguimiento, que he puesto como UA-123456789-1, por el tuyo propio.

Ahora este archivo lo comprimes en un zip como ejemplo0.zip y ya tienes tu primer complemento dispuesto a funcionar…

Lo único a reseña es la última línea que aparecerá en el archivo,

add_action('wp_head', 'google_analytics_script');

Esto le indica a WordPress que tiene que ejecutar la función en el encabezado.

Conclusiones

Como he comentado, esta es el primer artículo sobre WordPress, para la tarde de los Domingos. Por ser el primero, tampoco he querido extenderme mas allá. Pero el objetivo, es publicar cada vez un plugin o un tema y explicar como se puede hacer o bien con plugin o bien directamente en el archivo functions.php de tu tema.