# dfbundlevisual: comprados frequentemente juntos > Apresentação O dfbundlevisual mostra na ficha de produto um bloco « Comprados frequentemente juntos » ao estilo Amazon: cartões de produtos selecionáveis separados por « + », um preço total… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfbundlevisual/index.md), [en](https://www.datafirefly.com/en/documentation/dfbundlevisual/index.md), [es](https://www.datafirefly.com/es/documentation/dfbundlevisual/index.md), [de](https://www.datafirefly.com/de/documentation/dfbundlevisual/index.md), [it](https://www.datafirefly.com/it/documentation/dfbundlevisual/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfbundlevisual/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfbundlevisual/index.md) - Índice: ## Apresentação O dfbundlevisual mostra na ficha de produto um bloco « Comprados frequentemente juntos » ao estilo Amazon: cartões de produtos selecionáveis separados por « + », um preço total recalculado em direto e um botão único para adicionar a seleção ao carrinho. Um desconto de lote (percentagem ou montante fixo com IVA) é aplicado automaticamente quando o lote completo está no carrinho. Sem lote manual, o módulo pode sugerir os produtos realmente comprados juntos com base no seu histórico de encomendas. ## Instalação 1. No back-office, abra **Módulos > Gestor de módulos > Instalar um módulo**. 2. Carregue o ficheiro `dfbundlevisual.zip` e clique em **Instalar**. 3. O módulo cria as suas tabelas, o seu separador **Catálogo > Lotes visuais** e regista-se nos hooks necessários. Compatível com PrestaShop 8.0 a 9.x, mono e multiloja. Nenhuma dependência: nem Composer, nem framework, nem jQuery. ## Configuração Abra a página de configuração do módulo (**Módulos > Gestor de módulos > dfbundlevisual > Configurar**): - **Ativar o módulo**: interruptor geral do bloco do front-office. - **Ponto de apresentação**: `displayFooterProduct` (fundo da ficha de produto, recomendado) ou `displayProductAdditionalInfo` (sob o botão de compra, consoante o tema). - **Título do bloco**: personalizável por idioma. Preencha-o em português (« Comprados frequentemente juntos »), o valor por defeito é fornecido em francês e inglês. - **Ativar as sugestões automáticas**: mostra sugestões por co-compra quando não existe nenhum lote manual para o produto consultado. - **Número máximo de sugestões automáticas**: número de produtos complementares propostos (2 por defeito). - **Co-compras mínimas**: número mínimo de encomendas que contêm os dois produtos para que apareça uma sugestão (2 por defeito). - **Janela de histórico de encomendas (dias)**: período analisado para a coocorrência (365 por defeito). ## Criar um lote 1. Abra **Catálogo > Lotes visuais** e clique em **Adicionar**. 2. **Nome do lote**: nome interno, também usado como designação do desconto no carrinho. 3. **Produto principal**: pesquise por nome, referência ou ID. É na ficha deste produto que o bloco será apresentado. 4. **Produtos do lote**: adicione um ou vários produtos complementares através da pesquisa com preenchimento automático. 5. **Tipo e valor do desconto**: sem desconto, percentagem (máx. 100) ou montante fixo com IVA. 6. Ative o lote e guarde. Um único lote por produto principal e por loja: o bloco mantém-se legível e a mensagem comercial única. Em multiloja, cada loja pode ter o seu próprio lote para o mesmo produto. ## Funcionamento do desconto O desconto é aplicado por uma **regra de carrinho dinâmica** criada na hora para cada carrinho (código `DFBV-{id_lote}-{id_carrinho}`) e **restrita apenas aos produtos do lote**: - Só é criada se o lote completo estiver presente no carrinho: verificação feita do lado do servidor. - Um desconto em percentagem aplica-se apenas aos produtos do lote, nunca ao resto do carrinho. - Se o cliente retirar um produto do lote, o desconto é removido automaticamente. - Na validação da encomenda, a regra é desativada para não ser reutilizada. - Na desinstalação do módulo, todas as regras geradas são purgadas. O desconto em percentagem acumula-se com eventuais preços específicos: o cálculo parte do preço apresentado ao cliente. Verifique as suas margens se acumular promoções de catálogo e desconto de lote. ## Sugestões automáticas Quando não existe nenhum lote manual ativo para o produto consultado e a opção está ativada, o módulo analisa a coocorrência dos produtos nas suas **encomendas válidas** na janela configurada e mostra depois as combinações mais frequentes que respeitam o limiar de co-compras. Os produtos esgotados são excluídos. O resultado é guardado em cache para preservar o desempenho. Não é aplicado nenhum desconto às sugestões automáticas: o desconto é reservado aos lotes manuais. ## Estatísticas A lista **Catálogo > Lotes visuais** mostra para cada lote as suas **visualizações** (apresentações do bloco) e as suas **conversões** (adições completas ao carrinho). As sugestões automáticas são contabilizadas globalmente. Use estes números para ajustar composições e descontos. ## Resolução de problemas - **O bloco não aparece**: verifique que o módulo está ativado, que existe um lote ativo para o produto (ou que as sugestões automáticas estão ativadas com um histórico suficiente) e que o hook escolhido está presente no seu tema. - **O desconto não aparece**: só é criado se todos os produtos do lote estiverem no carrinho. Verifique também que o tipo de desconto não é « Sem desconto ». - **Nenhuma sugestão automática**: baixe o limiar de co-compras mínimas ou alargue a janela de histórico; são necessárias encomendas válidas que contenham os produtos juntos. - **Produtos com declinações**: a declinação por defeito é usada na adição, com controlo do stock.