Bilheteira e Eventos: guia completo

Apresentação

A Bilheteira e Eventos da DataFirefly transforma qualquer produto PrestaShop num bilhete de evento. O módulo gere dois tipos de evento (lugares livres ou lugares marcados), uma planta da sala visual, a geração de bilhetes com código QR descarregáveis em PDF e um ecrã de controlo de entrada por leitura de código. A particularidade da abordagem: cada categoria de lugar é uma combinação de produto, o que deixa o PrestaShop gerir nativamente os preços, os impostos e a faturação.

Instalação

1. Descarregue o ficheiro dfeventtickets.zip a partir da sua conta DataFirefly.
2. No back-office, vá a Módulos > Gestor de módulos, clique em Carregar um módulo e envie o ZIP.
3. O módulo instala-se automaticamente: cria as suas tabelas, os seus separadores de menu (em Clientes > DataFirefly Bilheteira) e regista os seus hooks.
4. Limpe a cache do PrestaShop (Parâmetros avançados > Desempenho > Limpar a cache) depois da instalação.

Conceitos-chave

Produto = bilhete

Cria primeiro um produto PrestaShop normal (o «bilhete») e associa-lhe depois um evento. Tudo o que diz respeito ao preço, ao IVA e à fatura continua a ser gerido pelo PrestaShop.

Zona de preço = combinação

Cada zona (Plateia VIP, Balcão, Bancada…) aponta para uma combinação do produto (id_product_attribute) ou para o preço base. É isso que garante totais e faturas corretos, sem cálculos paralelos.

Dois tipos de evento

• Lugares livres (general): o cliente escolhe uma categoria e uma quantidade através do bloco de compra nativo.
• Lugares marcados (seated): o cliente escolhe o seu lugar numa planta da sala interativa.

Criar um evento

Vá a Clientes > DataFirefly Bilheteira > Eventos e clique em Adicionar um evento. Indique:

• o produto associado;
• o tipo (lugares livres ou lugares marcados);
• as datas de início e de fim (formato AAAA-MM-DD HH:MM:SS) e o fuso horário;
• a capacidade (para os lugares livres);
• a duração da reserva (minutos durante os quais um lugar selecionado fica bloqueado, 15 por predefinição);
• o estado ativo.

Definir as zonas de preço

Depois de gravado o evento, o painel Zonas de preço aparece por baixo do formulário. Em cada zona, indique um nome, a combinação de produto correspondente (ou o preço base) e uma cor de apresentação. O preço real é lido a partir da combinação do PrestaShop.

Desenhar a planta da sala

Nos eventos com lugares marcados, abra Desenhar a planta da sala. O editor visual permite:

• gerar um bloco de lugares (filas × colunas, com primeira fila e primeiro número parametrizáveis) ligado a uma zona;
• reposicionar um lugar por arrastar e largar;
• ativar/desativar um lugar (clique): um lugar desativado não é vendido;
• eliminar um lugar (duplo clique);
• apagar tudo para recomeçar.

A barra «PALCO / ENTRADA» serve de referência de orientação para os seus clientes.

Do lado da loja: comprar um bilhete

Na ficha de produto, o módulo injeta automaticamente o widget adequado:

• Lugares marcados: uma planta interativa em que as zonas aparecem coloridas, os lugares ocupados a cinzento e os lugares disponíveis clicáveis. O cliente seleciona um ou vários lugares; cada seleção acrescenta a combinação correspondente ao carrinho e reserva o lugar temporariamente.
• Lugares livres: uma caixa de disponibilidade; a compra é feita através do bloco de quantidade nativo.

Bilhetes com código QR e PDF

Assim que a encomenda é validada e paga, o módulo gera um bilhete por cada lugar efetivamente pago, cada um com um token aleatório único codificado em QR. O cliente descarrega os seus bilhetes em PDF (um bilhete por página) a partir do detalhe da encomenda ou da sua área de cliente. Se o TCPDF não estiver disponível, é proposta uma alternativa em HTML pronta a imprimir.

Controlo de entrada (leitura de código)

No dia do evento, abra Clientes > DataFirefly Bilheteira > Leitura. Dois modos:

• Câmara: inicie a câmara e apresente o código QR do bilhete;
• Introdução manual: cole ou escreva o código do bilhete.

O resultado é apresentado a cores (válido, já utilizado, anulado, inválido) e um registo das últimas leituras ajuda o pessoal do acolhimento. Um bilhete validado passa a utilizado e não pode voltar a ser usado.

Ciclo de vida de um bilhete

• reserved: lugar selecionado, bloqueado até ao fim do prazo de reserva;
• valid: encomenda paga e reconciliada (só os lugares efetivamente pagos ficam válidos);
• used: bilhete lido à entrada;
• cancelled: encomenda anulada ou reembolsada;
• expired: reserva não confirmada que chegou ao fim do prazo.

Gestão dos bilhetes no back-office

O separador Bilhetes lista todos os bilhetes com o respetivo evento, lugar, cliente, encomenda, estado e data de emissão. A lista é filtrável e permite a anulação em massa. Está disponível um filtro por evento a partir do painel das zonas.

Compatibilidade e aspetos técnicos

• PrestaShop 8.0 a 9.x, multiloja, multilingue (FR, EN, ES, DE, IT);
• PHP 7.4 a 8.3;
• controladores ModuleAdminController (compatibilidade PS8/9, sem controladores Symfony);
• código QR (biblioteca MIT) e PDF (TCPDF nativo) incorporados, sem dependências Composer.

Resolução de problemas

O widget de seleção não aparece na ficha de produto

Verifique se o evento está ativo e associado ao produto certo e se o módulo está efetivamente ligado aos hooks da ficha de produto. Limpe a cache.

Aparece uma página em branco depois da instalação ou da atualização

Limpe a cache do PrestaShop para reconstruir o índice de classes e volte a carregar o ecrã.

A câmara não arranca no ecrã de leitura

A leitura por câmara exige um contexto seguro (HTTPS) e a autorização de acesso à câmara. Na sua falta, utilize a introdução manual do código.

Os preços ou os impostos parecem incorretos

Certifique-se de que cada zona aponta para a combinação de produto correta: é o PrestaShop que calcula o preço e o IVA a partir dessa combinação.