Variables globales de WordPress: qué son y cómo usarlas correctamente

Cuando desarrollamos plugins o temas para WordPress, es común encontrarnos con diferentes variables globales que este CMS pone a nuestra disposición. Estas variables nos permiten acceder rápidamente a información del entorno, del usuario, del contenido o incluso de las consultas realizadas a la base de datos.

En este artículo te explicamos cuáles son las variables globales de WordPress más importantes, para qué sirven y cómo puedes usarlas correctamente en tus desarrollos.

¿Qué son las variables globales en WordPress?

En programación, una variable global es una variable accesible desde cualquier parte del código. En el caso de WordPress, estas variables contienen objetos esenciales que forman parte del núcleo del sistema.

Por eso, conocerlas y saber cómo usarlas te puede ahorrar mucho tiempo durante el desarrollo, además de ayudarte a mantener una estructura de código más limpia y eficaz.

Principales variables globales de WordPress

$wpdb

Objeto para acceder a la base de datos de WordPress. Permite ejecutar consultas SQL personalizadas de forma segura.

<?php
global $wpdb;
$results = $wpdb->get_results( "SELECT * FROM {$wpdb->prefix}posts WHERE post_status = 'publish'" );

$post

Contiene el objeto del post actual en el loop de WordPress.

<?php
global $post;
echo $post->post_title;

$wp_query

Representa la consulta principal que WordPress realiza para cargar la página actual.

<?php
global $wp_query;
echo 'Número de posts encontrados: ' . $wp_query->found_posts;

$wp_the_query

Contiene la consulta original de WordPress antes de ser modificada (por ejemplo con query_posts()).

$wp_rewrite

Objeto que gestiona la reescritura de URLs amigables. Útil si estás registrando reglas personalizadas.

<?php
global $wp_rewrite;
print_r( $wp_rewrite->rules );

$wp

Contiene la instancia principal de WordPress, incluyendo rutas, peticiones y parámetros de consulta.

$current_user

Este objeto representa el usuario actualmente logueado en el sistema.

<?php
global $current_user;
echo 'Usuario actual: ' . $current_user->user_login;

También puedes obtener al usuario actual con wp_get_current_user(), que es más seguro.

$user_login

Contiene el nombre de usuario actual (menos usado hoy en día, se recomienda $current_user).

$comment

Almacena el comentario actual cuando se ejecuta dentro del loop de comentarios.

$pagenow

Variable con el nombre del archivo PHP actual dentro del admin de WordPress. Muy útil para condicionales en functions.php.

<?php
global $pagenow;
if ( $pagenow === 'post-new.php' ) {
    // Ejecutar algo solo al crear un nuevo post
}

$typenow

Contiene el tipo de post actual dentro del admin.

Buenas prácticas al usar variables globales en WordPress

• Siempre declara las variables con global antes de usarlas.
• Evita modificar directamente sus valores.
• Si es posible, usa funciones de WordPress como get_post() o wp_get_current_user() en lugar de depender exclusivamente de las variables globales.

Las variables globales en WordPress son herramientas muy poderosas si se usan de forma correcta. Te permiten acceder a información crítica del sistema sin complicaciones. Sin embargo, es importante no abusar de ellas y siempre tener en cuenta las buenas prácticas de desarrollo.