# Páginas incorporadas

> Uma página sua dentro da área do aluno: a página inicial, a de boas-vindas do primeiro acesso e a página nas aulas, com os dados do aluno que ela recebe.

Uma página incorporada é uma página do seu site, ou de uma aplicação sua, que aparece dentro da área do aluno. O aluno vê a página sem sair da plataforma. Em **Configurações > Páginas incorporadas** você escolhe três coisas: a página que substitui a tela inicial da área, a página da primeira entrada do aluno e se as aulas podem ter uma página incorporada.

## Como funciona

A Cademí abre a sua página num quadro dentro da área do aluno. O menu e o visual da plataforma ficam em volta. A página continua no seu servidor: a Cademí não copia nem muda o conteúdo dela.

**A regra mais importante:** a sua página precisa aceitar aparecer dentro de outro site. Se ela não aceita, o quadro fica em branco. Veja **Bom saber**.

Uma página incorporada pode entrar em vários lugares da área do aluno:

| Onde | Como se configura |
|---|---|
| A tela inicial da área | **Página inicial da área do aluno**, nesta tela |
| A primeira entrada do aluno | **Página de boas-vindas**, nesta tela |
| Abaixo do conteúdo de uma aula | **Permitir páginas incorporadas nas aulas**, nesta tela, e o campo **Página incorporada** em cada aula ([Módulos e aulas](https://help.cademi.cloud/pt/conteudo/modulos-e-aulas.md)) |
| Um item do menu do aluno | Um link do tipo **Página incorporada** em [Área do aluno](https://help.cademi.cloud/pt/configuracoes/area-do-aluno.md) |
| Uma vitrine | Uma vitrine cujo destino é uma **Página incorporada** ([Vitrines e grupos](https://help.cademi.cloud/pt/conteudo/vitrines-e-grupos.md)) |
| Um produto inteiro | Um produto no formato **Página incorporada** ([Produtos e formatos](https://help.cademi.cloud/pt/conteudo/produtos.md)) |

Este artigo explica os três primeiros, que ficam nesta tela. No alto da tela, a faixa **Configuração avançada** tem o botão **Ver guia**. Ele abre o guia para preparar a sua página.

## Os campos da tela

O painel **Área do aluno** tem dois campos. Os dois são opcionais.

- **Página inicial da área do aluno** aparece quando o aluno abre a área do aluno. A sua página toma o lugar da tela inicial. As vitrines e os produtos continuam no menu e nos links.
- **Página de boas-vindas** aparece só na primeira entrada do aluno na plataforma. Depois, o aluno vai para a tela inicial normal, ou para a sua **Página inicial da área do aluno**, se houver.

O painel **Conteúdo nas aulas** tem o interruptor **Permitir páginas incorporadas nas aulas**. Ligado, cada aula ganha o campo **Página incorporada** no editor. A página aparece para os alunos abaixo do conteúdo da aula.

Os endereços precisam ser completos e começar com https://. Tudo é gravado de uma vez, em **Salvar agora**.

## Passo a passo

1. Abra **Configurações > Páginas incorporadas**.
2. Cole o endereço completo em **Página inicial da área do aluno**, em **Página de boas-vindas** ou nos dois.
3. Para permitir páginas nas aulas, ligue **Permitir páginas incorporadas nas aulas**.
4. Clique em **Salvar agora**.
5. Para uma aula, abra a aula em **Conteúdo > Produtos**.
6. Preencha **Página incorporada** com o endereço completo.
7. Entre na área como aluno.
8. Confira se a página abre dentro do quadro.

## O que a sua página recebe

Quando abre uma página incorporada, a Cademí acrescenta ao endereço os dados do aluno que está vendo. Assim, a sua página pode reconhecer o aluno.

| Parâmetro | Conteúdo |
|---|---|
| `cuser_id` | O código do aluno na plataforma |
| `cuser_gratis` | 1 se o aluno tem a marca de cadastro gratuito; 0 nos demais. Uma compra depois não limpa a marca. Só um administrador a limpa, no perfil do aluno |
| `cuser_fname` | O primeiro nome |
| `cuser_name` | O nome completo |
| `cuser_email` | O e-mail |
| `cuser_phone` | O celular |
| `cuser_avatar` | O endereço da foto do aluno |

Esses dados chegam na própria URL. Use só páginas em https. Trate os dados com o mesmo cuidado que os do seu cadastro. Se você não quer que a sua página receba esses dados, peça ao suporte para desligar o envio.

## Bom saber

- **A página precisa permitir a incorporação.** Se a sua hospedagem bloqueia páginas dentro de outros sites, o quadro fica em branco. Para conferir:
  1. Abra a área como aluno.
  2. Clique com o botão direito e escolha inspecionar.
  3. No console, procure uma mensagem como "Refused to display in a frame".

  Se a mensagem aparece, peça à sua hospedagem que libere a incorporação para o endereço da sua plataforma.
- **Altura do quadro nas aulas.** Numa aula, o quadro ocupa a altura do conteúdo da página. Para isso, a página precisa carregar o script de redimensionamento da Cademí: `https://core.cademi.com.br/assets/js/vendor/iframeResizer.contentWindow.min.js`. Sem ele, o quadro da aula não ganha altura. A página inicial e a de boas-vindas ocupam a tela inteira e não precisam desse script.
- **A página de boas-vindas abre sozinha uma vez.** Ela aparece na primeira entrada de cada aluno. Para o aluno poder voltar a ela, crie no menu um link do tipo **Página da plataforma** com a página **Primeiro Acesso** ([Área do aluno](https://help.cademi.cloud/pt/configuracoes/area-do-aluno.md)). Essa página só fica disponível quando há uma página de boas-vindas. Um administrador que vê a área como aluno não passa por ela.
- **Sem aviso de página fora do ar.** Se a sua página cair, o quadro fica vazio e o aluno não vê erro. Se você não tem certeza de que a página fica sempre no ar, deixe a página inicial em branco.
- **Clone.** Um clone nasce com uma cópia das configurações da conta de origem, inclusive estes endereços. Depois, cada conta mantém os seus. Mudar um endereço na origem não muda o clone.

## Perguntas frequentes

**Quero uma página de apresentação só na primeira vez que o aluno entrar.** Cole o endereço em **Página de boas-vindas**. O aluno vê a página uma vez. Da segunda entrada em diante, ele vai para a área normal.

**A página aparece em branco dentro da plataforma, mas abre normalmente no navegador.** A hospedagem bloqueia a incorporação. Confira o console do navegador e peça a liberação à hospedagem.

**Posso usar a mesma página na tela inicial e numa aula?** Pode. Na aula, ela precisa carregar o script de redimensionamento para ter altura.

**A página inicial saiu do ar e os alunos viram uma tela vazia.** O quadro não mostra erro quando a sua página cai. Deixe **Página inicial da área do aluno** em branco até a página voltar.