Aprenda a desarrollar complementos de WordPress: construya funciones personalizadas desde cero hasta su finalización.

¿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 al mecanismo de plugins. Al desarrollar plugins personalizados, los desarrolladores pueden agregar cualquier función que sea necesaria a la plataforma principal sin tener que modificar los archivos centrales de WordPress. Esto asegura la independencia y mantenibilidad del código, ya que las funciones de los plugins se mantienen estables incluso con actualizaciones de temas o versiones de WordPress. Ya sea para satisfacer necesidades comerciales específicas, optimizar el rendimiento del sitio web o compartir soluciones en la comunidad, dominar el desarrollo de plugins es una habilidad de gran valor.

Un plugin estándar para WordPress es, en esencia, uno o más archivos PHP que se encuentran en una determinada ubicación dentro del sistema de WordPress./wp-content/plugins/Los plugins se encuentran en el directorio correspondiente y son reconocidos por WordPress a través de comentarios específicos en los cabezales de los archivos. A diferencia del desarrollo de temas, que se centra en la apariencia y el diseño, el desarrollo de plugins se enfoca en la lógica de funcionamiento, lo que permite que trabajen en conjunto con cualquier tema. Esta filosofía de separación de enfoques es la base para crear aplicaciones WordPress robustas y reutilizables.

Construye tu primera estructura de complemento.

El primer paso para comenzar a desarrollar plugins es crear la estructura de archivos correcta. Esto no solo es necesario para organizar el código, sino también para que WordPress pueda reconocer y activar el plugin.

Lecturas recomendadas Guía definitiva para el desarrollo de complementos de WordPress: crear funciones personalizadas de cero a uno.。

Crear el archivo del plugin principal

Cada plugin debe tener un archivo principal que contenga la información estándar de la cabecera del plugin. Este archivo suele llevar el nombre del mismo plugin, por ejemplo…my-first-plugin.phpLas notas en el encabezado del archivo son cruciales para que WordPress pueda leer información como el nombre del plugin, su descripción, la versión, etc.

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: 这是一个用于演示WordPress插件开发基础的自定义插件。
 * Version:     1.0.0
 * Author:      开发者名称
 * Author URI:  https://example.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 * Domain Path: /languages
 */

Coloca el archivo que contiene el código anterior en el lugar indicado./wp-content/plugins/my-first-plugin/Después de crear el directorio, podrás ver el plugin en la página de “Plugins” del panel de administración de WordPress, y podrás activarlo o desactivarlo según lo desees.Text DomainUtilizado para la internacionalización.Domain PathSe ha especificado la carpeta en la que se guardarán los archivos de idioma.

Organizar el directorio de plugins y los archivos

Para plugins sencillos, una sola archivo puede ser suficiente. Sin embargo, para plugins con funciones complejas, es esencial contar con una buena estructura de directorios. Un ejemplo típico de estructura de directorios para un plugin podría ser el siguiente:

my-advanced-plugin/
├── my-advanced-plugin.php      // 主插件文件
├── includes/                   // 核心PHP类与函数
│   ├── class-core.php
│   └── functions.php
├── admin/                      // 后台相关文件
│   ├── css/
│   ├── js/
│   └── class-admin.php
├── public/                     // 前端相关文件
├── assets/                     // 静态资源（图片、图标等）
└── languages/                  // 国际化语言文件

Esta estructura clasifica la lógica de backend, la lógica de frontend y los archivos de recursos de manera organizada, lo que hace que el código sea más fácil de gestionar y que el trabajo en equipo sea más eficiente. En el archivo principal del plugin, generalmente es necesario utilizar…require_onceoinclude_onceSe utilizan para incorporar los archivos de funciones que se encuentran en estos subdirectorios.

Comprender y utilizar las API principales: Acciones y Filtros

El núcleo del desarrollo de plugins para WordPress radica en su arquitectura basada en eventos, que se compone principalmente de…HookImplementación del sistema. Existen dos tipos de “ganchos” (hooks): los ganchos de acción (action hooks).ActionHookes para filtrosFilterSon los puentes que permiten que los plugins interactúen con el núcleo de WordPress, los temas y otros plugins.

Lecturas recomendadas Guía completa para el desarrollo de plugins para WordPress: Cómo crear funciones de extensión de alta calidad para WordPress desde cero.。

Usar ganchos de acción para ejecutar código.

Los ganchos de acción (action hooks) te permiten “insertar” tu propio código en momentos específicos durante la ejecución de WordPress. Por ejemplo, cuando se publica un artículo, cuando un usuario inicia sesión o cuando se inicializa el menú del administrador. Puedes utilizarlos para realizar diversas tareas, como personalizar la visualización de los contenidos, enviar notificaciones o ejecutar acciones automatizadas.add_action()La función monta tu función personalizada en un hook de acción específico.

Por ejemplo, si deseas mostrar algún contenido personalizado en la parte superior del sitio web, puedes agregarlo allí.wp_headEsta acción:

