Guía de introducción al desarrollo de plugins de WordPress: crea tu primer plugin desde cero.

WordPress es el sistema de gestión de contenidos más popular a nivel mundial, y su gran capacidad de expansión se debe en gran medida a su arquitectura de plugins. Cuando descubres que las funciones existentes no satisfacen tus necesidades, desarrollar tus propios plugins se convierte en la mejor opción. No solo resuelve problemas específicos, sino que también es una excelente forma de comprender en profundidad el funcionamiento interno de WordPress. Esta guía te guiará a través de todo el proceso de desarrollo de tu primer plugin para WordPress, desde la configuración del entorno hasta la escritura del código y, finalmente, su publicación.

Preparación del entorno de desarrollo y las herramientas

Antes de comenzar a escribir código, necesitas un entorno de desarrollo adecuado. Esto asegurará que tu proceso de desarrollo sea eficiente y que cumpla con las mejores prácticas de WordPress.

Configuración del entorno de desarrollo local

La opción preferida es instalar un entorno de servidor local en tu propio ordenador. Puedes utilizar herramientas como XAMPP, MAMP (para Mac), WAMP (para Windows) o Docker, que integran el servidor Apache, la base de datos MySQL y PHP, simulando perfectamente las condiciones de funcionamiento de WordPress en línea. Una vez que hayas instalado el servidor local, descarga la versión más reciente de WordPress desde el sitio web oficial de WordPress.org y configúralo localmente siguiendo el proceso de instalación estándar de “5 minutos”.

Lecturas recomendadas Guía para principiantes en el desarrollo de plugins para WordPress: Crea tu primer plugin funcional desde cero。

Editores de código y herramientas esenciales

Un editor de código potente es esencial. Visual Studio Code, PhpStorm o Sublime Text son opciones excelentes, ya que ofrecen resaltado de sintaxis, sugerencias inteligentes de código y funciones de depuración. Además, necesitarás un sistema de control de versiones, como Git, para gestionar los cambios en tu código. Aunque el primer complemento (plugin) puede ser sencillo de utilizar, desarrollar el hábito de utilizar un sistema de control de versiones es de vital importancia para el desarrollo futuro.

Servidor de WordPress de UltaHost

Garantía de reembolso en 30 días, ancho de banda ilimitado y bases de datos, protección gratuita contra ataques DDoS; descuento del 50% al comprar por 3 años (versiones de 4 TB y 5 TB).

página de acceso

Crea tu primer archivo de plugin.

Cada plugin de WordPress comienza con un archivo principal que contiene las notas de cabecera (header comments) necesarias para que WordPress reconozca el plugin.

Estructura del archivo principal del plugin

En el directorio de instalación local de WordPress, acceda a…wp-content/pluginsCarpeta. Crea una nueva carpeta aquí y nómbrala…my-first-plugin(El nombre debe ser breve y describir la función del plugin.) Dentro de esta carpeta, cree un archivo PHP que, por lo general, tendrá el mismo nombre que la carpeta:my-first-plugin.phpEste archivo será el punto de entrada para el plugin.

Escribir la información de cabecera del plugin

Al principio de este archivo principal, debes agregar una sección de comentarios de cabecera para el plugin que cumpla con los estándares de WordPress. Estos comentarios proporcionan información básica sobre el plugin. Aquí tienes un ejemplo muy básico:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习的简单WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Este código es el “dNI” (Documento de Identidad) del plugin.Plugin NameEste campo es obligatorio, ya que determina el nombre que se mostrará para el plugin en la interfaz de administración de WordPress. También se recomienda completar la información adicional, como la descripción y el número de versión. Después de guardar el archivo, acceda a la página de “Plugins” en la administración de WordPress y deberías ver que “Mi primer plugin” aparece en la lista de plugins, y podrás activarlo. Actualmente, este plugin no cuenta con ninguna función.

Lecturas recomendadas Guía completa para el desarrollo de plugins para WordPress: Crea tu primer plugin funcional desde cero。

Agregar funcionalidades básicas al plugin

Después de activar el plugin, le agregaremos dos funciones básicas: la posibilidad de agregar texto personalizado al final del contenido del artículo y la creación de una página de administración sencilla.

Usar ganchos para modificar el contenido de un artículo.

