Guía completa para el desarrollo de plugins para WordPress: Desde los fundamentos hasta la creación de funciones personalizadas

Descripción general del desarrollo de plugins para WordPress

Un plugin para WordPress es un conjunto de scripts en PHP diseñado para expandir y mejorar las funciones básicas de WordPress. Permite a los desarrolladores agregar nuevas características, herramientas, paneles de administración o modificar el comportamiento existente sin necesidad de modificar el código central de WordPress. Un plugin puede ser tan simple como un solo archivo o tan complejo como contener múltiples directorios y varios tipos de archivos.

Comprender el funcionamiento de un plugin radica en su archivo de entrada. Cada plugin debe contener al menos un archivo PHP principal, y en la parte inicial de este archivo deben proporcionarse los metadatos estándar del plugin. Estos datos son leídos por el administrador de plugins de WordPress y se muestran en la lista de plugins del backend.

Crea tu primer plugin

Crear la estructura básica de archivos.

Primero, necesitas crear el archivo de entrada para el plugin. Esto debe hacerse en el directorio de instalación de WordPress.wp-content/plugins/Dentro de la carpeta, cree una nueva carpeta, por ejemplo…my-first-pluginEn esa carpeta, cree un archivo PHP principal cuyo nombre suele ser el mismo que el de la carpeta, por ejemplo:my-first-plugin.php。

Lecturas recomendadas Desde cero: crea tu primer plugin de WordPress.。

Escribir la información de cabecera del plugin

En este archivo principal, debes agregar una nota de cabecera para el plugin que cumpla con los estándares de WordPress. Esto es clave para que el plugin sea reconocido y activado por 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

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于演示的简单插件，它将在文章内容顶部添加一行文字。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Esta nota proporciona información básica sobre el plugin. Después de guardar este archivo, podrás verlo en la página de “Plugins” del panel de administración de WordPress.

Implementar una función sencilla.

A continuación, agregaremos la función más simple a este plugin: insertar una línea de texto personalizado al principio de todo el contenido de los artículos. Para ello, podemos utilizar…the_contentEste filtro se implementa mediante un “hook” (gancho de filtro).

function myplugin_add_text_to_content( $content ) {
    $custom_text = '<p>Este texto es el saludo que se agregó con mi primer plugin.</p>';
    return $custom_text . $content;
}
add_filter( 'the_content', 'myplugin_add_text_to_content' );

Añada el código a su archivo de plugin principal.my-first-plugin.phpEn ese paso, guarda y activa el plugin. Ahora, cada vez que navegues por cualquier publicación o página del sitio web, el texto especificado aparecerá al principio del contenido. Esta es la implementación más básica de la funcionalidad de un plugin.

Conceptos centrales del desarrollo de plugins y API

Comprender el mecanismo de los ganchos (hooks)

Los “ganchos” (hooks) son esenciales en el desarrollo de plugins para WordPress, ya que permiten que tu código se integre en el flujo de ejecución del núcleo de WordPress o de otros plugins. Existen principalmente dos tipos de ganchos: las Acciones (Actions) y los Filtros (Filters).

Lecturas recomendadas ¿Cómo aprender a desarrollar complementos de WordPress desde cero? Guía completa y tutorial práctico.。

Se utiliza para ejecutar tu código personalizado en un punto en el tiempo específico. Por ejemplo,wp_footerEsta función te permite generar código HTML o scripts en la parte inferior de la página. Puedes utilizarla para añadir elementos o realizar acciones específicas según tus necesidades.add_action()Se utiliza una función para montar una acción (es decir, para asociar una acción con un evento específico).

Los filtros se utilizan para modificar los datos antes de que sean enviados a la base de datos o al navegador. Por ejemplo, los que se utilizaron en el ejemplo anterior…the_contentEl filtro te permite modificar el contenido de los artículos. Necesitas utilizarlo.add_filter()Se utiliza una función para agregar filtros, y tu función de callback debe devolver el valor modificado.

Utilizar las clases de base de datos principales

WordPress proporciona una poderosa clase de abstracción de bases de datos.wpdbSe utiliza para interactuar de manera segura con la base de datos. Deberías utilizar este objeto global directamente, en lugar de llamar las funciones de MySQL de PHP de forma directa.

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

Por ejemplo, si quieres consultar cierta información en la base de datos, puedes hacerlo de la siguiente manera:

global $wpdb;
$results = $wpdb->get_results( "SELECT id, name FROM {$wpdb->prefix}my_custom_table" );

