Guía completa para el desarrollo de plugins para WordPress: Desde los principios hasta la creación de funciones personalizadas avanzadas

¿Por qué elegir desarrollar un plugin para WordPress?

WordPress, como el sistema de gestión de contenidos más popular a nivel mundial, debe su gran capacidad de expansión principalmente a los plugins. Al desarrollar plugins personalizados, los desarrolladores pueden agregar cualquier función que sea necesaria a un sitio web sin tener que modificar el código central, lo que garantiza la seguridad de las actualizaciones y la independencia de las funciones del mismo. Ya sea para satisfacer necesidades comerciales específicas, optimizar los flujos de trabajo o crear productos dentro de la vasta comunidad de WordPress, el desarrollo de plugins es una habilidad de gran valor.

En lugar de modificar directamente el tema,functions.phpA diferencia de los archivos tradicionales, los plugins encapsulan la lógica de sus funciones en módulos independientes. Esto significa que, incluso si se cambia el tema del sitio, las funciones proporcionadas por el plugin seguirán funcionando sin problemas. Además, un plugin bien estructurado puede ser fácilmente migrado y reutilizado en diferentes sitios, lo que mejora significativamente la eficiencia del desarrollo.

Desarrolla tu primer complemento

El primer paso para comenzar a desarrollar plugins es comprender la estructura más básica de uno de ellos. Todos los plugins de WordPress se almacenan en…/wp-content/plugins/Bajo el directorio, cada complemento tiene su propia carpeta independiente.

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

Crear el archivo principal del plugin

El núcleo del plugin es un archivo principal en PHP. Necesitas crear una nueva carpeta, por ejemplo…my-first-pluginY dentro de esa carpeta, cree un archivo PHP con el mismo nombre que la carpeta misma:my-first-plugin.phpLas notas de cabecera de este archivo son de vital importancia, ya que proporcionan a WordPress la metainformación del plugin.

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

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

Después de guardar este archivo, podrás verlo y activarlo en la página de “Plugins” del panel de administración de WordPress. Aunque por el momento no tiene ninguna función, has creado con éxito un marco de plugin legal.

Agregar funcionalidades básicas al plugin

Después de activar el plugin, podemos comenzar a agregarle funciones sencillas. Un ejemplo común para comenzar es agregar una línea de texto personalizado en el pie de página del sitio web. Esto se puede hacer utilizando…wp_footerEste accionador (Action Hook) se utiliza para implementar dicha función.

En el archivo principal del plugin, añada el siguiente código:

// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
    echo '<p style="text-align: center;">¡Gracias por utilizar el servicio respaldado por mi primer plugin!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );

Aquí, hemos definido una función.my_first_plugin_footer_text()Luego, utilízalo.add_action()La función lo monta en…wp_footerEstá en el gancho. Cuando WordPress llega a la sección del pie de página, nuestra función se llama automáticamente para mostrar el contenido HTML predefinido. Esto demuestra el uso básico del mecanismo de “ganchos y callbacks” en WordPress.

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

En profundidad: Ganchos y filtros

La filosofía central del desarrollo de plugins para WordPress se basa en los “ganchos” (Hooks). Existen dos tipos de ganchos: los ganchos de acción (Action Hooks) y los ganchos de filtro (Filter Hooks). Comprender su funcionamiento es clave para pasar de ser un principiante a un experto en el desarrollo de plugins para WordPress.

Comprender los ganchos de acción (action hooks)

Los “ganchos de acción” (action hooks) te permiten insertar tu propio código en momentos específicos durante el ejecución de WordPress. Como en el ejemplo anterior…wp_footerSe activa durante la generación del código HTML del pie de página. Otro gancho de acción (action hook) muy utilizado es…initSe ejecuta después de que WordPress haya completado su carga inicial y antes de procesar las solicitudes, y se utiliza comúnmente para inicializar la configuración de los plugins o registrar tipos de artículos personalizados.

// 在初始化时执行一些操作
function my_plugin_init_action() {
    // 例如，在这里可以注册一个自定义文章类型
    // if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );

Dominar los ganchos (hooks) de los filtros

A diferencia de los ganchos de acción (action hooks), los ganchos de filtro (filter hooks) se utilizan para modificar datos. Reciben un valor, te permiten modificarlo y luego devuelven el valor procesado. Un ejemplo típico es…the_contentEl filtro te permite modificar el contenido principal de un artículo o una página.

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

// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">El contenido de este artículo ha sido generado mediante el filtrado realizado por mi plugin.</div>';
        $content .= $extra_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );

