Archivo de plantilla de acuerdo a url personalizada en WordPress

[ 2 septiembre 2020 ] [ Autor: Jhon Marreros Guzmán ][ Themes - Avanzado] [ ]

Recientemente se me planteó un problema, tenía que generar urls en base a parámetros, pero además que de acuerdo a esas urls personalizadas se muestre un determinado diseño e información.

Generalidades

Anteriormente habíamos visto que WordPress tiene una Jerarquia de Archivos a nivel del tema, en el cual dependiendo de la url consultada se ejecuta uno un otro archivo, sin embargo ¿qué sucede si tengo una url con parámetros, o una url que no se encuentra dentro de ese estándar?.

Resultado Final

Al final lo que queremos obtener será algo similar a lo que se muestra en la siguiente imagen:

Tal como puedes observar, estamos usando una url amigable que hace referencia a un nombre, cuando carga la página se mostrará con ese nombre como parte del contenido.

Código para mostrar archivo de plantilla de acuerdo a url

Para mostrar un contenido determinado de acuerdo a la url usaremos un archivo de plantilla.


//Sobreescritura de urls
add_action( 'init',  function() {
    add_rewrite_rule( 'nombre/([a-zA-Z ]+)[/]?$', 'index.php?nombre=$matches[1]', 'top' );
} );


//Agregar parámetros
add_filter( 'query_vars', function( $query_vars ) {
	$query_vars[] = 'nombre';
    return $query_vars;
} );

//Carga archivo de plantilla de acuerdo al parámetro
add_action( 'template_include', function( $template ) {
    if ( get_query_var( 'nombre' ) ) {
		return get_stylesheet_directory() . '/home-nombre.php';
    }
	return $template;
} );

El código anterior tiene 3 partes:

Sobreescritura de urls, este código nos permite trabajar con urls amigables en lugar de parámetros, usamos la función add_rewrite_rule(), acepta como parámetros una expresión regular para la url amigable y su correspondiente equivalencia con parámetros.
Agregar parámetros, necesitamos indicarle a WordPress con qué parámetros adicionales trabajar, para esto usamos el filtro query_vars en donde agregamos el nuevo parámetro de nombre
Carga archivo de plantilla, de acuerdo al parámetro de la url cargaremos un archivo de plantilla, usamos el hook template_include que hace referencia a una función en la cual verificamos si la url tiene un parámetro de nombre, si es así entonces cargaremos un archivo de plantilla llamado home-nombre.php

Código en el archivo de plantilla

En el archivo de plantilla, adicional al código existente, usarás un código que recupere el parámetro de la url en una variable y posteriormente la muestre, por ejemplo:

<div>
	<?php $nombre = get_query_var( 'nombre' );?>
	<h3>Hola <?php echo $nombre ?></h3>
</div>

Para la creación del archivo home-nombre.php, puedes basarte en un archivo de plantilla ya existente.

Conclusión

Tal como hemos visto, puedes crear tus propios archivos de plantillas que tengan un diseño personalizado y que se muestren sólo para determinadas url, todo esto de manera simple a través de código.

¿Aún con dudas?, en el siguiente video se detallan los puntos anteriores.