Crear un plugin en lugar de usar functions.php en WordPress

El archivo functions.php en WordPress es un componente vital para añadir características específicas a tu proyecto. Sin embargo, este archivo puede crecer indefinidamente, y es posible que contenga funciones que desees mantener al cambiar de tema o exportar a otros proyectos. Aunque los comentarios puedan aclarar cada función, el archivo puede volverse difícil de leer y complejo para habilitar o deshabilitar funciones específicas.

En tales circunstancias, lo ideal es crear un plugin con un propósito único o uno que combine varios propósitos, similar al functions.php.

Cómo crear un plugin de forma sencilla

Para trabajar cómodamente, elige un editor de texto como VSCode. Luego, dentro de la carpeta del proyecto, crea un archivo con la extensión .php y un nombre descriptivo, por ejemplo: "mi-plugin.php".

Para que el plugin funcione correctamente, debe contener los siguientes comentarios en PHP:

<?php
/*
Plugin Name: {Nombre que quieras}
Description: {Descripción del plugin}
Author: {Nombre del autor}
Version: {número de versión}
*/

Y se vería así:

Una vez que hayas creado tu plugin, puedes subirlo a través de SSH, FTP o comprimir la carpeta en un archivo .zip y cargarlo desde el panel de administración de WordPress en la sección de Plugins.

El código que coloques después de los comentarios del plugin funcionará de manera similar al código en el functions.php, pero con la ventaja de poder desactivarlo fácilmente si es necesario.

Hacer el plugin más eficiente

Hasta aquí lo único que habríamos hecho sería cambiar el código del functions.php de sitio. Para que realmente sea más útil, lo que podemos hacer es valernos del código “include” dentro de php.

Lo que hace el código include es incluir todo el código que esté en otro archivo. De esta forma podemos tener archivos para funciones muy específicas de nuestra web por separado, y tenerlo todo aislado en distintos módulos, para detectar los problemas de una forma más sencilla.

Por ejemplo, podríamos tener un archivo para la generación de shortcodes, otro para hooks, otros para hacer cambios en gutenberg o tinymc, otro para cambiar el heartbeat… y bueno ya se entiende, para añadir cualquier funcionalidad oculta de WordPress.

Para esto, lo que podemos hacer es que dentro de la carpeta del plugin, podemos crear otra carpeta, que se llame por ejemplo includes (para simplificar). Y entonces vamos creando nombres de archivos.php intuitivos para gestionar fácilmente nuestro proyecto.

Una vez hemos creado el archivo.php dentro de la carpeta includes, este no funcionará por arte de magia.

Entonces tendríamos que poner el código include de esta forma:

// Recomiendo siempre poner un comentario arriba aclarando que hace dicho archivo
include 'includes/nombre-ejemplo.php';

Entonces el plugin se vería así:

Este enfoque te permitirá mantener un proyecto bien coordinado con configuraciones similares al functions.php, al tiempo que hará que tu código sea más legible y fácil de extender, mejorar y modificar en el futuro.