Guía completa para el desarrollo de plugins para WordPress: Cómo crear tu propio plugin desde cero

Preparativos previos al desarrollo

Antes de comenzar a codificar, una preparación adecuada es una piedra angular esencial para el éxito del proyecto. Es necesario establecer un entorno de desarrollo eficiente y seguro.

Crear un entorno de desarrollo y prueba local

Se recomienda encarecidamente no desarrollar plugins en servidores de producción. Utilizar un entorno de desarrollo local te permite probar nuevas funcionalidades sin temor a que el sitio web se colapse. Puedes emplear herramientas como XAMPP, MAMP, Local by Flywheel o Docker para configurar rápidamente un entorno de ejecución de WordPress en tu ordenador, que incluya servidores Apache/Nginx, una base de datos MySQL y el lenguaje de programación PHP. De esta manera, las modificaciones y el depurado del código serán mucho más ágiles.

Comprender la estructura básica de los plugins de WordPress

El plugin más simple para WordPress puede contener solo un archivo principal. Este archivo debe incluir una anotación de cabecera específica que proporcione a WordPress la información básica sobre el plugin. Por ejemplo, un plugin llamado…my-first-plugin.phpEl contenido del archivo puede ser el siguiente:

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

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

Coloca este archivo en…/wp-content/plugins/En el directorio correspondiente, podrá verlo y activarlo en la página de “Plugins” del panel de administración de WordPress. Esta es la forma más básica en que se presenta un plugin; aunque, de momento, no cuenta con ninguna función.

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

Construye tu primer plugin funcional.

Comencemos con un ejemplo práctico para crear un plugin que añada automáticamente los derechos de autor al final de los artículos. Este ejemplo ilustrará varios conceptos clave del plugin.

Definir la función principal del plugin

Necesitamos crear una función para generar y mostrar información sobre los derechos de autor. La llamaremos…myplugin_add_copyright_textDentro de esta función, se obtienen los datos del artículo actual y se combinan para formar un texto de declaración de derechos de autor.

function myplugin_add_copyright_text( $content ) {
    if ( is_single() ) {
        $current_year = date( 'Y' );
        $copyright_text = '<p class="myplugin-copyright">© '$_año_actual'. Todos los derechos reservados. Este artículo fue publicado por primera vez en mi sitio web.</p>';
        $content .= $copyright_text;
    }
    return $content;
}

Utilizar ganchos (hooks) para integrar funciones en WordPress

Las funciones individuales no se ejecutan automáticamente. Necesitamos utilizar los “ganchos de filtro” (Filter Hooks) de WordPress para “incrustar” nuestra función antes de que el contenido del artículo sea mostrado. Aquí utilizaremos…the_contentEste filtro.

add_filter( 'the_content', 'myplugin_add_copyright_text' );

Combina el encabezado del archivo y estos dos segmentos de código en el mismo lugar.phpEn el archivo, se encuentra un plugin que cumple con funciones básicas. Este plugin añade una sección de información de derechos de autor que incluye el año actual justo después del texto principal de cada artículo.

Lecturas recomendadas De cero a uno: Guía de iniciación y mejores prácticas para el desarrollo de plugins para WordPress。

为输出内容添加基本样式

Para que la información de derechos de autor se vea más atractiva, podemos agregarle algunos estilos CSS sencillos. La mejor práctica es hacerlo de manera que sea consistente y que se ajuste a los estándares de diseño web.wp_enqueue_styleSe necesita una función para cargar las hojas de estilo de manera ordenada, asegurando que solo se carguen cuando sea necesario. Debemos crear un archivo de estilo.style.cssY regístrelo en el archivo principal del plugin.
Añada lo siguiente al archivo principal del plugin:

function myplugin_enqueue_styles() {
    wp_enqueue_style( 'myplugin-style', plugins_url( 'css/style.css', __FILE__ ) );
}
add_action( 'wp_enqueue_scripts', 'myplugin_enqueue_styles' );

Luego, cree un archivo en el directorio de plugins.css/style.cssArchivo, y añade estilo:

.myplugin-copyright {
    font-size: 0.9em;
    color: #666;
    border-top: 1px solid #eee;
    padding-top: 10px;
    margin-top: 20px;
}

Implementar opciones de configuración para el plugin

Un complemento (plugin) maduro generalmente permite que los usuarios realicen algunos ajustes personalizados. Vamos a agregar una página de configuración en el backend para el complemento de derechos de autor, para que los usuarios puedan modificar el texto relacionado con los derechos de autor.

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 la página del menú de configuración del backend

Primero, necesitamos agregar un elemento de menú secundario en el menú “Ajustes” del panel de administración de WordPress. Para ello, debemos utilizar…add_options_pageFunción.

