Categories()

A função Categories() retorna as categorias cadastradas no Painel Administrativo da loja.

Disponível em todas as páginas. Para saber mais sobre como cadastrar categorias acesse: Cadastrar Categorias

Como Usar

As requisições de categorias sempre retornarão um array de dados, veja o padrão de retorno em: categories.

Para Exibir Todas as Categorias

No código abaixo a função Categories() é atribuída a uma variável e a partir dela é executado um loop para exibir o nome de cada categoria existente.

Input

{# todas as categorias #}
<ul>
  {% set categories = Categories() %}
  {% for categorie in categories %}
    <li>{{ categorie.name }}</li>
  {% endfor %}
</ul>

Output

<ul>
    <li>Acessórios</li>
    <li>Roupas</li>
    <li>Calçados</li>
    <li>Outlet</li>
</ul>

Ao atribuir a função Categories() a variável categories ela retorna todas as categorias independente de possuírem produtos cadastrados nelas ou não.

Para Buscar determinada Categoria por ID

No código abaixo é atribuída a uma variável a função Categories() passando como parâmetro o id desejado de valor 2, e então é exibido o nome dessa categoria de id 2.

Input

{# busca o id 2: #}
{% set categoryTray = Categories( { "id": 2 } ) %}
<span>{{ categoryTray.name }}</span>    

Output

<span>Roupas</span> 

Para Exibir todas categorias em ordem ascendente

No código abaixo é atribuída a uma variável a função Categories() passando como parâmetro um objeto que define a ordem de exibição das categorias através do nome como ascendente, e então com o loop percorrendo todas categorias é exibido o nome de todas categorias ordenadas.

Input

{# todas as categorias ordenadas por nome ascendente #}
{% set myCategories = Categories({ "order": { "name": "asc" }}) %}
<ul>
  {% for category in myCategories %}
    <li>{{ category.name }}</li>
  {% endfor %}
</ul>

Output

<ul>
    <li>Acessórios</li>
    <li>Calçados</li>
    <li>Outlet</li>
    <li>Roupas</li>    
</ul>