Desde cero: Guía completa de introducción y tutorial práctico para el desarrollo de plugins para WordPress

Preparación y configuración del entorno.

Antes de desarrollar un plugin para WordPress, es de vital importancia establecer un entorno de desarrollo local estable. Esto te permitirá realizar pruebas y depuraciones sin afectar al sitio web en línea.

Elección y configuración del entorno de desarrollo local

El paso más importante es configurar un servidor local que integre PHP, MySQL y Apache/Nginx. Puedes elegir…MAMP、XAMPPEstos paquetes de software integrados ofrecen métodos de instalación sencillos tanto para Windows como para macOS. Para usuarios más avanzados, existe la opción de utilizar…DockerContenerizar tu entorno de desarrollo es la mejor práctica actual, ya que asegura la consistencia del entorno y facilita su replicación. Independientemente del método que elijas, asegúrate de que la versión de PHP que utilizas sea compatible con la versión principal en la que se esperan que funcionen tus plugins (por ejemplo, PHP 7.4 o superior), y activa las extensiones de PHP necesarias, como MySQLi o PDO.

Instalar y configurar WordPress.

Una vez que el entorno del servidor local esté listo, necesitarás instalar el núcleo de WordPress. Descarga la versión más reciente y estable desde el sitio web oficial de WordPress.org, y descomprime el archivo en la carpeta raíz del servidor web (por ejemplo, `/www/`).htdocsowwwEl archivo se encuentra en una carpeta dentro de esa otra carpeta. A continuación, acceda a dicha carpeta mediante un navegador y sigue los pasos de instalación descritos en el famoso tutorial de “cinco minutos” para completar el proceso. Se recomienda crear una base de datos dedicada al desarrollo de plugins, y anote el nombre de la base de datos, el nombre de usuario y la contraseña. Después de la instalación, ingrese al panel de administración de WordPress y cambie la estructura de los enlaces fijos a un formato no predeterminado (por ejemplo, el nombre del artículo), lo que ayudará a comprobar la compatibilidad del plugin con los enlaces permanentes.

Lecturas recomendadas Introducción al desarrollo de temas de WordPress: crea tu primer tema personalizado desde cero.。

Recomendaciones de herramientas de desarrollo esenciales

El desarrollo eficiente no es posible sin herramientas adecuadas. En primer lugar, necesitas un editor de código, como uno gratuito y potente.Visual Studio CodeInstale los complementos adecuados para PHP, WordPress y la detección inteligente de código. También, asegúrese de contar con una herramienta de control de versiones.GitEs un elemento esencial para gestionar los cambios en el código y realizar el seguimiento de su historial. Las herramientas de desarrollo de los navegadores (como Chrome DevTools o Firefox Developer Edition) son cruciales para el depurado del código front-end. Finalmente, considere instalar una herramienta de revisión de calidad del código.PHP_CodeSnifferCombinaciónWordPress-Coding-StandardsUn conjunto de reglas que te ayuda a seguir los estándares de codificación oficiales de 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

Estructura básica de los plugins y archivos centrales

Un plugin estándar de WordPress cuenta con una estructura de directorios y archivos específica. Seguir estas normas es esencial para que el plugin sea reconocido por el sistema y se pueda gestionar de manera efectiva.

Composición básica del archivo principal y su función

Cada plugin debe tener un archivo PHP principal que sirve como punto de entrada para el mismo. Las notas al principio de este archivo (los comentarios del tipo `/*`) contienen los metadatos del plugin, lo que es esencial para que WordPress lo reconozca. A continuación, se muestra un ejemplo de archivo principal de plugin muy básico:my-first-plugin.phpEjemplo:

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

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

Plugin NameEs el único campo obligatorio, utilizado para su visualización en la lista de plugins en el backend. Se recomienda definirlo.ABSPATHComprobar y evitar que usuarios malintencionados accedan directamente a los archivos centrales del plugin.

Añadir el código funcional esencial para el complemento.

Después de los comentarios de cabecera, puedes comenzar a escribir el código funcional del plugin. El ejemplo más simple es agregar un mensaje de “Hello World” en la interfaz de administración. Puedes utilizar…add_actionLos “ganchos” (hooks) permiten enlazar funciones personalizadas en puntos específicos de ejecución de WordPress.

