PS PrestaShop Iniciante

Calculadora de quantidades por área e volume: instalação e configuração

Instalação, configuração dos produtos, produtos complementares, margens de corte, páginas SEO da calculadora, estatísticas e resolução de problemas.

Atualizado Versão do módulo 1.1.0

Instalação

Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo enviando o ficheiro ZIP, ou copie a pasta dfsurfacecalculator para o diretório /modules/ da loja e clique em Instalar.

Na instalação, o módulo cria três tabelas (definições por produto, valores por combinação, cálculos guardados nos carrinhos), regista os seus hooks e adiciona o separador Calculadora de quantidades no menu Catálogo. O botão Configurar do gestor de módulos abre a mesma página.

A calculadora não aparece em nenhuma página de produto enquanto nenhum produto estiver configurado. Pode, por isso, instalar o módulo numa loja em produção sem qualquer alteração visível imediata.

Os cinco tipos de cálculo

  • Azulejos e pavimentos (m²): comprimento × largura de cada divisão, ou área conhecida. O conteúdo de uma unidade é a área coberta por uma caixa ou embalagem.
  • Tinta (litros): comprimento × altura de cada parede, número de demãos, rendimento em m² por litro, portas e janelas subtraídas. O conteúdo de uma unidade é o volume da lata.
  • Papel de parede (rolos): largura e altura de cada parede. O módulo conta as tiras, arredonda o comprimento de cada tira ao rapport do padrão e calcula o número de tiras inteiras por rolo.
  • Volume: betão, gravilha, terra (m³): comprimento × largura × espessura em centímetros, ou volume conhecido. O resultado é dado em m³ por unidade, ou em sacos se indicar a densidade do material e o peso de um saco.
  • Comprimento: rodapés, perfis (m): comprimento de cada parede ou troço. O conteúdo de uma unidade é o comprimento de uma peça.

Configurar um produto

Abra a página do produto, separador Módulos, bloco Calculadora de quantidades.

  1. Marque Mostrar a calculadora neste produto.
  2. Escolha o Tipo de cálculo e a unidade de venda em Vendido por (caixa, embalagem, lata, balde, rolo, saco, peça, palete ou unidade). É a unidade mostrada ao cliente: «Precisa de 12 caixas».
  3. Indique o conteúdo de uma unidade. O rótulo do campo muda consoante o tipo de cálculo: área coberta por uma unidade, volume de uma lata, rolos por unidade, volume de uma unidade ou comprimento de uma peça.
  4. Preencha os campos próprios do tipo de cálculo (ver abaixo).
  5. Clique em Guardar as definições da calculadora. As definições também são guardadas com o botão de gravação geral da página do produto.

Tinta

Indique o Rendimento em m² por litro, tal como consta na lata, e o número de Demãos propostas por predefinição. A opção Permitir ao cliente subtrair portas e janelas acrescenta dois campos à calculadora; a área subtraída por porta e por janela define-se na configuração do módulo (1,7 m² e 1,5 m² por predefinição).

Papel de parede

Indique a Largura do rolo em centímetros, o Comprimento do rolo em metros e o Rapport do padrão em centímetros (0 ou vazio para um papel liso). Se o produto for vendido ao rolo, deixe vazio o campo «Rolos por unidade». Cada tira mede a altura da parede mais 10 cm de acabamento, arredondada ao rapport seguinte.

Volume vendido em sacos

Para um produto vendido ao peso, deixe vazio o volume por unidade e indique a Densidade do material em kg/m³ e o Peso de uma unidade em kg. O módulo converte então o volume em peso e depois em número de sacos. Valores indicativos: gravilha 1500 a 1700, areia 1600, betão seco pronto 2000.

Margem de corte própria do produto

O campo Margem de corte predefinida para este produto substitui a margem pré-selecionada apenas para este produto. Deixe-o vazio para usar o valor do módulo. Se o valor introduzido não estiver entre as opções propostas, é acrescentado às opções deste produto.

Valores por combinação e combinação de embalagens

Se o produto tiver combinações, aparece uma tabela Valores por combinação. Preencha apenas as combinações cujo conteúdo difere do valor do produto, por exemplo uma lata de 2,5 L e outra de 10 L. Para um produto vendido ao peso, o valor introduzido é o peso de uma unidade em kg.

Se as suas combinações são tamanhos de embalagem, marque As combinações são tamanhos de embalagem: propor a combinação de tamanhos mais barata. Por baixo do resultado, a calculadora mostra então a combinação de tamanhos que cobre a necessidade ao preço mais baixo, a poupança face ao tamanho selecionado e um botão que adiciona todas as linhas ao carrinho. A pesquisa abrange os cinco tamanhos com melhor preço por unidade de conteúdo.

Usar uma característica do produto

