Watafak.io
Tutoriales

Cómo crear un plugin personalizado de WordPress en 5 minutos o menos

🕒 5 min

Esta es una guía rápida para principiantes. Aprenderás a implementar tu primer plugin personalizado en WordPress.

La idea es que dentro de ese plugin agregués algún código personalizado que necesites integrar a tu sitio web.

¿Para qué crear un plugin personalizado?

Mejor control del código

Al tener tus propios plugins, podrás organizarlo según funcionalidades, según áreas que afecta, según roles de usuario, etc.

Además, será más sencillo mantenerlo, modificarlo, actualizarlo o eliminarlo, según lo que necesités hacer.

Facilidad para depurar errores

La depuración de errores en WordPress siempre causa un ligero dolor de cabeza. Si tenés tus códigos personalizados en plugins separados, es más sencillo ir probando a desactivarlos uno a uno para ver cuál está causando errores.

Seguridad frente a actualizaciones del core, theme y otros plugins

Muchos tutoriales te dicen que incluyas código personalizado en el archivo functions.php de tu theme, ya que es una mejor pŕactica que agregarlo directamente el los archivos header.php o footer.php.

Algunos otros tutoriales te enseñan cómo crear tu tema hijo, para que así la actualización del theme no borre tus modificaciones.

Sin embargo, si no querés crear un tema hijo, y además querés tener mejor organización, lo ideal es tener separados tus códigos en plugins personalizados, ya que estos no se modificarán en caso que se actualice el core de WordPress, el theme de tu sitio o cualquier otro plugin.

Evitar instalar plugins con funciones innecesarias

En el repositorio de WordPress hay miles y miles de plugins. Muchas veces me ha pasado que necesito una funcionalidad pequeña que la resuelve un plugin, pero también ese plugin tiene muchas otras funciones que no voy a utilizar.

Instalar un plugin así provoca que tu instalación de WordPress consuma más recursos y tu web cargue más lento.

Entonces, si podés poner esa pequeña funcionalidad aislada dentro de un plugin personalizado, estarás contribuyendo a que tu WordPress corra más rápido, lo que mejorará la experiencia de tu usuario y tus métricas de rendimiento.

Paso a paso para crear tu propio plugin personalizado

¿Qué necesitás?

Debes tener acceso al administrador de archivos de tu instalación de WordPress, ya sea por FTP o a través del CPanel o DirectAdmin.

No está demás decirlo, pero necesitás tener una copia de seguridad de tu sitio.

Paso 1. Entrá a los archivos de tu instalación WordPress

Aquí estoy usando DirectAdmin, que es el Dashboard que tiene contratado mi hosting.

Por cierto, uso Interserver como hosting, ya que tienen un plan desde $ 2,5/por mes que tiene todo lo que necesito para iniciar un blog: dominios ilimitados, subdominios ilimitados, cuentas de email ilimitadas, acceso FTP, administrador de archivos, Softaculous y un largo etc.

Volviendo a nuestro asunto, en DirectAdmin buscás el acceso File Manager y le das clic. Se abrirá el administrador de archivos de tu hosting.

En la columna de la izquierda buscás y abrís la carpeta domains, abrís la carpeta con el nombre de tu dominio y cliqueas en public_html.

Ahora entrá a la carpeta wp_content > plugins. Ahí verás carpetas por cada plugin que tengas instalado, esté o no esté activado.

Paso 2. Creá un nuevo archivo .php

En el área de la derecha, donde se muestran carpetas y archivos, vas a la parte superior (donde dice name) y le das clic derecho. Se abrirá un menú secundario.

En ese menú seleccionás Create file. Se abrirá un popup donde deberás colocar el nombre de tu plugin (en este caso mi-plugin-maravilloso) seguido de la extensión .php.

Captura de pantalla del popup para crear archivo
Captura de pantalla del popup para crear archivo.

Como dato: si alguna vez necesitas crear otro tipo de archivo, sólamente debés definir la extensión al momento de crearlo. Puede ser .css, .js, .html, etc.

Una vez creado, le das clic derecho a tu nuevo archivo y seleccionás Edit in new tab. Se abrirá el editor de código:

Captura de pantalla del editor de codigo
Captura de pantalla del editor de codigo.

Una vez dentro, copiá el siguiente código:

    <?php
    /*
    Plugin Name: Mi plugin maravilloso
    Description: Este es mi primer plugin!
    Author: Aquiles Bailoyo
    */

No necesitás colocar la etiqueta de cierre ?> al final, esto lo explica el manual de PHP.

Guardá el archivo dándole clic a Save File, en la esquina superior derecha. No cerrés el editor, aún vamos a usarlo.

¿Frustrado por ir de una herramienta a otra para escribir tus publicaciones?

¡Basta de eso! Con watafak.io podés investigar palabras clave, organizarlas según el ciclo de vida de tu cliente, crear tu keyword clúster y escribir tus publicaciones ganadoras, todo en un sólo lugar.

Registrate en la lista de espera para conseguir tu acceso anticipado.

¡Quiero registrame ahora!

Paso 3. Verificá que el plugin se haya creado correctamente

Ahora, ve a tu panel de administración de Wordpres. En la barra lateral izquierda selecciona Plugins. Deberías ver tu primer plugin listo para ser activado:

Captura de pantalla del plugin correctamente instalado
Captura de pantalla del plugin correctamente instalado.

Si lo activas, no sucederá nada, ya que no le hemos colocado ningún código.

Solucionemos eso ahora.

Paso 4. Agregá código personalizado y activá el plugin

Volvamos al editor de código. Crearemos una pequeña función que agregará un mensaje al final del html de tu página, antes de la etiqueta de cierre </body>.

En el editor copiá el siguiente código debajo del código que ya habías copiado antes:

    /**
    * Función para agregar comentario personalizado al final de la etiqueta body
    * */
    function agregar_comentario_personalizado() {
        echo '<!-- Este comentario viene del plugin maravilloso -->';
    }
    add_action('wp_footer', 'agregar_comentario_personalizado', 9999);

Guardá los cambios y activá el plugin en tu panel de administración de WordPress.

Ahora, en otra pestaña ve a tu dominio, abrí el Inspector de Google Chrome, bajá hasta el fondo de tu código html y ahí estará tu comentario:

Captura de pantalla del comentario insertado por el plugin en el html
Captura de pantalla del comentario insertado por el plugin en el html.

Conclusiones

Aquí aprendiste a crear un plugin para tu código personalizado en 5 minutos o menos.

Recordá que, para casi cualquier código que querrás implementar, vas a necesitar activarlos con los ganchos o hooks de WordPress.

Artículo escrito por Juan Guillermo Castaño

Sobre mi: Soy perezoso, impaciente y arrogante. Por eso siempre busco la eficiencia, los resultados rápidos y los altos estándares. Mi frase favorita: 'si vis pacen, para bellum'. Me encantan los perros y los caballos.