# tray

Esse objeto retorna algumas configurações e integrações relacionadas a loja.

### Atributos disponíveis

| Atributos                                       | Descrição                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{{ tray.analytics}}`                           | Script de estatísticas de visitas do Google Analytics                                                                                                                                                                                                                                                                                                     |
| `{{ tray.credits }}`                            | Retorna informações de créditos da Tray **message**, **status**, **url**                                                                                                                                                                                                                                                                                  |
| `{{ tray.lang }}`                               | <p>Utiliza a regionalização já existente para retornar a linguagem utilizada. No código, adicione a variável <code>tray.lang</code> na tag <code>\<html></code>. Atualmente a variável está configurado para identificar e retornar:</p><p><strong>Inglês \[en]</strong></p><p><strong>Espanhol \[es]</strong></p><p><strong>Português \[pt]</strong></p> |
| `{{ tray.meta }}`                               | Retorna informações de meta dados configuradas na plataforma                                                                                                                                                                                                                                                                                              |
| `{{ tray.scripts }}`                            | Retorna os scripts internos da plataforma.                                                                                                                                                                                                                                                                                                                |
| `{{ tray.scripts_login }}`                      | <p>Retorna os scripts relacionados ao processo de login.<br><mark style="background-color:red;"><strong>Este atributo está depreciado e será totalmente descontinuado no segundo semestre de 2022.</strong></mark></p>                                                                                                                                    |
| `{{ tray.styles }}`                             | Retorna as folhas de estilos internas da plataforma.                                                                                                                                                                                                                                                                                                      |
| <p><code>{{ tray.paths }}</code><br></p>        | Retorna caminho dos cdns utilizados no tema **js**, **css**, **shop\_image**, **system\_image**, **theme**                                                                                                                                                                                                                                                |
| `{% tray.theme_configs.custom_theme_preview %}` | Valida se tem o item e exibe uma mensagem/texto com link para sair do modo preview do tema.                                                                                                                                                                                                                                                               |

#### Exemplo de retorno do objeto `tray`:

```php
 Array
  (
  [analytics] =>[SCRIPTS]
  [credits] => Array
      (
          [message] => Tecnologia TrayCommerce
          [status] => ATIVA
          [url] => [URL_REDIRECT]
      )
  [meta] => [META-TAGS]
  [scripts] =>[SCRIPTS]
  [styles] =>[STYLES]
  [paths] => Array
      (
          [js] => [PATH_URL]h
          [css] => [PATH_URL]
          [shop_image] =>[PATH_URL]
          [system_image] =>[PATH_URL]
          [theme] =>[PATH_URL]
      )
  )
```

## Como usar

Abaixo um exemplo da utilização do objeto `tray` para retornar os metadados na página default.  &#x20;

{% code title="Input" %}

```twig
{{ tray.analytics }} 
```

{% endcode %}

{% code title="Output" %}

```html
<script>...</script>
```

{% endcode %}

O script carregado virá com todas informações necessárias na loja.

## Como usar Modo Preview da loja

Abaixo um exemplo da utilização do atributo `{% tray.theme_configs.custom_theme_preview %}`  &#x20;

{% code title="Input" %}

```twig
{% if tray.theme_configs.custom_theme_preview %}
    <div class="mode-preview">
        <a href="/mvc/store/home/reset_opencode_preview?loja={{ store.id }}">Sair modo preview</a>
    </div>
{% endif %}
```

{% endcode %}

{% code title="Output" %}

```html
Sair do modo preview
```

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