# Páginas incorporadas

> Exiba páginas do seu site ou aplicações externas dentro da área do aluno, recebendo os dados de quem está logado.

Uma página incorporada é uma página externa (do seu site, de um formulário, de um painel próprio) exibida dentro da área do aluno, num quadro (iframe). A plataforma envia para essa página os dados do aluno logado, o que permite montar integrações sob medida.

:::aviso
Montar uma página que use os dados do aluno exige alguém da sua equipe com conhecimento técnico.
:::

## Onde usar páginas incorporadas

### Página inicial e página de boas-vindas

Em **Configurações › Páginas incorporadas** (`/dashboard/settings/embedded-pages`), seção **Área do aluno**:

- **Página inicial da área do aluno**: substitui a página inicial com as vitrines pela página que você informar.
- **Página de boas-vindas**: aparece uma única vez, na primeira entrada de cada aluno. Nas entradas seguintes, o aluno vê a página inicial normal. Administradores não veem essa página.

Informe o endereço completo, começando com `https://`, e clique em **Salvar**. Para voltar ao normal, apague o endereço e salve.

### Item no menu

Em **Configurações › Área do aluno**, na seção **Links do menu**, clique em **Adicionar link**, escolha o tipo **Página incorporada** e informe o **Endereço**. O item aparece no menu superior e abre a página dentro da área do aluno. Veja mais em [Aparência](/configuracoes/aparencia#links-do-menu).

## Dados enviados para a sua página

A plataforma acrescenta ao endereço da sua página os dados do aluno, como parâmetros GET:

| Parâmetro | Conteúdo |
|---|---|
| `cuser_id` | Código (ID) do aluno |
| `cuser_gratis` | `1` se o aluno entrou só por cadastro gratuito, sem nenhuma compra; `0` se não |
| `cuser_fname` | Primeiro nome |
| `cuser_name` | Nome completo |
| `cuser_email` | E-mail |
| `cuser_phone` | Celular |
| `cuser_avatar` | Endereço completo da foto do perfil |

Exemplo do endereço que a sua página recebe:

```
https://seusite.com.br/pagina?cuser_id=123&cuser_gratis=0&cuser_fname=Ana&cuser_name=Ana+Souza&cuser_email=ana%40exemplo.com&cuser_phone=21999999999&cuser_avatar=
```

Sua página lê esses parâmetros como faria com qualquer endereço com GET.

## Minha página não aparece

Se o quadro fica em branco ou mostra um erro, o mais comum é a hospedagem da sua página bloquear a exibição dentro de outro site. Para confirmar:

1. Na área do aluno, com a página incorporada aberta, clique com o botão direito e escolha **Inspecionar**.
2. Abra a aba **Console** e procure linhas em vermelho.
3. Mensagens com `X-Frame-Options` ou `frame-ancestors` indicam o bloqueio.

Peça à sua hospedagem (ou a quem cuida do site) para liberar a exibição em iframe para o endereço da sua plataforma, tanto o padrão (como `escola.asalahub.com`) quanto o domínio próprio, se houver.

:::info
A página precisa usar `https://`. Páginas sem HTTPS são bloqueadas pelos navegadores dentro de uma plataforma segura.
:::

## Em breve

:::embreve Página incorporada nas aulas e nas vitrines
A opção **Permitir páginas incorporadas nas aulas**, na mesma tela, e o campo de página incorporada de cada aula ainda não exibem nada para o aluno. O destino **Página incorporada** da vitrine também ainda não funciona. Por enquanto, use o item de menu.
:::