Se o seu catálogo já indica o conteúdo de uma unidade numa característica (por exemplo «Área por caixa: 1,44»), selecione-a na configuração em Característica com o conteúdo por unidade. Serve de valor predefinido quando o campo do produto está vazio. O mesmo princípio aplica-se ao rendimento da tinta com Característica com o rendimento da tinta. O módulo lê o primeiro número do valor, com vírgula ou ponto.

Ativação em massa por categoria

Na página do módulo, o bloco Atribuição em massa por categoria ativa ou desativa a calculadora em todos os produtos das categorias selecionadas, subcategorias incluídas se a caixa estiver marcada. Escolha o tipo de cálculo e a unidade de venda a aplicar. Por predefinição, os produtos já configurados mantêm as suas definições; marque Alterar também o tipo e a unidade dos produtos já configurados para as substituir. Os valores de embalagem já introduzidos nunca são apagados.

Um produto ativado sem informação de embalagem, nem no seu campo nem na característica escolhida, fica oculto na loja. Aparece com o estado Incompleto na lista de produtos configurados, com uma ligação para abrir a sua página.

Produtos complementares

No separador Módulos da página do produto, o bloco Produtos complementares associa até 6 produtos calculados juntamente com o produto principal: cola e betume para azulejos, primário para tinta, cola para papel de parede, areia para betão.

  1. Escreva pelo menos dois caracteres do nome ou da referência em Adicionar um produto complementar e escolha o produto ou a combinação na lista. As setas do teclado e a tecla Enter também funcionam.
  2. Indique o Consumo por unidade de medida do cálculo: por m² para azulejos, tinta e papel de parede, por m³ para volume, por metro para linear.
  3. Indique o Conteúdo de uma unidade do produto complementar, na mesma unidade do consumo.
  4. Guarde as definições da calculadora.

A quantidade proposta é a área, o volume ou o comprimento líquido introduzido pelo cliente, multiplicado pelo consumo, dividido pelo conteúdo de uma unidade e arredondado para cima. Exemplo: uma cola consumida a 5 kg por m² e vendida em sacos de 25 kg configura-se com 5 e 25; para 14,7 m², são propostos 3 sacos ao cliente. Para prever perdas, inclua-as no consumo.

Na loja, os produtos aparecem por baixo do resultado, assinalados por predefinição, com quantidade, preço e total. O botão Adicionar os produtos assinalados ao carrinho adiciona-os de uma vez. Um produto esgotado, quando as encomendas sem stock não são permitidas, aparece a cinzento e desassinalado. Os produtos inativos ou indisponíveis para encomenda não são apresentados.

Descontos de quantidade e stock

O preço estimado aplica os descontos de quantidade definidos no PrestaShop para a combinação selecionada, com a menção «Desconto de quantidade incluído». As regras de carrinho e os portes não estão incluídos.

Se a gestão de stock estiver ativa e a quantidade calculada exceder o stock disponível, o cliente vê o stock restante. Quando as encomendas sem stock não são permitidas, o botão de adicionar ao carrinho fica oculto e resta apenas a ligação Usar esta quantidade. Quando são permitidas, o cliente é informado de que o restante será enviado quando for reposto. A combinação de embalagens nunca propõe mais do que o stock disponível de um tamanho e respeita a quantidade mínima de encomenda de cada combinação.

Estatísticas

A página do módulo mostra um bloco Resultados da calculadora, nos últimos 30 dias e desde a instalação: carrinhos com um produto adicionado pela calculadora, encomendas validadas desses carrinhos, taxa de conversão e faturação sem IVA dos produtos calculados e complementares, convertida para a moeda predefinida. Uma tabela lista os cinco produtos que geraram mais faturação.

Só são contados os produtos adicionados com os botões da calculadora, e a opção Guardar o cálculo com a linha do carrinho tem de estar ativa para recolher os dados.

Definições do módulo

Apresentação

  • Posição na página do produto: por baixo do botão Adicionar ao carrinho (hook displayProductAdditionalInfo), junto às ações do produto (displayProductActions) ou hook personalizado.
  • Cor de destaque: cor dos botões, das escolhas de margem e do resultado.
  • Preço por m², litro, metro ou m³: mostra «ou seja, 22,85 € / m²» por baixo do preço, na página do produto e nas listagens.
  • Guardar o cálculo com a linha do carrinho: guarda as medidas do cliente para o carrinho e para a página da encomenda no back office.
  • Mostrar a calculadora recolhida: a página do produto mostra um botão «Calcular a quantidade de que preciso» que abre a calculadora. Abre-se sozinha se o cliente já tiver introduzido medidas, por exemplo numa página da calculadora.
  • Área de porta subtraída e Área de janela subtraída em m².

Margens de corte

Para cada tipo de cálculo, introduza as opções propostas ao cliente, em percentagem e separadas por vírgulas (por exemplo 5,10,15), e a margem pré-selecionada. Valores instalados: azulejos 5, 10 e 15 % (10 por predefinição), tinta 0 a 15 % (10), papel de parede 0 a 10 % (5), volume 0 a 10 % (5), rodapés 5 a 15 % (10).

