Aprenda a desarrollar complementos de WordPress: construya su primera extensión de funcionalidad desde cero.

¿Por qué elegir el desarrollo de plugins para WordPress?

El motivo por el cual WordPress se ha convertido en el sistema de gestión de contenidos más popular a nivel mundial se debe en gran medida a su potente arquitectura de plugins. Estos permiten a los desarrolladores agregar casi cualquier funcionalidad a un sitio web sin necesidad de modificar el código central, desde sencillos formularios de contacto hasta complejos sistemas de comercio electrónico. Aprender a desarrollar plugins significa que podrás personalizar WordPress a fondo para satisfacer necesidades comerciales específicas o transformar tus propias ideas en productos reutilizables.

Desarrollar uno propio plugin, en comparación con modificar directamente el tema, ofrece varias ventajas: functions.php Los archivos poseen ventajas significativas. Los plugins son módulos funcionales independientes del tema utilizado; por lo tanto, cuando cambias de tema, sus funciones no se pierden. Esto hace que el código sea más fácil de mantener, actualizar y compartir entre diferentes proyectos. Comprender los mecanismos fundamentales del desarrollo de plugins es un paso esencial para convertirse en un desarrollador avanzado de WordPress.

Configurar tu entorno de desarrollo

Antes de escribir la primera línea de código, es esencial disponer de un entorno de desarrollo local estable y eficiente. Esto te permitirá realizar pruebas y depuraciones sin afectar al sitio web en línea.

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

Configuración del entorno del servidor local

Se recomienda utilizar soluciones de servidores locales integradas, como Local by Flywheel, XAMPP o MAMP. Estas permiten instalar Apache/Nginx, PHP y MySQL con un solo clic. Asegúrese de que la versión de PHP sea compatible con la versión de WordPress que tenga intenciones de utilizar; generalmente se recomienda PHP 7.4 o una versión más reciente. Además, es necesario instalar una nueva versión de WordPress en el servidor local para utilizarla como un entorno de prueba (un “sandbox”) a fin de probar los plugins.

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

Editor de código y herramientas de depuración

Elija un editor de código potente, como Visual Studio Code o PHPStorm. Estos editores ofrecen resaltado de sintaxis, sugerencias de código e integración con sistemas de control de versiones. Para el depurado, es necesario activar el modo de depurado de WordPress. Esto se debe hacer editando el directorio raíz de WordPress. wp-config.php Archivo, se va a… WP_DEBUG Los constantes se establecen en true。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误日志保存到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

Al activar el modo de depuración, todos los errores, advertencias y notificaciones de PHP se registrarán, lo que te ayudará a localizar los problemas rápidamente.

Crea tu primer archivo de plugin.

Un plugin para WordPress puede ser tan simple que conste de un solo archivo, pero es de vital importancia seguir una buena estructura. Comenzaremos con el plugin más básico posible: el que muestra el mensaje “Hello World”.

Estructura del archivo principal del plugin

Primero, en WordPress… /wp-content/plugins/ En el directorio, cree una nueva carpeta, por ejemplo… my-first-pluginEn esta carpeta, cree un archivo PHP principal; el nombre del archivo suele ser el mismo que el nombre de la carpeta.my-first-plugin.php。

Lecturas recomendadas Guía de desarrollo personalizado de plugins para WooCommerce: Crea tu tienda en línea exclusiva。

Cada plugin debe contener un bloque de comentarios con información estándar sobre el mismo en la parte superior del archivo. WordPress utiliza este bloque para identificar el plugin y mostrarlo en la interfaz de administración en segundo plano.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://www.yourwebsite.com/my-first-plugin/
 * Description:       这是一个学习 WordPress 插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://www.yourwebsite.com/
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Después de guardar el archivo, inicie sesión en la página de administración de su WordPress y vaya a la sección de “Plugins”. Debería ver que el nuevo plugin aparece en la lista de plugins. Ahora puede activarlo, aunque todavía no cuenta con ninguna función.

Añadir la primera función: gestión del menú

A continuación, añadamos una función sencilla al plugin: crearemos un nuevo elemento de menú en la barra lateral del panel de administración 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

Vamos a utilizar… add_action() Función para montar una función de callback (de respuesta) admin_menu Este Action está “atado” a ese gancho.

// 在插件主文件中，插件头部注释块之后，添加以下代码

