Configuración del tema
Dos archivos JSON definen la configuración: settings_schema.json describe qué se puede ajustar y settings_data.json guarda los valores de cada preset.
settings_schema.json
Es un array de grupos. Cada grupo tiene un name y una lista de settings. El primer grupo es siempre theme_info:
[
{
"name": "theme_info",
"theme_name": "Minimo"
},
{
"name": "Paleta de color",
"settings": [
{
"type": "radio",
"id": "color_palette",
"label": "Paleta de la tienda",
"default": "coral",
"options": [
{ "value": "coral", "label": "Coral (LittleLane)" },
{ "value": "laguna", "label": "Laguna" },
{ "value": "uva", "label": "Uva" }
]
}
]
},
{
"name": "Tienda",
"settings": [
{
"type": "checkbox",
"id": "native_reviews_enabled",
"label": "Mostrar las valoraciones de los productos",
"default": true,
"value_on": "1"
}
]
}
]Tipos de campo
Los nueve temas en Twig usan solo estos cinco tipos en sus esquemas:
| Tipo | Qué produce |
|---|---|
| text | Una línea de texto. |
| radio | Una opción entre varias, con options de {value, label}. |
| checkbox | Un booleano. El valor activo se escribe con value_on. |
| page | Una página de contenido de la tienda. Admite allow_empty y empty_label. |
| image_picker | Una imagen de los archivos del tema. Admite max_width y max_height. |
Claves comunes
| Clave | Efecto |
|---|---|
| id | Nombre con el que se lee el ajuste en la plantilla. |
| label | Etiqueta visible en el editor. |
| default | Valor inicial cuando el preset no lo define. |
| info | Texto de ayuda bajo el campo. |
| row_break | Fuerza salto de fila en el formulario del editor. |
| value_on | Valor que se guarda cuando un checkbox está marcado. |
| options | Lista {value, label} de un radio. |
settings_data.json y presets
Guarda los valores. La estructura es {current, presets}: current dice qué preset está activo y cada preset es un objeto de ajustes.
{
"current": "current",
"presets": {
"current": {
"color_palette": "coral",
"theme_variant": "minimo",
"logo_txt": "1",
"logo_value": "Minimo",
"native_reviews_enabled": "1"
},
"LittleLane": {
"color_palette": "coral",
"theme_variant": "littlelane",
"logo_txt": "1",
"logo_value": "LittleLane"
}
}
}Los presets son variantes completas. Al crear uno nuevo hay que copiar todas las claves que el tema lea; los ajustes ausentes no heredan del preset anterior.
Leer los ajustes
El preset activo se expone en la variable global settings. Cada clave del esquema se lee por su id:
<body data-palette="{{ settings.color_palette }}"
data-variant="{{ settings.theme_variant }}">
{% if settings.wishlist_enabled %}{% include 'snippets/icon.html.twig' with {'name': 'heart'} %}{% endif %}Tiendy añade además settings.native_reviews_enabled con la preferencia de la tienda, aunque el tema no lo declare en su esquema.
El editor de temas
El editor abre la tienda dentro del panel y trabaja sobre un borrador, no sobre el tema publicado:
- Mientras editas, los cambios no los ve nadie más: la tienda pública sigue igual hasta que publicas.
- La sección seleccionada se resalta en la vista previa y cada cambio refresca solo esa sección.
- Al guardar, los valores del formulario se escriben en
settings_data.json; los presets nuevos se crean copiando el preset actual.