Guía para el desarrollo de plugins para WordPress: Te enseñamos paso a paso a crear tu propio plugin desde cero.

Comprender los fundamentos de los plugins y la configuración del entorno de desarrollo.

Antes de comenzar a escribir código, es de vital importancia comprender los conceptos básicos de los plugins de WordPress y preparar un entorno de desarrollo local adecuado. Un plugin es, en esencia, un directorio que contiene una o más archivos PHP, y funciona para extender o modificar las funciones principales de WordPress a través del sistema de ganchos (Hooks) proporcionado por este. A diferencia de los temas, los plugins se centran en agregar nuevas funcionalidades al sitio web, sin alterar su apariencia; por lo general, las funciones de un plugin se mantienen inalteradas incluso si se cambia de tema.

Para comenzar a desarrollar, primero necesitas un entorno local de WordPress. Esto se puede lograr fácilmente con herramientas como Local by Flywheel, MAMP, XAMPP o utilizando directamente contenedores Docker. Una vez que hayas instalado WordPress en tu entorno local, debes acceder a…wp-content/pluginsÍndice. Aquí se encuentran todos los plugins. Crea una nueva carpeta, por ejemplo…my-first-pluginDentro de esta carpeta, debes crear un archivo PHP principal cuyo nombre suele coincidir con el nombre de la carpeta, por ejemplo…my-first-plugin.phpEste archivo principal es el punto de entrada del plugin y contiene un conjunto de cabeceras de comentarios especiales que proporcionan a WordPress información sobre el nombre del plugin, su descripción, versión, autor, entre otros detalles.

Se recomienda activar esta opción en el entorno de desarrollo.WP_DEBUGModo. Abra el directorio raíz de WordPress.wp-config.phpEn el archivo, busque o añada la siguiente línea:

Lecturas recomendadas Guía práctica para el desarrollo de plugins de WordPress: desde cero hasta la creación de tu primer plugin.。

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );

Esto registrará los errores y las advertencias en…wp-content/debug.logEn los archivos, encontrarás información que te ayudará a localizar problemas rápidamente durante el proceso de desarrollo. Además, utilizar un editor de código o un entorno de desarrollo integrado (IDE) potente, como VS Code o PhpStorm, puede mejorar significativamente la eficiencia de desarrollo. Estos herramientas suelen ofrecer un buen soporte sintáctico y funciones de sugerencia para PHP y WordPress.

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

Crea tu primer archivo de plugin.

Seguiremos el proceso completo desde la creación de un archivo hasta la activación de un plugin, creando un sencillo plugin “Hello World”. Este plugin mostrará un mensaje de bienvenida en la parte superior de la interfaz de administración del sitio web.

En tu directorio de plugins…my-first-pluginEn este proceso, se crea el archivo principal.my-first-plugin.phpLa estructura básica del contenido del archivo debe comenzar con las notas en la parte superior del complemento (plugin).

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的示例插件，它将在后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            开发者姓名
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Estos encabezados de comentarios son obligatorios; WordPress los utiliza para identificar y mostrar tus plugins en la página de administración de plugins. Entre ellos,Text DomainUtilizado para la internacionalización (i18n).Domain PathSe especifica el directorio en el que se encuentran los archivos de idioma (si es necesario).

A continuación, agregaremos las funciones principales. En este ejemplo, utilizaremos…admin_noticesGancho: Agrega el siguiente código debajo de las notas en la parte superior del documento.

Lecturas recomendadas Guía completa para el desarrollo de complementos de WordPress: un tutorial práctico desde el nivel inicial hasta el avanzado.。

// 使用 admin_notices 钩子在管理后台输出提示信息
add_action( ‘admin_notices’, ‘my_first_plugin_display_admin_greeting’ );

/**
 * 在管理后台显示欢迎信息的函数
 * @return void
 */
function my_first_plugin_display_admin_greeting() {
    // 检查当前用户是否有权限，确保只在后台显示
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( ‘欢迎使用我的第一个插件！插件开发之旅正式开始！’, ‘my-first-plugin’ ); ?></p>
    </div>
    ¿php?  
}

