Tiendy Documentación
Plantillas

Secciones y bloques

Una sección es un archivo de marcado con un esquema JSON incrustado. El editor de temas la coloca en la página, rellena sus ajustes y permite reordenar sus bloques sin tocar código.

Cómo funciona

El modelo sigue tres piezas:

La sección: marcado y esquema

Este es un ejemplo real y completo (sections/announcement-bar.html.twig):

{% if section.settings.text or section.settings.highlight %}
<div class="announce">
  <div class="container">
    {% if section.settings.link %}<a class="an-item" href="{{ section.settings.link }}">{% endif %}
    {% if section.settings.text %}<span class="an-item">{% translate %}{{ section.settings.text }}{% endtranslate %}</span>{% endif %}
    {% if section.settings.highlight %}
    <span class="an-sep" aria-hidden="true"></span>
    <b class="an-strong">{% translate %}{{ section.settings.highlight }}{% endtranslate %}</b>
    {% endif %}
    {% if section.settings.link %}</a>{% endif %}
  </div>
</div>
{% endif %}

{% schema %}
{
  "name": "Barra de anuncio",
  "tag": "div",
  "settings": [
    { "type": "text", "id": "text", "label": "Mensaje", "default": "Free shipping on orders over €50" },
    { "type": "text", "id": "highlight", "label": "Mensaje destacado",
      "info": "Se muestra en el color de acento, después del mensaje." },
    { "type": "url", "id": "link", "label": "Enlace" }
  ]
}
{% endschema %}

El objeto section

Dentro de la sección, section siempre trae estos campos:

CampoContenido
section.idIdentificador de la instancia en el JSON de la página.
section.typeTipo de sección (el nombre del archivo, sin extensión).
section.indexPosición dentro de la página.
section.locationDónde se está renderizando: plantilla o grupo.
section.settingsAjustes de la sección, con los valores por defecto del esquema ya aplicados.
section.blocksBloques en orden. Cada uno lleva id, type, settings y, en modo diseño, tiendy_attributes.

El JSON de la plantilla

La plantilla declara sus secciones y el orden. Los ajustes que no se indican toman el valor por defecto del esquema:

{
  "sections": {
    "hero": {
      "type": "hero",
      "settings": {},
      "blocks": {
        "note-shipping": {
          "type": "note",
          "settings": { "icon": "truck", "text": "Free shipping over $50" }
        }
      },
      "block_order": ["note-shipping"]
    },
    "featured": {
      "type": "featured-collection",
      "settings": {
        "eyebrow": "Favoritos de la casa",
        "heading": "Productos destacados",
        "products_to_show": 8
      }
    }
  },
  "order": ["hero", "featured"]
}

Si el JSON no trae order, Tiendy usa el orden de las claves de sections. Si una sección está marcada con "disabled": true, no se renderiza.

Bloques

Los bloques los define el esquema de cada sección: son sus unidades repetibles (una ventaja, un testimonio, una nota). El tipo de bloque existe solo si aparece declarado en blocks del esquema; si un bloque del JSON usa un tipo no declarado, se ignora.

"blocks": [
  {
    "type": "item",
    "name": "Ventaja",
    "settings": [
      { "type": "text", "id": "title", "label": "Título" },
      { "type": "text", "id": "text", "label": "Texto" }
    ]
  }
]

En la plantilla se recorren con un for normal. Los temas incluidos usan tipos como item, note, prop, milestone y float, y cada uno se pinta distinto.

Tipos de ajuste

Los que usan los temas incluidos en sus esquemas:

TipoQué produce
textUna línea de texto.
textareaTexto largo.
checkboxBooleano. El valor activo se define con value_on.
selectUna opción de una lista.
radioUna opción, presentada como botones de radio.
rangeUn número dentro de un rango.
urlUna URL.
image_pickerUna imagen de los archivos del tema, con límites opcionales de tamaño.
link_listUn menú de enlaces de la tienda.
blogUn blog de la tienda.
header · paragraphNo guardan valor: organizan y explican el formulario del editor.

Grupos de secciones

La cabecera y el pie son grupos: archivos JSON en sections/ con la misma forma que una plantilla. El layout los inserta con una etiqueta:

{% block theme_header %}{% sections 'header-group' %}{% endblock theme_header %}
{% block theme_footer %}{% sections 'footer-group' %}{% endblock theme_footer %}

Así, los ajustes de la cabecera se editan una vez y valen para todas las páginas.

Modo diseño y re-render

Dentro del editor, cada sección se envuelve en su etiqueta con atributos que permiten seleccionarla y actualizarla:

<div id="tiendy-section-hero"
     class="tiendy-section tiendy-section-hero"
     data-tiendy-section-id="hero"
     data-tiendy-section-type="hero"
     data-tiendy-location="template"
     data-tiendy-section-label="Hero">
  ...
</div>