Desarrollo de plugins para WordPress: Una guía práctica completa desde los principios hasta la maestría

Por qué aprender a desarrollar plugins de WordPress

WordPress, como el sistema de gestión de contenidos más popular a nivel mundial, debe su gran capacidad de expansión en gran medida a su arquitectura de plugins. Aprender a desarrollar plugins significa que ya no estará limitado por las funcionalidades de los plugins existentes, y podrá personalizar soluciones según las necesidades de su proyecto. Ya sea que se trate de crear funciones únicas para un cliente específico o de desarrollar un plugin comercial dirigido a usuarios de todo el mundo, dominar esta habilidad le aportará una gran flexibilidad y valor comercial.

Al desarrollar sus propios plugins, puede asegurarse la calidad del código y evitar problemas de compatibilidad o vulnerabilidades de seguridad que podrían surgir al utilizar plugins de terceros. Además, comprender en profundidad el funcionamiento de los plugins le ayudará a entender mejor el funcionamiento del núcleo de WordPress, lo que le permitirá convertirse en un desarrollador más completo. Desde la simple mejora de funcionalidades hasta la integración de aplicaciones SaaS complejas, el desarrollo de plugins es la piedra angular para lograr todo esto.

Configurar el entorno de desarrollo y crear el primer plugin

Antes de comenzar a escribir código, es esencial contar con un entorno de desarrollo adecuado. Se recomienda utilizar herramientas de desarrollo locales como Local by Flywheel, XAMPP o MAMP, que permiten establecer rápidamente un entorno de servidor local que incluye PHP, MySQL y Apache/Nginx. Además, un editor de código profesional, como VS Code o PHPStorm, puede mejorar significativamente la eficiencia del desarrollo.

Crear los archivos básicos para un plugin

El plugin más simple para WordPress puede contener únicamente un archivo PHP principal. Para comenzar, en el directorio de instalación de WordPress…wp-content/pluginsDentro de la carpeta, cree una nueva carpeta, por ejemplo…my-first-plugin。

Dentro de esa carpeta, cree el archivo principal, que suele llevar el nombre del plugin, por ejemplo:my-first-plugin.phpCada plugin debe contener una anotación con información estándar sobre el mismo en la parte superior del archivo; esto es necesario para que WordPress pueda reconocer el 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:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Después de guardar el archivo, acceda a la página de “Plugins” en el panel de administración de WordPress. Deberías ver que el nuevo plugin aparece en la lista de plugins. Aunque por el momento no tiene ninguna función, has creado con éxito un plugin válido para WordPress.

Añadir una función sencilla al plugin.

Vamos a agregar una función muy básica a este plugin: la capacidad de agregar un texto personalizado en el pie de página del sitio web. Lo haremos utilizando el mecanismo de ganchos (Hooks) de WordPress.

// 在 my-first-plugin.php 的插件头部注释下方添加以下代码

function my_first_plugin_add_footer_text() {
    echo '<p style="text-align: center;">¡Gracias por usar mi primer plugin!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_add_footer_text' );

Después de activar el complemento, al acceder a la página principal del sitio web, verá el texto que se ha añadido en la parte inferior de la misma.add_action()La función utiliza lo que hemos definido nosotros mismos (nuestros propios datos, parámetros, etc.).my_first_plugin_add_footer_textLa función se ha “montado” (o integrado) en el núcleo de WordPress.wp_footerEn este “gancho de acción” se encuentra una de las principales formas en que se expanden las funcionalidades de los plugins para WordPress.

En profundidad: Ganchos (Hooks) y Filtros (Filters)

Comprender los hooks es clave para dominar el desarrollo de plugins para WordPress. Existen dos tipos de hooks: los Action y los Filter.

Gancho de Acciones (Actions)

Los ganchos de acción (action hooks) le permiten insertar su propio código en momentos específicos durante el funcionamiento de WordPress. Por ejemplo, después de la publicación de un artículo, cuando un usuario inicia sesión, o antes de que se cargue la parte superior de una página. Los usamos con anterioridad…wp_footerSe trata simplemente de un gancho de acción (action hook). Se utiliza para...add_action()Una función que se utiliza para montar (o cargar) otra función propia.

// 示例：在文章内容顶部添加一个提示框
function add_disclaimer_to_content( $content ) {
    if ( is_single() ) {
        $disclaimer = '<div class="notice">Este artículo es de contenido original; por favor, indique la fuente al reproducirlo.</div>';
        $content = $disclaimer . $content;
    }
    return $content;
}
// 注意：这是一个过滤器示例，为了对比，下面会给出动作示例

Un ejemplo más típico de acción es agregar un menú en la interfaz de administración:

function my_plugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'my-plugin-settings', // 菜单slug
        'my_plugin_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

