Como Adicionar o Widget ao Site

Depois de criar o seu Widget, há duas formas de o colocar no seu site: incorporar um único Widget, ou incorporar todo o seu catálogo de Widgets ativos de uma vez.

Onde encontrar o código

• No Gerador (Estúdio de Widgets), depois de gerar o Widget, o código aparece no fundo do painel lateral, com um botão "Copiar Código".
• Em Widgets → Widgets Ativos, cada Widget tem o seu próprio bloco de incorporação (com escolha de Cartão ou Página Completa), existe um bloco no topo da página para incorporar o catálogo completo, e cada Categoria tem o seu botão "Incorporar Categoria".

Incorporar um único Widget

Cole este código no HTML do seu site, onde quiser que o Widget apareça. Troque o identificador na URL pelo do seu próprio Widget.

Cartão — compacto, abre a reserva num modal:

<iframe src="https://nextreserva.com/embed/a851a6f6-0dd5-4641-8ee6-e326a31b71dc?layout=card" width="100%" style="border: none; background: transparent; overflow: hidden;" allowfullscreen></iframe>
<script src="https://nextreserva.com/sdk.js" async></script>

Página Completa — a experiência inteira já aberta:

<iframe src="https://nextreserva.com/embed/a851a6f6-0dd5-4641-8ee6-e326a31b71dc?layout=full" width="100%" style="border: none; background: transparent; overflow: hidden;" allowfullscreen></iframe>
<script src="https://nextreserva.com/sdk.js" async></script>

Incorporar o catálogo completo

Se quiser mostrar todos os seus Widgets ativos de uma só vez (por exemplo, numa página "Os Nossos Tours"), use este formato com o seu identificador de utilizador:

<iframe src="https://nextreserva.com/embed/widgets?userId=3" width="100%" style="border: none; background: transparent; overflow: hidden;" allowfullscreen></iframe>
<script src="https://nextreserva.com/sdk.js" async></script>

Categorias: agrupar Widgets por tema

Uma Categoria é uma pasta que agrupa vários Widgets — por exemplo "Passeios de Barco", "Tours a Pé" ou "Experiências Gastronómicas". Serve para duas coisas:

1. Organizar o painel Widgets Ativos, que fica difícil de percorrer quando tem dezenas de Widgets.
2. Incorporar apenas esse grupo numa página específica do seu site — a página "Passeios de Barco" mostra só os barcos, e não o catálogo inteiro.

Existe sempre uma categoria "Sem Categoria", onde entram todos os Widgets que ainda não arrumou. Não pode ser renomeada nem apagada.

Criar uma categoria

1. Vá a Widgets → Widgets Ativos.
2. No topo da página, à direita da caixa de pesquisa, escreva o nome no campo "Nome da nova categoria...".
3. Clique em Criar (ou carregue em Enter).

A categoria aparece imediatamente como um bloco vazio, com uma área a tracejado à espera dos seus Widgets.

Arrastar e largar Widgets para dentro de uma categoria

Cada cartão de Widget tem uma pega de arrasto — o ícone de pontos verticais (⣿) no canto superior direito do cartão. É por aí que se arrasta: o resto do cartão continua clicável normalmente, para que possa copiar código ou duplicar sem arrastar nada por engano.

1. Passe o rato por cima do cartão — a pega aparece no canto superior direito. (No telemóvel e no tablet a pega está sempre visível.)
2. Clique e mantenha premido na pega, e arraste o cartão. Uma cópia do cartão segue o cursor, ligeiramente inclinada.
3. Passe por cima do bloco da categoria de destino — ele acende-se a roxo, com contorno a tracejado, a confirmar que é ali que vai largar.
4. Largue. O Widget salta para a nova categoria e o contador ao lado do nome ("3 widgets") atualiza-se.

Notas úteis:

• Tirar um Widget de uma categoria: arraste-o de volta para o bloco "Sem Categoria".
• Mover entre categorias: arraste diretamente de um bloco para o outro, sem passos intermédios.
• No telemóvel: mantenha o dedo na pega cerca de meio segundo antes de arrastar — essa pequena pausa é o que distingue um arrasto de um scroll na página.
• Com a pesquisa ativa: a caixa de pesquisa esconde os cartões que não correspondem, e categorias inteiras podem desaparecer da vista. Limpe a pesquisa antes de arrastar, para ver todos os destinos possíveis.

Renomear e apagar categorias

• Renomear: passe o rato sobre o nome da categoria e clique no ícone do lápis. Escreva o novo nome e carregue em Enter (ou Salvar); Esc cancela.
• Apagar: clique no ícone do caixote do lixo, à direita do cabeçalho da categoria. Os Widgets não são apagados — voltam todos para "Sem Categoria".

Copiar o código de incorporação de uma categoria

1. No cabeçalho da categoria, clique em "Incorporar Categoria". (O botão só aparece se a categoria tiver pelo menos um Widget.)
2. Abre-se uma janela com o código já pronto para essa categoria.
3. Clique em "Copiar Código" — o botão fica verde com "Copiado!" a confirmar.
4. Cole o código no HTML da página do seu site onde quer aquele grupo de tours.

Antes de copiar, pode ainda:

• Ajustar o campo Altura do Iframe, para planear o espaço que o bloco vai ocupar na sua página.
• Clicar em "Visualizar Incorporação", que abre o embed real num separador novo — é exatamente o que os seus clientes vão ver.

O código copiado tem esta forma:

<iframe src="https://nextreserva.com/embed/widgets?userId=3&categoryName=Passeios%20de%20Barco&widgets=a851a6f6-0dd5-4641-8ee6-e326a31b71dc,7c2f19b4-3ad8-4c71-9f52-1e8b90c4d217" width="100%" style="border: none; background: transparent; overflow: hidden;" allowfullscreen></iframe>
<script src="https://nextreserva.com/sdk.js" async></script>

Os três parâmetros da URL são:

Parâmetros de personalização da URL

Estes parâmetros aplicam-se ao embed do catálogo e ao embed de categoria (ambos usam /embed/widgets), e juntam-se com & no fim da URL, por exemplo: ?userId=3&cardBg=transparent&borderRadius=0px.