---
title: "Plugin para código personalizado en WordPress"
description: "Añadir fragmentos de código a un proyecto de WordPress es bastante común cuando se desean ajustes específicos. A menudo se eligen métodos como incluirlos en el archivo functions.php de un tema..."
url: https://sebasweb.net/plugin-para-codigo-personalizado-en-wordpress/
date: 2025-01-20
modified: 2025-01-21
author: "Sebasweb"
image: https://sebasweb.net/wp-content/uploads/2025/01/Plugin-para-codigo-personalizado-en-WordPress.jpg
categories: ["Wordpress"]
type: post
lang: es
---

# Plugin para código personalizado en WordPress

Añadir fragmentos de código a un proyecto de WordPress es bastante común cuando se desean ajustes específicos. A menudo se eligen métodos como incluirlos en el archivo functions.php de un tema hijo (child theme) o usar un plugin dedicado a fragmentos (por ejemplo, Code Snippets). Sin embargo, existe una alternativa potente y versátil: **crear un plugin para código personalizado en WordPress.**

A continuación voy a hacer un recorrido por los beneficios de este enfoque y un repaso general sobre cómo hacerlo. La intención es que puedas aprovechar la flexibilidad de WordPress sin depender de tu tema actual ni arriesgar la compatibilidad de tu sitio en futuras actualizaciones.

https://youtu.be/x1PlHwlFNTE

Pero primero, veamos un par de conceptos indispensables sobre los plugins en WordPress.

## Qué es un plugin en WordPress

- Un plugin en WordPress no es más que un archivo o conjunto de archivos PHP que añaden funcionalidades específicas a un sitio sin necesidad de modificar el núcleo de WordPress o el tema activo.

- Básicamente, un plugin actúa como un pequeño programa que se conecta a WordPress mediante funciones y hooks (ganchos), permitiendo extender o modificar su comportamiento estándar.

## ¿Qué hace que un plugin funcione en WordPress?

- Un plugin funciona porque WordPress está diseñado para ser extendido. WordPress carga todos los plugins activos desde la carpeta wp-content/plugins/.

- Cuando WordPress se ejecuta, busca los archivos PHP de los plugins activos y los incluye. Esos archivos pueden contener funciones, clases o código que se ‘engancha’ al sistema principal de WordPress en puntos específicos llamados ‘hooks’.

- Estos hooks (filtros y acciones) son como señales: cuando WordPress llega a cierto punto del flujo de ejecución, llama a las funciones que le hemos dicho que respondan en esos momentos.

> En su forma más simple, un plugin puede ser un único archivo PHP.

## ¿Por qué un plugin para código personalizado en WordPress?

Muchas veces, ajustar funciones pequeñas requiere abrir el archivo functions.php en un theme o un child theme. Ese método funciona, pero puede volverse incómodo cuando se cambia a otro tema. Además, si el tema se actualiza y se olvida mover el código al tema hijo, se corre el riesgo de perder esas modificaciones.

La posibilidad de independizar todos los pequeños cambios en un **plugin para código personalizado** ofrece múltiples ventajas:

- **Independencia total del tema:** No es obligatorio usar el mismo archivo del tema.

- **Organización:** Se concentra el código en un lugar separado para mantener el proyecto más ordenado.

- **Facilidad de mantenimiento:** Un plugin propio puede activarse o desactivarse según convenga, sin preocuparse de afectar la plantilla principal.

- **Portabilidad:** No habrá que copiar y pegar fragmentos de una instalación a otra. Basta con mover o instalar el plugin y listo.

Las funciones que suelen ir en functions.php pueden colocarse allí sin complicar la vida a la hora de cambiar de tema o actualizarlo.

## Ventajas de usar un plugin para código personalizado en WordPress

- **Estandarización:** WordPress reconoce de manera nativa los plugins a través de una cabecera en el archivo principal. Al disponer de un plugin con nombre, descripción y versión, todo el código se alinea con la metodología estándar de WordPress. Eso facilita el control y la documentación de los cambios.

- **Comodidad al desactivar funciones:** Si algo deja de ser útil, simplemente se desactiva el plugin en el panel de administración. Con un child theme, a veces se borra el código o se deja comentado, lo que puede generar confusión con el tiempo.

- **Reutilización en otros proyectos:** Imagina que las mismas funciones personalizadas podrían servir para otro sitio. Un plugin que contenga ese código permite llevarlo de un proyecto a otro de manera casi inmediata, sin necesidad de refactorizar o reescribir.

- **Mayor claridad en el repositorio:** Al clonar un proyecto de WordPress, el plugin aparece en la carpeta plugins, separado del tema. Eso invita a distinguir con facilidad qué parte del código corresponde a funcionalidades propiamente dichas y qué parte pertenece a la plantilla.

- **Seguridad básica:** Al crear el plugin se incluyen buenas prácticas, como verificar if ( ! defined( 'ABSPATH' ) ) { exit; }. Esa condición detiene la ejecución del archivo si se intenta acceder a él directamente sin pasar por WordPress. Además, en caso de necesitar formularios de administración, el uso de nonces y validaciones de capacidades resulta más natural dentro de un plugin.

## Cómo crear tu propio plugin para código personalizado en WordPress

Crear un plugin sencillo sólo requiere un archivo .php con una cabecera reconocible por WordPress. En otras palabras, se necesita lo siguiente:

**1. Crear una carpeta y un archivo**: Dentro de wp-content/plugins/, conviene generar una carpeta con un nombre identificable, por ejemplo funciones-sebasweb. En su interior, crea un archivo funciones-sebasweb.php.

**2. Agregar la cabecera del plugin**: En el archivo PHP, se añade algo parecido a:

```