function myplugin_add_custom_head_content() {
    echo '<meta name="my-custom-tag" content="value">';
}
add_action( 'wp_head', 'myplugin_add_custom_head_content' );

Otro ejemplo común es la ejecución de operaciones de inicialización cuando un complemento (plugin) se activa, como la creación de tablas en una base de datos. Esto requiere que el complemento se monte (es decir, que se integre) en el sistema en el que se está ejecutando el programa.register_activation_hookEste gancho especial.

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 myplugin_activate() {
    // 执行创建数据表等初始化代码
}
register_activation_hook( __FILE__, 'myplugin_activate' );

Modificar datos utilizando los ganchos (hooks) de los filtros

Los ganchos de filtro se utilizan para modificar los datos que se transmiten en el proceso. A diferencia de los ganchos de acción, las funciones de filtro deben recibir un valor de entrada y devolver un valor modificado.add_filter()Se utiliza una función para agregar filtros.

Por ejemplo, modificar el contenido que se muestra en el título del artículo:

function myplugin_modify_post_title( $title ) {
    return '【推荐】' . $title;
}
add_filter( 'the_title', 'myplugin_modify_post_title' );

Los filtros también pueden utilizarse para modificar parámetros de consulta, elementos de menú e incluso las propias configuraciones de los plugins. Comprender y utilizar de manera experta las acciones y los filtros es clave para desarrollar plugins flexibles y con buena compatibilidad.

Lecturas recomendadas De cero a uno: Guía completa y mejores prácticas para el desarrollo de plugins para WordPress。

Crear una interfaz de administración para el plugin.

La mayoría de los plugins requieren una página de configuración que permita a los administradores del sitio web establecer las opciones deseadas. WordPress ofrece una API amplia y versátil que ayuda a los desarrolladores a crear interfaces de administración estandarizadas de manera rápida y sencilla.

Añadir menú de administración y submenúes

utilizaradd_menu_page()La función puede agregar un menú principal en la barra lateral del lado posterior de tu plugin. Necesitas proporcionar parámetros como el título de la página, el título del menú, los permisos necesarios, el alias del menú y la función de callback correspondiente.

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

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',           // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',       // 所需权限（管理员）
        'myplugin-settings',    // 菜单别名（slug）
        'myplugin_settings_page', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                      // 菜单位置
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

La función de callback correspondientemyplugin_settings_page()Se encarga de renderizar el contenido HTML de la página de configuración. Para plugins más complejos, es posible que también sea necesario utilizar otros herramientas o métodos adicionales.add_submenu_page()Vamos a agregar un menú secundario.

Usar la API de configuración para guardar la configuración

Tratar manualmente los envíos de formularios y el almacenamiento de opciones es tanto tedioso como inseguro. La API de configuraciones (Settings API) de WordPress ofrece un método seguro y estandarizado para registrar configuraciones, campos y secciones.

En primer lugar, utiliceregister_setting()Registre un conjunto de configuraciones y defina sus funciones de devolución de llamada (callbacks) para la validación.