Lecturas recomendadas Desde cero: Guía completa y tutorial práctico para el desarrollo de plugins para WordPress。

/**
 * 在管理后台顶部显示欢迎信息
 */
function myfp_display_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>¡Bienvenido a usar “Mi primer plugin”!</p></div>';
}
add_action( 'admin_notices', 'myfp_display_admin_notice' );

Para mantener la organización del código y evitar conflictos de nombres, todos los nombres de funciones y clases deben utilizar un prefijo único, como se muestra aquí.myfp_(Abreviatura de “Mi Primer Plugin”).

Normas de organización del directorio de plugins y los archivos de recursos

Un plugin con funciones más complejas suele contener varios archivos. Una estructura de directorios adecuada puede mejorar significativamente su mantenibilidad. Las formas comunes de organizar estos archivos son las siguientes:
- /assets/Almacena recursos estáticos como CSS, JavaScript, imágenes y fuentes.
- /includes/Almacena los archivos de clases PHP esenciales y los archivos que contienen las funciones funcionales.
- /admin/Almacena archivos PHP, CSS y JS que están relacionados únicamente con el backend del administrador.
- /public/Almacena los archivos relacionados con la parte frontal ( frontend) de los sitios web.
- /languages/Almacena los archivos de traducción internacional (.po, .mo).

Recuerda siempre que el archivo principal del plugin se encuentra en la carpeta raíz del mismo. Al hacer referencia a los archivos de recursos en el código, debes utilizar el camino correcto hacia ese archivo.plugin_dir_url( FILE )oplugin_dir_path( FILE )Obtener dinámicamente la URL o la ruta del servidor correcta.

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

Mecanismo de ganchos (hooks) y interacción con las API principales

El alma del desarrollo de plugins para WordPress reside en su mecanismo de “ganchos” (Hooks), que permite que tu código se inserte y se ejecute en momentos específicos del núcleo del sistema, de los temas o de otros plugins.

Comprender los ganchos de acción (action hooks) y los ganchos de filtro (filter hooks)

Los ganchos se dividen en dos categorías principales: Acciones (Action) y Filtros (Filter). Los ganchos de acción se utilizan para ejecutar tu código cuando ocurre un evento específico, por ejemplo, después de publicar un artículo o antes de cargar una página. No devuelven ningún valor; simplemente “hacen” algo. La función central que se utiliza para esto es…add_action()Ydo_action()Los ganchos de filtro (filter hooks) se utilizan para modificar los datos. Puedes interceptar y alterar los datos antes de que sean utilizados, guardados o mostrados. Estos ganchos deben devolver un valor. La función central que se utiliza para esto es…add_filter()Yapply_filters()。

Montar funciones personalizadas en los ganchos estándar

El núcleo de WordPress ofrece cientos de ganchos (hooks) estándar. Por ejemplo, es posible agregar automáticamente una declaración de derechos de autor al final del contenido de un artículo, lo que implica el uso tanto de acciones (actions) como de filtros (filters).

Lecturas recomendadas Desarrollo de plugins para WordPress: Desde los principios hasta la maestría: Te enseñamos paso a paso a crear funciones personalizadas。

// 使用过滤器修改文章内容
function myfp_add_copyright_to_content( $content ) {
    if ( is_single() ) {
        $copyright_text = '<p><em>Por favor, indique la fuente al reproducir este contenido.</em></p>';
        $content .= $copyright_text;
    }
    return $content;
}
add_filter( 'the_content', 'myfp_add_copyright_to_content' );

// 使用动作在文章保存时执行操作
function myfp_log_post_publish( $post_id ) {
    // 记录日志或执行其他后处理
    error_log( "文章 ID {$post_id} 已发布。" );
}
add_action( 'publish_post', 'myfp_log_post_publish' );

Crear y proporcionar ganchos personalizados para la extensión.

