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 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.

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.

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.

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.