settings

O objeto settings é responsável por refletir algumas configurações da área administrativa e do customizador do tema.

Disponível para uso em todas as páginas. Variáveis personalizadas devem ser inseridas no arquivo settings.json para correto funcionamento.

Variáveis de configuração personalizadas

Para utilizar o objeto settings que recebe como parâmetro as variáveis definidas no arquivo settings.json, deve-se utilizar no código HTML da seguinte maneira:

{{ settings.meuparametro }}

Dessa forma é possível utilizá-lo para criar condicionais ou atribuir valores para preenchimento de informações. Exemplo:

Input

{% if settings.cor == '#000' %}
    Esta é a cor preta!
{% endif %}

{% if settings.titulo %}
    O título é {{ settings.titulo }}
{% endif %}

Output

Esta é a cor preta!

O título é Seção de destaque!

Variáveis de configuração padrões da Loja

Também é possível com o objeto settings obter o valor de configurações definidas na plataforma para utilizá-las no tema, como apresentado na tabela de atributos abaixo.

Atributos disponíveis​

Atributos	Característica
{{ settings.show_product_stock }}	Verifica se está configurado na plataforma para "Exibir quantidade do estoque na página do produto". Retorna o valor 1 quando verdadeiro.
{{ settings.purchase_limit_show_quantity }}	Verifica se está configurado para Limitação de compras por produto e se nessa limitação foi marcado para ser exibido o campo quantidade. Retorna o valor 1 quando verdadeiro.
{{ settings.show_shipping_simulator }}	Verifica se está configurado para "Exibir simulador de frete na página de produto". Retorna o valor 1 quando verdadeiro.
{{ settings.compare }}	Verifica se está configurado para "Habilitar função para comparar produtos". Retorna o valor 1 quando verdadeiro.
{{ settings.without_stock_sale }}	Verifica se está configurado para "Permitir venda com estoque igual a 0 (zero) ou negativo". Retorna o valor 1 quando verdadeiro.
{{ settings.show_reference }}	Verifica se está configurado para "Exibir campo referência nas páginas de produto e carrinho". Retorna o valor 1 quando verdadeiro.
{{ settings.show_release_date }}	Verifica se está configurado para "Exibir campo data de lançamento na página do produto". Retorna o valor 1 quando verdadeiro.
{{ settings.new_release_title }}	Exibe o texto definido no campo "Título para a data de lançamento".
{{ settings.customers_waiting }}	Verifica se está configurado para "Habilitar opção avise-me quando chegar". Retorna o valor 1 quando verdadeiro.
{{ settings.international_shipping }}	Verifica qual o tipo do envio configurado na plataforma. Retorna 1 se for "Somente internacional" e 2 caso seja "Nacional e internacional".
{{ settings.hide_warranty }}	Verifica se não está configurado para "Exibir a aba de garantia na página do produto". Retorna o valor 1 verdadeiro quando a aba não deve ser exibida.
{{ settings.show_product_warranty }}	Verifica se está configurado para "Exibir campo tempo de garantia na página do produto". Retorna o valor 1 quando verdadeiro.
{{ settings.show_related_product }}	Verifica se não está configurado para "Completar produtos relacionados com produtos semelhantes usando busca inteligente". Retorna o valor 1 quando verdadeiro.
{{ settings.variant_layout }}	Verifica qual a configuração ativa do "Layout para exibir as variações na página do produto." Valores retornados para cada opção: "Lista aberta das variações" 1 , "Lista fechada das variações" 2 , "Lista aberta, acima de 10 variações altera para lista fechada" 4.
{{ settings.show_variant_price }}	Verifica se está configurado para "Exibir preço das variações no produto". Retorna o valor 1 quando verdadeiro.
{{ settings.payment_method_option }}	Verifica qual a configuração ativa do "Modelo de exibição das formas de pagamento na página do produto (aba formas de pagamento)". Valores retornados para cada opção: "Lista Aberta" 1, "Ícones" 2.
{{ settings.mandatory_variant }}	Retorna verdadeiro caso seja obrigatório selecionar ao menos uma variação.
{{ settings.show_product_brand }}	Verifica se está configurado para "Exibir campo marca na página do produto e carrinho". Retorna o valor 1 quando verdadeiro.
{{ settings.zoom_width }}	Retorna o valor da largura do zoom definido para as imagens do Produto nas configurações.
{{ settings.zoom_height }}	Retorna o valor da altura do zoom definido para as imagens do Produto nas configurações.
{{ settings.vertical_zoom }}	Retorna o valor da "Distância Vertical da Imagem" definido para o zoom das imagens do Produto nas configurações.
{{ settings.horizontal_zoom }}	Retorna o valor da "Distância Horizontal da Imagem" definido para o zoom das imagens do Produto nas configurações.
{{ settings.zoom_position }}	Retorna o valor definido para "Posição do Zoom" nas configurações. Valores possíveis: left | rigth
{{ settings.default_image_zoom_height }}	Retorna o valor definido para "Altura da Imagem Padrão (sem zoom)" nas configurações.
{{ settings.default_image_zoom_width }}	Retorna o valor definido para "Largura da Imagem Padrão (sem zoom)" nas configurações.
{{ settings.currency }}	Verifica qual a configuração ativa da "Moeda". Valores possíveis: R$ | US$
{{ settings.history_position }}	Define onde será exibido o Histórico de Navegação na página de produto. Retorna 1 para "Exibir acima do Rodapé" e 2 para "Exibir abaixo do rodapé".
{{ settings.hottags_position }}	Retorna 1 para "Exibir abaixo do rodapé" e 2 para "Exibir acima do Rodapé".
{{ settings.social_position }}	Verifica qual a configuração ativa do "Local de apresentação" das Redes sociais. Valores retornados para cada opção: "Exibir Abaixo da foto do produto" 0, "Exibir abaixo do botão Comprar" 1.
{{ settings.show_description }}	Retorna verdadeiro caso a descrição do produto deve ser exibida.
{{ settings.currency_abbr }}	Verifica qual a Moeda ativa e exibe o código de abreviação dessa moeda. Valores possíveis: BRL | USS