Desarrollo de plugins de WordPress de principio a fin: una guía completa para crear un sitio web personalizado

Por qué aprender a desarrollar plugins de 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 superar las limitaciones de los temas existentes y agregar a los sitios web cualquier función que sea necesaria, desde códigos cortos y sencillos hasta sistemas de comercio electrónico complejos. Dominar las habilidades de desarrollo de plugins significa que no solo podrás satisfacer las necesidades de proyectos específicos, sino que también podrás comercializar tus soluciones y crear valor dentro de la vasta comunidad de WordPress.

En lugar de modificar directamente el tema,functions.phpEn comparación con los archivos tradicionales, utilizar plugins para encapsular funciones es una práctica más profesional y sostenible. Los plugins pueden existir de manera independiente del tema principal, lo que facilita el reutilizamiento de funciones, así como su mantenimiento y actualización de forma separada. Un plugin bien estructurado, que sigue los estándares de codificación y los principios de arquitectura de WordPress, garantiza la compatibilidad con el núcleo del sistema y con otros plugins.

Desde el punto de vista del desarrollo profesional, ya sea que se trabaje como autónomo proporcionando soluciones personalizadas para los clientes o como gerente de producto desarrollando complementos comerciales dirigidos a usuarios de todo el mundo, esta habilidad cuenta con una gran demanda en el mercado y un gran potencial para generar ingresos.

Lecturas recomendadas Dominar el desarrollo de plugins para WordPress desde cero: Creación de funciones personalizadas y extensiones。

Configura tu entorno de desarrollo de plugins

Antes de comenzar a escribir la primera línea de código, es de vital importancia establecer un entorno de desarrollo local profesional. Esto te permitirá realizar pruebas y depuraciones en un espacio seguro y aislado.

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

Configuración del entorno del servidor local

Se recomienda utilizar paquetes de software para servidores locales integrados, como Local by Flywheel, DevKinsta o XAMPP. Estos herramientas instalan de forma sencilla PHP, MySQL/MariaDB y servidores web (como Apache o Nginx). Asegúrese de que su entorno esté utilizando una versión de PHP compatible con su entorno de producción (por ejemplo, PHP 7.4 o 8.0+) y que las extensiones necesarias, como MySQLi o PDO, estén activadas.

Editor de código y herramientas de depuración

Elija un editor de código o un entorno de desarrollo integrado (IDE) potente. Visual Studio Code, PhpStorm o Sublime Text son opciones excelentes. Estos deben contar con funcionalidades como resaltado de sintaxis, sugerencias de código y integración con sistemas de control de versiones.

El depurado es un paso esencial en el proceso de desarrollo. Es crucial asegurarse de que…wp-config.phpActiva el modo de depuración de WordPress en el archivo.WP_DEBUGLos constantes se establecen entrueEsto mostrará en la pantalla errores, advertencias y notificaciones de PHP, lo que te ayudará a localizar los problemas rápidamente.

// 在 wp-config.php 中定义调试常量
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误记录到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不在前端显示错误

Iniciación del sistema de control de versiones

Desde el principio, utiliza Git para el control de versiones. Inicia un repositorio en el directorio raíz de tu plugin y crea uno nuevo….gitignoreArchivos: ignora elementos como…node_modules、vendor(También los archivos de configuración que contengan información sensible, si se utiliza Composer). Esto te ayudará a seguir los cambios en el código y a colaborar con el equipo.

Lecturas recomendadas Desde cero: Crea tu primer plugin para WordPress。

Crea tu primer plugin de WordPress.

Un plugin básico de WordPress solo necesita un archivo PHP principal, y en la parte superior de ese archivo deben incluirse las anotaciones de información del plugin que cumplan con los estándares establecidos.

Estructura del archivo principal del plugin

En tu…wp-content/pluginsEn el directorio, cree una nueva carpeta, por ejemplo…my-first-pluginDentro de esa carpeta, cree el archivo principal de PHP; el nombre del archivo suele ser el mismo que el nombre de la carpeta.my-first-plugin.php。

