Configurador de produto PrestaShop: guia completo (v2.0.1)
Instalar, criar um configurador por passos, definir preços (fórmulas, stock), importar um dos 14 modelos por setor e acompanhar as encomendas.
O configurador de produto DataFirefly transforma uma ficha de produto num percurso guiado: o cliente escolhe passo a passo, vê o produto compor-se na pré-visualização e conhece sempre o preço que vai pagar, calculado pelo PrestaShop. Este guia trata da versão 2.0.1, compatível com PrestaShop 1.7.8, 8 e 9.

Instalação e atualização
Requisitos
- PrestaShop 1.7.8 a 9.x, tema Classic, Hummingbird ou derivado
- PHP 7.2 a 8.5 com GD e fileinfo (extensões padrão)
- Sem tarefa cron nem serviço externo
- Em Módulos > Gestor de módulos, clique em Carregar um módulo e envie
datafireflyconfigurator-2.0.1.zip. - Aparece o menu Módulos > Configuradores de produto: crie um configurador ou abra a Biblioteca de modelos.
- Ajuste a apresentação comum em Configurar (modo, cor de destaque, barra móvel, letras).
Atualização a partir de 1.x ou 2.0.0: instale o zip 2.0.1 por cima. Configuradores, campos, opções, carrinhos e encomendas são mantidos; os configuradores existentes mantêm a vista de todos os campos; os ficheiros dos clientes passam para uma pasta privada e os antigos scripts de demonstração são removidos.
Criar um configurador
- Associe um ou mais produtos e, se necessário, categorias (subcategorias incluídas).
- Escolha a apresentação: passos guiados (um de cada vez) ou todos os campos.
- Adicione os passos com a paleta de tipos e depois as opções (etiqueta em cada idioma, suplemento, peso, stock, referência, cor, miniatura).
- Ative a pré-visualização se quiser uma imagem composta em direto e guarde.

Tipos de campo
- Lista pendente, cartões, amostras de cor, miniaturas: uma escolha entre várias.
- Caixas de seleção com número mínimo e máximo de escolhas.
- Texto e área de texto: gravação, mensagem, referência; letra, tamanho e cor à escolha do cliente.
- Número: medidas, quantidades, com mínimo, máximo, passo e nome de variável para as fórmulas.
- Envio de ficheiro: logótipo, foto, desenho PDF ou DXF, receita.
- Data com prazo mínimo (fabrico, entrega, levantamento).
Preços: o que o cliente vê é o que paga
Cada opção tem um suplemento sem IVA na moeda predefinida: montante fixo, percentagem do preço base, por caráter, por unidade ou fórmula com os campos número (largura * altura / 10000 * 42). O PrestaShop aplica depois o IVA, as promoções, os descontos de grupo, os descontos por quantidade e a moeda do cliente. A ficha mostra exatamente esse cálculo: o preço mostrado é o do carrinho. O navegador só envia escolhas; nenhum preço é lido do pedido.
Condições, stock e pré-visualização
- Mostrar apenas se: um passo só aparece se uma das opções indicadas for escolhida (a bateria para a bicicleta elétrica, a receita para lentes graduadas).
- Stock das opções: deixe vazio para não gerir ou indique uma quantidade; baixa a cada encomenda e volta se a encomenda for cancelada. O cliente vê «Só restam N» ou «Indisponível».
- Pré-visualização: imagem de fundo, camadas por opção (PNG ou SVG), tingimento da silhueta, camada com a cor de outro campo, texto e imagem do cliente numa zona desenhada com o rato. A imagem final é guardada com a encomenda.
Biblioteca de modelos
14 configuradores completos, um por setor, redigidos nos 8 idiomas com as suas imagens. Clique em Importar e escolha: um produto de demonstração (oculto ou visível, com imagem, preço, descontos por quantidade e stock), um dos seus produtos ou só o configurador. Tudo continua editável.

Exemplos por setor
Cada modelo vem na biblioteca. Primeiro o cliente na ficha de produto, depois a configuração no back office.
Têxtil · T-shirt personalizada
Cor, tamanho, posição da estampagem, logótipo do cliente e texto com escolha de letra. Descontos por quantidade para encomendas de equipa.


Mobiliário · Mesa por medida em madeira maciça
Comprimento e largura ao centímetro com preço pela superfície, madeira, acabamento, pés e extensões. Pré-visualização em direto.


Bicicletas · Bicicleta urbana à medida
Tamanho, forma e cor do quadro, transmissão com stock de motores, bateria só para a versão elétrica, acessórios visíveis na pré-visualização.


Joalharia · Pendente gravado
Metal, forma, corrente, gravação por letra com escolha de letra, data no verso e estojo. Stock limitado em ouro rosa.


Informática · PC montado à medida
Utilização, caixa, processador, memória, armazenamento, placa gráfica só para criação e jogos, com stock de componentes, sistema e garantia.


Sinalética · Painel ou lona impressa
Suporte por m² (PVC, compósito de alumínio, lona, acrílico), formato livre, acabamentos por suporte, ficheiro de impressão e descontos por quantidade.


Presentes · Cabaz de presente à escolha
Tamanho do cabaz, 3 a 8 produtos com stock de cada um, fita, cartão escrito e data de entrega: cada produto aparece na caixa.


Janelas e estores · Estore de rolo à medida
Tecido por m², cor, montagem na parede ou no vão, medidas ao centímetro, comando com telecomando só para o motor, caixa de alumínio ao metro.


Cozinha · Bancada à medida
Material por m², comprimento e profundidade, espessura e orla ao metro, recortes visíveis na pré-visualização, planta cotada do cliente, montagem.


Pastelaria e catering · Bolo de aniversário personalizado
Fatias, sabor, cobertura e cor, decorações, mensagem escrita no bolo, foto comestível, alergias e data de levantamento com prazo mínimo.


Indústria B2B · Peça em chapa cortada a laser
Forma, material, medidas e espessura em mm com preço ao peso, furos à unidade, tratamento, tolerância em %, desenho DXF obrigatório para forma livre, referência do cliente e descontos a partir de 10 peças.


Ótica · Óculos à escolha
Forma e cor da armação, tipo de lentes, receita obrigatória para lentes graduadas, distância pupilar, tratamentos e estojo.


Florista · Ramo da estação à escolha
Estilo, cor dominante, tamanho, jarra com stock, cartão visível na pré-visualização, extras, data e horário de entrega.


Objetos personalizados · Caneca com foto personalizada
Foto do cliente colocada na caneca, texto com letra à escolha, cor da asa e do interior, capacidade e descontos a partir de 6 canecas.


Na ficha de produto
- Passos guiados com «Anterior / Seguinte», barra de progresso e verificação antes de avançar.
- Resumo de todas as escolhas com o suplemento e uma ligação «Alterar» para cada passo.
- No telemóvel, a pré-visualização fica fixa no topo e uma barra de preço fixa mantém o botão à mão.
- Utilizável com teclado: amostras como botões de opção, setas para mover texto e imagem, foco visível, preço anunciado aos leitores de ecrã.
- Três modos: integrado na ficha, janela em ecrã inteiro ou substituição da ficha.
- Depois de adicionar, o contador e a pré-visualização do carrinho do tema atualizam-se logo, sem recarregar a página, com a janela do módulo ou do tema.




Encomendas, e-mails e faturas
Cada configuração torna-se uma personalização PrestaShop: aparece no carrinho, no e-mail de confirmação, na fatura e na guia de remessa. Na encomenda, o bloco Personalizações mostra o detalhe, a imagem final e os ficheiros do cliente, descarregáveis só pelos funcionários.



Definições
Modo de apresentação e posição (automática ou hook displayDfProductConfigurator para page builders), cor de destaque, botão de carrinho nativo oculto, barra de preço móvel, nome e barra de passos, comportamento após adicionar ao carrinho, letras Google (desativadas por predefinição, quatro letras livres incluídas) e conservação dos ficheiros não encomendados.

Segurança e privacidade
- Ficheiros dos clientes guardados fora do módulo com nome aleatório, nunca acessíveis por URL; conteúdo real verificado (uma imagem tem de ser uma imagem, sem código PHP).
- Um ficheiro só pode ser anexado pelo seu autor; envio e adição ao carrinho protegidos por um token próprio de cada visitante; no máximo 30 envios por hora.
- Ficheiros nunca encomendados apagados após o prazo escolhido (60 dias por predefinição), sem cron; os das encomendas são mantidos.
Bom saber
- Uma fórmula com
qtyé calculada com a quantidade ao adicionar ao carrinho; os descontos por quantidade do produto seguem sempre a quantidade do carrinho. - A pré-visualização é indicativa: as camadas não mudam de escala com as medidas introduzidas.