Después de guardar el archivo, inicie sesión en el panel de administración de su sitio web WordPress y vaya a la página de “Plugins”. Debería ver un plugin llamado “Mi primer plugin” en la lista de plugins. Haga clic en el botón “Activar”. Una vez activado, actualice cualquier página de administración (por ejemplo, el panel de control) y debería ver un mensaje de éxito en color verde que contiene el saludo que definimos en nuestro código. Esta es una implementación mínima pero completa que verifica que su entorno de desarrollo y la estructura de los plugins están correctos.

Técnicas centrales de WordPress: Ganchos (Hooks) y Filtros (Filters)

Comprender y utilizar hábilmente los hooks es esencial para el desarrollo de plugins en WordPress. Existen dos tipos de hooks: las acciones (Actions) y los filtros (Filters). Los hooks de acción te permiten insertar y ejecutar código personalizado en momentos específicos, como después de la publicación de un artículo o antes de que se cargue la parte superior de una página. Los que utilizamos anteriormente…admin_noticesSe trata de un “gancho de acción” (action hook). Por su parte, los “ganchos de filtro” (filter hooks) te permiten modificar los datos que se generan o se transfieren durante el proceso, por ejemplo, cambiar el contenido del título de un artículo o los resultados de una consulta realizada por un plugin.

¿Cómo agregar una acción personalizada?

La acción se ha llevado a cabo con éxito.add_action()Se ha agregado una función. La sintaxis es:add_action( ‘hook_name’, ‘your_function_name’, priority, accepted_args )La prioridad es un número entero; cuanto menor sea el valor, antes se ejecutará la acción correspondiente. El valor predeterminado es 10. Por ejemplo, si deseas agregar algunos elementos HTML personalizados después del contenido del artículo, debes establecer la prioridad de dichos elementos de manera que se procesen después del resto del contenido.

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

add_action( ‘the_content’, ‘my_custom_content_append’ );
function my_custom_content_append( $content ) {
    // 只在单篇文章主循环内生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $extra_content = ‘<div class="“my-custom-box”"><p>Este es contenido personalizado que se ha añadido mediante un plugin.</p></div>’;
        $content .= $extra_content;
    }
    return $content;
}

Tenga en cuenta que, aunque…the_contentEs un filtro (que necesita devolver el resultado modificado).$content), pero WordPress también lo utiliza como punto de activación para una acción. Una práctica más rigurosa sería utilizar…add_filter。

¿Cómo agregar un filtro personalizado?

El filtro ha funcionado correctamente.add_filter()Adición de funciones. Sintaxis y…add_action()Algo similar. Un ejemplo común es modificar la longitud de los extractos de un artículo.

add_filter( ‘excerpt_length’, ‘my_custom_excerpt_length’, 999 );
function my_custom_excerpt_length( $length ) {
    // 将默认的55个词改为20个词
    return 20;
}

Puedes crear tus propios “ganchos” (hooks) para que tu plugin también pueda ser extendido por otros desarrolladores o temas.do_action()Para definir un gancho de acción (action hook), se utiliza…apply_filters()Definir un gancho de filtro es crucial para construir plugins modulares y extensibles.

Lecturas recomendadas Guía completa para el desarrollo de plugins para WordPress: desde cero hasta avances avanzados。

Avances en las funcionalidades de los plugins y mejores prácticas

A medida que las funciones de los plugins se vuelven más complejas, una buena organización del código, la seguridad, la mantenibilidad y el rendimiento adquieren una importancia crucial. Una práctica común es utilizar la programación orientada a objetos (POO) para estructurar el código, encapsulando las funciones y datos relacionados en una clase principal.

Utilizar la programación orientada a objetos para encapsular el código.

Crear una clase principal puede ayudar a gestionar mejor el estado y los métodos de los plugins, evitando conflictos de nombres de funciones. A continuación, se muestra un ejemplo simple de estructura orientada a objetos (OOP):

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