Abra este archivo y añada comentarios de cabecera para los plugins en la parte superior del mismo. Estos comentarios son necesarios para que WordPress reconozca los plugins.

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

<?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 el archivo, inicie sesión en la página de administración de su WordPress y vaya a la sección de “Plugins”. Allí debería ver que “Mi primer plugin” aparece en la lista de plugins. Active el plugin; aunque aún no tiene ninguna función, ya ha creado con éxito un plugin nuevo.

Implementar una función sencilla: administrar notificaciones.

Vamos a agregar la primera función real a este plugin: mostrar una notificación personalizada en la pantalla de administración. Utilizaremos la API de notificaciones de WordPress para ello.

En el archivo principal del plugin, agregue el siguiente código justo debajo de las notas de cabecera. Lo utilizaremos para...admin_noticesUtilizamos los “ganchos de acción” (Action Hooks) para mostrar nuestro contenido en posiciones específicas.

Lecturas recomendadas Guía completa para el desarrollo de complementos de WordPress: desde cero hasta tutoriales prácticos avanzados.。

// 钩子：在管理后台显示通知
add_action( 'admin_notices', 'mfp_display_admin_notice' );

/**
 * 在管理后台显示欢迎通知的函数。
 * 该函数通过 `admin_notices` 钩子被调用。
 */
function mfp_display_admin_notice() {
    // 检查当前用户是否有管理权限，避免向普通用户显示
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( '欢迎使用“我的第一个插件”！', 'my-first-plugin' ); ?></p>
    </div>
    ¿php?  
}

Explicación del código:add_action()La función utiliza nuestra función personalizada.mfp_display_admin_noticeMontar enadmin_noticesEn este gancho. Cuando WordPress llega a la zona de notificaciones en el backend, se llama a nuestra función. Dentro de la función, primero se comprueban los permisos del usuario y luego se genera una notificación en HTML que incluye un estilo de éxito y un botón para cerrarla.__()o_e()Es una buena práctica que las funciones se utilicen para la internacionalización del texto.

En profundidad: Ganchos, códigos cortos y opciones

Para desarrollar plugins con funciones avanzadas, es esencial dominar varios mecanismos de extensión clave de WordPress: los ganchos (Hooks), los códigos cortos (Shortcodes) y la API de opciones (Options).

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

Comprender y utilizar los ganchos de acciones y filtros.

Los ganchos (hooks) son la piedra angular de la arquitectura de plugins de WordPress, ya que te permiten “inyectar” tu propio código en puntos específicos del proceso de ejecución del código central del sistema. Existen dos tipos de ganchos: las Acciones (Actions) y los Filtros (Filters).

Los “ganchos de acción” (action hooks) ejecutan tu código cuando ocurre un evento específico, y no requieren que se devuelva un valor. Por ejemplo,init(Inicialización)wp_enqueue_scripts(Cargando los scripts y estilos del lado del cliente.)save_post(Al guardar el artículo…) Lo que utilizamos antes…admin_noticesEs simplemente un gancho de acción (action hook).

Los ganchos de filtro (filter hooks) se utilizan para modificar datos. Reciben un valor y esperan que se devuelva el valor modificado. Por ejemplo,the_titleLos filtros te permiten modificar la forma en que se muestra el título de los artículos.widget_textLos filtros te permiten modificar el texto contenido en los componentes (widgets).

// 使用过滤器修改文章标题
add_filter( 'the_title', 'mfp_modify_post_title' );
function mfp_modify_post_title( $title ) {
    if ( ! is_admin() && in_the_loop() ) {
        return '📢 ' . $title;
    }
    return $title;
}

Crear y usar códigos cortos.

Los códigos cortos permiten a los usuarios acceder a funciones específicas mediante una etiqueta sencilla (como…)[my_shortcode]Inserir contenido dinámico en un artículo o página. Utilizar…add_shortcode()Función para registrar códigos cortos.

