# Calcolatore di quantità per superficie e volume: installazione e configurazione

> Installazione Installate il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP, oppure copiate la cartella dfsurfacecalculator nella directory /modules/ del negozio e fate clic…

- Pagina: <https://www.datafirefly.com/it/documentation/dfsurfacecalculator/>
- Lingua: it
- Aggiornato il: 2026-09-23
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfsurfacecalculator/index.md), [en](https://www.datafirefly.com/en/documentation/dfsurfacecalculator/index.md), [es](https://www.datafirefly.com/es/documentation/dfsurfacecalculator/index.md), [de](https://www.datafirefly.com/de/documentation/dfsurfacecalculator/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfsurfacecalculator/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfsurfacecalculator/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfsurfacecalculator/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Installazione

Installate il modulo da **Moduli > Gestione moduli > Carica un modulo** inviando il file ZIP, oppure copiate la cartella `dfsurfacecalculator` nella directory `/modules/` del negozio e fate clic su Installa.

All'installazione il modulo crea tre tabelle (impostazioni per prodotto, valori per combinazione, calcoli salvati sui carrelli), registra i suoi hook e aggiunge la scheda **Calcolatore di quantità** nel menu Catalogo. Il pulsante Configura della gestione moduli apre la stessa pagina.

Il calcolatore non compare in nessuna scheda finché nessun prodotto è configurato: potete quindi installare il modulo su un negozio in produzione senza alcun cambiamento visibile immediato.

## I cinque tipi di calcolo

- **Piastrelle e pavimenti (m²)**: lunghezza × larghezza di ogni stanza, o superficie nota. Il contenuto di un'unità è la superficie coperta da una scatola o confezione.
- **Pittura (litri)**: lunghezza × altezza di ogni parete, numero di mani, resa in m² per litro, porte e finestre sottratte. Il contenuto di un'unità è il volume del barattolo.
- **Carta da parati (rotoli)**: larghezza e altezza di ogni parete. Il modulo conta i teli, arrotonda la lunghezza di ogni telo al rapporto del motivo e calcola il numero di teli interi per rotolo.
- **Volume: calcestruzzo, ghiaia, terra (m³)**: lunghezza × larghezza × spessore in centimetri, o volume noto. Il risultato è in m³ per unità, oppure in sacchi se indicate la densità del materiale e il peso di un sacco.
- **Lunghezza: battiscopa, profili (m)**: lunghezza di ogni parete o tratto. Il contenuto di un'unità è la lunghezza di un pezzo.

## Configurare un prodotto

Aprite la scheda del prodotto, scheda **Moduli**, blocco **Calcolatore di quantità**.

1. Spuntate **Mostra il calcolatore su questo prodotto**.
2. Scegliete il **Tipo di calcolo** e l'unità di vendita in **Venduto a** (scatola, confezione, barattolo, secchio, rotolo, sacco, pezzo, pallet o unità). È l'unità mostrata al cliente: «Vi servono 12 scatole».
3. Inserite il contenuto di un'unità. L'etichetta del campo cambia secondo il tipo di calcolo: superficie coperta da una unità, volume di un barattolo, rotoli per unità, volume di una unità o lunghezza di un pezzo.
4. Completate i campi specifici del tipo di calcolo (vedi sotto).
5. Fate clic su **Salva le impostazioni del calcolatore**. Le impostazioni vengono salvate anche con il pulsante di salvataggio generale della scheda prodotto.

### Pittura

Indicate la **Resa** in m² per litro, come riportata sul barattolo, e il numero di **Mani proposte di default**. L'opzione **Consenti al cliente di sottrarre porte e finestre** aggiunge due campi al calcolatore; la superficie sottratta per ogni porta e finestra si regola nella configurazione del modulo (1,7 m² e 1,5 m² per impostazione predefinita).

### Carta da parati

Indicate la **Larghezza del rotolo** in centimetri, la **Lunghezza del rotolo** in metri e il **Rapporto del motivo** in centimetri (0 o vuoto per una carta senza motivo). Se il prodotto è venduto a rotolo, lasciate vuoto il campo «Rotoli per unità». Ogni telo misura l'altezza della parete più 10 cm di rifilatura, arrotondata al rapporto successivo.

### Volume venduto in sacchi

Per un prodotto venduto a peso, lasciate vuoto il volume per unità e indicate la **Densità del materiale** in kg/m³ e il **Peso di una unità** in kg. Il modulo converte allora il volume in peso e poi in numero di sacchi. Valori indicativi: ghiaia da 1500 a 1700, sabbia 1600, calcestruzzo secco premiscelato 2000.

### Margine di taglio specifico del prodotto

Il campo **Margine di taglio predefinito per questo prodotto** sostituisce il margine preselezionato solo per questo prodotto. Lasciatelo vuoto per usare il valore del modulo. Se il valore inserito non è tra le scelte proposte, viene aggiunto alle scelte di questo prodotto.

## Valori per combinazione e combinazione di confezioni

Se il prodotto ha delle combinazioni, compare una tabella **Valori per combinazione**. Compilate solo le combinazioni il cui contenuto è diverso dal valore del prodotto, per esempio un barattolo da 2,5 L e uno da 10 L. Per un prodotto venduto a peso, il valore inserito è il peso di un'unità in kg.

Se le vostre combinazioni sono formati di confezione, spuntate **Le combinazioni sono formati di confezione: proponi la combinazione di formati più economica**. Sotto il risultato il calcolatore mostra allora la combinazione di formati che copre il fabbisogno al prezzo più basso, il risparmio rispetto al formato selezionato e un pulsante che aggiunge tutte le righe al carrello. La ricerca riguarda i cinque formati con il miglior prezzo per unità di contenuto.

## Usare una caratteristica prodotto

Se il vostro catalogo riporta già il contenuto di un'unità in una caratteristica (per esempio «Superficie per scatola: 1,44»), selezionatela in **Caratteristica con il contenuto per unità** nella configurazione. Serve da valore predefinito quando il campo del prodotto è vuoto. Lo stesso vale per la resa della pittura con **Caratteristica con la resa della pittura**. Il modulo legge il primo numero del valore, con virgola o punto.

## Attivazione in blocco per categoria

Nella pagina del modulo, il blocco **Assegnazione massiva per categoria** attiva o disattiva il calcolatore su tutti i prodotti delle categorie selezionate, sottocategorie comprese se la casella è spuntata. Scegliete il tipo di calcolo e l'unità di vendita da applicare. Per impostazione predefinita i prodotti già configurati mantengono le loro impostazioni; spuntate **Cambia anche il tipo e l’unità dei prodotti già configurati** per sovrascriverle. I valori di confezione già inseriti non vengono mai cancellati.

Un prodotto attivato senza informazioni sulla confezione, né nel suo campo né nella caratteristica scelta, resta nascosto nel negozio. Compare con lo stato **Incompleto** nell'elenco dei prodotti configurati, con un link per aprire la sua scheda.

## Prodotti complementari

Nella scheda Moduli del prodotto, il blocco **Prodotti complementari** associa fino a 6 prodotti calcolati insieme al prodotto principale: adesivo e stucco per le piastrelle, primer per la pittura, colla per la carta da parati, sabbia per il calcestruzzo.

1. Digitate almeno due caratteri del nome o del riferimento in **Aggiungi un prodotto complementare**, poi scegliete il prodotto o la combinazione nell'elenco. Funzionano anche le frecce della tastiera e il tasto Invio.
2. Indicate il **Consumo** per unità di misura del calcolo: per m² per piastrelle, pittura e carta da parati, per m³ per il volume, per metro per il lineare.
3. Indicate il **Contenuto di una unità** del prodotto complementare, nella stessa unità del consumo.
4. Salvate le impostazioni del calcolatore.

La quantità proposta è la superficie, il volume o la lunghezza netta inserita dal cliente, moltiplicata per il consumo, divisa per il contenuto di una unità e arrotondata per eccesso. Esempio: un adesivo consumato a 5 kg per m² e venduto in sacchi da 25 kg si imposta con 5 e 25; per 14,7 m² al cliente vengono proposti 3 sacchi. Per prevedere delle perdite, includetele nel consumo.

Nel negozio i prodotti compaiono sotto il risultato, selezionati per impostazione predefinita, con quantità, prezzo e totale. Il pulsante **Aggiungi al carrello i prodotti selezionati** li aggiunge in una volta. Un prodotto esaurito, quando gli ordini senza stock non sono consentiti, è in grigio e non selezionato. I prodotti inattivi o non ordinabili non vengono mostrati.

## Sconti quantità e stock

Il prezzo stimato applica gli sconti quantità definiti in PrestaShop per la combinazione selezionata, con la dicitura «Sconto quantità incluso». Le regole carrello e le spese di spedizione non sono incluse.

Se la gestione delle scorte è attiva e la quantità calcolata supera lo stock disponibile, il cliente vede lo stock residuo. Quando gli ordini senza stock non sono consentiti, il pulsante di aggiunta al carrello viene nascosto e resta solo il link **Usa questa quantità**. Quando sono consentiti, il cliente viene informato che il resto sarà spedito al riassortimento. La combinazione di confezioni non propone mai più dello stock disponibile di un formato e rispetta la quantità minima d'ordine di ogni combinazione.

## Statistiche

La pagina del modulo mostra un blocco **Risultati del calcolatore**, sugli ultimi 30 giorni e dall'installazione: carrelli con un prodotto aggiunto dal calcolatore, ordini convalidati da questi carrelli, tasso di conversione e fatturato IVA esclusa dei prodotti calcolati e complementari, convertito nella valuta predefinita. Una tabella elenca i cinque prodotti che hanno generato più fatturato.

Sono conteggiati solo i prodotti aggiunti con i pulsanti del calcolatore, e l'opzione **Salva il calcolo con la riga del carrello** deve essere attiva per raccogliere i dati.

## Impostazioni del modulo

### Visualizzazione

- **Posizione nella scheda prodotto**: sotto il pulsante Aggiungi al carrello (hook `displayProductAdditionalInfo`), accanto alle azioni prodotto (`displayProductActions`) o hook personalizzato.
- **Colore di accento**: colore dei pulsanti, delle scelte di margine e del risultato.
- **Prezzo al m², al litro, al metro o al m³**: mostra «cioè 22,85 € / m²» sotto il prezzo, nella scheda prodotto e negli elenchi.
- **Salva il calcolo con la riga del carrello**: conserva le misure del cliente per il carrello e per la pagina dell'ordine nel back office.
- **Mostra il calcolatore chiuso**: la scheda prodotto mostra un pulsante «Calcola la quantità che mi serve» che apre il calcolatore. Si apre da solo se il cliente ha già inserito delle misure, per esempio in una pagina del calcolatore.
- **Superficie della porta sottratta** e **Superficie della finestra sottratta** in m².

### Margini di taglio

Per ogni tipo di calcolo, inserite le scelte proposte al cliente, in percentuale e separate da virgole (per esempio `5,10,15`), e il margine preselezionato. Valori installati: piastrelle 5, 10 e 15 % (10 predefinito), pittura da 0 a 15 % (10), carta da parati da 0 a 10 % (5), volume da 0 a 10 % (5), battiscopa da 5 a 15 % (10).

### Hook personalizzato

Per posizionare il calcolatore altrove nella scheda, scegliete la posizione «Hook personalizzato» e aggiungete questa riga al template prodotto del vostro tema:

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

## Pagine SEO del calcolatore

Ogni tipo di calcolo può avere una propria pagina pubblica, con il calcolatore, i vostri prodotti dello stesso tipo con la quantità e il prezzo calcolati per le misure del visitatore, una spiegazione del metodo e i link agli altri calcolatori. Gli indirizzi seguono lo schema `/calcolatore/piastrelle-pavimenti`, `/calcolatore/pittura`, `/calcolatore/carta-da-parati`. L'elenco delle pagine pubblicate e i loro link si trovano in cima alla pagina del modulo.

- **Attiva le pagine del calcolatore** e **Pagine da pubblicare**: pubblicate solo i tipi pertinenti al vostro catalogo.
- **Prefisso URL**: comune a tutte le lingue, definito all'installazione in base alla lingua predefinita del negozio.
- **Prodotti mostrati per pagina**: 12 per impostazione predefinita, 0 nasconde l'elenco.
- Per ogni pagina e ogni lingua: **URL semplificato**, **Titolo** (H1 e tag title), **Meta description** e **Testo di introduzione**. Titoli e indirizzi scritti per le ricerche più comuni sono precompilati in 8 lingue.

Le pagine dichiarano un canonical, i tag hreflang delle lingue attive e un breadcrumb. Vengono aggiunte automaticamente alla sitemap del modulo **gsitemap** di PrestaShop alla sua generazione successiva. L'indirizzo di un'altra lingua reindirizza con un 301 a quello della lingua visualizzata. Se modificate un URL semplificato, il vecchio indirizzo non viene più servito: prevedete un reindirizzamento se la pagina era già indicizzata.

Il testo di introduzione è il posto giusto per i vostri consigli di posa e per il lessico dei vostri clienti. Evitate di copiare parola per parola la spiegazione del metodo, già mostrata sotto il calcolatore.

## Cosa vede il cliente

Il cliente inserisce una o più stanze, pareti o zone. Ogni blocco mostra il proprio subtotale. Dalla seconda zona in poi, la casella **Sottrai questa zona** permette di togliere un'isola, una vetrata o un armadio. Sceglie poi il margine tra i vostri valori.

Il risultato indica la superficie o il volume, il fabbisogno margine incluso, il numero di unità, il totale coperto con la scorta e il prezzo stimato. Il pulsante **Aggiungi 12 scatole al carrello** compila il campo quantità e attiva il pulsante carrello del tema. Il link **Usa questa quantità** compila solo il campo. Se il prodotto è esaurito, viene proposto solo questo link.

Un valore non numerico viene evidenziato in rosso e blocca il risultato. Un valore molto alto, per esempio 120 m come lunghezza di una stanza, mostra un promemoria sull'unità attesa. Le misure vengono conservate per la sessione: il visitatore le ritrova tra la pagina del calcolatore e la scheda prodotto.

## Carrello e ordini

Quando il cliente aggiunge al carrello dal calcolatore, le sue misure vengono salvate con la riga. Il carrello mostra un riepilogo sotto il prodotto, per esempio «Superficie 14,7 m² + 10% = 16,17 m². Calcolato: 12 scatole», e segnala se la quantità è stata modificata dopo. Nel back office, la pagina dell'ordine mostra un blocco **Calcoli delle quantità** con le stesse informazioni.

## Risoluzione dei problemi

### Il calcolatore non compare nella scheda prodotto

Verificate nell'elenco dei prodotti configurati che il prodotto sia attivo e che il suo stato non sia **Incompleto**. Verificate poi che l'hook della posizione scelta esista nel vostro tema; nel dubbio, provate l'altra posizione o l'hook personalizzato. Svuotate la cache del negozio dopo ogni modifica.

### Il messaggio «Mancano le informazioni sulla confezione per questa opzione»

La combinazione selezionata non ha un contenuto, e nemmeno il prodotto. Inserite il valore del prodotto o quello della combinazione nella tabella dei valori per combinazione.

### La pagina del calcolatore restituisce un errore 404

Verificate che le pagine siano attivate e che il tipo sia spuntato in **Pagine da pubblicare**. Se gli URL semplificati del negozio sono disattivati, la pagina resta raggiungibile tramite il suo indirizzo lungo, indicato in cima alla pagina del modulo.

### La combinazione di confezioni non compare

L'opzione deve essere spuntata, almeno due combinazioni devono avere un contenuto e un prezzo, e la combinazione viene proposta solo se costa meno del formato selezionato.

### Il prezzo al m² non compare negli elenchi prodotti

Viene mostrato tramite l'hook `displayProductPriceBlock` di tipo `unit_price`, che alcuni temi non richiamano nelle miniature prodotto. Aggiungete la chiamata al template della miniatura o disattivate l'opzione.

## Compatibilità

- PrestaShop da 8.0 a 9.x, lo stesso ZIP copre entrambe le versioni.
- Multinegozio e multilingua.
- Architettura ModuleAdminController, senza dipendenze Composer.
- Interfaccia e testi del calcolatore disponibili in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.
