Primeros pasos para crear un plugin en WordPress

Los plugins son una parte esencial para personalizar y ampliar la funcionalidad de tu sitio web en WordPress. Si bien podemos encontrar muchos plugins ya existentes, en ocasiones necesitamos uno a nuestra medida. En esta guía, te guiaremos a través de los pasos iniciales para crear un plugin básico de forma sencilla.

Paso 1: Preparar el Entorno de Desarrollo

Antes de empezar, asegúrate de tener instalado Composer, una herramienta de gestión de dependencias para PHP. Puedes descargarlo desde el sitio web oficial de Composer. Deberás ver en tun terminal un ouput como este en el momento de instalar composer:

Installer verified
All settings correct for using Composer
Downloading.
Composer (version 2.6.3) successfully installed to: /home/user/wp_tutorial/my_wp/plugins/test-plugin/composer.phar
Use it: php composer.phar

Paso 2: Crear una Carpeta para tu Plugin

Lo segundo que debes hacer es crear una carpeta para tu plugin. Es importante elegir un nombre único y descriptivo para tu carpeta, preferiblemente relacionado con la funcionalidad que planeas implementar. Esta carpeta debe ubicarse dentro de la carpeta de plugins de tu directorio de Wordpress.

Paso 3: Configurar el Archivo Principal y Usar Composer

Dentro de la carpeta que acabas de crear, crea un archivo principal para tu plugin. Este archivo contendrá información esencial sobre tu plugin y será la puerta de entrada para WordPress.

Crea un archivo llamado mi-primer-plugin.php y agrega el siguiente contenido inicial:

<?php
/**
 * Plugin Name: Mi Primer Plugin
 * Plugin URI: https://MiWeb.com
 * Description: Este es un plugin de ejemplo para WordPress.
 * Version: 1.0
 * Author: Tu Nombre
 * Author URI: https://MiWeb.com
 */

// Requerir las dependencias usando Composer
require_once plugin_dir_path(__FILE__) . 'vendor/autoload.php';

Paso 4: Inicializar Composer y Configurar Dependencias

Ahora, inicializa Composer en la raíz de tu plugin para gestionar las dependencias. Crea un archivo composer.json en la raíz de tu plugin con las siguientes configuraciones iniciales:

{
  "name": "tunombre/mi-primer-plugin",
  "description": "Plugin de ejemplo para WordPress",
  "authors": [
    {
      "name": "Tu Nombre",
      "email": "tu@email.com"
    }
  ],
  "require": {
		"php": ">=7.2" //Pon la versión que se requiera y añade más requerimientos de ser necesario
	}
}

Luego, ejecuta composer install en la raíz de tu plugin para instalar las dependencias y generar el directorio "vendor". Veras en tu terminal un output como este:

No composer.lock file present. Updating dependencies to latest instead of installing from lock file. See https://getcomposer.org/install for more information.
Loading composer repositories with package information
Updating dependencies
Nothing to modify in lock file
Writing lock file
Installing dependencies from lock file (including require-dev)
Nothing to install, update or remove
Generating autoload files

Paso 5: Incluir Funcionalidades con PHP

Ahora, es el momento de añadir funcionalidades a tu plugin utilizando PHP. Para este tutorial vamos a usar una simple función para imprimir un mensaje en el frontend de tu sitio.

Edita el archivo mi-primer-plugin.php y agrega el siguiente código para imprimir un mensaje en el pie de página:

<?php
//...
function mi_primer_plugin_funcion() {
    echo '¡Hola, este es mi primer plugin en WordPress!';
}

add_action('wp_footer', 'mi_primer_plugin_funcion');

Paso 6: ¡Activa tu Plugin!

Finalmente, es hora de activar tu plugin y verlo en acción en tu sitio web de WordPress. Ve al panel de administración de WordPress, haz clic en "Plugins" y encontrarás tu plugin listado. Activa tu plugin haciendo clic en "Activar".

¡Felicidades! Ahora has creado tu primer plugin en WordPress y estás listo para seguir ampliando sus funcionalidades.

Conclusión

Crear un plugin en WordPress puede parecer abrumador al principio, pero con estos pasos iniciales, estás en el camino correcto. Experimenta, aprende y personaliza tu plugin para adecuarse a tus necesidades y mejorar la experiencia de tu sitio web.

¡Esperamos que este tutorial te haya sido útil!