// 注册一个短代码
add_shortcode( 'mfp_current_time', 'mfp_render_current_time_shortcode' );
/**
 * 渲染显示当前时间的短代码。
 * @param array $atts 短代码属性。
 * @param string $content 短代码包裹的内容（如果有）。
 * @return string 渲染后的HTML。
 */
function mfp_render_current_time_shortcode( $atts = [], $content = null ) {
    // 使用 shortcode_atts 设置默认属性并合并用户输入
    $atts = shortcode_atts( [
        'format' => 'Y-m-d H:i:s',
    ], $atts, 'mfp_current_time' );

// 根据格式获取当前时间
    $current_time = date( $atts['format'] );

// 返回输出
    return '<p class="mfp-time">Hora actual: '. esc_html($current_time).'</p>';
}

Los usuarios pueden ingresar texto en el editor.[mfp_current_time format="F j, Y"]Muestra la hora en un formato especificado.

Utilizar la API de opciones para almacenar configuraciones.

Los plugins suelen necesitar guardar cierta información de configuración. WordPress ofrece la API Options para realizar esto.wp_optionsAlmacenar, recuperar y actualizar datos de manera segura en una tabla.

utilizaradd_option()、get_option()、update_option()Ydelete_option()Existen funciones para manipular datos. Con el fin de mantener una claridad organizativa, se recomienda agregar un prefijo común a los nombres de todos los botones o opciones.

// 定义默认选项
define( 'MFP_DEFAULT_MESSAGE', '你好，世界！' );

// 插件激活时设置默认选项（需要注册激活钩子）
register_activation_hook( __FILE__, 'mfp_set_default_options' );
function mfp_set_default_options() {
    if ( false === get_option( 'mfp_custom_message' ) ) {
        add_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
    }
}

// 在代码中获取选项值
$message = get_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
echo esc_html( $message );

Construir plugins profesionales: seguridad, gestión y publicación

A medida que las funciones de los plugins se vuelven más complejas, es necesario considerar la organización del código, la seguridad, la interfaz de usuario y el proceso de publicación.

Seguir las mejores prácticas de seguridad.

La seguridad es la línea de vida en el desarrollo de plugins. El principio fundamental es: nunca confíes en los datos introducidos por los usuarios. Verifica, limpia y escape todos los datos provenientes de los usuarios, la base de datos o API externas.
* 验证（Validation）：检查数据是否符合预期格式（如是否是邮箱、数字），使用filter_var()、preg_match()O funciones de WordPress comois_email()。
* 清理（Sanitization）：清理数据，移除不安全字符。对于文本输入，使用sanitize_text_field()Para el contenido HTML, se utiliza…wp_kses_post()En cuanto a las URL, se utiliza…esc_url_raw()。
* 转义（Escaping）：在将数据输出到HTML、JavaScript或URL时，根据上下文进行转义。使用esc_html()、esc_attr()、esc_js()、esc_url()y otras funciones.
* 非ce验证：所有可能修改数据库的操作（如表单提交）都必须包含非ce验证，使用wp_nonce_field()、wp_verify_nonce()。

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

Para los plugins que requieren configuración por parte del usuario, es esencial proporcionar una página de administración clara y sencilla. WordPress ofrece una API de configuración que simplifica este proceso, ya que se encarga automáticamente de la verificación de autenticación (no basada en el protocolo CE), el control de permisos y el almacenamiento de datos.

Necesitas utilizar…add_options_page()oadd_menu_page()Agregue una página para las funciones correspondientes y luego utilízalas.register_setting()、add_settings_section()Yadd_settings_field()Vamos a definir los campos de configuración.

Organizar el código y preparar la publicación

No acumules todo el código en el archivo principal. A medida que aumente el número de plugins, deberás dividir el código en módulos funcionales y almacenarlos en archivos separados. Una estructura de directorios típica podría incluir:
* /adminAlmacena el código relacionado con el backend (páginas de configuración, etc.).
* /publicAlmacena el código relacionado con la parte frontal (frontend) del sitio web.
* /includesAlmacena las clases y funciones relacionadas con las funciones esenciales del sistema.
* /assetsAlmacena CSS, JavaScript e imágenes.
* /languages: Almacenar archivos de traducción internacionales (.po/.mo).

