Tiendy Documentación
Plantillas

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:

TipoQué produce
textUna línea de texto.
radioUna opción entre varias, con options de {value, label}.
checkboxUn booleano. El valor activo se escribe con value_on.
pageUna página de contenido de la tienda. Admite allow_empty y empty_label.
image_pickerUna imagen de los archivos del tema. Admite max_width y max_height.

Claves comunes

ClaveEfecto
idNombre con el que se lee el ajuste en la plantilla.
labelEtiqueta visible en el editor.
defaultValor inicial cuando el preset no lo define.
infoTexto de ayuda bajo el campo.
row_breakFuerza salto de fila en el formulario del editor.
value_onValor que se guarda cuando un checkbox está marcado.
optionsLista {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: