Páginas incorporadas: seu site na área do aluno

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)
Um item do menu do aluno	Um link do tipo Página incorporada em Área do aluno
Uma vitrine	Uma vitrine cujo destino é uma Página incorporada (Vitrines e grupos)
Um produto inteiro	Um produto no formato Página incorporada (Produtos e formatos)

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

Abra Configurações → Páginas incorporadas.
Cole o endereço completo em Página inicial da área do aluno, em Página de boas-vindas ou nos dois.
Para permitir páginas nas aulas, ligue Permitir páginas incorporadas nas aulas.
Clique em Salvar agora.
Para uma aula, abra a aula em Conteúdo → Produtos.
Preencha Página incorporada com o endereço completo.
Entre na área como aluno.
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:

Abra a área como aluno.
Clique com o botão direito e escolha inspecionar.
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). 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.

Páginas incorporadas