Botões +/− de Quantidade: guia completo
Instalar, configurar e personalizar os botões + e − de quantidade na ficha de produto do PrestaShop 8 e 9: estilo, cores, compatibilidade com o tema Classic e funcionamento sem override.
Apresentação
O módulo Botões +/− de Quantidade acrescenta verdadeiros botões + e − de cada lado do campo de quantidade, na ficha de produto. Substitui o pequeno campo numérico nativo do PrestaShop, pouco prático com o teclado e com o dedo no telemóvel, por dois botões largos e fáceis de acertar.
O módulo não altera nenhum ficheiro do tema: acrescenta uma folha de estilo e um script leves, apenas na ficha de produto, que envolvem o campo de quantidade existente. É compatível com o PrestaShop 1.7, 8 e 9, tanto com o tema Classic como com a maioria dos temas personalizados.
Instalação
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Instalar um módulo e carregue o ficheiro ZIP do módulo.
- Assim que a instalação terminar, clique em Configurar (facultativo: o módulo funciona com as definições predefinidas logo após a instalação).
Não é criada qualquer tabela SQL nem alterado qualquer ficheiro do tema. O módulo limita-se a registar o hook que carrega os seus recursos na ficha de produto.
Configuração
A página de configuração reúne quatro definições. Todas são opcionais: por predefinição, os botões estão ativos, em estilo quadrado, com as setas nativas ocultas.
Ativar os botões
O interruptor Ativar os botões controla a apresentação global. Desative-o para ocultar temporariamente os botões sem desinstalar o módulo: a ficha de produto recupera então o campo de quantidade original.
Estilo dos botões
Escolha o aspeto dos botões:
- Quadrado: os botões + e − têm cantos ligeiramente arredondados nas extremidades do grupo (estilo predefinido).
- Arredondado: os botões assumem uma forma de pastilha, com extremidades completamente arredondadas.
Cor de fundo e cor dos ícones
Dois seletores de cor permitem ajustar:
- a cor de fundo dos botões (por predefinição, um cinzento claro);
- a cor dos ícones + e − (por predefinição, um cinzento escuro).
O efeito ao passar o rato é derivado automaticamente da cor de fundo, pelo que não há uma terceira definição a gerir. As cores são aplicadas através de variáveis CSS, o que garante uma integração limpa na maioria dos temas.
Ocultar as setas nativas do campo numérico
Com esta opção ativada (recomendado), as pequenas setas verticais do campo numérico do navegador ficam ocultas, mantendo-se apenas os botões + e − do módulo. Desative-a se preferir deixar as setas nativas visíveis.
Do lado do cliente
Na ficha de produto, o cliente vê um botão − à esquerda do campo de quantidade e um botão + à direita. Cada clique aumenta ou diminui a quantidade num passo e atualiza depois o preço, as eventuais combinações e o botão de adicionar ao carrinho, exatamente como uma introdução manual. A quantidade continua, claro, a poder ser alterada diretamente pelo teclado no campo.
Funcionamento e compatibilidade
Sem override de template
O módulo não sobrepõe nenhum ficheiro do tema. Localiza o campo de quantidade padrão da ficha de produto e envolve-o por injeção de JavaScript para lhe acrescentar os botões. Esta abordagem torna-o compatível com um vasto conjunto de temas e protege-o das atualizações do PrestaShop, já que nenhum template é sobreposto.
Tema Classic e bootstrap-touchspin
O tema Classic já enriquece o campo de quantidade com o bootstrap-touchspin, que acrescenta duas pequenas setas verticais. O módulo neutraliza corretamente essas setas dentro do seu próprio grupo de botões, para deixar apenas os + e − bem legíveis, sem duplicados nem desalinhamentos.
Sincronização com o carrinho
Em cada clique, o módulo aplica o novo valor e despoleta depois os eventos esperados pelo PrestaShop, tanto nativos como jQuery. O preço total, as combinações e o botão de adicionar ao carrinho reagem normalmente. Depois de uma mudança de combinação, que reconstrói o bloco de quantidade, os botões são reinjetados automaticamente.
Respeito pelo stock e pelas restrições
Os botões leem a quantidade mínima, a quantidade máxima e o passo definidos no campo. O cliente não pode descer abaixo do mínimo exigido (muitas vezes 1) nem ultrapassar o stock disponível quando este está limitado. O comportamento mantém-se coerente com as regras da loja.
Resolução de problemas
Os botões não aparecem na ficha de produto
Verifique se o módulo está ativado e se a opção Ativar os botões está em Sim. Limpe depois a cache do PrestaShop (Parâmetros avançados > Desempenho) e recarregue a ficha de produto. Se o seu tema usar um campo de quantidade muito personalizado, o módulo pode não o detetar; contacte o apoio ao cliente indicando o seu tema.
As setas nativas do tema Classic continuam visíveis
Certifique-se de que está a utilizar a versão 1.1.0 ou superior, que neutraliza as setas do bootstrap-touchspin, e limpe a cache. Verifique também se nenhuma sobreposição de CSS do seu tema volta a mostrar essas setas.
A quantidade muda mas o preço não é atualizado
Este comportamento vem geralmente de um tema que não utiliza os eventos padrão do PrestaShop. O módulo despoleta os eventos nativos e jQuery; se o tema escutar um mecanismo diferente, contacte o apoio ao cliente indicando o tema utilizado.
Desinstalação
A desinstalação do módulo retira os seus recursos da ficha de produto e elimina a sua configuração. O campo de quantidade recupera o aspeto original. Nenhum dado de produto ou de encomenda é afetado.
FAQ
O módulo altera o meu tema?
Não. Não sobrepõe nenhum ficheiro do tema: acrescenta uma folha de estilo e um script apenas na ficha de produto, que envolvem o campo de quantidade existente.
Posso mudar a cor dos botões?
Sim. A configuração permite definir a cor de fundo e a cor dos ícones + e −, bem como o estilo quadrado ou arredondado. O efeito ao passar o rato é derivado automaticamente da cor de fundo.
O módulo é compatível com o PrestaShop 9?
Sim, o módulo é compatível com o PrestaShop 1.7, 8.x e 9.x, tanto em loja única como em multiloja.