El mecanismo central de WordPress son los “ganchos” (Hooks), que te permiten insertar tu propio código en momentos específicos. Los ganchos de acción (Action Hooks) se utilizan para ejecutar alguna acción, mientras que los ganchos de filtro (Filter Hooks) se usan para modificar datos. Queremos agregar una línea de texto al final del contenido de un artículo, y para ello necesitamos utilizar los ganchos de filtro.the_contentEste gancho de filtro.
Debajo de las notas al principio del archivo de tu plugin principal, agrega las siguientes funciones y ganchos:

// 在文章内容末尾添加自定义文本
function myfp_add_footer_text( $content ) {
    // 仅在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>¡Gracias por leer! Este artículo fue generado por “Mi primer plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'myfp_add_footer_text' );

Después de guardar el archivo, actualiza la página del artículo en la parte frontal del sitio web. Verás el texto añadido al final del contenido del artículo. En este código…myfp_add_footer_textLa función recibe el valor original.$contentDespués de verificar las condiciones de la página, se agregó un texto de párrafo HTML personalizado al final, y finalmente se devolvió el contenido modificado.add_filter()La función nos permite asociar nuestra función personalizada con los filtros principales de WordPress.

hosting.com Alojamiento compartido

Alto rendimiento con CPU AMD EPYC, almacenamiento SSD NVMe y LiteSpeed, asistencia interna de expertos 24 horas al día, 7 días a la semana, medidas de seguridad avanzadas como SSL, fuerza bruta, protección contra malware y DDoS, ahorro de hasta 73%.

página de acceso

Crear un menú de administración simple

A continuación, crearemos una página de configuración para el plugin en el backend de WordPress. Esto implica utilizar ganchos de acción (action hooks) para agregar un nuevo elemento al menú de administración. Agregue el siguiente código:

// 在后台管理菜单中添加一个新页面
function myfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'myfp_admin_page_html', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        100                   // 菜单位置
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

// 定义管理页面的HTML内容
function myfp_admin_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1>¿¿¿¿php echo esc_html( get_admin_page_title() ); ?&gt;</h1>
        <p>Bienvenido a la página de configuración de “Mi primer plugin”. ¡Esto es el comienzo!</p>
    </div>
    ¿php?  
}

Guarda y actualiza el backend de WordPress. Deberías ver un nuevo elemento de menú llamado “Mis plugins” cerca de la parte inferior de la barra de menú de la izquierda. Haz clic en él para acceder a una página de configuración sencilla. Aquí…add_menu_page()La función se encarga de registrar la página del menú principal.myfp_admin_page_html()La función es responsable de renderizar el contenido HTML de esa página.

Seguridad de los plugins y optimización del código

Al desarrollar plugins, la seguridad y la mantenibilidad deben ser considerados como aspectos clave desde el principio.

Lecturas recomendadas Comenzando desde cero: ¿por qué elegir el desarrollo de plugins para WordPress?。

Validación de datos y escape

Nunca confíes en los datos introducidos por los usuarios o en datos externos. Cualquier dato que se envíe al navegador o se guarde en una base de datos debe ser procesado antes de ello. WordPress ofrece una gran cantidad de funciones de ayuda para ello. Por ejemplo, cuando se necesite mostrar un valor en un atributo HTML, se puede utilizar una función específica proporcionada por WordPress para garantizar que el dato sea procesado de manera segura.esc_attr()Al generar el texto en HTML, se debe utilizar el siguiente formato:esc_html()Al enviar el contenido a una URL, se debe utilizar el siguiente formato:esc_url()En lo anterior…myfp_admin_page_html()En la función, hemos utilizado…esc_html()Para generar de manera segura el título de la página…

Usar clases para organizar el código

A medida que aumenta el número de funciones de los plugins, colocar todas ellas en un espacio de nombres global puede provocar conflictos y confusión. Es una buena práctica utilizar clases en PHP para encapsular las funcionalidades de los plugins. Esto mejora la organización, la legibilidad y la reutilizabilidad del código. A continuación, se muestra el esquema básico para reescribir nuestras funciones anteriores utilizando clases:

Alojamiento compartido InterServer

Alojamiento compartido $2.50 USD al mes , primer mes $0.1 USD código promocional tryinterserver, 461 scripts de aplicaciones en la nube, instalación en un clic.

página de acceso

