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:

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

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>

Previousbreadcrumb Nextcategories

Last updated 2 years ago

Was this helpful?

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>