Tenga cuidado al usarlo.$wpdb->prefixPara asegurar la corrección del prefijo de la tabla, es esencial utilizarlo en todas las operaciones de inserción, actualización o eliminación.wpdbLo proporcionado es…insert()、update()Métodos como estos manejan automáticamente la escapación de datos, lo que previene ataques de inyección SQL.

Crear la página de configuración de administración

Crear una página de configuración para los complementos es un requisito básico para un complemento profesional. WordPress ofrece diversas funciones API para agregar elementos de menú y páginas de diferentes niveles; la más utilizada es…add_menu_page() Y add_options_page()。

Lecturas recomendadas Guía práctica de WooCommerce: Cómo construir un sitio web de comercio electrónico profesional desde cero。

A continuación, se muestra un ejemplo de cómo agregar un menú principal y una página de configuraciones simples:

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',        // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',      // 所需权限
        'myplugin-settings',   // 菜单Slug
        'myplugin_settings_page', // 回调函数，用于输出页面HTML
        'dashicons-admin-generic', // 图标
        6                      // 菜单位置
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Configuraciones de mi plugin</h1>
        <form method="post" action="/es/options.php/" data-trp-original-action="options.php">
            <?php
                settings_fields( 'myplugin_settings_group' );
                do_settings_sections( 'myplugin-settings' );
                submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="es"/></form>
    </div>
    ¿php?  
}

Este ejemplo creará un menú principal llamado “Mi plugin”; al hacer clic en él, se accederá al contenido correspondiente.myplugin_settings_pagePáginas renderizadas por funciones. Por lo general, se utiliza en combinación con la API de Configuraciones (Settings API) de WordPress.register_setting, add_settings_section, add_settings_fieldSe utiliza para manejar y guardar los elementos de configuración de manera 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

Práctica en proyectos: Desarrollo de un complemento para la gestión de notas

En esta parte, combinaremos el conocimiento adquirido anteriormente para crear una sencilla función de “notas” que pueda utilizarse en la página de edición de artículos. Este complemento permite que los editores añadan notas internas y privadas a los artículos.

Crear tablas de bases de datos personalizadas

En primer lugar, cuando el complemento se active, necesitaremos crear una nueva tabla en la base de datos para almacenar las notas. Esto se puede lograr registrando un gancho de activación (activation hook).register_activation_hookPara lograrlo…

function my_note_plugin_activate() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'post_notes';
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        post_id bigint(20) NOT NULL,
        note_content text NOT NULL,
        created_by bigint(20) NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY  (id)
    ) $charset_collate;";

require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}
register_activation_hook( __FILE__, 'my_note_plugin_activate' );

Aquí, utilizamos…dbDelta()Se utiliza una función para crear o actualizar la estructura de una tabla. Este es un método seguro y compatible con la mayoría de los sistemas.

Añadir un cuadro de metadatos en la interfaz de edición del artículo.

A continuación, necesitamos agregar un cuadro meta en la página de edición del artículo para mostrar y guardar las notas. Para ello, será necesario utilizar…add_meta_boxFunción, y luego montarla en…add_meta_boxesEn términos de acción.

function my_note_add_meta_box() {
    add_meta_box(
        'my_note_meta_box',         // 元框的唯一ID
        '文章内部便签',             // 显示的标题
        'my_note_meta_box_callback', // 渲染元框内容的回调函数
        'post',                     // 要显示的帖子类型
        'side',                     // 位置
        'default'                   // 优先级
    );
}
add_action( 'add_meta_boxes', 'my_note_add_meta_box' );

function my_note_meta_box_callback( $post ) {
    // 从数据库获取当前文章的已有便签
    global $wpdb;
    $table_name = $wpdb->prefix . 'post_notes';
    $notes = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $table_name WHERE post_id = %d ORDER BY created_at DESC", $post->ID ) );

wp_nonce_field( 'my_note_save_action', 'my_note_nonce_field' );
    echo '<textarea name="my_new_note" rows="5" style="width:100%;" placeholder="Ingresa tus notas internas..."></textarea>';
    echo '<p class="description">Esta nota solo es visible para los editores y administradores del sitio web.</p>';

if ( $notes ) {
        echo '<hr><h4>Notas históricas:</h4>';
        foreach ( $notes as $note ) {
            $user = get_user_by( 'id', $note-&gt;created_by );
            $username = $user ? $user-&gt;display_name : '未知用户';
            echo '<p><strong>' . esc_html( $username ) . ' (' . $note-&gt;created_at . '):</strong><br>';
            echo nl2br( esc_html( $note-&gt;note_content ) ) . '</p>';
        }
    }
}

Guardar y limpiar datos

Cuando un artículo se guarda o se actualiza, necesitamos almacenar las nuevas notas en la base de datos. Esto se puede lograr mediante…save_postEstas acciones deben implementarse de manera correspondiente. Además, cuando el complemento se elimina (opcional), también es necesario proporcionar un mecanismo de desinstalación.register_uninstall_hookVamos a limpiar las tablas de datos que se crearon.

function my_note_save_post_data( $post_id ) {
    // 检查非ce、权限、自动保存等
    if ( ! isset( $_POST['my_note_nonce_field'] ) || ! wp_verify_nonce( $_POST['my_note_nonce_field'], 'my_note_save_action' ) ) {
        return;
    }
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }
    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }

if ( ! empty( $_POST['my_new_note'] ) ) {
        global $wpdb;
        $table_name = $wpdb->prefix . 'post_notes';

$wpdb->insert(
            $table_name,
            array(
                'post_id' => $post_id,
                'note_content' => sanitize_textarea_field( $_POST['my_new_note'] ),
                'created_by' => get_current_user_id(),
            ),
            array( '%d', '%s', '%d' )
        );
    }
}
add_action( 'save_post', 'my_note_save_post_data' );

// 可选：卸载插件时删除数据表
function my_note_plugin_uninstall() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'post_notes';
    $wpdb->query( "DROP TABLE IF EXISTS $table_name" );
}
register_uninstall_hook( __FILE__, 'my_note_plugin_uninstall' );

Mejores prácticas y preparación para el lanzamiento

Seguir los estándares de codificación de WordPress

Para garantizar la legibilidad, mantenibilidad del código y su compatibilidad con otros plugins, es esencial seguir estrictamente los estándares oficiales de codificación PHP de WordPress. Esto incluye, pero no se limita a: utilizar el indentación correcta (tabulaciones en lugar de espacios), nombrar las funciones y variables con letras minúsculas separadas por guiones bajos (formato `snake_case`), nombrar las clases con mayúsculas y guiones altos (formato `UpperCamelCase`), y utilizar funciones de internacionalización para todos los textos que puedan ser traducidos.

Implementar la internacionalización

Un plugin de calidad, que se espera sea ampliamente utilizado, debe ser compatible con la internacionalización. Esto implica que todo el texto dirigido al usuario debe estar encapsulado en funciones de traducción.

WordPress ofrece…__()、_e()、_n()Una serie de funciones… En primer lugar, es necesario configurar todo esto en la información de cabecera del plugin.Text Domain(Por ejemplo: “my-first-plugin”), y luego envolverlo (o encapsularlo) cada vez que se genere o se utilice el string.

Ejemplo:

\necho '<p>' . esc_html__( '这是一个演示文本。', 'my-first-plugin' ) . '</p>';

Luego, puedes utilizar herramientas como Poedit para extraer todo el texto y generar lo que necesitas..potArchivo, para que el traductor lo traduzca a diferentes idiomas..moY.poDocumentos.

Optimización de la seguridad y el rendimiento

La seguridad es de suma importancia en el desarrollo de plugins. Siempre se debe verificar y desinfectar (sanitizar) la información introducida por los usuarios, así como escapar (escape) los datos que se muestran. En las consultas SQL, es esencial utilizar…prepare()Se deben utilizar instrucciones específicas para prevenir inyecciones de código malicioso. Antes de realizar cualquier operación, se deben verificar los permisos del usuario.current_user_can()Para casos que no se relacionen con el protocolo CE (Common Encryption), se utiliza el mecanismo de nonces de WordPress.wp_nonce_field(), wp_verify_nonce()）。

En términos de rendimiento, es importante optimizar las consultas a la base de datos y evitar ejecutarlas dentro de bucles. Utiliza de manera adecuada la API de Transients de WordPress para almacenar datos en caché. Cuando no sea necesario utilizar los hooks de montaje (mount hooks), elimínelos de inmediato.remove_action(), remove_filter()Finalmente, asegúrese de que el directorio de plugins contenga solo los archivos necesarios, y comprese y limpie el código antes de su publicación.

Preparando la publicación en el repositorio de WordPress.

Si tienes la intención de publicar el plugin en el directorio oficial de plugins de WordPress, es necesario realizar una serie de preparativos. Asegúrate de que el plugin cuente con una descripción clara y completa.readme.txtEl archivo cumple con los estándares de WordPress. Debe contener una descripción del plugin, instrucciones de instalación, preguntas frecuentes (FAQ), registros de actualizaciones de versiones, etc. Además, asegúrate de que la información del encabezado del archivo principal del plugin sea completa y precisa. Realiza pruebas exhaustivas para comprobar la compatibilidad de tu plugin en diferentes entornos y versiones de WordPress.

resúmenes

El desarrollo de plugins para WordPress es un proceso creativo que convierte ideas en funciones poderosas. Al comprender la estructura básica de los plugins, dominar los mecanismos clave de los “ganchos” (Actions y Filters), y utilizar con habilidad la API de configuraciones (Settings API) y las operaciones de base de datos, podrás crear una gran variedad de plugins, desde herramientas sencillas hasta soluciones complejas. Durante todo el proceso de desarrollo, siempre ten en cuenta la seguridad, el rendimiento, los estándares de código y la internacionalización como pilares fundamentales. Comienza creando tu primer plugin “Hello World”, practica paso a paso, y con el tiempo serás capaz de desarrollar plugins de nivel profesional listos para su publicación en WordPress.

FAQ Preguntas más frecuentes

¿Qué tecnologías se deben dominar para el desarrollo de plugins?

Es esencial que tengas una base sólida en PHP, así como un conocimiento práctico de HTML, CSS y JavaScript. También es importante tener una comprensión básica de las bases de datos MySQL. Lo más importante de todo es que comprendas la arquitectura central de WordPress, en particular el mecanismo de ganchos (Hooks) y la jerarquía de plantillas (Template Hierarchy). El conocimiento de programación orientada a objetos (OOP) será de gran ayuda para desarrollar plugins complejos.

¿Cuál es la diferencia entre las funciones de los plugins y las funciones de los temas?

Los plugins se utilizan para agregar o modificar las funcionalidades de un sitio web y, en teoría, deberían estar separados de su apariencia visual, lo que les confiere una alta portabilidad, permitiéndoles seguir funcionando incluso después de cambiar el tema del sitio. Los temas se encargan principalmente de controlar la apariencia y el diseño del sitio web; no obstante, los temas modernos a menudo incluyen también un gran volumen de código funcional, lo cual se considera una mala práctica. La mejor práctica es la siguiente: si una funcionalidad está estrechamente relacionada con la presentación visual del sitio, puede incluirse dentro del tema; si, por el contrario, es una funcionalidad general o independiente, debería crearse como un plugin.

¿Cómo manejar las actualizaciones y la compatibilidad de los plugins?

Para procesar las actualizaciones, es necesario actualizar las notas en la parte superior del plugin.VersionPara las actualizaciones importantes, se puede considerar utilizar el mecanismo de notificación de actualizaciones de WordPress y los procedimientos de actualización correspondientes. La clave para garantizar la compatibilidad es desarrollar el código siguiendo estrictamente la API principal de WordPress, evitar el uso de funciones privadas o descontinuadas, y asegurarse de que todas las modificaciones se integren de manera adecuada con el sistema existente.readme.txtEl archivo indica claramente la versión mínima de WordPress que soporta el plugin. Antes de lanzar una nueva versión, es esencial realizar pruebas exhaustivas en varias versiones de WordPress.

¿Cómo deben cargar los plugins los archivos CSS y JavaScript?

En ningún caso se debe escribir código CSS o JS de forma directa e integrada dentro de los archivos PHP de los plugins. Para garantizar la compatibilidad y el rendimiento, es esencial utilizar la función `wp_enqueue` de WordPress para cargar correctamente los scripts y las hojas de estilo. Esto se debe hacer en el backend (es decir, en el lado del servidor).admin_enqueue_scriptsGancho, utilizado en la interfaz frontal (frontend).wp_enqueue_scriptsGancho. Usarlo.wp_enqueue_style()Ywp_enqueue_script()Funciones, y asegúrate de manejar las dependencias y los números de versión adecuadamente.

¿Cómo puedo agregar tipos de artículos personalizados o sistemas de clasificación personalizados a mi plugin?

Cómo agregar tipos de artículos personalizados (Custom Post Types, CPT)register_post_type()Función para agregar una clasificación personalizadaregister_taxonomy()Funciones. La mejor práctica es realizar estas operaciones de registro en…initSe ejecuta dentro de los ganchos de acción (action hooks). Es necesario configurar cuidadosamente el array de parámetros de registro, incluyendo la etiqueta, el nivel de publicidad, las funciones soportadas, y la existencia de una página de archivo, ya que estos determinan el comportamiento del componente tanto en el backend como en el frontend.