<?php
/**
 * Plugin Name:       进阶示例插件
 */
if ( ! class_exists( ‘My_Advanced_Plugin’ ) ) {
    class My_Advanced_Plugin {
        /**
         * 构造方法，用于初始化钩子
         */
        public function __construct() {
            add_action( ‘init’, array( $this, ‘register_custom_post_type’ ) );
            add_action( ‘admin_menu’, array( $this, ‘add_admin_menu_page’ ) );
            add_filter( ‘the_title’, array( $this, ‘filter_post_title_prefix’ ), 10, 2 );
        }

/**
         * 注册一个自定义文章类型
         */
        public function register_custom_post_type() {
            $args = array(
                ‘public’ => true,
                ‘label’  => ‘我的产品’,
                ‘supports’ => array( ‘title’, ‘editor’, ‘thumbnail’ ),
                ‘has_archive’ => true,
            );
            register_post_type( ‘my_product’, $args );
        }

/**
         * 在文章标题前添加前缀的过滤器
         * @param string $title 原标题
         * @param int    $id    文章ID
         * @return string 修改后的标题
         */
        public function filter_post_title_prefix( $title, $id = null ) {
            if ( ! is_admin() && in_the_loop() ) {
                $title = ‘[精品] ’ . $title;
            }
            return $title;
        }

// ... 其他方法
    }
    // 实例化插件类
    new My_Advanced_Plugin();
}

Esta estructura organiza las funciones relacionadas de manera que el código sea más claro y fácil de gestionar.

Garantizar la seguridad y el rendimiento de los plugins.

La seguridad es la principal prioridad en el desarrollo de plugins. Nunca confíes en los datos introducidos por los usuarios. En cuanto a todo lo que proviene de…$_GET、$_POSTo$_REQUESTLos datos obtenidos deben ser verificados, limpiados y escapados. WordPress ofrece una serie de funciones de ayuda para ello:
* 验证：check_ajax_referer()， wp_verify_nonce()
* 清理：sanitize_text_field()， sanitize_email()， absint()
* 转义：esc_html()， esc_url()， wp_kses_post()

Antes de enviar cualquier dato a HTML, atributos o URL, asegúrese de utilizar las funciones de escape adecuadas. En cuanto al rendimiento, use los “ganchos” (hooks) de manera inteligente para evitar que las consultas que consumen muchos recursos se ejecuten en cada carga de la página. Considere utilizar la caché transitoria de WordPress (Transients API) para almacenar los resultados de consultas no esenciales y que puedan ser reutilizados durante un cierto período de tiempo.

Implementar la página de configuración del plugin

La mayoría de los plugins requieren una página de configuración para que el usuario pueda realizar los ajustes necesarios. Esto se suele lograr a través de...add_options_page()oadd_menu_page()Funciones como estas, montadas en…admin_menuSe debe implementar mediante un “gancho” (hook) específico. Para configurar las opciones, se debe utilizar la API de Ajustes (Settings API) de WordPress para realizar el registro, almacenamiento y validación de datos de manera segura. Esto implica el uso de los métodos y funciones proporcionados por dicha API.register_setting()、add_settings_section()Yadd_settings_field()Funciones como estas no solo aseguran la seguridad (por ejemplo, mediante la verificación de los valores `nonce`), sino que también contribuyen a mantener un estilo uniforme en la interfaz de administración de WordPress.

resúmenes

El desarrollo de plugins para WordPress es un proceso que convierte las ideas en funciones reales, comenzando por comprender la estructura básica de los plugins y la configuración del entorno local. Al crear el plugin más simple posible (“Hello World”), pusimos en práctica todo el proceso, desde la creación de los archivos hasta la activación de sus funciones. El núcleo del desarrollo reside en comprender en profundidad y utilizar de manera flexible el potente sistema de ganchos de WordPress: las acciones (actions) y los filtros (filters), que actúan como puentes de interacción entre el núcleo de WordPress y otras partes del sistema. A medida que las funciones del plugin aumentan, adoptar un enfoque de programación orientado a objetos, seguir normas de codificación segura (verificación de datos, limpieza de datos, escape de caracteres), y utilizar la API de configuraciones (Settings API) para crear páginas de configuración se convierte en pasos clave para garantizar que el plugin sea estable, seguro, sencillo de mantener y escalable. Siguiendo estas guías y buenas prácticas, podrás desarrollar con confianza todo tipo de plugins de WordPress de alta calidad, desde herramientas sencillas hasta aplicaciones complejas.

