Plantillas de archivo

Una plantilla de archivo posee el HTML exterior de un archivo de entrada de WordPress, tipo de contenido personalizado o archivo de WooCommerce compatible. Puede combinar información del archivo, información del término de taxonomía, shortcodes y el bucle de resultados.

Crear y asignar una plantilla de archivo

Crea plantillas en Settings → POM Theme → Templates → HMTL templates → Archive HTML templates.. Completa Template name, Template HTML y cualquier selección de hoja de estilos o script requerida.

Asigna el resultado en:

  • Settings → POM Theme → Templates → Blog → Post archive, usando Sidebar layout.
  • La pestaña de archivo del tipo de contenido personalizado correspondiente en Settings → POM Theme → Templates, usando Archive layout.
  • Settings → POM Theme → E-Commerce → Storefront → Product archives, usando Archive layout.

Para los archivos de entradas de WordPress como archivos de categoría, etiqueta y fecha, Sidebar layout incluye las opciones integradas de barra lateral/contenedor y las plantillas HTML de archivo guardadas.

Región de resultados

Usa {{archive_results}} donde deben mostrarse las entradas:

<main class="directory">
    {{archive_results}}
</main>

El Results wrapper del archivo controla la disposición del bucle. Su Custom result template controla el HTML que se repite para cada entrada. Si se omite {{archive_results}}, la plantilla de archivo no tiene punto de inserción de resultados.

Orden predeterminado de resultados

Para un tipo de contenido personalizado, abre su pestaña en Settings → POM Theme → Templates y busca Default archive order. Elige Order by y Order direction, y luego guarda.

Estos ajustes se aplican al archivo del tipo de contenido y a sus archivos de taxonomía, incluidos los resultados insertados con {{archive_results}}. Elige Menu order y Ascending para seguir el orden numérico del menú de las entradas, de menor a mayor. Cada entrada debe tener ya asignado el orden previsto; seleccionar esta opción no asigna valores de orden.

Deja seleccionado WordPress default para conservar el orden nativo. Un ajuste Archive orderby específico del término puede anular el valor predeterminado del tipo de contenido; déjalo en Default para heredar el ajuste del tema.

Para comprobar el resultado, visita un archivo de taxonomía que contenga entradas con distintos valores de orden y confirma que su secuencia coincide con esos valores.

Valores de todo el archivo

{{archive_title}}

Devuelve el título del archivo actual:

<h1>{{archive_title}}</h1>

{{blogname}}

Devuelve el título del sitio actual:

<span class="site-name">{{blogname}}</span>

Valores del término de taxonomía

Identificadores

{{term_id}} devuelve el ID del término consultado.

{{parent_term_id}} devuelve el ID del padre. Su fallback opcional acepta current o un valor numérico:

<div data-term="{{term_id}}" data-parent="{{parent_term_id fallback="current"}}">

Descripción y medios

<div class="term-description">{{term_description}}</div>
<img src="{{term_thumbnail}}" alt="{{archive_title}}">
<section style="background-image:url('{{term_bg_image}}')"></section>

{{term_thumbnail}} y {{term_bg_image}} devuelven URLs, no elementos de imagen completos. Las miniaturas de categoría de producto usan la imagen de término de WooCommerce correspondiente; otras taxonomías compatibles usan sus medios de término de POM.

Para introducir los resultados con la descripción guardada de la categoría, coloca {{term_description}} antes de {{archive_results}} en el HTML del archivo. Esto conserva la plantilla de resultado seleccionada y la paginación. Si el subencabezado ya muestra el título del archivo, no añadas otro h1 en la plantilla. Con Polylang, edita la descripción en cada término traducido y verifica ambas URLs de archivo.

Color

{{term_color}} devuelve el color seleccionado para el término:

<span class="term-swatch" style="background-color:{{term_color}}"></span>

Estas etiquetas no devuelven ningún valor cuando el archivo o el término actual no proporciona los datos solicitados.

Iconos y texto traducido

{{icon family="feather" name="sliders"}}
{{translatable_string text=%%Filter results%%}}

family y name identifican el icono. text proporciona la etiqueta enviada a través de la integración de traducción activa cuando es compatible.

Shortcodes

Los shortcodes en el HTML de archivo guardado se procesan después de las etiquetas de combinación del archivo. Esto permite que un shortcode reciba un término resuelto o un valor traducido:

[web_offcanvas_content title="{{translatable_string text=%%Filters%%}}"]

Usa solo los shortcodes compatibles con el tema y los plugins activos.

Ejemplo completo

<header class="catalog-hero" style="background-image:url('{{term_bg_image}}')">
    <div class="container">
        <p class="catalog-site">{{blogname}}</p>
        <h1>{{archive_title}}</h1>
        <div class="catalog-description">{{term_description}}</div>
    </div>
</header>

<div class="catalog-toolbar">
    {{icon family="feather" name="sliders"}}
    <span>{{translatable_string text=%%Available results%%}}</span>
</div>

<main class="catalog-results">
    {{archive_results}}
</main>

Límites

  • Las plantillas de archivo no admiten bloques {{if}}.
  • Las etiquetas de elemento de feed como {{excerpt}} y {{featured_image}} pertenecen a la plantilla de feed seleccionada.
  • Las etiquetas individuales como {{content}} y {{posts_nav}} pertenecen a una plantilla individual.
  • {{archive_results}} normalmente debería aparecer una vez.
Crea una plantilla de archivo
Anterior
Etiquetas de combinación de la plantilla de archivo
Siguiente