{
  "settings": [
    {
      "type": "text",
      "id": "heading",
      "label": "Heading",
      "default": "Hello, world!"
    },
    {
      "type": "select",
      "id": "layout",
      "label": "Layout",
      "options": [
        {
          "value": "full_width",
          "label": "Full width",
          "kiwi_extra": {
            "icon": "fa fa-arrows-alt-h"
          }
        },
        {
          "value": "contained",
          "label": "Contained",
          "kiwi_extra": {
            "icon": "fa fa-compress"
          }
        }
      ],
      "default": "full_width",
      "kiwi_extra": {
        "labeled": true
      }
    },
    {
      "type": "range",
      "id": "padding",
      "min": 0,
      "max": 100,
      "step": 5,
      "unit": "px",
      "label": "Padding",
      "default": 20
    }
  ]
}

Propriedades

type
string
required
O tipo de entrada de configuração. Tipos disponíveis:
  • checkbox - Botão de alternância booleano
  • course - Seletor de curso
  • image_picker - Seleção de imagem
  • course - Seletor de módulo
  • range - Controle deslizante numérico
  • select - Seleção de botão de alternância
  • text - Entrada de texto de linha única
id
string
required
Identificador único para a configuração. Deve ser único dentro da seção.
label
string
required
O rótulo mostrado no editor de tema para esta configuração. Pode ser traduzido usando o prefixo t: mais uma chave válida dos arquivos de tradução de schema. Mais detalhes podem ser encontrados em Locales.
default
any
Valor padrão para a configuração. O tipo depende do tipo de configuração.
info
string
Informações adicionais mostradas abaixo da configuração no editor de tema. Pode ser traduzido usando o prefixo t: mais uma chave válida dos arquivos de tradução de schema. Mais detalhes podem ser encontrados em Locales.
options
array
Para configurações de seleção, um array de opções com propriedades value, label e icon.
min
number
Para configurações de range, o valor mínimo permitido.
max
number
Para configurações de range, o valor máximo permitido.
step
number
Para configurações de range, o incremento do passo.
unit
string
Para configurações de range, a unidade a exibir (ex., “px”, “sec”).
kiwi_extra
object
Propriedades adicionais para a configuração. Atualmente suportadas:
  • hidden: valor booleano, indica se esta configuração deve ser exibida na barra de configuração do Editor de Tema
  • validations: Aplica validações a esta configuração antes de salvar. Atualmente suportadas:
    • required: Valor booleano. Se verdadeiro, esta configuração deve ser preenchida com um valor válido