load_banners

Como utilizar a tag load_banners.

Banners são blocos de conteúdo dinâmicos que podem ser listados por posição usando a tag {% load_banners %}.

Com essa tag você recebe um array de banners através da variável {{ loaded_banners }}, e com parâmetro position você especifica quais banners deseja.

Para percorrer o array utilize a tag {% for %} iterando entre os banners com a variável {{ banner }}.

{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
    {{ banner }}
  {% endfor %}

Atributos do objeto

  • color: se informado na plataforma, retorna o valor hexadecimal de uma cor, para ser aplicado de acordo com o comportamento previsto pelo desenvolvedor.
{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
    <div class="cor" style="background-color:{{ banner.color }}">
  {% endfor %}
  • description: retorna um bloco de texto HTML com a descrição de um banner.
{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
    <span>{{ banner.description }}</span>
  {% endfor %}
  • external: retorna um valor booleano true/false que define se a URL do banner deve ser aberta em uma nova aba.
{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
    <a href="{{ banner.url }}" {% if menu.external %}target="_blank"{% endif %}>
      {{ banner.title }}
    </a>
  {% endfor %}
  • file_url: retorna a URL da imagem relacionada ao banner.
{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
      {% if banner.file_url %}
        <img src="{{ banner.file_url }}" alt="{{ banner.title }}" />
      {% endif %}
  {% endfor %}
  • subtitle: retorna o subtítulo do banner.

Esse é um campo opcional do formulário de criação de banners criados via Admin, e recomendamos usá-lo ao invés de title para exibir o título de um banner.

{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
      <h3>{{ banner.subtitle }}</h3>
  {% endfor %}
  • title: retorna o título do banner.

Esse é um campo obrigatório do formulário de criação de banners criados via Admin, e recomendamos utilizá-lo como identificador de localização do banner no layout da loja, e não no front.

{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
      {{ banner.title }}
  {% endfor %}
  • url: retorna a URL de destino do banner.
{% load_banners position: "posicao" %}
  {% for banner in loaded_banners %}
    <a href="{{ banner.url }}" {% if menu.external %}target="_blank"{% endif %}>
      {{ banner.title }}
    </a>
  {% endfor %}