Pular para o conteúdo

Instalar um formulário incorporado na página

Formulário incorporado precisa saber onde nascer na página. Há dois caminhos: uma tag no tema ou a seleção visual de um elemento.

Pop-up aparece sobre a página e não precisa de instalação. Incorporado entra no fluxo da página, então precisa de um ponto de referência. Você escolhe o caminho na aba Layout, na seção Inserir na página. Os dois modos são exclusivos: use um ou outro.

Modo Código no tema

Gera uma tag para você colar no tema da loja, no ponto exato onde o formulário deve aparecer.

<div data-bevean-form="ID_DO_GRUPO_DO_FORMULARIO"></div>
  • A tag só é gerada depois de salvar o formulário pela primeira vez.
  • O identificador é do formulário, não da versão: a mesma tag continua valendo quando você publica novas versões.
Informação:

Quando esse modo compensa

Você controla exatamente onde o formulário nasce, e o ponto não se perde quando o layout da página muda. Em compensação, exige editar o tema da loja.

Modo Selecionar elemento

Carrega a página real dentro do editor. Você clica num elemento de referência e escolhe onde o formulário entra em relação a ele. Não exige mexer no tema.

PosiçãoOnde o formulário entra
Antes do elementoImediatamente acima do elemento escolhido.
Depois do elementoImediatamente abaixo. É o padrão.
Dentro, no inícioComo primeiro item dentro do elemento.
Dentro, no fimComo último item dentro do elemento.
Atenção:

Trocou o tema da loja? Selecione o elemento de novo

A seleção guarda uma referência à estrutura da página. Quando o tema muda, essa estrutura muda junto e a referência pode deixar de existir — o formulário simplesmente para de aparecer, sem erro visível na loja.

Avisos do preview

O preview da página dentro do editor testa a instalação e diz o que encontrou:

AvisoO que significa
Nenhum elemento selecionadoVocê está no modo seletor e ainda não escolheu o elemento de referência. O formulário não tem onde ser inserido.
A tag deste formulário não foi encontrada nesta páginaVocê está no modo tag e ela não está no tema, ou não existe naquela URL específica.
O elemento selecionado não foi encontrado nesta páginaO elemento escolhido não existe na URL carregada. Pode ser outra página, ou o tema mudou.
Importante:

Teste na URL certa

Um formulário incorporado só aparece onde a tag ou o elemento existem. Se a tag foi colada na página de produto, ele não vai aparecer na home — e isso é o esperado, não um defeito.

Atualizado em

Central de Ajuda — tutoriais e respostas sobre a plataforma.

Digite ao menos duas letras para buscar.