Gancho de filtros (Filters)

Los ganchos de filtro (filter hooks) le permiten modificar los datos que se transmiten durante el proceso. WordPress envía los datos a través de filtros, y su función puede modificarlos antes de devolverlos. Utilícelos para realizar cualquier ajuste o procesamiento necesario en los datos.add_filter()Función.

// 示例：修改文章摘要的长度
function my_custom_excerpt_length( $length ) {
    return 30; // 将摘要字数改为30字
}
add_filter( 'excerpt_length', 'my_custom_excerpt_length' );

// 示例：修改“阅读更多”链接的文本
function my_custom_excerpt_more( $more ) {
    return '... <a href="/es/' . get_permalink() . '/">Seguir leyendo</a>';
}
add_filter( 'excerpt_more', 'my_custom_excerpt_more' );

Construir una arquitectura de plugins: seguridad, opciones e internacionalización

Un complemento (plugin) maduro requiere una buena arquitectura, lo que incluye un manejo seguro de los datos, un sistema de almacenamiento eficiente y soporte para la internacionalización.

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

Mejores prácticas de seguridad.

Todos los plugins deben cumplir con las normas de seguridad de WordPress. El principio más importante es: verificar, escapar y limpiar los datos de entrada, así como escapar los datos de salida.

• Validación: se trata de verificar si la entrada del usuario cumple con el formato esperado (por ejemplo, si es un correo electrónico, un número, etc.) y se realiza antes de que los datos se almacenen en la base de datos.
• Limpieza (Sanitización): Limpiar la entrada del usuario y eliminar cualquier carácter no seguro o innecesario. WordPress ofrece una gran cantidad de funciones de limpieza, como por ejemplo:sanitize_text_field()。
• Escapado: Antes de enviar cualquier dato al navegador (ya sea en el frontend o en el backend), es necesario escaparlo para evitar ataques de XSS. Utiliceesc_html()、esc_attr()、esc_url()y otras funciones.

// 从表单接收一个标题，清理后保存，输出时转义
$user_input_title = $_POST['title']; // 不安全！
$clean_title = sanitize_text_field( $user_input_title ); // 清理
update_option( 'my_plugin_title', $clean_title ); // 保存

// ... 在另一个地方输出 ...
echo '<h2>'`. esc_html( get_option( 'my_plugin_title' ) )`.'</h2>'; // Salida segura

Usar la API de opciones para almacenar datos.

Para configuraciones sencillas, la API de opciones de WordPress es la mejor forma de almacenar datos. Proporciona un método seguro y fácil de almacenar, recuperar y actualizar datos individuales con nombres específicos.

// 保存或更新一个选项
update_option( 'my_plugin_setting_1', 'some value' );

// 获取一个选项，如果不存在则返回默认值
$setting = get_option( 'my_plugin_setting_1', 'default value' );

// 删除一个选项
delete_option( 'my_plugin_setting_1' );

Para varios ajustes relacionados, se recomienda almacenarlos en un array para reducir la cantidad de consultas a la base de datos.

// 保存一组设置
$settings_array = array(
    'api_key' => '12345',
    'enable_feature' => true,
    'color_scheme' => 'blue'
);
update_option( 'my_plugin_settings', $settings_array );

// 获取设置数组
$saved_settings = get_option( 'my_plugin_settings' );
$api_key = $saved_settings['api_key'] ?? ''; // PHP 7+ 空合并运算符

Internacionalización de plugins

Para que su plugin pueda ser utilizado por usuarios de todo el mundo, la internacionalización (i18n) es esencial. Esto implica que debe utilizar las funciones de traducción de WordPress para encapsular todas las cadenas de texto dirigidas al usuario.

1. Usar__()、_e()、_x()Funciones como estas se utilizan para envolver cadenas de texto (strings) en otros elementos o estructuras de datos.
2. Definir en las notas del encabezado del plugin.Text Domain(Por ejemplo: my-first-plugin).
3. Utilizar herramientas como Poedit para generar el contenido..potArchivo de plantilla para que lo creen los traductores.poY.moDocumentos.

