Passeios - Configurações do Módulo

O que é

A página de Configurações de Experiências controla três comportamentos globais do módulo Passeios / Experiências da sua empresa: o Modo Experiência Apenas, a exibição do item Experiências no menu principal do admin e a ordem dos blocos na home do site público (Pacotes antes ou depois das experiências individuais).

O usuário normalmente chega aqui logo após contratar o módulo passeios-experiencias, para decidir como o módulo se integra ao restante do sistema. Empresas que trabalham somente com passeios (sem excursões com transporte) ativam aqui o Modo Experiência Apenas, que oculta o vocabulário de excursões tanto no admin quanto no site.

Importante: esta página não configura categorias de preço, horários, extras ou temporadas - esses ajustes são por experiência, dentro da tela de edição do passeio, nas abas Categorias de Preço, Horários, Extras e Temporadas.

Como usar

1. Vá em Módulos > Passeios / Experiências > Configurações no sidebar (ícone de engrenagem). A URL é /admin/passeios/configuracoes.
2. No primeiro card, Modo Experiência Apenas, decida com o toggle teal se o empresa trabalha somente com experiências:
   • Quando ativo, o sistema oculta Excursões e Reservas do menu admin, remove Excursões do menu do site, e substitui a seção da home e o carrinho vazio por Experiências.
   • O bloco verde-água com o aviso "Ativo" só aparece enquanto o toggle está ligado.
3. No segundo card, Menu de Navegação, use o toggle Exibir Experiências no menu principal para colocar o item Experiências direto no menu lateral (entre Reservas e Cadastros), além de mantê-lo dentro da seção Módulos.
   • Este toggle fica bloqueado e marcado automaticamente quando o Modo Experiência Apenas está ativo - porque o modo exclusivo implica menu raiz ligado.
4. No terceiro card, Ordenação na Página Inicial, escolha com o toggle se Pacotes aparecem antes das Experiências individuais na home do site público. Desligado, as experiências avulsas vêm primeiro.
5. Clique em Salvar configurações (botão teal no rodapé direito). A página recarrega com o toast verde "Configurações salvas com sucesso!".

Casos especiais

Configurar categorias de preço, horários, extras ou temporadas

Esses ajustes não estão nesta página. Eles são por experiência, dentro da edição do passeio:

• Vá em Módulos > Passeios / Experiências > Catálogo (ou clique numa experiência no Dashboard).
• Abra a experiência desejada e use as abas no topo do formulário:
  • Categorias de Preço - define cada categoria (adulto, criança, etc.), preço de custo, preço de venda, quantos consome do estoque e quanto cada inscrito "conta" como (útil para meia-entrada).
  • Horários - cadastra horários por dia da semana ou data específica, com vagas e horário de início/fim.
  • Extras - adiciona extras opcionais (fotos, refeições, equipamentos) com preço e tipo de cobrança.
  • Temporadas - define períodos com preço sazonal diferente do padrão.

Modo Experiência Apenas com o toggle Menu Raiz cinza

Quando o Modo Experiência Apenas está ligado, o toggle "Exibir Experiências no menu principal" aparece desabilitado e marcado. Isso é intencional - o modo exclusivo sempre ativa o menu raiz junto. Para mexer no menu raiz isoladamente, desligue antes o Modo Experiência Apenas.

Empresa que volta a vender excursões

Se você precisar reativar o vocabulário de excursões e o menu de Reservas, basta desligar o Modo Experiência Apenas e salvar. Os dados de excursões anteriores permanecem no banco - apenas estavam ocultos.

Erros comuns e como resolver

• "Configurações salvas com sucesso!" não aparece - Causa: o usuário não tem a permissão de editar as experiências e a rota POST /admin/passeios/configuracoes rejeita o envio antes de gravar. Solução: peça ao Proprietário/Gerente para conceder editar as experiências no perfil RBAC.
• Página retorna 403 ou redireciona - Causa: o módulo passeios-experiencias está inativo ou o usuário não tem permissão de ver as experiências. Solução: ative o módulo em Configurações > Módulos e verifique o perfil do usuário.
• Item "Experiências" não aparece no menu principal mesmo após salvar - Causa: cache de menu antigo (especialmente em sessão impersonada). Solução: faça logout e login novamente ou alterne o modo de impersonação.

Onde encontrar

• URL: /admin/passeios/configuracoes
• Caminho no menu: Módulos > Passeios / Experiências > Configurações (engrenagem no submenu de Passeios)
• Permissão necessária para visualizar: ver as experiências
• Permissão necessária para salvar: editar as experiências
• Módulo necessário: passeios-experiencias

Veja também

• Dashboard de Experiências
• Catálogo de Experiências
• Criar Experiência - onde ficam categorias, horários, extras e temporadas
• Editar Experiência
• Pacotes de Experiências