function myplugin_add_settings_page() {
    add_options_page(
        '版权插件设置', // 页面标题
        '版权设置',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单slug
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}
add_action( 'admin_menu', 'myplugin_add_settings_page' );

Configuraciones de registro, bloques y campos

WordPress proporciona la API Settings para gestionar las opciones de configuración de manera segura y conveniente. Necesitamos registrar un grupo de configuraciones, una opción de configuración concreta (que se almacene en la base de datos) y un campo (un cuadro de entrada en el formulario).

function myplugin_register_settings() {
    register_setting( 'myplugin_settings_group', 'myplugin_copyright_text' );
    add_settings_section( 'myplugin_main_section', '主要设置', null, 'myplugin-settings' );
    add_settings_field( 'myplugin_text_field', '版权文本', 'myplugin_render_text_field', 'myplugin-settings', 'myplugin_main_section' );
}
add_action( 'admin_init', 'myplugin_register_settings' );

// 渲染文本字段的函数
function myplugin_render_text_field() {
    $option_value = get_option( 'myplugin_copyright_text', '© [year] 版权所有。本文首发于我的网站。' );
    echo '<input type="text" name="myplugin_copyright_text" value="' . esc_attr( $option_value ) . '" class="regular-text" />';
    echo '<p class="description">Puede utilizar los placeholders. <code data-no-auto-translation="">[year]</code> Se utiliza para representar el año actual.</p>';
}

Entre ellos,myplugin_render_settings_pageLa función es responsable de generar la estructura del formulario HTML de toda la página de configuración.

Lecturas recomendadas Guía completa para el desarrollo de complementos de WordPress: desde cero hasta la creación de funciones personalizadas.。

Modifique la función principal para que soporte texto dinámico.

Ahora, necesitamos modificar la función principal original.myplugin_add_copyright_textDeje que lea el texto configurado por el usuario desde la base de datos y reemplaze los placeholders.

function myplugin_add_copyright_text( $content ) {
    if ( is_single() ) {
        $text = get_option( 'myplugin_copyright_text', '© [year] 版权所有。本文首发于我的网站。' );
        $text = str_replace( '[year]', date( 'Y' ), $text );
        $copyright_text = '<p class="myplugin-copyright">'. $text . '</p>';
        $content .= $copyright_text;
    }
    return $content;
}

Publicación y mantenimiento de plugins

Una vez que el desarrollo esté completo y haya sido probado, es probable que desees compartir tu trabajo con más personas. Esto implica empaquetar el software, publicarlo y realizar actualizaciones posteriores.

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

Seguir los estándares para empaquetar y publicar el contenido.

Enwp-content/plugins/Dentro del directorio, tu plugin debe encontrarse en una carpeta independiente, por ejemplo…my-first-plugin/Este folder generalmente contiene, al menos, el archivo del plugin principal.my-first-plugin.phpUnoREADME.txt(Descripción del plugin y método de instalación), así como las posibles problemas o inconvenientes que puedan surgir.assets(Imagen)includes(Archivo PHP adicional)js、cssCree subdirectorios según sea necesario. Asegúrese de que la estructura de los archivos sea clara y organizada.

Si planeas enviar el plugin al directorio oficial de plugins de WordPress, debes seguir estrictamente sus requisitos y procedimientos.Guía para desarrolladoresIncluye estándares de código, seguridad, compatibilidad, así como el uso de Subversion (SVN) para el control de versiones.

Garantizar la seguridad de los plugins.

La seguridad es de vital importancia. Siempre verifique, limpie y escape los datos introducidos por los usuarios, así como los datos dinámicos.
1. 验证（Validation）：检查数据是否符合预期的格式（如是否为邮箱、数字）。
2. 清理（Sanitization）：在将数据存入数据库或用于其他操作前，移除其中的不安全字符。对于表单输入，使用sanitize_text_fieldosanitize_textarea_field。
3. 转义（Escaping）：在将数据从数据库输出到HTML页面时，确保其中的特殊字符被正确转换，防止XSS攻击。使用esc_html、esc_attrowp_kses_post。
Por ejemplo, al enviar los elementos de configuración a un formulario, utilizamos…esc_attr：

echo '<input ... value="' . esc_attr( $option_value ) . '" ... />';

Planificar el camino de actualizaciones para el futuro

Establece un número de versión claro para tu plugin (por ejemplo, 1.0.0), siguiendo los principios de control de versiones semántico. Además, cada vez que realices una actualización, actualiza la anotación en la parte superior del archivo principal del plugin.VersionInformación.
Si la actualización de un plugin requiere modificar la estructura de la base de datos o migrar datos, se puede utilizar el mecanismo de actualización de WordPress. Puedes comparar…get_option( ‘myplugin_version’ )Se compara el número de versión antiguo almacenado con el número de versión actual; cuando se detecta un cambio en la versión, se ejecuta la tarea de actualización.
Mantener la compatibilidad de los plugins con las últimas versiones de WordPress y PHP, realizar pruebas periódicas y seguir mejorándolos según los comentarios de los usuarios.

resúmenes

El desarrollo de plugins para WordPress es un proceso que convierte las ideas en funciones concretas, lo que a su vez mejora las capacidades de un sitio web. Comenzando por crear un plugin sencillo…phpEl archivo comienza con la integración de funciones mediante el uso de ganchos de acción (action hooks) y ganchos de filtro (filter hooks), seguido por la creación de una interfaz de configuración amigable para el usuario utilizando la API de Settings. Finalmente, el proceso se completa siguiendo normas de seguridad y prácticas de gestión de versiones para el lanzamiento y mantenimiento del producto. Cada paso refleja un enfoque de desarrollo modular y estandarizado. La clave radica en comprender en profundidad el sistema de ganchos y la API de WordPress, siempre dando prioridad a la seguridad y a la experiencia del usuario. Al dominar estos conceptos básicos, estarás en condiciones de desarrollar herramientas poderosas que satisfagan necesidades específicas, logrando así la creación de soluciones desde cero.

FAQ Preguntas más frecuentes

¿Qué conocimientos básicos se necesitan para desarrollar un complemento de WordPress?

Es necesario que cuentes con conocimientos básicos del lenguaje de programación PHP, ya que este es el idioma central para el desarrollo de WordPress. Además, es esencial tener un entendimiento básico de HTML, CSS y JavaScript para manejar la presentación y la interacción del lado del usuario. Es crucial comprender los conceptos fundamentales de las bases de datos MySQL (como las consultas), así como las funciones centrales de WordPress, los ganchos (Actions y Filters) y las API comunes (como la API Options).

¿Cómo depuro el plugin que he desarrollado?

Existen varios métodos efectivos para depurar el desarrollo de plugins para WordPress. En primer lugar, asegúrese de que…wp-config.phpEl archivo se abrió en el programa.WP_DEBUGYWP_DEBUG_LOGDe esta manera, los errores y las informaciones se registrarán./wp-content/debug.logEn los archivos, se debe evitar mostrar el contenido directamente al usuario. En segundo lugar, es posible utilizar estos archivos de manera amplia y generalizada.error_log()La función imprime la información de las variables en el registro de actividad (log). Además, utilizar las herramientas de desarrollo del navegador (la consola y la etiqueta de red, Console and Network) para verificar errores de JavaScript en el lado del cliente y solicitudes de API, así como emplear entornos de desarrollo integrado (IDE) profesionales como PHPStorm o VS Code para realizar depuración con puntos de interrupción, son métodos muy eficaces.

¿Los plugins pueden llamar a API de terceros?

Por supuesto que sí. Los plugins de WordPress pueden acceder a API de terceros (como servicios de pronóstico del tiempo, redes sociales, pasarelas de pago, etc.). Al hacerlo, se deben utilizar las funciones de API HTTP proporcionadas por WordPress.wp_remote_get()、wp_remote_post()Son más eficientes que los métodos nativos de PHP para trabajar con cURL.file_get_contentsEs más seguro y cuenta con mecanismos integrados como tiempos de espera y reintentos. Es esencial manejar las posibles fallas en las llamadas a la API (como tiempos de espera de red o códigos de error devueltos), así como realizar una verificación y limpieza rigurosas de los datos recibidos para garantizar su seguridad.

¿Cómo puedo hacer que mi plugin sea internacionalizable y soporte múltiples idiomas?

WordPress utiliza el stack tecnológico GNU gettext para implementar la internacionalización (i18n) y la localización. En tus plugins, todo el texto que necesite ser traducido debe ser encapsulado utilizando funciones específicas.__('文本', 'my-plugin-textdomain')Se utiliza para devolver la cadena de texto traducida._e('文本', 'my-plugin-textdomain')Se utiliza para la salida directa. Es necesario definirlo en el encabezado del archivo del plugin.Text DomainY utilizarload_plugin_textdomain()La función se ejecuta en el momento adecuado (por ejemplo, cuando...).init(La acción consiste en cargar el archivo de traducción. Luego, se utiliza una herramienta como Poedit para crear el contenido traducido.).potArchivo de plantilla, utilizado por los traductores para generar versiones del texto en diferentes idiomas..poY.moDocumentos.

¿Qué se debe tener en cuenta al desarrollar plugins comerciales?

El desarrollo de plugins comerciales requiere un mayor nivel de profesionalismo. La calidad del código, el diseño de la arquitectura, la seguridad y el rendimiento deben cumplir con estándares más elevados. Es necesario diseñar un sistema de verificación de licencias claro y sin conflictos (generalmente implementado a través de un propio servidor o servicios de terceros). Es de vital importancia proporcionar documentación técnica profesional, manuales de usuario y canales de soporte técnico oportunos. Incorporar mecanismos de actualización automática en el plugin (utilizando un propio servidor en lugar de WordPress.org) facilita que los usuarios obtengan nuevas versiones y parches de manera más conveniente. Además, es crucial establecer claramente los términos de uso y la política de privacidad, y asegurarse de que el plugin cumpla con regulaciones de protección de datos como el GDPR.