En este ejemplo, la función…my_plugin_content_filter()Recibir el original.$contentSe debe verificar si se trata de la página de un único artículo; luego, se debe agregar un segmento de HTML al final de ese contenido. Finalmente, se debe devolver el contenido modificado. WordPress utilizará este valor devuelto en lugar del contenido original para su visualización.

Construir plugins configurables

Un plugin profesional suele necesitar proporcionar una interfaz de administración que permita a los usuarios realizar configuraciones. Esto implica crear páginas de configuración en el backend de WordPress, procesar los datos de los formularios y guardarlos de manera segura.

Crear menús y páginas de administración.

utilizaradd_menu_page()oadd_options_page()Las funciones pueden agregar un elemento de menú y una página de configuración para tu plugin en segundo plano. Esto sucede generalmente cuando…admin_menuSe completó en el gancho de acción (action hook).

Lecturas recomendadas Guía para principiantes en el desarrollo de plugins para WordPress: Cómo crear funciones personalizadas desde cero hasta la perfección。

// 添加插件管理菜单
function my_plugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

// 设置页面的HTML内容
function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Configuraciones de mi plugin</h1>
        <form method="post" action="/es/options.php/" data-trp-original-action="options.php">
            
        <input type="hidden" name="trp-form-language" value="es"/></form>
    </div>
    ¿php?  
}

Configuraciones de registro, campos y medidas de seguridad

A continuación, necesitarás utilizar la API de Configuraciones de WordPress (WordPress Settings API) para registrar configuraciones, campos y gestionar el almacenamiento de datos. Esto garantiza la seguridad de la validación de datos, los controles de permisos y el proceso de serialización del almacenamiento.

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个新的设置项到“my_plugin_settings_group”
    register_setting( 'my_plugin_settings_group', 'my_plugin_options' );

// 在设置页面添加一个区域
    add_settings_section(
        'my_plugin_section_id',
        '基础配置',
        null,
        'my-plugin-settings'
    );