Un plugin bien diseñado también debe permitir que otros desarrolladores lo extiendan. Puedes lograr esto creando tus propios ganchos (hooks) personalizados. Esto no solo refleja la apertura de la arquitectura de los plugins, sino que también sigue la filosofía de WordPress en sí misma.

// 定义一个自定义动作钩子
function myfp_process_data() {
    $data = '一些初始数据';
    // 其他开发者可以通过 ‘myfp_before_action’ 在此处插入代码
    do_action( 'myfp_before_action', $data );

// 插件的主要处理逻辑...

// 其他开发者可以通过 ‘myfp_after_action’ 在此处插入代码
    do_action( 'myfp_after_action', $data );
}

// 定义一个自定义过滤器钩子
function myfp_get_output() {
    $output = '默认输出';
    // 允许其他开发者过滤最终的输出
    return apply_filters( 'myfp_filter_output', $output );
}

Crear una interfaz de administración de plugins y opciones de configuración

La mayoría de los plugins requieren una interfaz de administración en el backend que permita al usuario realizar configuraciones. WordPress ofrece varias API para ayudarte a crear páginas de configuración y opciones estándar de manera rápida y 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

Gestión de opciones de seguridad mediante la API de configuración

El API de configuración de WordPress es un marco de trabajo seguro para el manejo de formularios, validación, almacenamiento y visualización de datos de opciones. Se encarga automáticamente del manejo de los campos de seguridad tipo “nonce” y de las comprobaciones de permisos. Los pasos básicos para crear una página de configuración son: 1) registrar la configuración, 2) agregar bloques de configuración y 3) agregar campos. El siguiente código demuestra cómo registrar una configuración sencilla:

function myfp_register_settings() {
    register_setting(
        'myfp_settings_group', // 选项组名
        'myfp_option_name',    // 选项名（存储在wp_options表中）
        array( 'sanitize_callback' => 'myfp_sanitize_callback' ) // 消毒回调函数
    );

add_settings_section(
        'myfp_settings_section', // 区块ID
        '基本设置',               // 区块标题
        'myfp_section_callback', // 区块回调函数（可输出描述）
        'myfp-settings-page'     // 设置页面Slug
    );

add_settings_field(
        'myfp_text_field',      // 字段ID
        '示例文本输入',         // 字段标签
        'myfp_text_field_callback', // 字段回调函数（输出HTML表单域）
        'myfp-settings-page',   // 页面Slug
        'myfp_settings_section' // 所属区块ID
    );
}
add_action( 'admin_init', 'myfp_register_settings' );

Crear páginas de menús y submenús en diferentes ubicaciones

Debes agregar el enlace a la página de configuraciones al menú de administración de WordPress. Para hacerlo, sigue estos pasos:add_menu_page()Es posible crear un menú principal y utilizarlo.add_submenu_page()Es posible crear menús secundarios.