if ( ! defined( 'ABSPATH' ) ) {
    exit; // 禁止直接访问
}

// 钩子到 admin_menu 动作
add_action( 'admin_menu', 'mfp_add_admin_menu' );

/**
 * 注册一个自定义管理菜单
 */
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',          // 菜单标题
        'manage_options',    // 所需权限
        'my-first-plugin',   // 菜单别名 (slug)
        'mfp_display_admin_page', // 显示页面内容的回调函数
        'dashicons-smiley', // 菜单图标 (使用 Dashicon)
        6                    // 菜单位置
    );
}

/**
 * 管理页面的显示内容
 */
function mfp_display_admin_page() {
    ?>
    <div class="wrap">
        <h1>¿¿¿¿php echo esc_html( get_admin_page_title() ); ?&gt;</h1>
        <p>¡Hola, mundo! Esta es mi primera página de administración de plugins para WordPress.</p>
    </div>
    ¿php?  
}

Al guardar el archivo y actualizar el backend de WordPress, verá un nuevo elemento de menú llamado “Mis plugins” en la barra de menú de la izquierda. Al hacer clic en él, accederá a una página sencilla que mostrará un mensaje de bienvenida.

En profundidad: Ganchos y filtros

La filosofía central del desarrollo de plugins para WordPress es el concepto de “ganchos” (Hooks). Los ganchos permiten que tu código se integre en los procesos centrales de WordPress en momentos específicos, con el fin de modificar o agregar nuevas funcionalidades. Existen principalmente dos tipos de ganchos: las Acciones (Actions) y los Filtros (Filters).

Lecturas recomendadas Guía para el desarrollo y personalización de temas para WordPress: Desde los principios hasta la maestría para crear su sitio web exclusivo。

Comprender los ganchos de acción (action hooks)

Los ganchos de acción (action hooks) en WordPress se activan en momentos específicos durante su ejecución, como al guardar un artículo, al cargar la cabecera de la página o al generar el pie de página. Tu plugin puede “escuchar” estos eventos y ejecutar sus propias funciones. Es lo que utilizamos anteriormente. admin_menu Es simplemente un gancho de acción (action hook).

Otro ejemplo común es la adición automática de un párrafo de texto al final del contenido de un artículo.

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

add_action( 'the_content', 'mfp_append_text_to_content' );

function mfp_append_text_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $append_text = '<p><em>Este artículo fue generado por mi primer plugin.</em></p>';
        $content .= $append_text;
    }
    return $content;
}

Modificar datos utilizando filtros

Los ganchos de filtro (filter hooks) se utilizan para modificar los datos antes de que sean almacenados en la base de datos o enviados al navegador. Reciben los datos, los modifican y, a continuación, deben devolver los datos modificados. Un ejemplo típico es la modificación del título de un artículo.

add_filter( 'the_title', 'mfp_modify_post_title' );

function mfp_modify_post_title( $title ) {
    // 只在非后台的主查询中修改
    if ( ! is_admin() && in_the_loop() ) {
        $title = '[重要] ' . $title;
    }
    return $title;
}

Comprender y utilizar hábilmente los “ganchos” (hooks) es clave para crear plugins flexibles y potentes. El núcleo de WordPress ofrece miles de estos ganchos, que están distribuidos a lo largo de todo el ciclo de vida del sistema.

Seguridad de los plugins y prácticas recomendadas

Escribir código seguro y seguir las mejores prácticas te asegurará que tu plugin sea estable, eficiente y fácil de ser aceptado por otros desarrolladores.

Validación de datos y escape

Nunca confíes en los datos introducidos por los usuarios o en los datos provenientes de la base de datos. Cada vez que se envíen datos al navegador (en formato HTML, JavaScript o como atributos), es necesario realizar su escape (es decir, modificarlos para evitar que se interpreten de manera inesperada). WordPress ofrece una serie de funciones de ayuda para ello.

// 输出到 HTML 内容中
echo esc_html( $untrusted_data );
// 输出到 HTML 属性中
echo esc_attr( $untrusted_data );
// 输出到 URL 中
echo esc_url( $untrusted_data );
// 在 JavaScript 变量中输出
$js_data = wp_json_encode( $untrusted_data );

Antes de guardar los datos en la base de datos o de realizar juicios lógicos, es necesario realizar una validación para asegurarse de que los datos cumplen con el formato esperado (por ejemplo, si se trata de una dirección de correo electrónico, un número, etc.).