// 向该区域添加一个字段
    add_settings_field(
        'my_plugin_text_field',
        '提示文本',
        'my_plugin_text_field_render',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 渲染文本框字段
function my_plugin_text_field_render() {
    $options = get_option( 'my_plugin_options' );
    ?>
    <input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
    <p class="description">El texto que se ingresa aquí se mostrará en la página principal del sitio web.</p>
    ¿php?  
}

De esta manera, los datos introducidos por los usuarios en la interfaz frontal son procesados de forma segura por WordPress, incluyendo la desescapulación de caracteres y la verificación de su validez. Posteriormente, estos datos se almacenan en forma de array.wp_optionsEn la tabla. El código de tu plugin puede ser utilizado a través de…get_option( ‘my_plugin_options’ )Obtener estos valores de manera segura.

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 las mejores prácticas y prepararse para el lanzamiento.

Desarrollar un plugin de alta calidad, fácil de mantener y seguro implica seguir una serie de buenas prácticas.

Organización del código y seguridad

Nunca confíes en lo que ingresa el usuario. Para todo lo que provenga de…$_GET、$_POSTLos datos obtenidos, o aquellos leídos de la base de datos y preparados para su salida, deben ser procesados utilizando las funciones proporcionadas por WordPress para su correcta escapación o validación.esc_html()、esc_attr()、sanitize_text_field()、wp_kses()Usar, etc.wp_enqueue_script()Ywp_enqueue_style()Es necesario cargar correctamente los scripts y los estilos, así como gestionar las dependencias y el control de versiones. Para plugins complejos, se recomienda utilizar la programación orientada a objetos (POO) para organizar el código, encapsulando las funciones en clases. Esto mejora la modularidad y la reutilizabilidad del código.

Internacionalización y localización

Para que tu plugin pueda ser utilizado por usuarios de todo el mundo, la internacionalización (i18n) es esencial. Esto significa que necesitas…__()o_e()Las funciones como `etc.` envuelven todas las cadenas de texto (strings) dirigidas al usuario. Estas funciones están definidas en las notas al principio del plugin.Text Domain(Por ejemplo,my-first-pluginDebe ser consistente con los campos de texto utilizados en este lugar.

// 错误示例
echo “Settings Saved”;

// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );

Luego, puedes utilizar herramientas como Poedit para extraer estas cadenas de texto y generar lo que necesitas..potLos archivos de plantilla permiten que los traductores creen contenido en diferentes idiomas a partir de ellos.zh_CN.poPor favor, proporciona el texto que necesitas traducir..moLos archivos de compilación se encuentran en el directorio de los plugins./languages/Dentro de la carpeta, WordPress cargará automáticamente las traducciones correspondientes según el idioma del sitio.

Listo para ser publicado en el directorio oficial.

Si planeas enviar el plugin al directorio oficial de plugins de WordPress.org, debes asegurarte de que el código cumpla con las especificaciones. Esto incluye la creación de un documento detallado que explique cómo funciona el plugin, sus características principales, cómo se instala y utiliza, así como cualquier información adicional que pueda ser de utilidad para los usuarios y desarrolladores.readme.txtEl archivo describe los complementos (plugins) utilizando un formato específico, incluyendo capturas de pantalla, instrucciones de instalación, preguntas frecuentes (FAQ) y registros de actualizaciones. Está licenciado bajo la licencia GPL, y el código se envía a través del repositorio oficial de Subversion (SVN). Antes de su publicación, se realiza una prueba exhaustiva para garantizar la compatibilidad del complemento con diferentes versiones de WordPress, PHP, temas populares y otros complementos.

resúmenes

El desarrollo de plugins para WordPress es un proceso gradual que va desde la encapsulación de funciones simples hasta la creación de aplicaciones complejas. Comienza con un archivo PHP que contiene las anotaciones de cabecera adecuadas, y su esencia radica en el uso hábil de los ganchos de acción (action hooks) y los ganchos de filtro (filter hooks) para interactuar con el núcleo de WordPress. La construcción de una interfaz de administración en el backend a través de la API Settings hace que los plugins sean más fáciles de utilizar por los usuarios. Seguir las mejores prácticas de seguridad, implementar la internacionalización y organizar el código de manera adecuada son las piedras angulares para desarrollar plugins de nivel profesional. Ya sea que lo hagas para satisfacer las necesidades de un proyecto personal o para contribuir a la comunidad de código abierto, dominar este proceso de desarrollo te abrirá las puertas a una gran capacidad de personalización.

FAQ Preguntas más frecuentes

¿Qué conocimientos previos se necesitan para desarrollar plugins?

Es necesario contar con conocimientos básicos de programación en PHP, entender HTML y CSS, así como tener un conocimiento previo de las operaciones y conceptos fundamentales de WordPress (como artículos, páginas y widgets). Ser familiarizado con los conceptos básicos de las bases de datos MySQL también sería de ayuda, aunque no es obligatorio, ya que WordPress proporciona funciones convenientes para la gestión de la base de datos.WP_Query、wpdbClase).

¿Cuál es la diferencia entre los archivos functions.php de los plugins y los temas?

Coloca el código dentro del tema.functions.phpEl archivo contiene un método para agregar funciones de manera rápida, pero estas funciones están vinculadas al tema específico. Cuando cambias de tema, esas funciones se pierden. Por otro lado, los plugins son módulos independientes del tema; sus funciones permanecen activas independientemente del tema que se esté utilizando, siempre y cuando el plugin esté activado. Por lo tanto, para funciones que se planea utilizar a largo plazo o que necesitan ser reutilizadas en múltiples sitios web, desarrollarlas como plugins es la opción más conveniente.

¿Cómo depuro el código de mi plugin?

WordPress ofrece una variedad de herramientas de depuración. En primer lugar, puedes…wp-config.phpEl archivo se abrió en el programa.WP_DEBUGModo, por favor.define( 'WP_DEBUG', true );Esto mostrará todos los errores, advertencias y notificaciones de PHP en la pantalla. Una forma más segura es configurar ambas opciones al mismo tiempo.WP_DEBUG_LOGParatrueRegistra los errores en…/wp-content/debug.logEn el archivo. Además, se utiliza…error_log()Utilizar funciones o plugins de depuración profesionales como Query Monitor permite rastrear variables y consultas a la base de datos de manera más eficiente.

¿Cómo puedo asegurarme de que mi plugin sea compatible con versiones más recientes de PHP?

Para asegurarte de que el plugin funcione correctamente en futuras versiones de PHP, debes evitar utilizar funciones y gramáticas que ya han sido descontinuadas o eliminadas. En el entorno de desarrollo local, utiliza un entorno que coincida con la versión futura a la que te diriges (por ejemplo, PHP 8.x) para realizar las pruebas. Mantén un seguimiento constante de los anuncios de actualizaciones oficiales de WordPress y PHP, y indica en el registro de actualizaciones del plugin el rango de versiones de PHP con las que es compatible. Esto ayudará a los usuarios a elegir el entorno adecuado para su uso.