// 在插件主文件中加载文本域
function my_plugin_load_textdomain() {
    load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
add_action( 'plugins_loaded', 'my_plugin_load_textdomain' );

// 在代码中使用翻译函数
$greeting = __( 'Hello, world!', 'my-first-plugin' );
_e( 'This text will be echoed and is translatable.', 'my-first-plugin' );

Publicar y distribuir tus plugins

Una vez que el desarrollo esté completo, puede optar por distribuir el plugin para que otros lo utilicen. Para uso personal o para clientes, simplemente compile el archivo en un formato ZIP. Si desea enviarlo al directorio oficial de plugins de WordPress, deberá seguir normas más estrictas.

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

Listo para la publicación.

Asegúrese de que su código cumpla con los estándares de codificación de WordPress, cuente con comentarios de documentación completos y haya sido probado exhaustivamente. Cree uno…readme.txtEl archivo debe seguir los requisitos de WordPress.org en cuanto a su formato y debe contener una descripción del plugin, instrucciones de instalación, respuestas a preguntas frecuentes, registros de actualizaciones, etc. Esta es la fuente del contenido de la página del directorio de plugins.

Enviar a WordPress.org

Regístrese en una cuenta en WordPress.org y envíe su plugin para su revisión. El equipo de revisión verificará la seguridad del código, su cumplimiento con las normativas y otros aspectos relevantes.readme.txtUna vez que el archivo haya sido aprobado, podrá utilizar SVN para enviar el código del complemento al repositorio oficial, y así los usuarios de todo el mundo podrán buscar e instalar su complemento. Mantener un complemento exitoso implica realizar actualizaciones continuas, reparar vulnerabilidades y responder a las solicitudes de soporte de los usuarios.

resúmenes

El desarrollo de plugins para WordPress es un proceso gradual que comienza con la comprensión de la estructura básica (archivos del plugin, comentarios en la cabecera), continúa con el dominio de los mecanismos centrales de extensión (ganchos de acciones y filtros), y finalmente con la creación de productos robustos, seguros e internacionalizables (prácticas de seguridad, API de opciones, i18n). Al seguir las mejores prácticas y aprovechar la amplia API proporcionada por WordPress, los desarrolladores pueden crear plugins potentes y estables que satisfagan necesidades personales o sirvan a usuarios de todo el mundo. El aprendizaje constante de los nuevos estándares y API de la comunidad es clave para mantener la vitalidad de los plugins.

FAQ Preguntas más frecuentes

¿Qué conocimientos previos se necesitan para desarrollar un plugin de WordPress?

Es necesario que cuentes con una base sólida en programación PHP, ya que el desarrollo de plugins se realiza principalmente en este lenguaje. Además, es esencial tener un conocimiento básico de HTML, CSS y JavaScript para manejar la presentación y la interacción del lado del usuario. Ser familiarizado con los conceptos básicos de las bases de datos MySQL también es de ayuda, aunque la API de WordPress ya encapsula la mayoría de las operaciones relacionadas con las bases de datos. Lo más importante es tener una comprensión clara de los conceptos fundamentales de WordPress, como artículos, páginas, categorías, etiquetas y roles de usuarios.

¿Cuál es la principal diferencia entre los ganchos de acción (Action) y los ganchos de filtro (Filter)?

Los ganchos de acción se utilizan para “ejecutar un fragmento de código” en momentos específicos; no esperan un valor de retorno y se usan principalmente para desencadenar ciertas operaciones, como agregar menús, enviar correos electrónicos o insertar elementos en una página. Por su parte, los ganchos de filtro se utilizan para “modificar los datos que se pasan”; deben devolver un valor (generalmente el valor de entrada modificado) que se utilizará para cambiar el texto, ajustar parámetros de configuración o filtrar resultados de consultas, entre otras cosas. En resumen, los ganchos de acción se encargan de “hacer algo”, mientras que los ganchos de filtro se encargan de “modificar algo”.

¿Cómo depuro mi plugin para WordPress?

En primer lugar, asegúrate de que enwp-config.phpEl archivo se abrió en el programa.WP_DEBUGYWP_DEBUG_LOGEsto registrará los errores y avisos de PHP enwp-content/debug.logEl archivo se encuentra dentro del sistema y no se muestra a los visitantes. En segundo lugar, se utiliza…error_log()La función escrive información de depuración personalizada en el registro. Para lógicas complejas, se pueden utilizar herramientas de depuración profesionales como Xdebug en combinación con un entorno de desarrollo integrado (IDE) para realizar el depurado mediante puntos de interrupción. Además, es de vital importancia verificar los errores de JavaScript en la consola del navegador.

¿Cómo puede mi complemento ser compatible con un tema u otros complementos?

Para maximizar la compatibilidad, siempre se debe utilizar la API oficial de WordPress (como la API de opciones, la API de configuración y la API HTTP) en lugar de funciones PHP personalizadas. Agregue un prefijo único a los nombres de sus funciones, clases y opciones.myplugin_En lugar de ser un método universal (o generalmente aplicable).get_data()Esto se hace para evitar conflictos de nombres. Al agregar ganchos (hooks), configure adecuadamente los parámetros de prioridad para que el orden de ejecución sea el esperado. Modifique las variables globales con cuidado y considere la posibilidad de proporcionar filtros que permitan a otros desarrolladores modificar el comportamiento predeterminado de su plugin.