Desarrollo de plugins para WordPress: Cómo crear plugins con funciones personalizadas desde cero

¿Por qué elegir desarrollar tu propio plugin para WordPress?

En la ecosistema de WordPress, los plugins son esenciales para expandir las funcionalidades de un sitio web. Aunque el catálogo oficial y los mercados de terceros ofrecen una gran variedad de opciones, desarrollar tus propios plugins puede brindarte ventajas únicas. Cuando los plugins existentes no se adaptan perfectamente a la lógica de tu negocio, presentan problemas de rendimiento o incluyen funciones innecesarias, el desarrollo personalizado se convierte en la mejor opción. Esto te permite crear soluciones livianas y altamente específicas, que contengan solo el código necesario, lo que mejora el rendimiento del sitio web.

Lo que es más importante, los plugins personalizados ofrecen un control total sobre el funcionamiento del sistema. Puedes iterar las funcionalidades según las necesidades del proyecto, integrar sin problemas APIs internas o servicios de terceros, y asegurarte de que el código cumpla con tus estándares de seguridad y codificación. Para los desarrolladores, esto también representa una oportunidad para comprender en profundidad la arquitectura central de WordPress, incluyendo sus mecanismos internos y principios de funcionamiento.Hook(Enganchos) Son prácticas excelentes para la operación de sistemas y bases de datos. Dominar las habilidades de desarrollo de plugins significa que puedes crear soluciones verdaderamente personalizadas para cualquier proyecto de WordPress.

Construir la estructura básica de tu primer plugin

Crear un plugin para WordPress comienza con un directorio sencillo y un archivo principal. La estructura básica del plugin es la piedra angular para el desarrollo de todas las funciones futuras.

Lecturas recomendadas Aprenda a desarrollar complementos de WordPress: cree módulos de funciones personalizadas y eficientes desde cero.。

Crear el archivo principal del plugin

Todos los plugins de WordPress deben tener un archivo PHP principal que contenga ciertas notas de cabecera específicas; estas notas son clave para que WordPress reconozca el plugin. Necesitas…wp-content/pluginsCrea una nueva carpeta en el directorio, por ejemplo,my-first-pluginLuego, cree el archivo principal dentro de esa carpeta.my-first-plugin.php。

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

Las notas al principio del archivo deben contener información sobre el nombre del plugin, su descripción, la versión, el autor, etc. Aquí hay un ejemplo básico:

