Patrón de nombres de archivo para plantillas Twig (vistas)

Mientras creamos nuestras plantillas para Drupal solemos acudir a la consola para ver los nombres de plantillas que nos sugiere y poder maquetar correctamente y acorde al diseño.

Con las opciones de desarrollo activadas en el archivo settings.php estas sugerencias nos ayudan mucho a componer los nombres adecuados para nuestros archivos, pero Drupal no siempre nos muestra la información completa y necesitamos conocer la estructura esperada para que todo funcione correctamente.

Pattern name para las vistas

Supongamos que hemos creado una vista y ahora queremos hacer algún tipo de modificación en la forma en que se presenta el contenido de la misma...

Como todo en la vida, son muchos los caminos que llevan a Roma:

• Modificar la plantilla del tipo de contenido
• Modificar la plantilla de un tipo de "view" determinado...

En este caso, vamos a suponer que la clave para el éxito de nuestro diseño es modificar el twig de la vista.

Ver las sugerencias de Drupal

Con las opciones de desarrollo activadas en en archivo settings.php accederemos a la consola de nuestro explorador en la página que estamos maquetando.

En el código fuente, Drupal nos añade una serie de comentarios para que podamos ver que plantilla está usando y cuales podríamos usar en lugar de la que él ha tomado como referencia.

En la sección  FILE NAME SUGGESTIONS observamos las diferentes sugerencias que nos ofrece Drupal como nombres válidos para la plantilla, el marcado con una X es el que está actualmente en uso.

Seguidamente nos muestra la ruta del archivo de plantilla que está usando.

Estructura del nombre de archivo

La estructura que usa internamente Drupal para la construcción de los archivos de plantilla válidos es la siguiente:

views-view-DISPLAY_NAME--VIEWS_MACHINE_NAME--DISPLAY_MACHINE_NAME.html.twig

Desglosemos esta estructura...

• DISPLAY_NAME: es el tipo de vista usado (table, unformatted...). Si este nombre contiene guiones bajos (_) los cambiaremos por guiones medios (-).
• VIEWS_MACHINE_NAME: es el nombre de máquina que hemos asignado a la vista.
• DISPLAY_MACHINE_NAME: es el nombre del bloque, página... dentro de la vista.

En el supuesto de que no usemos el DISPLAY_MACHINE_NAME, la plantilla se usará para todos los bloques o páginas que estén definidos en la vista.

En el caso de la imagen anterior podemos ver que estamos definiendo una plantilla para la vista denominada homepage y uno de sus bloques llamado block-swiper.