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

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

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.