Saltar al contenido

Función PHP add_rewrite_var(): Todo lo que necesitas saber

Como desarrollador de WordPress, es posible que necesites registrar una variable de consulta personalizada para usarla con reglas de reescritura. La función add_rewrite_var() es una función de la API de WordPress que te permite agregar una nueva variable de consulta a la lista de variables de consulta de reescritura reconocidas. En este artículo, analizaremos en profundidad la función add_rewrite_var() y su uso.

¿Qué es la función add_rewrite_var()?

La función add_rewrite_var() es una función de WordPress que registra una variable de consulta personalizada. Esto hace que la variable esté disponible para su uso en las reglas de reescritura de WordPress y en el análisis de consultas.

Cómo usar la función add_rewrite_var()

Usar la función add_rewrite_var() es sencillo. Acepta un solo parámetro: el nombre de la variable de consulta. A continuación se muestra la sintaxis:

Sintaxis

php
add_rewrite_var( string $name ): void

Dado que WordPress carga las funciones al principio del ciclo de vida de la solicitud, normalmente se llama a esta función dentro de una devolución de llamada vinculada a la acción init. A continuación se muestra un ejemplo de uso correcto:

Ejemplo

php
function my_custom_query_var() {
    add_rewrite_var( 'my_custom_var' );
}
add_action( 'init', 'my_custom_query_var' );

En este ejemplo, registramos una nueva variable de consulta llamada my_custom_var. Una vez registrada, puedes acceder a su valor en tu tema o plugin utilizando get_query_var( 'my_custom_var' ).

Conclusión

La función add_rewrite_var() es una herramienta útil de WordPress para registrar variables de consulta personalizadas para reglas de reescritura. Al comprender su sintaxis de un solo parámetro y la práctica adecuada de vinculación, puedes ampliar fácilmente el análisis de consultas de WordPress. Esperamos que este artículo haya sido informativo y útil para comprender la función add_rewrite_var().

Práctica

¿Qué hace la función add_rewrite_var() en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.