Hoeveelheidscalculator op oppervlakte en volume: installatie en configuratie

Installatie

Installeer de module via Modules > Modulebeheer > Een module uploaden met het ZIP-bestand, of kopieer de map dfsurfacecalculator naar de map /modules/ van uw winkel en klik op Installeren.

Bij de installatie maakt de module drie tabellen aan (instellingen per product, waarden per combinatie, berekeningen opgeslagen bij winkelwagens), registreert de hooks en voegt het tabblad Hoeveelheidscalculator toe onder het menu Catalogus. De knop Configureren in Modulebeheer opent dezelfde pagina.

Zolang er geen product is ingesteld, verschijnt de calculator op geen enkele productpagina. U kunt de module dus in een live winkel installeren zonder direct zichtbare verandering.

De vijf soorten berekening

• Tegels en vloeren (m²): lengte × breedte van elke ruimte, of bekende oppervlakte. De inhoud van een eenheid is de oppervlakte die een doos of pak dekt.
• Verf (liter): lengte × hoogte van elke muur, aantal lagen, rendement in m² per liter, deuren en ramen afgetrokken. De inhoud van een eenheid is het volume van het blik.
• Behang (rollen): breedte en hoogte van elke muur. De module telt de banen, rondt elke baanlengte af op het patroonrapport en berekent het aantal volledige banen per rol.
• Volume: beton, grind, aarde (m³): lengte × breedte × dikte in centimeters, of bekend volume. Het resultaat is in m³ per eenheid, of in zakken als u de dichtheid van het materiaal en het gewicht van een zak invult.
• Lengte: plinten, profielen (m): lengte van elke muur of elk deel. De inhoud van een eenheid is de lengte van één stuk.

Een product instellen

Open de productpagina, tabblad Modules, blok Hoeveelheidscalculator.

1. Vink De calculator op dit product tonen aan.
2. Kies het Type berekening en de verkoopeenheid onder Verkocht per (doos, pak, blik, emmer, rol, zak, stuk, pallet of eenheid). Dit is de eenheid die de klant ziet: „U hebt nodig 12 dozen”.
3. Vul de inhoud van één eenheid in. Het label van het veld verandert met het type berekening: oppervlakte gedekt door één eenheid, inhoud van één blik, rollen per eenheid, volume van één eenheid of lengte van één stuk.
4. Vul de velden van het type berekening in (zie hieronder).
5. Klik op Calculatorinstellingen opslaan. De instellingen worden ook opgeslagen met de algemene opslagknop van de productpagina.

Verf

Vul het Rendement in m² per liter in, zoals vermeld op het blik, en het aantal Standaard voorgestelde lagen. De optie De klant deuren en ramen laten aftrekken voegt twee velden aan de calculator toe; de afgetrokken oppervlakte per deur en per raam stelt u in de moduleconfiguratie in (standaard 1,7 m² en 1,5 m²).

Behang

Vul de Rolbreedte in centimeters, de Rollengte in meters en het Patroonrapport in centimeters in (0 of leeg voor behang zonder patroon). Wordt het product per rol verkocht, laat het veld „Rollen per eenheid” dan leeg. Elke baan is de muurhoogte plus 10 cm om bij te snijden, naar boven afgerond op het volgende rapport.

Volume verkocht in zakken

Laat bij een product op gewicht het volume per eenheid leeg en vul de Dichtheid van het materiaal in kg/m³ en het Gewicht van één eenheid in kg in. De module rekent het volume dan om naar gewicht en vervolgens naar een aantal zakken. Richtwaarden: grind 1500 tot 1700, zand 1600, droge betonmortel 2000.

Eigen marge voor snijverlies per product

Het veld Standaardmarge voor snijverlies bij dit product vervangt de voorgeselecteerde marge alleen voor dit product. Laat het leeg om de waarde van de module te gebruiken. Staat de ingevulde waarde niet tussen de aangeboden keuzes, dan wordt ze aan de keuzes van dit product toegevoegd.

