# pages

Contém informações das páginas da loja, como por exemplo a página atual e as paginas personalizadas.

{% hint style="info" %}
**Disponível em todas as páginas.**

[**Clique aqui para saber mais sobre Páginas Institucionais (Extras).**](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6735669122971-Institucional-P%C3%A1ginas-Internas)
{% endhint %}

### Atributos disponíveis

| Atributos             | Característica                                              |
| --------------------- | ----------------------------------------------------------- |
| `{{ pages.current }}` | Em qual página o usuário está navegando, ex: home           |
| `{{ pages.custom }}`  | Páginas Personalizadas cadastradas no Painel Administrativo |

Em paginas personalizadas é retornado o **slug** "uma string que corresponde ao trecho de URL que indica o acesso a determinada página da loja".

#### Retornos possíveis do Objeto `pages.current`

| Páginas retornadas no pages.current | Descrição                                                 |
| ----------------------------------- | --------------------------------------------------------- |
| home                                | Página inicial da loja                                    |
| search                              | Página de busca                                           |
| catalog                             | Página de catálogo (categoria)                            |
| product                             | Página de produto                                         |
| checkout\_cart                      | Carrinho de compras                                       |
| register                            | Página de cadastro                                        |
| login                               | Página de login                                           |
| checkout\_payment                   | Página para escolha de pagamento na finalização de compra |
| company                             | Quem somos                                                |
| map                                 | Mapa do site                                              |

Com os valores retornados pelo `pages.current` é possível, por exemplo, validar a exibição de informações especificas para cada página.

## Como Usar

Abaixo alguns exemplos de como utilizar o objeto `pages`.

### Verificando a página atual

A chamada do objeto no código HTML para verificar qual a página atual da navegação do usuário, deve seguir como o formato básico abaixo:

{% code title="Input" %}

```html
{% if pages.current == 'home' %}
  <h4>Você está na nossa página inicial, navegue na nossa loja!</h4>
{% endif %}
```

{% endcode %}

{% code title="Output" %}

```html
<h4>Você está na nossa página inicial, navegue na nossa loja!</h4>
```

{% endcode %}

### Exibir páginas customizadas

A chamada do objeto no código HTML para exibir o nome e o link das páginas customizadas existentes, deve seguir como o formato básico abaixo:

{% code title="Input" %}

```html
<h3>{{ Translation('institucional') }}</h3>
<ul class="links-list">
    {% for custom in pages.custom %}
        <li>
            <a href="{{ custom.url }}">{{ custom.name }}</a>
        </li>
    {% endfor %}
</ul>
```

{% endcode %}

{% code title="Output" %}

```html
<h3>Institucional</h3>
<ul class="links-list">
        <li>
            <a href="www.sualoja/sobre-a-loja">Sobre a Loja</a>
        </li>
        <li>
            <a href="www.sualoja/como-comprar">Como comprar</a>
        </li>
        <li>
            <a href="www.sualoja/seguranca">Segurança</a>
        </li>
</ul>
```

{% 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/pages.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.