Inicio/conocimiento/WordPress/Detalles del contenido

Desarrollo de plugins para WordPress: Desde los principios hasta la maestría: Una guía completa para crear funciones personalizadas

2 minutos de lectura
2026-03-15
2026-06-03
2,030
Gano comisiones cuando compras a través de los enlaces de abajo, sin coste adicional para ti.

Configuración del entorno de desarrollo para plugins de WordPress

Antes de comenzar a escribir código, es esencial disponer de un entorno de desarrollo estable y eficiente. Esto no solo mejora la eficiencia del desarrollo, sino que también asegura la compatibilidad de los plugins en diferentes entornos. En primer lugar, debes configurar un entorno de ejecución para WordPress en tu ordenador local. Se recomienda utilizar paquetes de software de servidores locales integrados, como XAMPP, MAMP o Local by Flywheel, que permiten instalar Apache, MySQL y PHP con un solo clic.

A continuación, necesitarás un editor de código. Visual Studio Code, PhpStorm o Sublime Text son opciones excelentes, ya que ofrecen resaltado de sintaxis, sugerencias de código y funciones de depuración. Asegúrate de que tu versión de PHP sea compatible con el entorno de WordPress al que te diriges; generalmente, la página oficial de WordPress recomienda una versión estable de PHP.

La preparación fundamental para el desarrollo es crear la estructura básica de un plugin. En el directorio de instalación de tu WordPress…wp-content/pluginsDentro de la carpeta, crea una nueva carpeta exclusiva para tu plugin, por ejemplo:my-first-pluginEn esta carpeta, debes crear un archivo principal para el plugin, que suele llevar el mismo nombre que el plugin en sí. Por ejemplo:my-first-plugin.phpEste archivo es el punto de entrada del plugin, y la información contenida en las notas en su parte superior es de vital importancia. WordPress depende de esta información para reconocer y mostrar tu plugin.

Lecturas recomendadas Guía completa para el desarrollo de complementos de WordPress: desde cero hasta crear tu primer complemento。

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

Esta nota describe la información que se mostrará sobre el plugin en la interfaz de administración de WordPress. Una vez que completes este paso, podrás ver y activar tu plugin en la página de “Plugins” del administrador de WordPress, aunque por el momento no tendrá 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).
LOGO de UltaHost página de acceso

Comprender los mecanismos centrales de los plugins de WordPress

La gran ventaja de WordPress radica en su arquitectura altamente extensible, que se logra principalmente a través del mecanismo de “ganchos” (Hooks). Comprender los ganchos es clave para dominar el desarrollo de plugins. Existen dos tipos principales de ganchos: los ganchos de acción (Action Hooks) y los ganchos de filtro (Filter Hooks).

Los ganchos de acción (action hooks) te permiten “insertar” y ejecutar tu propio código en momentos específicos. Por ejemplo, cuando se publica un artículo o cuando un usuario accede a la parte superior del sitio web, WordPress activa los ganchos de acción correspondientes. Puedes utilizarlos para realizar tareas automatizadas o personalizar el funcionamiento del sitio según tus necesidades.add_action()La función “monta” tu función personalizada en estos ganchos (hooks).

function my_custom_function() {
    // 你的代码逻辑
}
add_action( 'wp_head', 'my_custom_function' );

El código anterior se ejecutará en el sitio web.<head>Parte de la ejecuciónmy_custom_functionFunción.

Los ganchos de filtro (filter hooks) se utilizan para modificar los datos. Te permiten hacer cambios en ellos antes de que sean utilizados (por ejemplo, al guardarlos en una base de datos o al mostrarlos en una página). Puedes utilizarlos para realizar cualquier tipo de manipulación necesaria.add_filter()Se utiliza una función para aplicar el filtro. La función de filtro debe recibir un valor de entrada y devolver un valor modificado.

Lecturas recomendadas Introducción práctica para principiantes: te enseñaremos paso a paso cómo desarrollar complementos de WordPress.。

function modify_content( $content ) {
    $new_content = $content . “<p>Este artículo fue añadido por mi plugin.</p>”;
    return $new_content;
}
add_filter( 'the_content', 'modify_content' );

Este código añade un texto personalizado al final del contenido de cada artículo.

Otro mecanismo central es el código corto (Shortcode). Los códigos cortos permiten a los usuarios utilizar etiquetas sencillas para...[my_shortcode]) Inserir contenido dinámico en un artículo o página. Puedes utilizar...add_shortcode()Se proporciona una función para registrar una función que maneja códigos cortos (shortcodes).

Crear un ejemplo de plugin con funcionalidades completas

Ahora, vamos a utilizar todo el conocimiento adquirido para crear un sencillo plugin que permita estimar el tiempo necesario para leer un artículo. Este plugin calculará automáticamente el tiempo de lectura y lo mostrará antes del contenido principal.

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%.
LOGO hosting.com página de acceso

Primero, en el archivo principal del plugin, creamos una función para calcular el tiempo de lectura. Supongamos que la velocidad promedio de lectura es de 200 palabras por minuto.

function calculate_reading_time( $content ) {
    // 去除HTML标签，只计算纯文字
    $text = strip_tags( $content );
    // 计算单词数
    $word_count = str_word_count( $text );
    // 计算阅读分钟数（向上取整）
    $reading_time = ceil( $word_count / 200 );

// 创建显示信息
    $reading_time_html = ‘<div class="“reading-time”">Tiempo estimado de lectura: ’.$reading_time.‘ minutos</div>’;

// 将阅读时间信息附加到文章内容之前
    return $reading_time_html . $content;
}
// 使用过滤器将函数应用到文章内容
add_filter( ‘the_content’, ‘calculate_reading_time’ );

Sin embargo, es posible que no queramos mostrar la hora de lectura en todos los lugares (como los resúmenes o las fuentes RSS). Podemos optimizar esto agregando condiciones de evaluación.

function calculate_reading_time( $content ) {
    // 仅在主循环的单篇文章页面显示
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $text = strip_tags( $content );
        $word_count = str_word_count( $text );
        $reading_time = ceil( $word_count / 200 );

$reading_time_html = ‘<div class="“reading-time”"><strong>📖 Tiempo de lectura:</strong>Aproximadamente $reading_time… minutos.</div>’;
        return $reading_time_html . $content;
    }
    // 如果不是单篇文章，返回原内容
    return $content;
}
add_filter( ‘the_content’, ‘calculate_reading_time’ );

Para que el estilo sea más atractivo, también podemos agregar un poco de CSS. Podemos utilizar…wp_enqueue_style()Se trata de una función diseñada para cargar tablas de estilos de manera segura. Para comenzar, crea un archivo en la carpeta de plugins.style.cssEl archivo es luego añadido a la cola mediante un gancho de acción (action hook).

Lecturas recomendadas Guía para principiantes en el desarrollo de complementos de WordPress: crea tu primer complemento funcional desde cero.。

function my_plugin_styles() {
    wp_enqueue_style(
        ‘my-plugin-style’,
        plugin_dir_url( __FILE__ ) . ‘style.css’,
        array(),
        ‘1.0.0’
    );
}
add_action( ‘wp_enqueue_scripts’, ‘my_plugin_styles’ );

Mejores prácticas para la internacionalización y la seguridad de plugins

Un plugin profesional dirigido a usuarios de todo el mundo debe soportar la internacionalización (i18n), lo que permite que sea traducido a otros idiomas. Para implementar la internacionalización, es necesario utilizar las funciones de traducción proporcionadas por WordPress. Para comenzar, asegúrese de configurar correctamente las opciones de traducción en las notas del encabezado del plugin.Text DomainComo lo establecimos anteriormente…my-first-plugin。

En el código, se deben utilizar los mismos métodos para traducir todas las cadenas de texto que necesiten ser traducidas.()、_e()oesc_html()Se realizan paquetes para funciones como estas.

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.
LOGOTIPO DE INTERSERVER página de acceso 
$iempo_de_caminata_html = ‘<div class="“reading-time”"><strong>’
    . esc_html__( ‘📖 Reading Time:’, ‘my-first-plugin’ )
    . ‘</strong>’
    . sprintf(
        esc_html__( ‘about %d minutes’, ‘my-first-plugin’ ),
        $reading_time
    )
    . ‘</div>’;

Luego, necesitarás utilizar una herramienta (como Poedit) para generarlo..potArchivos de plantilla: los traductores pueden utilizarlos como base para crear nuevos contenidos..poY.moEstos archivos deben colocarse en la carpeta del plugin.languagesEn la carpeta.

La seguridad es la línea de vida en el desarrollo de plugins. Es esencial seguir las siguientes prácticas de seguridad fundamentales:
1. 数据验证：对所有来自用户或外部来源的输入数据进行严格检查。使用函数如sanitize_text_field()、absint()Vamos a limpiar los datos.
2. 数据转义：在将任何数据输出到HTML、JavaScript或URL之前，必须进行转义。使用esc_html()、esc_attr()、esc_url()Ywp_kses_post()y otras funciones.
3. 非ce验证：对于涉及数据更改（如表单提交、AJAX请求）的操作，必须使用wp_nonceUn token numérico se utiliza para verificar la legitimidad e intención de la solicitud, con el fin de prevenir ataques CSRF (Cross-Site Request Forgery).
4. 能力检查：在执行管理操作前，使用current_user_can()La función verifica si el usuario actual cuenta con los permisos suficientes (por ejemplo,...).‘manage_options’）。

resúmenes

El desarrollo de plugins para WordPress es un proceso que convierte las ideas en funciones reales, y su esencia radica en comprender a fondo y utilizar de manera flexible el mecanismo de los “ganchos” (hooks) de WordPress. Comienza estableciendo el entorno y creando los archivos básicos, luego interactúa de manera profunda con el núcleo de WordPress a través de acciones (actions) y filtros (filters) para construir módulos funcionales. Un plugin maduro no solo debe contar con funciones completas, sino que también debe cumplir con estándares elevados de internacionalización y seguridad, asegurando su estabilidad y confiabilidad para que puedan ser utilizados por usuarios de todo el mundo. A través de la práctica y el aprendizaje continuos, podrás pasar de desarrollar plugins con funciones sencillas a crear extensiones complejas y de nivel comercial para WordPress.

FAQ Preguntas más frecuentes

¿Es necesario dominar PHP para desarrollar un plugin de WordPress?

Sí, dominar PHP es esencial para desarrollar plugins para WordPress. El núcleo de WordPress está escrito en PHP, y toda la lógica de los plugins y temas depende de este lenguaje. Es necesario estar familiarizado con la sintaxis de PHP, sus funciones, la programación orientada a objetos y cómo interactuar con la base de datos MySQL. Además, tener un buen conocimiento de HTML, CSS y JavaScript es crucial para desarrollar funciones de interacción en la parte frontal del sitio web.

¿Cómo depuro el plugin de WordPress que he desarrollado?

WordPress ofrece una variedad de herramientas de depuración. En primer lugar, puedes…wp-config.phpEn el archivo, active el modo de depuración y establezcaWP_DEBUGLos constantes se establecen entrueEsto mostrará en la página errores, advertencias y notificaciones de PHP. Para un depurado más complejo, se puede utilizar…error_log()La función registra la información en el registro de errores del servidor, o se utilizan herramientas de depuración profesionales como Query Monitor para ver detalles sobre las consultas a la base de datos, la ejecución de los ganchos (hooks), la carga de scripts, etc.

¿Cómo puedo publicar el plugin que he desarrollado en el directorio oficial de plugins de WordPress?

Para publicar un plugin en el directorio oficial de WordPress.org, primero debes crear una cuenta en WordPress.org y enviar tu plugin allí. Tu plugin debe cumplir con los estándares y normas de código oficiales, lo que incluye utilizar una licencia compatible con la GPLv2 o una versión más reciente, seguir las mejores prácticas de seguridad y contener comentarios de documentación completos. Después de enviarlo, el equipo de revisión de plugins lo examinará y, si es aprobado, podrás publicarlo. Una vez publicado, los usuarios podrán buscarlo, instalarlo y actualizarlo directamente desde su panel de administración de WordPress.

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

Puedes utilizar la “API de Configuraciones” (Settings API) de WordPress para crear páginas de administración que sean estándar y seguras. Los pasos principales incluyen:add_menu_page()oadd_submenu_page()La función registra una nueva página de menú y, a continuación, la utiliza.add_settings_section()Yadd_settings_field()Definir la zona de configuración y los campos. Finalmente, utilizar…register_setting()Regístrese para configurar y activar la función de salvado automático y validación. Este proceso garantiza la seguridad de la página de configuraciones y su compatibilidad con la interfaz de administración de WordPress.

¿Qué sigue, qué sigue?

Si estás creando o optimizando un sitio web de WordPress, te recomendamos que continúes leyendo sobre optimización de rendimiento, configuración de complementos y personalización de temas.

Lectura ampliada y conocimientos prácticos

Los siguientes están relacionados con el tema de este artículo y son adecuados para una lectura más profunda. A menudo es mejor priorizar empezando por el artículo que más se acerque a su problema actual y ampliando gradualmente a los temas circundantes.

Etiquetas.