Usar espacios de nombres y clases

Para plugins complejos, se recomienda utilizar espacios de nombres en PHP y programación orientada a objetos (POO) para organizar el código. Esto ayuda a evitar conflictos de nombres de funciones y mejora la modularidad y legibilidad del código.

<?php
namespace MyFirstPluginAdmin;

class Admin_Menu {
    public function __construct() {
        add_action( 'admin_menu', [ $this, 'add_menu_page' ] );
    }

public function add_menu_page() {
        add_menu_page( ... );
    }
}

// 初始化
new Admin_Menu();

Además, se debe agregar soporte a la internacionalización al plugin (utilizando…). __() Y _e() Que una función sea eficiente, que se ofrezcan opciones razonables para la desinstalación y la limpieza del plugin, y que se respeten los estándares de codificación de WordPress, son elementos esenciales para que un plugin sea de calidad.

resúmenes

El desarrollo de plugins para WordPress es un proceso que se desarrolla paso a paso, desde crear un archivo básico que pueda ser reconocido por WordPress hasta utilizar un sistema poderoso como los ganchos de acciones y filtros para expandir las funcionalidades del sistema. Cada paso se basa en una comprensión clara de la arquitectura de WordPress. El entorno de desarrollo local es tu “laboratorio”, las herramientas de depuración son tus “microscopios”, y la seguridad así como las buenas prácticas son las piedras angulares para garantizar que tu trabajo sea estable y fiable.

Al crear un sencillo plugin de menú de administración, ya has puesto en práctica los procesos fundamentales del desarrollo de plugins. A continuación, puedes intentar integrar opciones de configuración, crear tablas de bases de datos personalizadas, agregar funcionalidades de códigos cortos, o desarrollar una pequeña herramienta adicional. Con la práctica constante y tomando como referencia el código fuente de otros plugins de calidad, serás capaz de manejar requisitos cada vez más complejos y, finalmente, crear plugins de nivel profesional para WordPress.

FAQ Preguntas más frecuentes

¿Cuántos archivos necesita tener como mínimo un plugin para WordPress?

Un plugin para WordPress necesita, como mínimo, un archivo PHP. Siempre y cuando este archivo contenga las anotaciones de cabecera adecuadas, WordPress podrá reconocerlo y activarlo en la lista de plugins del backend. Por supuesto, para los plugins con funciones más avanzadas, el código suele organizarse en varios archivos y carpetas a fin de mejorar su mantenibilidad.

¿Cómo evitar los conflictos de nombres de funciones en el desarrollo de plugins?

Existen dos métodos principales para evitar conflictos de nombres de funciones. El primero es agregar un prefijo único a todas tus funciones, por ejemplo, utilizando abreviaturas o siglas de plugins. mfp_ o myplugin_En segundo lugar, se puede utilizar las clases y los espacios de nombres de PHP para encapsular tus funciones dentro de métodos de clase. Esta es una práctica más moderna y recomendada, ya que permite resolver de manera fundamental los problemas de conflictos de nombres.

¿Cómo puedo agregar una página de opciones de configuración para mi plugin?

Agregar una página de configuración para un plugin generalmente implica el uso de… add_options_page() o add_submenu_page() Se utiliza una función para registrar la página y, a continuación, se aplica el API de Configuraciones (Settings API) de WordPress para crear, verificar y guardar opciones de manera segura. El API de Configuraciones incluye… register_setting()、add_settings_section() Y add_settings_field() Funciones como estas simplifican el proceso de creación de formularios con configuraciones estandarizadas y se encargan automáticamente de la seguridad y el almacenamiento de datos.

Una vez que el plugin esté completamente desarrollado, ¿cómo se publica en el directorio oficial de WordPress?

Para publicar un plugin en el directorio oficial de WordPress.org, primero debes solicitar un repositorio SVN para tu plugin en la página web de WordPress.org. Luego, debes asegurarte de que el código de tu plugin cumpla con los requisitos y normas oficiales, lo que incluye la calidad del código, la seguridad, que la licencia sea compatible con GPL, y que contenga un archivo readme.txt estándar, entre otros. A continuación, utiliza herramientas SVN para enviar tu código al repositorio designado. El equipo de WordPress lo revisará y, si es aprobado, tu plugin aparecerá en el directorio oficial para que los usuarios lo descarguen e instalen.