function myfp_add_admin_menu() {
    // 添加顶级菜单
    add_menu_page(
        '我的插件设置',        // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',     // 权限能力
        'myfp-settings-page', // 菜单Slug
        'myfp_render_settings_page', // 渲染页面的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80                    // 菜单位置
    );

// 添加子菜单（指向同一个页面，但菜单标题不同）
    add_submenu_page(
        'myfp-settings-page', // 父菜单Slug
        '关于此插件',         // 页面标题
        '关于',              // 菜单标题
        'manage_options',    // 权限能力
        'myfp-about-page',   // 菜单Slug
        'myfp_render_about_page' // 渲染回调
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

Función de callback para renderizar la página de configuraciones personalizadas

myfp_render_settings_pageLa función de callback es responsable de generar la estructura HTML de la página de configuración. En esta función, es necesario realizar una llamada a…settings_fields()Ydo_settings_sections()Muestre los campos registrados mediante la API de Configuración (Settings API).

function myfp_render_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1>¿¿¿¿php echo esc_html( get_admin_page_title() ); ?&gt;</h1>
        <form action="/es/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myfp_settings_group' );
            do_settings_sections( 'myfp-settings-page' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="es"/></form>
    </div>
    ¿php?  
}

resúmenes

El desarrollo de plugins para WordPress es un proceso que convierte las ideas en funciones reales. El éxito de este proceso depende de una comprensión clara de la estructura básica del sistema, del uso hábil de los mecanismos de interacción («hooks») y de una atención constante a la seguridad y la experiencia del usuario. Desde la configuración del entorno y la redacción de los archivos principales, pasando por la integración profunda con WordPress mediante acciones y filtros, hasta la creación de interfaces de administración profesionales a través de API, cada paso sigue normas y buenas prácticas establecidas. Lo esencial es mantener el código modular, legible y extensible; utilizar prefijos únicos para evitar conflictos y dar siempre prioridad a la seguridad. Gracias al estudio y la práctica de esta guía, ya cuentas con las habilidades necesarias para crear un plugin para WordPress completo y que cumpla con los estándares establecidos.

FAQ Preguntas más frecuentes

¿Qué conocimientos de programación se necesitan para desarrollar un plugin para WordPress con el nombre ###?
Para desarrollar plugins para WordPress, es esencial contar con conocimientos básicos del lenguaje de programación PHP, incluyendo su sintaxis, funciones, arrays y conceptos de programación orientada a objetos. También es útil tener un conocimiento básico de las tecnologías front-end como HTML, CSS y JavaScript, ya que son fundamentales para la creación de plugins con interfaz de usuario. Además, ser familiarizado con las operaciones básicas de la base de datos MySQL es de gran beneficio, dado que WordPress depende en gran medida de estas bases de datos.

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

Existen varios métodos para depurar plugins. En primer lugar,wp-config.phpEl archivo se abrió en el programa.WP_DEBUGYWP_DEBUG_LOGEsto registrará los errores y advertencias de PHP en…/wp-content/debug.logEl contenido del archivo no se muestra al usuario final. En segundo lugar, se pueden utilizar las herramientas de desarrollo del navegador (como Chrome DevTools) para depurar el código JavaScript y las solicitudes de red. Para lógicas más complejas, se pueden emplear otros métodos de desarrollo y optimización.var_dump()oerror_log()La función permite enviar los valores de las variables a los registros de log o a la página. Además, instalar un depurador PHP profesional como Xdebug y integrarlo con tu editor de código te permite realizar el depurado con puntos de interrupción, lo cual es el método más eficiente para resolver problemas en el código.

¿Cómo puedo hacer que mi plugin sea internacionalizable y soporte múltiples idiomas?

Para implementar la internacionalización (i18n) en WordPress, se utilizan principalmente los recursos y herramientas que ofrece el propio framework.__()、_e()、_x()En el código del plugin, debes envolver todas las cadenas de texto que necesitan ser traducidas utilizando estas funciones, y especificar el dominio de texto (Text Domain), que se define en las notas al comienzo del plugin.Text DomainLuego, se utiliza una herramienta como Poedit para analizar el código fuente del plugin y generar lo necesario..potArchivos de plantilla: los traductores utilizan estos archivos para crear versiones del texto en diferentes idiomas..poY después de la compilación..moArchivos. Finalmente, coloque estos archivos de traducción en el plugin./languages/Se encuentra dentro del directorio y se utiliza durante la inicialización del plugin.load_plugin_textdomain()Las funciones las cargan.

¿Cómo puedo publicar mi plugin de forma gratuita en el directorio oficial de plugins de WordPress?

Para publicar un plugin en el directorio oficial de WordPress, es necesario cumplir con una serie de requisitos. En primer lugar, asegúrate de que tu plugin cumpla estrictamente con la licencia GPL v2 o una versión posterior. En segundo lugar, asegúrate de la calidad y seguridad del código, siguiendo los estándares de codificación de WordPress. A continuación, debes crear una cuenta en WordPress.org y enviar tu plugin a la sección destinada a los desarrolladores. Antes de enviarlo, asegúrate de que el plugin cuente con una documentación detallada y bien estructurada.readme.txtEl archivo está elaborado utilizando un formato Markdown específico y la internacionalización ha sido configurada correctamente. Tras su envío, el equipo de revisión de plugins lo analizará; este proceso puede durar de varios días a varias semanas. Una vez aprobado, tu plugin podrá ser buscado e instalado en el directorio oficial.