DF Quantity Tiers: documentação

Apresentação e pré-requisitos

O DF Quantity Tiers transforma os descontos por quantidade nativos do PrestaShop num bloco de venda claro e clicável. O módulo não introduz nenhuma lógica de preços nova: lê os preços específicos « a partir de N unidades » já configurados no seu catálogo e apresenta-os sob a forma de cartões ou de tabela, com um botão de adição ao carrinho para cada escalão.

• Compatível com PrestaShop 8.0 a 9.x, tema Classic e temas derivados.
• PHP 7.4 a 8.3.
• Multiloja e multilingue (FR/EN/ES/DE/IT).
• Nenhum override de ficheiros: apenas hooks nativos.

Instalação

Instale o módulo como qualquer módulo PrestaShop:

1. Descarregue o arquivo dfquantitytiers-1.1.0.zip a partir da sua conta de cliente.
2. No back-office, vá a Módulos > Gestor de módulos.
3. Clique em Instalar um módulo e carregue o arquivo.
4. Depois de instalado, clique em Configurar.

Na instalação, o módulo regista os seus hooks, cria a sua tabela de estatísticas e pré-preenche um título de bloco traduzido nos cinco idiomas. Os seus preços degressivos existentes aparecem imediatamente nas fichas de produto em causa.

Atualização a partir da 1.0.0

A atualização para a 1.1.0 faz-se normalmente a partir do Gestor de módulos. O script de upgrade integrado cria a tabela de estatísticas, regista o novo hook da página do carrinho e aplica os valores por defeito das novas opções (modo fiscal, JSON-LD, incentivo no carrinho, estatísticas, etiquetas de embalagem). Não é necessária nenhuma ação manual e a sua configuração existente é conservada.

Configuração geral

A página de configuração reúne o conjunto das definições de apresentação:

• Título do bloco: texto apresentado acima dos escalões, traduzível por idioma.
• Disposição: « Cartões » (recomendado, um cartão por escalão) ou « Tabela compacta » (uma linha por escalão).
• Posição na ficha de produto: sob o bloco de compra (hook displayProductAdditionalInfo, por defeito) ou diretamente sob o preço (hook displayProductPriceBlock).
• Cor de destaque: aplicada ao escalão « Melhor oferta », aos badges e aos botões.
• Apresentação da poupança: em percentagem, em montante, ou ambos.
• Mostrar o preço total do escalão: acrescenta o total para a quantidade do escalão.
• Mostrar o escalão « à unidade »: mostra o preço base como primeiro escalão de comparação.

Modo fiscal (B2B)

O modo fiscal determina se os preços dos escalões são apresentados sem IVA ou com IVA incluído:

• Automático: segue a definição de apresentação do grupo de clientes atual (comportamento padrão do PrestaShop).
• Forçar s/ IVA: mostra sistematicamente os preços sem IVA, com a menção « s/ IVA » ao lado de cada preço unitário. Ideal para uma loja profissional.
• Forçar c/ IVA: mostra sistematicamente os preços com IVA incluído, com a menção « c/ IVA ».

O modo escolhido aplica-se tanto aos cartões da ficha de produto como ao bloco de incentivo do carrinho.

Etiquetas de embalagem

Pode associar uma etiqueta comercial a cada quantidade, por exemplo « caixa » ou « palete ». No campo Etiquetas de embalagem, introduza uma associação por linha no formato quantidade=etiqueta:

12=Caixa de 12
48=Meia palete
96=Palete

A etiqueta aparece sob a quantidade do escalão correspondente. Este campo é traduzível: preencha-o em cada idioma a partir do seletor de idioma do formulário.

Incentivo para o escalão seguinte

Estão disponíveis dois mecanismos de incentivo, ativáveis de forma independente.

Na ficha de produto

Uma barra de progresso mostra uma mensagem do tipo « Adicione mais 3 unidade(s) para poupar 15 % », recalculada em tempo real consoante a quantidade introduzida. Quando o cliente atinge o escalão mais vantajoso, a mensagem passa a « Está a beneficiar do melhor desconto! ».

Na página do carrinho

Para cada produto do carrinho cujo escalão superior continua alcançável, o módulo mostra sob o carrinho um bloco « Adicione mais N unidades para passar a X € / unidade », acompanhado de um botão de adição num clique. O botão usa o mecanismo nativo de atualização do carrinho do PrestaShop e depois recarrega a página. Se nenhum escalão superior for alcançável, não é mostrado nenhum bloco.

Dados estruturados (JSON-LD)

Quando a opção está ativada, o módulo acrescenta à ficha de produto uma marcação JSON-LD do tipo AggregateOffer, com uma oferta por escalão e a quantidade elegível associada. Isto permite aos motores de pesquisa compreender os seus intervalos de preço por quantidade.

Estatísticas de cliques por escalão

Quando a opção está ativada, cada clique num botão de adição por escalão é registado de forma anónima: produto, declinação, quantidade e desconto do escalão clicado. Não é usado nenhum dado pessoal nem cookie, o que torna a função conforme ao RGPD.

A página de configuração mostra um painel dos últimos 30 dias: número total de cliques e top das combinações produto / escalão / desconto mais clicadas. Estes dados ajudam-no a calibrar os seus descontos identificando os escalões que desencadeiam realmente adições ao carrinho.

FAQ e resolução de problemas

O bloco não aparece num produto

Verifique que o produto tem preços específicos com uma quantidade inicial superior a 1, e que esses preços se aplicam ao grupo de clientes, à moeda e ao país atuais. O escalão base sozinho não desencadeia a apresentação se não existir nenhum escalão de desconto.

O botão de adição não funciona com o meu tema

O módulo apoia-se no botão de adição ao carrinho padrão do tema Classic. Num tema fortemente personalizado, certifique-se de que o campo de quantidade e o botão de adição seguem a marcação padrão do PrestaShop.

Funciona com as declinações?

Sim. Os escalões são recalculados para cada combinação e o bloco atualiza-se automaticamente na mudança de declinação, sem recarregar a página.

O que acontece na desinstalação?

A desinstalação remove de forma limpa os hooks, as variáveis de configuração e a tabela de estatísticas. Não fica nenhum dado residual na base de dados.