Guía para principiantes en el desarrollo de plugins para WordPress: Crea tu primer plugin personalizado desde cero

Preparación del entorno de desarrollo para plugins de WordPress

Antes de comenzar a escribir el código, necesitas un entorno de desarrollo local adecuado. Se recomienda encarecidamente no desarrollar plugins directamente en servidores en línea. Un entorno de desarrollo típico para WordPress incluye software de servidor local (como XAMPP, MAMP, Local by Flywheel o Docker), un editor de código (como VS Code o PHPStorm), así como una instalación nueva de WordPress.

Debes asegurarte de que tu versión de PHP sea compatible con la versión de WordPress a la que te diriges. Por lo general, el núcleo de WordPress es compatible con varias versiones de PHP. Para el desarrollo de plugins, se recomienda utilizar PHP 7.4 o una versión más reciente, ya que ofrece un lenguaje y funciones más modernas. Además, debes activar ciertas opciones en la interfaz administrativa de WordPress.WP_DEBUGEl patrón (pattern) puede ayudarte a localizar errores rápidamente durante el proceso de desarrollo.wp-config.phpEn el archivo, encuentre y configure las siguientes constantes:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Con esta configuración, los mensajes de error se registrarán en…/wp-content/debug.logEl contenido se almacena en un archivo y no se muestra directamente en la página, lo que no afecta la experiencia del usuario en la interfaz frontal. Esta es la mejor práctica.

Lecturas recomendadas De cero a uno: Guía autoritativa y tutorial práctico para el desarrollo de plugins para WordPress。

Crea tu primer archivo de plugin.

Todos los plugins de WordPress se encuentran almacenados en…/wp-content/plugins/Está en el directorio. Cada plugin suele tener una carpeta independiente, y el nombre de la carpeta debe ser breve y reflejar la función del plugin. Ahora, vamos a crear el primer plugin.

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

Escribir el archivo principal del plugin

Dentro de la carpeta de tus plugins, es necesario crear un archivo PHP principal. El nombre de este archivo suele coincidir con el nombre de la carpeta, por ejemplo:my-first-plugin.phpEste archivo es el punto de entrada para el plugin, y debe contener una anotación de cabecera específica para el mismo. WordPress utiliza esta información metadatos para listar tu plugin en la página de administración de plugins en el backend.

<?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
 */

Después de guardar este archivo, podrás verlo en la página de “Plugins” del panel de administración de WordPress. Ahora puedes activarlo; aunque aún no tiene ninguna función real, este es un hito importante. En el encabezado del plugin…Text DomainYDomain PathSe utiliza para la internacionalización y localización, con el fin de prepararse para el futuro lanzamiento de plugins.

Seguridad y estructura básicas de los plugins

La seguridad es la principal prioridad en el desarrollo de plugins. Una práctica básica es evitar el acceso directo a los archivos de tu plugin. Podemos lograrlo agregando una comprobación para evitar dicho acceso al principio del archivo. Modifica tu archivo principal y añade el siguiente código después de las notas de cabecera del plugin:

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

Este código verifica si una constante tiene un valor correcto.ABSPATHSe verifica si el archivo ha sido definido o no; si no lo ha sido (lo que indica que alguien intentó acceder directamente al archivo PHP a través de una URL), la ejecución del script se detiene. Esta es una medida de seguridad que todos los plugins de calidad para WordPress deben contar.

Lecturas recomendadas Guía completa para el desarrollo de plugins para WordPress: Un tutorial práctico desde cero hasta la publicación en línea。

Añadir funcionalidades esenciales al plugin.

La función de los plugins es expandir las capacidades de WordPress. Aprendamos cómo agregar nuevas funcionalidades a través de dos ejemplos sencillos: crear una página de administración y agregar contenido en la interfaz frontal del sitio web.

Añada un menú de administración sencillo.

Primero, aprenderemos cómo agregar una página de menú que pertenezca a nuestro propio plugin en la interfaz de administrador del lado del servidor. Para ello, necesitaremos utilizar el sistema de “ganchos” (Hooks) de WordPress, en particular…admin_menuGanchos de acción.

Añadimos una función en el archivo principal del plugin, por ejemplo…mfp_add_admin_menuLuego, utilízalo.add_actionLa función lo monta en…admin_menuEn 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

function mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 权限要求
        'my-first-plugin',      // 菜单Slug
        'mfp_admin_page_html',  // 用于渲染页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        30                      // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

A continuación, necesitamos definir las funciones de callback que se utilizaron anteriormente.mfp_admin_page_htmlAquí está el contenido HTML de la página. Este es un ejemplo muy simple:

function mfp_admin_page_html() {
    // 再次检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1>¿¿¿¿php echo esc_html( get_admin_page_title() ); ?&gt;</h1>
        <p>¡Hola, mundo! Esta es mi primera página de administración de plugins.</p>
    </div>
    ¿php?  
}

Ahora, actualiza tu panel de administración de WordPress. Deberías ver un nuevo elemento de menú llamado “Mis plugins” en la barra de navegación de la izquierda.

Añadir texto en la parte inferior de la página frontal.

Además de administrar la parte posterior del sistema, con mucha más frecuencia necesitamos modificar la parte frontal (el código que se visualiza en el navegador). Por ejemplo, queremos agregar un texto de derechos de autor al final de todos los artículos y páginas. Esta vez vamos a utilizar…the_contentHookes para filtros.

Lecturas recomendadas Guía para principiantes en el desarrollo de plugins para WordPress: Crea tu primera extensión de funcionalidades desde cero。