Waarden per combinatie en mix van verpakkingen

Heeft het product combinaties, dan verschijnt een tabel Waarden per combinatie. Vul alleen de combinaties in waarvan de inhoud afwijkt van de productwaarde, bijvoorbeeld een blik van 2,5 L en een van 10 L. Bij een product op gewicht is de waarde het gewicht van één eenheid in kg.

Zijn uw combinaties verpakkingsgroottes, vink dan De combinaties zijn verpakkingsgroottes: stel de goedkoopste mix van groottes voor aan. Onder het resultaat toont de calculator dan de combinatie van groottes die de behoefte dekt tegen de laagste prijs, de besparing ten opzichte van de gekozen grootte en een knop die alle regels in de winkelwagen legt. De zoektocht omvat de vijf groottes met de beste prijs per inhoudseenheid.

Een productkenmerk gebruiken

Vermeldt uw catalogus de inhoud van een eenheid al in een kenmerk (bijvoorbeeld „Oppervlakte per doos: 1,44”), selecteer het dan in de configuratie onder Kenmerk met de inhoud per eenheid. Het dient als standaardwaarde wanneer het productveld leeg is. Voor het rendement van verf geldt hetzelfde met Kenmerk met het rendement van de verf. De module leest het eerste getal van de waarde, met komma of punt.

Bulkactivering per categorie

Op de modulepagina schakelt het blok Bulktoewijzing per categorie de calculator in of uit voor alle producten van de gekozen categorieën, subcategorieën inbegrepen als het vakje is aangevinkt. Kies het type berekening en de verkoopeenheid die u wilt toepassen. Standaard behouden al ingestelde producten hun instellingen; vink Ook het type en de eenheid van al geconfigureerde producten wijzigen aan om ze te overschrijven. Al ingevulde verpakkingswaarden worden nooit gewist.

Module-instellingen

Weergave

• Positie op de productpagina: onder de knop In winkelwagen (hook displayProductAdditionalInfo), naast de productacties (displayProductActions) of eigen hook.
• Accentkleur: kleur van de knoppen, de margekeuzes en het resultaat.
• Prijs per m², liter, meter of m³: toont „dus 22,85 € / m²” onder de prijs, op de productpagina en in productlijsten.
• De berekening opslaan bij de winkelwagenregel: bewaart de afmetingen van de klant voor de winkelwagen en de bestelpagina in de back-office.
• Afgetrokken deuroppervlakte en Afgetrokken raamoppervlakte in m².

Marges voor snijverlies

Vul per type berekening de keuzes voor de klant in, als percentage en gescheiden door komma’s (bijvoorbeeld 5,10,15), en de voorgeselecteerde marge. Geïnstalleerde waarden: tegels 5, 10 en 15 % (standaard 10), verf 0 tot 15 % (10), behang 0 tot 10 % (5), volume 0 tot 10 % (5), plinten 5 tot 15 % (10).

Eigen hook

Om de calculator elders op de productpagina te plaatsen, kiest u de positie „Eigen hook” en voegt u deze regel toe aan het producttemplate van uw thema:

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

SEO-calculatorpagina’s

Elk type berekening kan een eigen openbare pagina krijgen, met de calculator, uw producten van hetzelfde type met de hoeveelheid en prijs voor de afmetingen van de bezoeker, een uitleg van de methode en links naar de andere calculators. De adressen volgen het patroon /calculator/tegels-vloeren, /calculator/verf, /calculator/behang. De lijst van gepubliceerde pagina’s en hun links staat bovenaan de modulepagina.

• Calculatorpagina’s inschakelen en Te publiceren pagina’s: publiceer alleen de types die bij uw catalogus passen.
• URL-voorvoegsel: gelijk voor alle talen, bij de installatie bepaald volgens de standaardtaal van de winkel.
• Getoonde producten per pagina: standaard 12, 0 verbergt de lijst.
• Per pagina en per taal: Vriendelijke URL, Titel (H1 en title-tag), Metabeschrijving en Introductietekst. Titels en adressen voor veelgebruikte zoekopdrachten zijn in 8 talen vooraf ingevuld.