<?php
/**
 * Plugin Name:       我的第一个自定义插件
 * Plugin URI:        https://www.yourwebsite.com/
 * Description:       这是一个用于学习WordPress插件开发的自定义插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Después de guardar el archivo, podrás verlo y activarlo en la página de “Plugins” del panel de administración de WordPress. Aunque por el momento no tiene ninguna función, la estructura ya está lista.

Organizar el directorio de plugins y los archivos

A medida que aumentan las funcionalidades, una estructura de archivos adecuada es de vital importancia. Se recomienda separar los diferentes tipos de código en directorios subordinados, lo que facilita el mantenimiento a largo plazo. Un ejemplo típico de directorio para un plugin sencillo podría ser el siguiente:

my-first-plugin/
├── my-first-plugin.php      // 主文件，包含插件头和管理核心钩子
├── includes/                // 存放核心功能类或函数文件
│   └── class-core-functions.php
├── admin/                   // 后台相关的CSS、JS和PHP文件
│   ├── css/
│   ├── js/
│   └── admin-settings.php
├── public/                  // 前端相关的CSS、JS和PHP文件
│   ├── css/
│   ├── js/
│   └── class-public-handler.php
└── languages/               // 国际化翻译文件（.po/.mo）

En el archivo principalmy-first-plugin.phpEn esto, puedes utilizar…require_onceoinclude_onceSe pueden incorporar estos archivos modulares según sea necesario. Esta estructura separa de manera clara la lógica del backend, la presentación del frontend y las funciones principales del sistema.

Lecturas recomendadas Guía completa y sencilla para aprender a desarrollar plugins para WordPress, desde cero.。

Implementar funciones utilizando ganchos (hooks) y filtros.

La arquitectura de plugins de WordPress se basa en un sistema de ganchos (hooks) basado en eventos, y principalmente incluye:Action(Acción) yFilterLos filtros son fundamentales para el desarrollo de plugins. Comprenderlos y utilizarlos de manera efectiva es esencial para crear funciones avanzadas y mejorar la calidad del software.

Ejecutar tareas a través de ganchos de acción (action hooks).

Los ganchos de acción (action hooks) te permiten insertar tu propio código en momentos específicos del ciclo de vida de WordPress, como durante la inicialización, la carga del contenido del cabezal de la página (front-end header) o al guardar un artículo. Puedes utilizarlos para realizar tareas personalizadas o agregar funcionalidades adicionales al sistema.add_action()La función “monta” (es decir, la integra) las funciones personalizadas en estos ganchos (hook points).

Por ejemplo, si deseas agregar un aviso para los administradores en la parte superior de la pantalla de administración del sitio web, puedes hacerlo utilizando…admin_noticesEste gancho de acción: primero, defina una función en el archivo principal del plugin.my_custom_admin_noticeLuego, montarlo en el gancho.

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

\n// Define la función que muestra la notificación
function my_custom_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Mi plugin personalizado se ha activado con éxito.</p></div>'// Definición de la función 'my_custom_admin_notice'
function my_custom_admin_notice() {
    // Aquí se agregará el código que desee ejecutar cuando se active el hook 'admin_notices'.
    echo '<p>Este es un mensaje de notificación personalizado.</p>';
}
// Montaje de la función en el hook de acción 'admin_notices'
add_action( 'admin_notices', 'my_custom_admin_notice' );

Cuando WordPress llega a…admin_noticesEn este momento, se llamará automáticamente la función que has montado, lo que resultará en la emisión de una notificación. Los ganchos de acción (action hooks) se utilizan para “hacer algo” y no requieren que devuelvan un valor.

Modificar datos utilizando los ganchos (hooks) de los filtros

A diferencia de los ganchos de acción, los ganchos de filtro se utilizan para “modificar algo”. Te permiten modificar los datos que envía el núcleo de WordPress, otros plugins o temas. Puedes utilizarlos para realizar ajustes o cambios en el funcionamiento del sistema.add_filter()Se utiliza una función para aplicar un filtro.

Un ejemplo clásico es la modificación de las últimas palabras del contenido de un artículo. WordPress ofrece la posibilidad de hacerlo.the_contentLos filtros te permiten modificar el contenido de los artículos que se van a mostrar.

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

// Define la función que modifica el contenido
function append_custom_text_to_content( $content ) {
    if ( is_single() ) { // Solo se aplica a la página de un artículo individual
        $custom_text = ' '<p><em>¡Gracias por leer! Este artículo cuenta con el soporte de mi plugin.</em></p>'${$content}`;  
    if (isset($$custom_text)) {  
      ${$content}` += `\n${$custom_text}`;  
    }  
    return ${$content}`; // Es necesario devolver el contenido modificado.  
}
// Montar la función en el gancho del filtro the_content  
add_filter( 'the_content', 'append_custom_text_to_content' );

La función de filtro recibe un valor de entrada (en este caso…).$contentDespués del procesamiento, se debe devolver un valor. De esta manera, puedes modificar de manera flexible casi cualquier dato que sea procesado por WordPress.

Crear una página de configuración de administración para el plugin.

Para los plugins que requieren configuración por parte del usuario, es esencial proporcionar una página de configuración amigable en el backend. WordPress ofrece una serie de API para simplificar el proceso de creación de páginas de menú y de opciones.

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

Añadir un menú principal o un submenú

Puedes usaradd_menu_page()La función crea un menú principal independiente en el backend para el plugin, o bien lo utiliza de alguna otra manera.add_submenu_page()Colócalo como un subelemento de un menú existente (como “Ajustes”). Por lo general, para realizar esta operación es necesario realizar un montaje (mounting).admin_menuEn el gancho de acción.

El siguiente código demuestra cómo agregar una página de configuración principal sencilla:

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

A continuación, necesitas definir la función de callback.my_plugin_settings_pagePara renderizar el contenido HTML de la página.

Crear un formulario de configuración y opciones de salvado

De WordPressSettings APIProporciona métodos estandarizados para registrar, verificar y guardar configuraciones de manera segura. Esto evita el manejo directo de los datos.$_POSTLos datos han mejorado la seguridad.

En primer lugar, utiliceregister_setting()Registre un grupo de configuraciones y utilícelo.add_settings_section()Añada la región y utilízela.add_settings_field()Agregue los campos específicos. Luego, en la función de callback definida anteriormente, utilice esos campos.settings_fields()Ydo_settings_sections()Función para generar la salida de un formulario.

funcion my_plugin_settings_page() {
    // Comprobar los permisos del usuario
    si ( !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">
            <br />
        <input type="hidden" name="trp-form-language" value="es"/></form>
    </div>
    ¿php?  
}

A través deSettings APIPuedes crear fácilmente páginas de configuración que contengan cuadros de texto, menús desplegables, casillas de selección y otros tipos de campos. Todos los datos se guardarán de manera segura.wp_optionsEn la tabla, se puede acceder a los datos a través de…get_option()La función puede ser llamada en el lado del frontend o en el lado del backend.

Garantizar la seguridad y la mantenibilidad del plugin.

Es esencial crear un plugin robusto que no solo se enfoque en la implementación de sus funciones, sino que también tenga en cuenta aspectos como la seguridad, el rendimiento y la facilidad de mantenimiento en el futuro. Seguir las mejores prácticas es de vital importancia.

Validación de datos, escape y manejo inseguro de información

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 (por ejemplo…$_GET、$_POST、$_COOKIEAntes de ingresar a la base de datos o ser mostrado en la página, todo debe pasar por un proceso estricto de validación y escape.

Para los datos que se ingresan (antes de almacenarlos en la base de datos), se deben utilizar funciones de validación.sanitize_text_field()、absint()Vamos a limpiar los datos. Para el resultado que se muestra en el navegador (después de ser extraído de la base de datos), se deben utilizar funciones de escape.esc_html()、esc_attr()、esc_url()Esto se hace para prevenir ataques XSS (Cross-Site Scripting).

// Procesamiento del envío del formulario (ejemplo; generalmente se realiza en options.php mediante la API Settings)
$$user_input = isset($$_POST['my_field']) ? sanitize_text_field($$_POST['my_field']) : '';

// Mostrar en la interfaz frontal los datos obtenidos de la base de datos
echo '<div class="info">'`. esc_html( get_option( 'my_saved_option' ) ) . `'</div>';

Además, al realizar consultas en la base de datos, es necesario utilizar…$wpdbLos métodos proporcionados por la clase (por ejemplo…)$wpdb->prepare()) para prevenir inyecciones SQL.

Implementar soporte para internacionalización y localización.

Para que tu plugin pueda ser utilizado por usuarios de todo el mundo, es esencial soportar la internacionalización (i18n). Esto implica que todas las cadenas de texto dirigidas al usuario deben ser encapsuladas utilizando las funciones de traducción de WordPress.

utilizar__()Función para traducir y devolver una cadena de texto, utilizando…_e()Se trata de una función que se utiliza para traducir y generar directamente una cadena de texto. Está definida en el encabezado del plugin.Text DomainEl campo de texto debe ser idéntico al que se utiliza en este lugar.

// 错误示例：直接输出英文字符串
echo “Hello World”;

// 正确示例：可翻译的字符串
echo esc_html__( ‘Hello World’, ‘my-first-plugin’ );
// 或者
_e( ‘Hello World’, ‘my-first-plugin’ );

Luego, puedes utilizar herramientas como Poedit para extraer todas las cadenas de texto marcadas y generar lo que necesitas..potArchivo, utilizado por el traductor para crear versiones del texto en diferentes idiomas..poY.moEl archivo debe colocarse dentro del plugin.languagesDentro de la carpeta, WordPress cargará automáticamente las traducciones correspondientes según el idioma del sitio.

resúmenes

El desarrollo de plugins para WordPress es un proceso sistemático que convierte las ideas en funciones prácticas. Al crear un archivo principal que contenga las anotaciones de cabecera estándar, ya has dado el primer paso. Comprender y utilizar a fondo los ganchos de acciones (actions) y filtros (filters) es esencial para darle a tu plugin capacidad dinámica, lo que te permite intervenir de manera fluida en todos los aspectos del funcionamiento de WordPress. La interfaz de administración construida a través de la API Settings ofrece una forma sencilla y amigable para los usuarios de configurar el plugin, lo que aumenta su profesionalidad.

Durante todo el proceso de desarrollo, los principios de seguridad deben ser aplicados de manera constante, incluyendo una verificación estricta de datos, el uso adecuado de los mecanismos de escape de caracteres y operaciones de base de datos estandarizadas. Además, el soporte a la internacionalización permitirá que tu plugin sea utilizado por un público más amplio a nivel mundial. Seguir una estructura de organización de archivos clara (como separar el código del backend, el frontend y el código central) y estándares de codificación establecerá una base sólida para el mantenimiento a largo plazo y la expansión de funcionalidades del plugin. Recuerda que un buen plugin no es solo un conjunto de código que funciona, sino también una solución segura, eficiente y fácil de mantener.

FAQ Preguntas más frecuentes

¿Qué tecnologías básicas se deben dominar para desarrollar plugins para WordPress?

Es necesario que estés familiarizado con los fundamentos del lenguaje PHP, ya que el plugin está escrito principalmente en este idioma. Además, debes comprender HTML, CSS y JavaScript para construir las interfaces y la interacción entre el lado front-end y el lado back-end. Lo más importante es dominar el conjunto de conocimientos específico de WordPress, incluyendo su sistema de ganchos (Actions y Filters) y las clases de operación de la base de datos.$wpdbTambién es de gran ayuda tener un conocimiento básico de la API de configuraciones, así como de las API REST, entre otras. Además, comprender los niveles de prioridad en el funcionamiento de los temas y plugins de WordPress resulta muy útil.

¿Cómo depurar un plugin para WordPress que has desarrollado tú mismo?

En primer lugar, asegúrate de que enwp-config.phpEl archivo se abrió en el programa.WP_DEBUGEste modo mostrará directamente en la página los errores, advertencias y notificaciones de PHP. Utilízalo.error_log()Las funciones pueden escribir información en archivos de registro personalizados para rastrear variables y procesos. Para llamadas complejas a APIs Ajax o REST, se puede utilizar el panel “Red” de las herramientas de desarrollo del navegador para obtener detalles sobre las operaciones que se realizan. Además, existen muchos plugins excelentes, como “Query Monitor”, que permiten analizar en profundidad las consultas a la base de datos, la ejecución de los hooks y los puntos de estrangulamiento en el rendimiento, lo que los convierte en herramientas muy útiles para el desarrollo y la depuración.

¿Cómo publicar un plugin desarrollado en el directorio oficial de WordPress después de su finalización?

En primer lugar, debes asegurarte de que el código del plugin cumpla con los estándares de codificación y los requisitos de directorios oficiales de WordPress. Por ejemplo, debe contener un archivo de configuración estándar.readme.txtPrimero, debes crear un archivo que contenga la descripción de tu plugin. Luego, solicita una cuenta de desarrollador en WordPress.org y envía tu plugin para que sea revisado. El proceso de revisión incluirá la evaluación de la calidad del código, la seguridad, el acuerdo de licencia (que debe ser compatible con GPL) y la descripción de sus funciones, entre otros aspectos. Una vez que tu plugin sea aprobado, podrás utilizar la herramienta SVN para subir el código al repositorio oficial de SVN de WordPress. Después de eso, podrás actualizar las versiones de tu plugin a través de la interfaz de administración en el backend.

¿Cuál es la diferencia entre agregar código en los archivos functions.php de los plugins personalizados y de los temas?

Añade el código al tema actual.functions.phpLos archivos son una forma sencilla de realizar pruebas rápidas o de agregar funcionalidades específicas a un sitio web. Sin embargo, este método presenta desventajas evidentes: las funcionalidades están vinculadas al tema utilizado, por lo que se desactivan cuando se cambia de tema. Además, el código carece de una buena encapsulación y de espacios de nombres (namespaces), lo que puede provocar conflictos con otro código.

Crear un plugin independiente permite desacoplar las funciones del tema principal, asegurando que estas funcionen correctamente sin importar el tema que se esté utilizando. Los plugins cuentan con una estructura completa que facilita la organización del código, el manejo de las dependencias, la proporcionación de páginas de configuración y la actualización de manera independiente. Son la opción ideal para funciones que se planifican reutilizar, que son complejas o que necesitan ser distribuidas a otros usuarios.