Los ganchos de filtro (Filter Hooks) te permiten modificar los datos que se pasan a una función. Vamos a crear una función.mfp_add_footer_textRecibe el contenido del artículo como parámetro y agrega nuestro propio texto al final de él.

function mfp_add_footer_text( $content ) {
    // 仅对主循环中的单篇文章和页面生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $footer_text = '<p><em>Este artículo cuenta con el soporte de mi primer plugin.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'mfp_add_footer_text' );

Este código primero verifica si el entorno actual corresponde a un único artículo o página, y si se encuentra dentro del ciclo de consulta principal, con el fin de evitar la duplicación del texto en otros lugares (como herramientas auxiliares o resúmenes). A continuación, agrega un párrafo HTML que contiene la información de copyright al contenido original y lo devuelve.

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ácticas avanzadas para el desarrollo de plugins

Después de dominar los conceptos básicos, conocer algunas prácticas avanzadas puede hacer que tu plugin sea más profesional y más robusto.

Implementar opciones de plugins configurables.

Un plugin maduro suele permitir que los usuarios realicen configuraciones. WordPress ofrece una API de configuración para simplificar el proceso de creación de páginas de opciones. Esto implica registrar las configuraciones, agregar campos de configuración y organizar dichos campos en secciones específicas del plugin. Aunque es más complejo que agregar directamente páginas de menú, este enfoque gestiona automáticamente aspectos de seguridad (como la verificación de datos mediante Nonces) y el almacenamiento de los datos de los formularios.

Por lo general, almacenamos las opciones de los plugins en forma de array en WordPress.wp_optionsEn la tabla. Puedes usarlo.add_option()、get_option()Yupdate_option()Funciones para manipular los datos de tu plugin.

Usar clases para organizar el código de los plugins.

Cuando las funciones de un plugin aumentan en número, colocar todas ellas en un espacio de nombres global puede fácilmente provocar conflictos de nombres de funciones. La mejor práctica es utilizar clases PHP para encapsular las funcionalidades del plugin. Esto no solo ayuda a organizar el código de manera más eficiente, sino que también permite aprovechar las características del enfoque orientado a objetos, como la carga automática de clases, los espacios de nombres (si se utiliza PHP 5.3 o una versión posterior) y una mayor privacidad de los datos.

Un archivo principal de un plugin basado en clases podría tener el siguiente aspecto:

if ( ! defined( 'ABSPATH' ) ) exit;

class My_First_Plugin {
    public function __construct() {
        // 在构造函数中挂载所有钩子
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
    }

public function add_admin_menu() { /* ... */ }
    public function add_footer_text( $content ) { /* ... */ }
}

// 初始化插件
new My_First_Plugin();

Este método agrupa todos los métodos relacionados en una sola clase, lo que mejora significativamente la mantenibilidad del código.

resúmenes

Esta guía te ha guiado a través del proceso completo de crear un plugin personalizado para WordPress desde cero. Has aprendido cómo configurar el entorno, cómo crear una estructura de archivos segura para el plugin, cómo utilizar los ganchos de acción (action hooks) y los ganchos de filtro (filter hooks) para expandir tanto la gestión del lado backend como la visualización del lado frontend, y has comprendido los conceptos de desarrollo avanzado como el enfoque orientado a objetos y el uso de API. El corazón del desarrollo de plugins reside en la comprensión del sistema de ganchos de WordPress, que ofrece innumerables puntos de entrada que te permiten modificar el comportamiento de la plataforma sin tener que modificar el código central. La mejor forma de dominar esta habilidad es practicar constantemente, comenzando por escribir funciones sencillas y luego construyendo plugins cada vez más complejos.

FAQ Preguntas más frecuentes

¿Qué conocimientos básicos de PHP se necesitan para desarrollar plugins para ###?
Es necesario dominar la sintaxis básica de PHP, incluyendo variables, arrays, funciones, condiciones de evaluación y bucles. Lo más importante es comprender cómo interactuar con la API de WordPress, por ejemplo, cómo utilizar los ganchos (hooks).add_action, add_filterLas funciones comunes de WordPress son también de gran utilidad. El conocimiento de la programación orientada a objetos (POO) resulta de gran ayuda al desarrollar plugins complejos.

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

ActivarWP_DEBUGEl paso más crucial es establecer el patrón correcto. Consulta más detalles al respecto.wp-content/debug.logEl archivo contiene registros de errores. Además, puedes utilizar estos registros en tu código.var_dump()oerror_log()La función muestra información de depuración. Por ejemplo,error_log( print_r( $variable, true ) );Es posible registrar el contenido de cualquier variable en el archivo `debug.log`. El uso de plugins de depuración profesionales, como Query Monitor, también puede mejorar significativamente la eficiencia.

¿Puedo usar bibliotecas PHP de terceros en mi plugin?

Sí, pero se debe manejar con cuidado. Para evitar conflictos de versiones con las bibliotecas utilizadas por otros plugins o temas, se recomienda usar el herramienta de gestión de dependencias de PHP, Composer, y aprovechar su función de carga automática. Al empaquetar y publicar el plugin, puedes optar por incluir los archivos de la biblioteca en tu propio plugin (teniendo en cuenta que debes cumplir con las condiciones de su licencia), o pedir a los usuarios que instalen la dependencia por sí mismos en el servidor.

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

Necesitas acceder a WordPress.org para enviar tu plugin para su revisión. El código de tu plugin debe cumplir con los estándares y guías de codificación oficiales, como garantizar la seguridad y realizar la internacionalización (utilizando…).__()Y_e()La función incluye varios componentes (funciones) y también contiene una descripción detallada (detallada).readme.txtUna vez que el archivo sea aprobado, tu plugin estará disponible para que los usuarios de todo el mundo lo busquen e instalen.