De pagina’s geven een canonical, hreflang-tags van de actieve talen en een broodkruimel. Ze worden bij de volgende generatie automatisch opgenomen in de sitemap van de PrestaShop-module gsitemap. Het adres van een andere taal verwijst met een 301 door naar dat van de getoonde taal. Wijzigt u een vriendelijke URL, dan wordt het oude adres niet meer geserveerd: stel een doorverwijzing in als de pagina al geïndexeerd was.

Wat de klant ziet

De klant vult een of meer ruimtes, muren of zones in. Elk blok toont zijn subtotaal. Vanaf de tweede zone trekt het vakje Deze zone aftrekken een kookeiland, een pui of een kast af. Daarna kiest hij de marge uit uw waarden.

Het resultaat toont de oppervlakte of het volume, de behoefte inclusief marge, het aantal eenheden, het totaal gedekt met de reserve en de geschatte prijs. De knop 12 dozen in winkelwagen vult het aantalveld in en activeert de winkelwagenknop van het thema. De link Deze hoeveelheid gebruiken vult alleen het veld in. Is het product niet op voorraad, dan wordt alleen deze link aangeboden.

Een niet-numerieke waarde wordt rood omlijnd en blokkeert het resultaat. Een zeer hoge waarde, bijvoorbeeld 120 m als lengte van een ruimte, toont een herinnering aan de verwachte eenheid. De afmetingen blijven tijdens de sessie bewaard: de bezoeker vindt ze terug tussen de calculatorpagina en de productpagina.

Winkelwagen en bestellingen

Wanneer de klant vanuit de calculator iets in de winkelwagen legt, worden zijn afmetingen bij de regel opgeslagen. De winkelwagen toont een samenvatting onder het product, bijvoorbeeld „Oppervlakte 14,7 m² + 10% = 16,17 m². Berekend: 12 dozen”, en meldt het als het aantal daarna is gewijzigd. In de back-office toont de bestelpagina een blok Hoeveelheidsberekeningen met dezelfde gegevens.

Probleemoplossing

De calculator verschijnt niet op de productpagina

Controleer in de lijst van geconfigureerde producten of het product actief is en niet de status Onvolledig heeft. Controleer daarna of de hook van de gekozen positie in uw thema bestaat; probeer bij twijfel de andere positie of de eigen hook. Leeg de cache van de winkel na elke wijziging.

De melding „De verpakkingsgegevens ontbreken voor deze optie”

De gekozen combinatie heeft geen inhoud, en het product ook niet. Vul de productwaarde in, of de waarde van de combinatie in de tabel met waarden per combinatie.

De calculatorpagina geeft een 404-fout

Controleer of de pagina’s zijn ingeschakeld en of het type is aangevinkt bij Te publiceren pagina’s. Zijn vriendelijke URL’s in de winkel uitgeschakeld, dan blijft de pagina bereikbaar via het lange adres dat bovenaan de modulepagina staat.

De mix van verpakkingen wordt niet getoond

De optie moet zijn aangevinkt, minstens twee combinaties moeten een inhoud en een prijs hebben, en de mix wordt alleen voorgesteld als die goedkoper is dan de gekozen grootte.

De prijs per m² verschijnt niet in productlijsten

Hij wordt getoond via de hook displayProductPriceBlock van het type unit_price, die sommige thema’s niet aanroepen in de productminiaturen. Voeg de aanroep toe aan het miniatuurtemplate of schakel de optie uit.

Compatibiliteit

• PrestaShop 8.0 tot 9.x, hetzelfde ZIP dekt beide versies.
• Multistore en meertalig.
• Architectuur ModuleAdminController, zonder Composer-afhankelijkheid.
• Interface en calculatorteksten beschikbaar in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.