FAQ Preguntas más frecuentes

¿Qué conocimientos previos se necesitan para desarrollar un plugin para WordPress con el nombre ###?
Es necesario que tengas conocimientos básicos del lenguaje de programación PHP, ya que los plugins están escritos principalmente en este idioma. Además, tener un entendimiento básico de HTML, CSS y JavaScript te ayudará a crear plugins con interacción en la parte frontal del sitio web ( frontend). Lo más importante es que estés familiarizado con los conceptos fundamentales de WordPress, como artículos, páginas, categorías, roles de usuarios y, sobre todo, con el sistema de ganchos (hooks).

¿Cómo depurar un plugin de WordPress en desarrollo?

Se recomienda encarecidamente activar esta opción en el entorno de desarrollo.WP_DEBUGLos modos y configuraciones relevantes ya se han explicado en la sección sobre la configuración del entorno principal. Esto permitirá que los errores, advertencias y notificaciones de PHP se registren en un archivo de registro. Además, puedes utilizar…error_log()Funciones o funciones auxiliares, como…var_dump()Cooperarwp_die()Es necesario generar los valores de las variables para realizar comprobaciones. Las pestañas “Consola” y “Red” (Network) de las herramientas de desarrollo del navegador son esenciales para depurar JavaScript y solicitudes AJAX.

¿Cómo puede mi plugin ser compatible con diferentes versiones de WordPress?

En el código del plugin, debes verificar si ciertas funciones o clases existen en la versión actual de WordPress antes de usarlas. Para ello, puedes utilizar herramientas específicas o métodos de comprobación integrados en el framework de WordPress.function_exists()ois_admin()Para realizar comprobaciones basadas en condiciones, se puede hacer referencia a las instrucciones del complemento a través de las notas en el encabezado del mismo.Requires at least:Se utiliza un campo para especificar la versión mínima de WordPress requerida. Es una buena práctica probar periódicamente la compatibilidad de tus plugins con la versión más reciente del núcleo de WordPress.

¿Cómo puedo internacionalizar mi plugin para que sea compatible con múltiples idiomas?

Debes utilizar las funciones de traducción de WordPress para envolver todas las cadenas de texto que necesitan ser traducidas. Por ejemplo, utiliza…__( ‘文本’, ‘your-plugin-text-domain’ )Para generar el texto traducido, use_e( ‘文本’, ‘your-plugin-text-domain’ )Vamos a hacer que esto se refleje directamente. Necesitas configurarlo correctamente en las notas del encabezado del plugin.Text DomainYDomain PathLuego, utiliza herramientas como Poedit para crearlo..potLos archivos de plantilla, a partir de los cuales los traductores pueden crear..poY.moArchivos de idioma.

Una vez que el desarrollo esté completo, ¿cómo se puede enviar el plugin al directorio oficial de plugins?

Primero, debes registrar una cuenta en el sitio web oficial de WordPress y enviar tu plugin para que sea revisado. Tu código debe cumplir con los estándares y guías de codificación oficiales, lo que incluye aspectos como la seguridad, la ausencia de código malicioso y la compatibilidad con la licencia GPL. La estructura de tu directorio de plugins debe contener el archivo PHP principal, además de otros archivos necesarios para el funcionamiento del plugin.readme.txtLos archivos (cuyo formato cumple con estándares específicos), así como las capturas de pantalla y los iconos (opcionales), serán revisados. El proceso de revisión puede llevar algún tiempo; el equipo examinará tu código para asegurarse de que cumpla con los requisitos.