Faragiri

Aprender Temas WordPress

La lista que WordPress recorre para cada tipo de página, los dos formatos de tema y el archivo que de verdad se está usando ahora mismo.

4Secciones
4Minutos
5Profundidad

Una URL, cinco candidatos

El orden en que WordPress prueba archivos para una entrada

El primer archivo que existe gana y el resto nunca se consulta, por eso agregar un archivo cambia el diseño y editar el equivocado no cambia nada.

  1. single-{tipo}-{slug}.phpUna sola entrada. Invisible en cuanto cambia el slug
  2. single-{tipo}.phpTodas las entradas de un tipo. La excepción útil
  3. single.phpCualquier entrada individual, de cualquier tipo
  4. singular.phpCompartido con las páginas. El archivo que la mayoría de los temas debería tener
  5. index.phpSiempre existe, porque un tema sin él no es un tema

Un tema de bloques recorre la misma lista con archivos .html dentro de una carpeta de plantillas. El carril es la jerarquía, no el formato del archivo, por eso un tutorial escrito para un tipo casi siempre sirve para el otro.

WordPress elige el archivo de plantilla probando una lista en orden y quedándose con el primero que existe. Para una entrada la lista es single-{tipo}-{slug}.php, luego single-{tipo}.php, luego single.php, luego singular.php, luego index.php. No hay ruteo ni registro: el nombre del archivo es el ruteo.

Lo cual quiere decir que index.php es el único archivo que un tema necesita de verdad, junto con style.css para el comentario que lo identifica. Cada archivo adicional es una excepción que intercepta la lista antes, y agregar uno es la manera de que un solo tipo de contenido se vea distinto sin tocar nada que ya funcione.

Las listas que conviene saberse de memoria

  • Una página: la plantilla elegida a mano en la propia página, luego page-{slug}.php, page-{id}.php, page.php, singular.php, index.php
  • Un archivo (archive): archive-{tipo}.php, luego archive.php, luego index.php
  • Una página no encontrada: 404.php, luego index.php
  • singular.php es el respaldo compartido entre una entrada y una página, y es el archivo que la mayoría de los temas debería tener y no tiene

Las variantes con slug o con id al principio de cada lista son la vía de escape, y conviene usarlas poco: una plantilla con el nombre del slug de una página es invisible hasta que alguien renombra la página, y ahí el diseño vuelve a su versión anterior sin avisar.

Dos datos más cierran el modelo. Un archivo de plantilla se incluye, no se llama, así que todo lo que ya está en el ámbito en ese momento queda disponible dentro: la variable global del post, la consulta y cualquier cosa que un plugin haya preparado antes. Y el bucle es explícito, no implícito, por eso una plantilla que olvida the_post() repite la misma entrada o no muestra nada.

Dos tipos de tema, y cómo distinguirlos de un vistazo

Un tema clásico es archivos PHP más functions.php, y la jerarquía de arriba es todo el modelo de ruteo. Un tema de bloques es archivos HTML dentro de una carpeta templates/ más un theme.json, y se edita desde el editor del sitio en vez de un archivo, aunque la misma jerarquía sigue aplicando con .html en lugar de .php.

La prueba cabe en un solo listado de carpeta: theme.json y templates/index.html presentes es un tema de bloques; solo index.php y functions.php es clásico. La mayoría de las plantillas que se venden a negocios pequeños en la región, encargadas a un diseñador independiente o compradas en un catálogo, siguen siendo clásicas, mientras que buena parte de los tutoriales nuevos que aparecen al buscar ya hablan del formato de bloques sin decirlo, lo que explica por qué ninguno de los pasos coincide con lo que el cliente tiene abierto.

Qué instalar para dejar de adivinar cuál plantilla corrió

Un tema hijo es la herramienta cuando el tema es de otra persona, gratis con WordPress: una carpeta con un style.css que nombra al tema padre y un functions.php propio, y cualquier plantilla que se agregue ahí gana sobre la versión del padre. Reemplaza editar el tema padre, que la próxima actualización deshace por completo, y es la convención más útil de todo WordPress.

Query Monitor nombra la plantilla que de verdad se usó en la petición actual, gratis y de código abierto. Reemplaza agregar un echo en cada archivo candidato para averiguar cuál corrió, y además dice de qué carpeta viene, si es del tema o del tema hijo.

El archivo que se edita y no cambia nada

El estancamiento es editar un archivo que no es el que se está usando. Don Ernesto vende repuestos en Xalapa y su sobrina le armó una tienda con WooCommerce; cuando quiso cambiar el precio destacado en las fichas de producto, editó single.php durante media hora sin que nada cambiara, porque el tema traía un single-product.php que ganaba antes en la lista. Nada marca error, el cambio simplemente no tiene efecto, y la reacción natural es hacer un cambio todavía más grande.

Antes de tocar nada conviene leer qué plantilla está en uso para esa URL. Es una sola línea en Query Monitor y elimina esta categoría entera de problema. Lo que las plantillas terminan llamando es Plugins, el idioma en que están escritas es PHP desde cero, y el sistema completo detrás de ambos es WordPress.

Al lado de esto

Arriba de esto