class My_First_Plugin {
    // 构造方法，用于初始化钩子
    public function __construct() {
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

public function add_footer_text( $content ) {
        // ... 函数实现同上 ...
    }

public function add_admin_menu() {
        // ... 函数实现同上 ...
    }

public function admin_page_html() {
        // ... 函数实现同上 ...
    }
}
// 实例化插件类
new My_First_Plugin();

Este método une todos los métodos y atributos relacionados en un solo objeto, lo que hace que la estructura sea mucho más clara.

resúmenes

A través de esta guía, has completado los pasos fundamentales para crear un plugin para WordPress desde cero: configurar el entorno, crear el archivo del plugin con información de cabecera estándar, utilizar ganchos de acción y ganchos de filtro para agregar funcionalidades al contenido de los artículos, así como crear una interfaz de administración. También has comprendido, de manera preliminar, la importancia de la seguridad y la organización del código. Este es solo un comienzo; el mundo del desarrollo de plugins para WordPress es muy amplio y te permite explorar funciones más avanzadas como los códigos cortos (Shortcodes), los widgets, los tipos de artículos personalizados (Custom Post Types) y los puntos de terminación de API REST. Recuerda que leer el código fuente, consultar cómo están implementados los plugins de calidad y estudiar la documentación oficial de los desarrolladores son los mejores métodos para mejorar continuamente tus habilidades.

FAQ Preguntas más frecuentes

¿Qué tecnologías se deben dominar para desarrollar plugins?

Para desarrollar plugins para WordPress es necesario dominar los conocimientos básicos de PHP, HTML, CSS y JavaScript. PHP es el elemento central, ya que WordPress está escrito en este lenguaje, y será necesario utilizarlo para escribir la lógica de los plugins. HTML/CSS se utilizan para construir la interfaz frontal del sitio, mientras que JavaScript (especialmente jQuery y las versiones modernas de ES6+) puede ayudar a mejorar la interactividad y a realizar solicitudes AJAX. Tener un conocimiento básico de MySQL también es útil para el manejo de datos.

¿Por qué mi plugin no se muestra en el backend?

Por favor, revise primero los siguientes puntos: 1. ¿Se ha colocado el archivo principal del plugin en el lugar correcto?wp-content/pluginsDentro de una carpeta independiente en el directorio. 2. Los comentarios en la cabecera del plugin del archivo principal (especialmente los de ).Plugin Name:1. ¡Compruebe si el formato es correcto! 2. ¡Compruebe si la codificación del archivo es UTF-8 sin BOM! 3. ¡Compruebe si hay errores de sintaxis que impidan que PHP analice el archivo! Puede revisar el registro de depuración de WordPress (que se encuentra en <).wp-config.phpActivar en...WP_DEBUG）。

¿Cómo probar un plugin sin afectar al sitio web en línea?

Se recomienda encarecidamente desarrollar y probar plugins en un entorno de desarrollo local (como Local by Flywheel o XAMPP) o en un servidor de prueba independiente (Staging Site). Jamás pruebe plugins nuevos y no verificados directamente en un sitio web en producción que esté en funcionamiento y que contenga datos importantes. Utilice herramientas de control de versiones (como Git) para gestionar el código, lo que le permitirá revertir fácilmente cualquier cambio en caso de problemas.

¿Cómo se deben actualizar las versiones de los plugins?

Deberías actualizar la información en las notas al comienzo del archivo principal del plugin.Version:Para actualizaciones de mayor envergadura, se recomienda seguir el control de versiones semántico (SemVer): por ejemplo, añadir un número de revisión para corregir errores (1.0.1), un número de versión secundaria para nuevas funcionalidades compatibles con versiones anteriores (1.1.0), y un número de versión principal para actualizaciones incompatibles (2.0.0). También puedes implementar mecanismos de detección de actualizaciones (por ejemplo, almacenar la información de los plugins en tu propio servidor o en el directorio de plugins de WordPress) para que los usuarios reciban notificaciones de las mismas en la parte administrativa del sitio.

¿Qué requisitos se necesitan para publicar un complemento en el directorio oficial?

Si deseas enviar un plugin al directorio oficial de plugins de WordPress.org, debes cumplir con los siguientes requisitos principales: el código del plugin debe ser compatible con la licencia GPLv2 o una versión posterior; la calidad del código debe ser satisfactoria y cumplir con los «Estándares de Codificación de WordPress»; las funciones del plugin deben ser universales y prácticas, es decir, no deben estar diseñadas exclusivamente para un sitio web específico; además, no debe contener código malicioso ni enlaces no deseados. Antes de enviar el plugin, asegúrate de leer atentamente las guías y requisitos detallados en el «Centro para Desarrolladores» del directorio oficial.