# Botões +/− de Quantidade: guia completo > 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… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfqtybuttons/index.md), [en](https://www.datafirefly.com/en/documentation/dfqtybuttons/index.md), [es](https://www.datafirefly.com/es/documentation/dfqtybuttons/index.md), [de](https://www.datafirefly.com/de/documentation/dfqtybuttons/index.md), [it](https://www.datafirefly.com/it/documentation/dfqtybuttons/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfqtybuttons/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfqtybuttons/index.md) - Índice: ## 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 1. No back-office, abra **Módulos > Gestor de módulos**. 2. Clique em **Instalar um módulo** e carregue o ficheiro ZIP do módulo. 3. 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.