Module Prijs « Vanaf » (dffromprice): documentatie

De module dffromprice (« Vanaf ») toont de laagste prijs per hoeveelheid meteen in uw productoverzichten, zodra een product een staffelkorting heeft. Deze documentatie behandelt de installatie, de volledige configuratie en de probleemoplossing.

Overzicht

Heeft een product staffelkortingen (bijvoorbeeld « 3 gekocht, 20 % korting »), dan is die informatie alleen op de productfiche zichtbaar, helemaal onderaan. De module haalt een opschrift « Vanaf X € » naar de productminiatuur, in de categorieën, de zoekresultaten en de blokken met kruisverkoop en uitgelichte producten. De getoonde prijs wordt met het native mechanisme van PrestaShop berekend, rekening houdend met de klantgroep, de valuta, het land en de manier waarop de belasting wordt berekend.

Installatie

Via de backoffice

1. Ga naar Modules > Modulebeheer.
2. Klik op Een module installeren en kies het ZIP-bestand van de module.
3. Zodra het uploaden klaar is, installeert de module zichzelf en registreert hij zijn hooks.

Via FTP

1. Pak het archief uit en plaats de map dffromprice in de map /modules van uw winkel.
2. Zoek in Modules > Modulebeheer naar « Vanaf » en klik op Installeren.

Instellingen

De configuratie staat in Modules > Modulebeheer > dffromprice > Configureren. Zij bestaat uit twee panelen.

Weergave

• De module inschakelen: de hoofdschakelaar.
• Tonen in de productoverzichten: categorieën, zoekresultaten, kruisverkoop en uitgelichte producten.
• Tonen op de productfiche: zet de prijs « Vanaf » na de hoofdprijs op de productfiche.
• Opschrift: de tekst vóór de prijs, per taal te vertalen (« Vanaf », « From » en zo verder).
• De minimale hoeveelheid tonen: geeft aan welk aantal nodig is om de beste prijs te krijgen.
• Opschrift bij de hoeveelheid: de tekst bij het aantal, met de variabele %qty% (bijvoorbeeld « vanaf %qty% stuks »).
• Het kortingspercentage tonen: een badge « -21 % », op basis van het verschil tussen de basisprijs en de beste staffelprijs.
• Btw-opschrift (incl. of excl. btw): Nooit, Volgens de instellingen van de winkel, of Altijd.
• Weergavemodus: De gewone prijs vervangen of Naast de gewone prijs tonen.
• Te verbergen CSS-selector(s): in de vervangmodus de CSS-selectors die worden verborgen wanneer de prijs « Vanaf » verschijnt.

Uitzicht en beperkingen

• Tekstkleur: een kleurkiezer, standaard #f1a019.
• Minimale korting om te tonen (%): verbergt de prijs « Vanaf » als de korting onder dat percentage blijft. 0 betekent altijd tonen.
• Uitgesloten product-ID’s: een lijst met ID’s, gescheiden door komma’s.
• Uitgesloten categorie-ID’s: een lijst met ID’s, gescheiden door komma’s (op basis van de standaardcategorie van het product).
• Eigen CSS: wordt op alle pagina’s aan de frontzijde toegevoegd, om het blok .df-fromprice en de onderdelen ervan aan te spreken.

Werking en prijsberekening

De module steunt op SpecificPrice::getQuantityDiscounts() met dezelfde parameters als de native tabel « Staffelkorting » (winkel, valuta, land, klantgroep, klant). Voor elke staffel boven 1 wordt de werkelijke stukprijs met Product::getPriceStatic() berekend. De prijs « Vanaf » verschijnt alleen als die prijs strikt lager is dan de basisprijs. Een statische cache per product en per variant zorgt voor één enkele berekening per miniatuur binnen dezelfde pagina.

Compatibiliteit met thema’s

De module haakt in op de hook displayProductPriceBlock, die in alle standaard productoverzichten van PrestaShop aanwezig is. In de vervangmodus wordt de gewone prijs verborgen met de instelbare CSS-selector. De standaardwaarde dekt de thema’s op basis van Classic en het Falcon-thema:

.df-fromprice + .wrapper-price-taxe, .df-fromprice + .price

Bekijk bij een ander thema de prijscontainer in de miniatuur en pas de selector daarop aan.

Problemen oplossen

De prijs « Vanaf » verschijnt niet

• Controleer of het product wel een staffelkorting heeft (een staffel boven 1) en of de staffelprijs lager is dan de basisprijs.
• Controleer of de weergave in de productoverzichten aanstaat.
• Bekijk de minimale kortingsdrempel: staat die te hoog, dan kan de weergave geblokkeerd blijven.
• Ga na of het product of zijn categorie niet bij de uitsluitingen staat.

De gewone prijs blijft zichtbaar in de vervangmodus

De CSS-selector om te verbergen komt niet overeen met de prijscontainer van uw thema. Pas het veld « Te verbergen CSS-selector(s) » aan en leeg daarna de cache.