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

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.

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