function myplugin_register_settings() {
    register_setting(
        'myplugin_settings_group', // 设置组名，需与 settings_fields() 调用一致
        'myplugin_option_name',    // 存储在 wp_options 表中的选项名
        array( 'sanitize_callback' => 'myplugin_sanitize_input' ) // 清理回调
    );

// 添加一个设置区块
    add_settings_section(
        'myplugin_main_section',   // 区块ID
        '主要设置',                // 区块标题
        'myplugin_section_callback', // 区块介绍文本的回调函数
        'myplugin-settings'        // 所属页面的别名
    );

// 在区块中添加一个字段
    add_settings_field(
        'myplugin_text_field',     // 字段ID
        '示例文本输入',            // 字段标签
        'myplugin_text_field_callback', // 渲染字段HTML的回调
        'myplugin-settings',       // 页面别名
        'myplugin_main_section'    // 所属区块ID
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

Luego, en la función de callback de la página de configuración, utilízalo.settings_fields()、do_settings_sections()Ysubmit_button()Utiliza funciones como estas para generar el contenido de un formulario y mostrarlo en la pantalla.

Asegurarse de la seguridad y la mantenibilidad del plugin.

Desarrollar un plugin no se trata solo de implementar funcionalidades; lo más importante es asegurarse de que sea seguro, eficiente y fácil de mantener a largo plazo.

Verificación, limpieza y escape de datos.

Esta es la primera línea de defensa en materia de seguridad de los plugins. Todos los datos provenientes de los usuarios o de fuentes externas (como…)$_POST、$_GET、$_COOKIETodo debe ser procesado antes de ingresar a la base de datos o ser mostrado en la página.

• Validación: Comprobar si los datos cumplen con el formato, el tipo o el rango esperados. Utilizar funciones como, por ejemplo,filter_var()、is_email()O use expresiones regulares personalizadas.
• Limpieza (Sanitización): elimina los caracteres ilegales o peligrosos de los datos para que sean seguros. Para diferentes tipos de datos, WordPress ofrece una gran variedad de funciones de limpieza, como por ejemplo:sanitize_text_field()(Usado para texto)sanitize_email()、sanitize_key()etc.
• Escape: Al enviar datos a HTML, JavaScript, URL o atributos, es necesario escaparlos para evitar ataques de secuencias de comandos entre sitios. Para ello, se utilizan funciones como escape() o htmlspecialchars().esc_html()、esc_js()、esc_url()、esc_attr()。

Una regla de oro es: limpie lo antes posible y siempre escape los caracteres especiales (los que necesitan ser transformados en su forma legible).

Implementar internacionalización y localización

Para que tu plugin pueda ser utilizado por usuarios de todo el mundo, es esencial soportar múltiples idiomas. Esto se logra a través del framework de internacionalización de WordPress.

Primero, rodea todas las cadenas de texto que necesitan ser traducidas con los siguientes marcadores:__()(Usado para valores devueltos) o_e()(Se utiliza para mostrar directamente la función, y se especifica que está definida en la parte superior del plugin.)Text Domain。

$greeting = __( ‘Hello, world!’, ‘my-first-plugin’ );
_e( ‘Settings saved successfully!’, ‘my-first-plugin’ );

Luego, utiliza herramientas como Poedit para analizar el código del plugin y generar….pot(Plantilla) Archivo. Los traductores pueden utilizarlo como base para crear los documentos en el idioma correspondiente..poY después de la compilación..moEl archivo debe ser colocado en el directorio de los plugins./languages/En la carpeta. Finalmente, utilízalo.load_plugin_textdomain()La función carga los paquetes de idioma durante la inicialización del plugin.

resúmenes

El desarrollo de plugins para WordPress es un proceso que convierte las ideas en funciones reales, y se basa en una comprensión profunda de la arquitectura central de este sistema. Comienza con la creación de un archivo principal que contenga los encabezados de archivo estándar, continúa con la integración profunda con la plataforma mediante el potente sistema de ganchos de acciones y filtros, y finalmente se llega a la creación de interfaces de administración seguras en el backend utilizando la API de configuración. Cada paso sigue las mejores prácticas de WordPress. Además, considerar la seguridad (verificación, limpieza de datos, escape de caracteres) y la internacionalización como requisitos fundamentales del desarrollo es clave para crear plugins profesionales, fiables y de amplia aplicabilidad. Al seguir estos principios y pasos, los desarrolladores pueden crear con confianza plugins de alta calidad que satisfagan las diversas necesidades de los usuarios.

FAQ Preguntas más frecuentes

¿Qué conocimientos básicos se necesitan para desarrollar plugins para WordPress?

Para desarrollar plugins para WordPress es necesario tener conocimientos básicos del lenguaje de programación PHP, ya que los plugins se escriben principalmente en PHP. Además, es esencial tener un entendimiento básico de HTML, CSS y JavaScript para manejar la presentación y la interacción en la parte frontal del sitio web. Lo más importante es comprender la arquitectura básica de WordPress, como los temas, los plugins, los “hooks” y el funcionamiento de los ciclos de ejecución. Estar familiarizado con las operaciones básicas de la base de datos MySQL también es de gran ayuda para gestionar los datos de los plugins.

Cómo depurar un plugin de WordPress en desarrollo

ActivarWP_DEBUGEste es el primer paso para depurar el plugin.wp-config.phpEn el documento, se indicará que...define( ‘WP_DEBUG’, true );Establecer comotrueEsto mostrará errores, advertencias y notificaciones de PHP en la página. Además, es posible utilizarlo para...error_log()La función escrive información de depuración personalizada en el registro de errores del servidor. Para un depurado más avanzado, se puede considerar utilizar plugins de depuración especializados o herramientas de depuración integradas en un entorno de desarrollo integrado (IDE).

¿Cómo evitar conflictos con otros plugins al desarrollar uno propio?

Para evitar conflictos, es esencial que el código de tus plugins cuente con una buena encapsulación. Añade un prefijo único a todos los nombres de funciones, clases, variables y opciones; por ejemplo, utiliza abreviaturas o nombres específicos del plugin. Encapsula el código utilizando programación orientada a objetos (POO) dentro de clases, lo que ayudará a reducir la contaminación del espacio de nombres global. Utiliza variables globales con precaución y asegúrate de que tus funciones de callback tengan una prioridad clara. Antes de publicar el plugin, realiza pruebas exhaustivas en un entorno que contenga una variedad de plugins populares.

¿Cómo enviar un plugin que he desarrollado al directorio oficial de plugins?

En primer lugar, debes asegurarte de que tu plugin cumpla plenamente con los estándares y guías oficiales de desarrollo de plugins de WordPress. Luego, crea una cuenta en WordPress.org y envía tu paquete comprimido de plugin a través de la página de “Desarrolladores”. Tras el envío, el equipo de revisión de plugins examinará el código, su calidad, su seguridad y el acuerdo de licencia (que debe ser compatible con GPL). Una vez aprobado, tu plugin será incluido en el directorio oficial de plugins de WordPress, y podrás obtener un repositorio SVN para gestionar el código y realizar actualizaciones.