Hook personalizado

Para colocar a calculadora noutro local da página do produto, escolha a posição «Hook personalizado» e acrescente esta linha ao template de produto do seu tema:

{hook h='displayDfSurfaceCalculator' product=$product}

Páginas SEO da calculadora

Cada tipo de cálculo pode ter a sua própria página pública, com a calculadora, os seus produtos do mesmo tipo com a quantidade e o preço calculados para as medidas do visitante, uma explicação do método e ligações para as outras calculadoras. Os endereços seguem o modelo /calculadora/azulejos-pavimentos, /calculadora/tinta, /calculadora/papel-de-parede. A lista das páginas publicadas e as respetivas ligações aparecem no topo da página do módulo.

  • Ativar as páginas da calculadora e Páginas a publicar: publique apenas os tipos que correspondem ao seu catálogo.
  • Prefixo do URL: comum a todos os idiomas, definido na instalação conforme o idioma predefinido da loja.
  • Produtos listados por página: 12 por predefinição, 0 oculta a lista.
  • Para cada página e cada idioma: URL amigável, Título (H1 e etiqueta title), Meta descrição e Texto de introdução. Títulos e endereços escritos para as pesquisas mais comuns vêm preenchidos em 8 idiomas.

As páginas declaram um canonical, as etiquetas hreflang dos idiomas ativos e um breadcrumb. São adicionadas automaticamente ao sitemap do módulo gsitemap do PrestaShop na sua próxima geração. O endereço de outro idioma redireciona com um 301 para o do idioma apresentado. Se alterar um URL amigável, o endereço antigo deixa de ser servido: preveja um redirecionamento se a página já estava indexada.

O texto de introdução é um bom local para os seus conselhos de aplicação e o vocabulário dos seus clientes. Evite copiar palavra por palavra a explicação do método, que já aparece por baixo da calculadora.

O que o cliente vê

O cliente introduz uma ou várias divisões, paredes ou zonas. Cada bloco mostra o seu subtotal. A partir da segunda zona, a caixa Subtrair esta zona permite retirar uma ilha, uma janela grande ou um roupeiro. Escolhe depois a margem entre os seus valores.

O resultado indica a área ou o volume, a necessidade com a margem incluída, o número de unidades, o total coberto com a sobra e o preço estimado. O botão Adicionar 12 caixas ao carrinho preenche o campo de quantidade e aciona o botão de carrinho do tema. A ligação Usar esta quantidade apenas preenche o campo. Se o produto estiver esgotado, só esta ligação é proposta.

Um valor não numérico é assinalado a vermelho e bloqueia o resultado. Um valor muito alto, por exemplo 120 m para o comprimento de uma divisão, mostra um lembrete da unidade esperada. As medidas são guardadas durante a sessão: o visitante reencontra-as entre a página da calculadora e a página do produto.

Carrinho e encomendas

Quando o cliente adiciona ao carrinho a partir da calculadora, as suas medidas são guardadas com a linha. O carrinho mostra um resumo por baixo do produto, por exemplo «Área 14,7 m² + 10% = 16,17 m². Calculado: 12 caixas», e assinala se a quantidade foi alterada depois. No back office, a página da encomenda mostra um bloco Cálculos de quantidades com a mesma informação.

Resolução de problemas

A calculadora não aparece na página do produto

Verifique na lista de produtos configurados que o produto está ativo e que o seu estado não é Incompleto. Verifique depois se o hook da posição escolhida existe no seu tema; em caso de dúvida, experimente a outra posição ou o hook personalizado. Limpe a cache da loja após cada alteração.

A mensagem «Falta a informação de embalagem para esta opção»

A combinação selecionada não tem conteúdo, nem o produto. Indique o valor do produto ou o da combinação na tabela de valores por combinação.

A página da calculadora devolve um erro 404

Verifique se as páginas estão ativadas e se o tipo está marcado em Páginas a publicar. Se os URL amigáveis da loja estiverem desativados, a página continua acessível pelo seu endereço longo, indicado no topo da página do módulo.

A combinação de embalagens não aparece

A opção tem de estar marcada, pelo menos duas combinações têm de ter conteúdo e preço, e a combinação só é proposta se custar menos do que o tamanho selecionado.

O preço por m² não aparece nas listagens

É apresentado através do hook displayProductPriceBlock do tipo unit_price, que alguns temas não chamam nas miniaturas de produto. Acrescente a chamada ao template da miniatura ou desative a opção.

Compatibilidade

  • PrestaShop 8.0 a 9.x, o mesmo ZIP cobre as duas versões.
  • Multiloja e multilíngue.
  • Arquitetura ModuleAdminController, sem dependências Composer.
  • Interface e textos da calculadora disponíveis em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte