> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# AverageRating

> Exibe a média de avaliações de um produto com estrelas e contagem de reviews.

<img src="https://mintcdn.com/yampi/aVuas9YGYMYd9zGw/images/componentes/average-rating.png?fit=max&auto=format&n=aVuas9YGYMYd9zGw&q=85&s=ce75c6aa9106e598f684a0351bec18f2" alt="" width="520" height="396" data-path="images/componentes/average-rating.png" />

O componente `AverageRating` renderiza as estrelas de avaliação e o total de reviews aprovados de um produto. Ao clicar, rola a página até a seção de avaliações. O comportamento visual muda dependendo de onde é usado: em cards de produto (`isGrid: true`) ou na página do produto.

## Uso

Em cards de produto (grade):

```twig theme={"system"}
<average-rating :product="product" :is-grid="true" />
```

Na página do produto:

```twig theme={"system"}
<average-rating :product="product" />
```

## Propriedades

| Propriedade |    Tipo   | Obrigatória | Valor padrão | Descrição                                                                                     |
| :---------- | :-------: | :---------: | :----------: | :-------------------------------------------------------------------------------------------- |
| `product`   |  `Object` |      ✅      |       —      | Objeto do produto contendo `average_reviews` e `total_approved_reviews`.                      |
| `isGrid`    | `Boolean` |      ❌      |    `false`   | Quando `true`, exibe versão compacta para uso em cards de produto (sem o texto "avaliações"). |

## Comportamentos automáticos

* **Clique:** ao clicar no componente, a página rola suavemente até a seção de avaliações do produto.
* **Preenchimento das estrelas:** cada estrela é preenchida proporcionalmente à média (suporte a meias estrelas).