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:
sections/<tipo>.html.twig: el marcado de la sección más un bloque{% schema %}con su JSON.templates/<página>.json: qué secciones componen la página y en qué orden.sections/<grupo>.json: grupos reutilizables, comoheader-groupyfooter-group.
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:
| Campo | Contenido |
|---|---|
| section.id | Identificador de la instancia en el JSON de la página. |
| section.type | Tipo de sección (el nombre del archivo, sin extensión). |
| section.index | Posición dentro de la página. |
| section.location | Dónde se está renderizando: plantilla o grupo. |
| section.settings | Ajustes de la sección, con los valores por defecto del esquema ya aplicados. |
| section.blocks | Bloques 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:
| Tipo | Qué produce |
|---|---|
| text | Una línea de texto. |
| textarea | Texto largo. |
| checkbox | Booleano. El valor activo se define con value_on. |
| select | Una opción de una lista. |
| radio | Una opción, presentada como botones de radio. |
| range | Un número dentro de un rango. |
| url | Una URL. |
| image_picker | Una imagen de los archivos del tema, con límites opcionales de tamaño. |
| link_list | Un menú de enlaces de la tienda. |
| blog | Un blog de la tienda. |
| header · paragraph | No 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>- La etiqueta del wrapper se toma de
tagen el esquema, limitada adiv,section,header,footer,aside,navyarticle. - La clase base es
tiendy-section tiendy-section-<tipo>, más laclassopcional del esquema. - Los bloques llevan
data-tiendy-block-idydata-tiendy-block-typeen modo diseño. - Pedir una sección con
?section_id=<id>devuelve solo su HTML: es lo que usa el editor para refrescar sin recargar la página. - Si una sección falla al renderizar, en modo diseño se muestra el error en su lugar; fuera del editor, se registra y se omite.