# 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

{% hint style="warning" %}
**Disponível para uso na página:** catalog
{% endhint %}

{% hint style="info" %}
**Para saber mais sobre categorias acesse:** [Cadastrar categorias](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6734145561243-Cadastrar-Categorias)
{% endhint %}

### Atributos disponíveis

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

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

{% hint style="warning" %} <mark style="color:orange;">**¹**</mark> Para saber mais sobre o termo de aceite por categoria e produto [acesse o link.](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6733439361307-Termo-de-Aceite-em-sua-loja)
{% endhint %}

## 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.

{% code title="Input" %}

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

{% endcode %}

{% code title="Output" %}

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

{% endcode %}

## Exemplo <a href="#ir-para-brinquedos" id="ir-para-brinquedos"></a>

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`.

{% code title="Input" %}

```html
{% 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 %} 
```

{% endcode %}

{% code title="Output" %}

```html
<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>
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.tray.com.br/themes/construindo-seu-template/referencias/objetos/category.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.