category

O Objeto category é responsável por retornar a categoria atual do tema. Através dela é possível, por exemplo, fazer validações relacionadas a categoria dos produtos para criação de filtros ou exibição de informações

Disponível para uso na página: catalog

Para saber mais sobre categorias acesse: Cadastrar categorias

Atributos disponíveis

Para imprimir informações de uma categoria na página catalog, é possível utilizar o category. Segue abaixo algumas chamadas:

Atributos	Característica
{{ category.id }}	Identificador único da categoria
{{ category.name }}	Nome da categoria
{{ category.brands }}	As marcas vinculadas aos produtos da categoria são retornadas em um array.
{{ category.children }}	Subcategorias são retornadas em um array.
{{ category.parent }}	Exibe o ID da categoria mãe quando a página em execução for uma subcategoria.
{{ category.small_description }}	Exibe a descrição detalhada da categoria cadastrada no campo "Descrição para categoria".
{{ category.title }}	Titulo da Categoria (SEO) cadastrado no campo "Título da categoria (meta title)"
{{ category.link }}	URL da categoria
{{ category.order }}	Número referente a ordem de exibição da categoria segundo as configurações da loja.
{{ category.slug }}	Exibe uma string que corresponde ao trecho de URL que indica o acesso a categoria.
{{ category.has_acceptance_term }}	Retorna 1 caso a loja possua o "termo de aceite" habilitado para a categoria. ¹
{{ category.acceptance_term }}	Retorna a descrição incluída no campo "Termo de Aceite" da categoria.

¹ Para saber mais sobre o termo de aceite por categoria e produto acesse o link.

Como Usar

Dentro da página pages/catalog o objeto category pode ser usado para exibir as informações desejadas.

O código HTML abaixo mostra o nome e o ID da categoria atual em exibição.

Input

<div>
   <h4>ID: {{ category.id }}</h4>
   <h3>Categoria: {{ category.name }}</h3>
</div>

Output

<div>
   <h4>ID: 1</h4>
   <h3>Categoria: Outlet</h3>
</div>  

Exemplo

No código abaixo caso a categoria possua marcas é exibido um filtro que percorre o array category.brands em um loop para mostrar o nome de cada marca dentro da tag option.

Input

{% if category.brands %}
  <h5>Filtrar por Marcas:</h5>
  <select name="filtrar_marca">
    {% for brand in category.brands %}
      <option value="{{ brand.name }}">{{ brand.name }}</option>
    {% endfor %}
  </select>
{% endif %} 

Output

<h5>Filtrar por Marcas:</h5>
<select name="filtrar_marca">
    <option value="Exemplo A">Exemplo A</option>
    <option value="Exemplo B">Exemplo B</option>
    <option value="Exemplo C">Exemplo C</option>
    <option value="Exemplo D">Exemplo D</option>In
</select>