utilizarrequire_onceoinclude_onceIntroduce estos archivos en los lugares apropiados. Considera utilizar Composer para gestionar las dependencias de PHP, y NPM/Yarn para gestionar los recursos frontales.

Antes de publicar tu plugin, asegúrate de que cumpla con las instrucciones del Manual de Desarrollo de Plugins y con los Estándares de Codificación oficiales de WordPress. Utiliza herramientas como PHP_CodeSniffer para realizar verificaciones. Escribe el código de manera clara y comprensible.readme.txtArchivo: Descripción detallada de las funciones, pasos de instalación, capturas de pantalla y registros de actualizaciones.

resúmenes

El desarrollo de plugins para WordPress es un proceso que comienza con la comprensión de la arquitectura básica (archivos de los plugins, ganchos, hooks), avanza hacia conceptos más avanzados (códigos cortos, API de opciones) y, finalmente, conlleva a un desarrollo más profesional (seguridad, arquitectura, publicación de los plugins). Partiendo de la creación de un plugin sencillo como “Hello World”, puedes ir añadiendo funcionalidades como notificaciones en el backend, códigos cortos y opciones de configuración, dominando así de manera sistemática todo el proceso de desarrollo. Recuerda que escribir código seguro, eficiente y fácil de mantener, así como seguir las normas y mejores prácticas de la comunidad de WordPress, es clave para crear plugins de éxito. El aprendizaje continuo, la lectura de la documentación oficial y el estudio del código fuente de plugins de calidad te ayudarán a mejorar tus habilidades y a pasar de ser un principiante a un experto.

FAQ Preguntas más frecuentes

¿Es necesario dominar PHP para desarrollar plugins para ###?
Sí, es esencial tener una base sólida en PHP, ya que el núcleo de WordPress y sus plugins están escritos en este lenguaje. Debes comprender conceptos como la sintaxis de PHP, las funciones, los arrays y la programación orientada a objetos. Además, es crucial tener un conocimiento básico de HTML, CSS y JavaScript para crear las interfaces frontales y la interacción de los plugins.

¿Cuál es la diferencia entre los archivos functions.php de los plugins y los temas?

Coloca el código de las funciones dentro del tema.functions.phpEn el archivo, dicha función está vinculada al tema seleccionado. Cuando cambies de tema, estas funciones dejarán de funcionar. Por otro lado, los plugins son módulos independientes del tema y su funcionamiento se mantiene en cualquier tema activo, lo que facilita su reutilización, mantenimiento y distribución. Para funciones que se destinan a ser utilizadas a largo plazo o a ser compartidas con otros, se recomienda priorizar el desarrollo de plugins.

¿Cómo depuro el código de mi plugin?

Activar el modo de depuración de WordPress es el primer paso más importante. Esto se puede hacer a través de la configuración correspondiente.WP_DEBUGUtiliza constantes relacionadas para mostrar los errores.error_log()La función registra la información de las variables en el registro de errores del servidor.debug.logEl archivo contiene la información necesaria. Además, se pueden instalar complementos de depuración profesionales, como Query Monitor, que proporcionan detalles sobre consultas a la base de datos, hooks y scripts, convirtiéndose en una herramienta muy útil para los desarrolladores.

¿Cómo puedo implementar la internacionalización en múltiples idiomas para mi plugin?

WordPress utiliza el framework GNU gettext para implementar la internacionalización. En tu plugin, debes utilizar las funciones de traducción para todos los textos dirigidos al usuario.()、_e()、esc_html()Espere y especifique el dominio de texto (Text Domain). Luego, utilice herramientas como Poedit para analizar el código del plugin y generar lo necesario..potArchivos de plantilla: los traductores utilizan estos archivos para crear versiones del mismo contenido en diferentes idiomas..poY.moEl archivo debe colocarse dentro del plugin./languagesPuede colocarlo directamente en el directorio.