PS PrestaShop Beginner

DF Quantity Tiers: volledige gids

DF Quantity Tiers installeren, configureren en benutten: staffelprijzen tonen, per staffel toevoegen, aanmoediging in de winkelwagen, B2B-modus, voorraad, JSON-LD, statistieken en vertalingen.

Bijgewerkt Moduleversie 1.2.2

Overzicht en vereisten

DF Quantity Tiers maakt van de native hoeveelheidskortingen van PrestaShop een helder en aanklikbaar verkoopblok. De module voegt geen nieuwe prijslogica toe: hij leest de specifieke prijzen « vanaf N stuks » die al in uw catalogus staan en zet die neer als kaarten of als tabel, met per staffel een knop om aan de winkelwagen toe te voegen.

  • Compatibel met PrestaShop 8.0 tot 9.x, het Classic-thema en daarvan afgeleide thema’s.
  • PHP 7.4 tot 8.3.
  • Multistore en meertalig: interface vertaald in het Engels, Frans, Duits, Italiaans, Spaans, Nederlands, Portugees en Pools. Elke andere taal toont de teksten in het Engels.
  • Geen enkele bestandsoverride: uitsluitend native hooks.

De staffels komen uit Catalogus > Product > Prijzen > Specifieke prijzen, veld « Vanaf hoeveelheid ». Heeft een product geen specifieke prijzen per hoeveelheid, dan verschijnt het blok voor dat product niet.

Installatie

Installeer de module zoals elke andere PrestaShop-module:

  1. Download het archief dfquantitytiers-1.2.2.zip vanuit uw klantaccount.
  2. Ga in de backoffice naar Modules > Modulebeheer.
  3. Klik op Een module uploaden en plaats het archief.
  4. Klik na de installatie op Configureren.

Bij de installatie registreert de module zijn hooks, maakt hij zijn statistiektabel aan en vult hij in elke taal van de winkel een vertaalde bloktitel vooraf in. Uw bestaande staffelprijzen verschijnen meteen op de betrokken productpagina’s.

Bijwerken

De update verloopt gewoon via het Modulebeheer: upload het nieuwe archief over de oude versie heen. Uw bestaande configuratie blijft behouden.

  • Vanaf 1.0.0: het ingebouwde upgradescript maakt de statistiektabel aan, registreert de hook voor de winkelwagenpagina en past de standaardwaarden toe van de opties die in 1.1.0 zijn verschenen.
  • Vanaf 1.1.x of 1.2.0: er is geen migratie nodig.

Leeg na de update de cache via Geavanceerde instellingen > Prestaties. Zonder deze stap kan PrestaShop de oude templates en de oude teksten blijven tonen (bijvoorbeeld Franse labels in een Italiaanse winkel).

Algemene configuratie

De configuratiepagina bundelt alle weergave-instellingen:

  • Bloktitel: tekst boven de staffels, per taal vertaalbaar. Laat het veld leeg om de titel volledig te verbergen.
  • Weergave: « Kaarten (aanbevolen) », één kaart per staffel, of « Compacte tabel », één rij per staffel.
  • Positie op de productpagina: onder het aankoopblok (hook displayProductAdditionalInfo, standaard) of rechtstreeks onder de prijs (hook displayProductPriceBlock).
  • Accentkleur: toegepast op de staffel « Beste deal », op de badges en op de knoppen.
  • Weergave van de besparing: als percentage (« -10% »), als bespaard bedrag per stuk (« U bespaart 0,78 € / stuk »), of allebei.
  • Totaalprijs van de staffel tonen: voegt het totaal toe voor precies de hoeveelheid van de staffel, gelabeld « Totaal voor 6 stuks: 42,12 € ». Standaard uitgeschakeld.
  • Staffel « per stuk » tonen: toont de basisprijs als eerste vergelijkingsstaffel.

De besparing wordt per stuk uitgedrukt, zodat ze klopt ongeacht de bestelde hoeveelheid: een klant die 7 stuks neemt bij een staffel « 6+ » bespaart op elk stuk precies 0,78 €. De totaalprijs geldt daarentegen alleen voor de exacte hoeveelheid van de staffel; daarom is die standaard uitgeschakeld.

De staffel met de laagste stukprijs krijgt automatisch de badge « Beste deal » (alleen wanneer er minstens twee kortingsstaffels zijn). Wijzigt de klant de hoeveelheid, dan wordt de kaart die bij zijn keuze past in realtime gemarkeerd.

Belastingmodus (B2B)

De belastingmodus bepaalt of de prijzen van de staffels exclusief of inclusief btw worden getoond:

  • Automatisch (klantengroep): volgt de prijsweergave-instelling van de huidige klantengroep (het standaardgedrag van PrestaShop).
  • Excl. btw forceren: toont de prijzen stelselmatig exclusief btw, met de vermelding « excl. btw » naast elke stukprijs. Ideaal voor een zakelijke winkel.
  • Incl. btw forceren: toont de prijzen stelselmatig inclusief btw, met de vermelding « incl. btw ».

De gekozen modus geldt voor de kaarten op de productpagina, voor het aanmoedigingsblok in de winkelwagen en voor de gestructureerde gegevens. De vermelding wordt vertaald in de taal van de bezoeker (bijvoorbeeld « IVA escl. » in het Italiaans, « zzgl. MwSt. » in het Duits).

Verpakkingslabels

U kunt aan elke hoeveelheid een eigen label koppelen, bijvoorbeeld « doos » of « pallet ». Voer in het veld Verpakkingslabels per regel één koppeling in, in de vorm aantal=label:

12=Doos van 12
48=Halve pallet
96=Pallet

Het label verschijnt onder het aantal van de bijbehorende staffel. Dit veld is vertaalbaar: vul het per taal in via de taalkiezer van het formulier.

Voorraad, minimale hoeveelheid en zichtbaarheid van de prijzen

Het blok respecteert de verkoopregels van PrestaShop:

  • Minimale bestelhoeveelheid: wordt een product alleen per 6 verkocht, dan voegt de knop van de staffel « per stuk » 6 stuks toe en toont hij « Toevoegen 6 ».
  • Voorraad: is het voorraadbeheer actief en worden bestellingen zonder voorraad geweigerd, dan worden de knoppen van de staffels waarvan de hoeveelheid de beschikbare voorraad overschrijdt uitgeschakeld, met de vermelding « Onvoldoende voorraad ».
  • Niet bestelbaar product (optie « Beschikbaar voor bestelling » uitgevinkt, catalogusmodus): de staffels blijven ter informatie zichtbaar, zonder toevoegknop.
  • Verborgen prijzen (catalogusmodus zonder prijzen, klantengroep zonder prijsweergave, optie « Prijs tonen » uitgevinkt): het blok wordt niet getoond.

Aanmoediging naar de volgende staffel

Er zijn twee aanmoedigingsmechanismen, die u onafhankelijk van elkaar kunt inschakelen.

Op de productpagina

Een voortgangsbalk toont een bericht van het type « Voeg nog 3 stuk(s) toe en bespaar 15% », dat in realtime opnieuw wordt berekend op basis van de ingevoerde hoeveelheid. Bereikt de klant de voordeligste staffel, dan wisselt het bericht naar « U krijgt de hoogste korting! ».

Op de winkelwagenpagina

Voor elk product in de winkelwagen waarvoor een hogere staffel binnen bereik blijft, toont de module onder de winkelwagen een blok « Voeg nog N stuk(s) toe om X € per stuk te betalen », met een knop om in één klik toe te voegen. De knop gebruikt het native updatemechanisme van de winkelwagen van PrestaShop en ververst daarna de pagina.

  • Worden de hoeveelheidskortingen per product berekend (PrestaShop-instelling Hoeveelheidskortingen gebaseerd op: Producten), dan worden de hoeveelheden van alle varianten van het product opgeteld, zoals PrestaShop dat ook voor de prijs doet.
  • Er wordt niets voorgesteld als de voorraad niet volstaat om de staffel te bereiken, en evenmin voor gratis producten.
  • Weigert PrestaShop de toevoeging (voorraad, maximale hoeveelheid…), dan verschijnt de foutmelding rechtstreeks in het blok.

Gestructureerde gegevens (JSON-LD)

Staat de optie aan, dan voegt de module op de productpagina een JSON-LD-markup Product toe met een aanbod Offer waarvan het veld priceSpecification per staffel een UnitPriceSpecification bevat, met de minimale in aanmerking komende hoeveelheid (eligibleQuantity) en de vermelding incl./excl. btw. Dat is de aanbevolen vorm voor staffelprijzen van één en dezelfde verkoper. De markup bevat ook de beschikbaarheid, de hoofdafbeelding en de referentie (SKU).

Genereert uw thema of een andere SEO-module al een volledige Product– / Offer-markup voor uw producten, schakel deze optie dan uit om een dubbele markup te vermijden die in Search Console wordt gesignaleerd.

Klikstatistieken per staffel

Staat de optie aan, dan wordt elke klik op een toevoegknop per staffel anoniem vastgelegd: product, variant, hoeveelheid en korting van de aangeklikte staffel. Er worden geen persoonsgegevens en geen cookies gebruikt, waardoor de functie AVG-conform is.

De staffel wordt aan de serverzijde opnieuw gecontroleerd en de korting wordt herberekend op basis van uw werkelijke prijzen: de gegevens kunnen dus niet worden vervalst met gemanipuleerde verzoeken. Klikken die ouder zijn dan een jaar worden automatisch verwijderd om de tabel licht te houden.

De configuratiepagina toont een dashboard over de laatste 30 dagen: het totale aantal klikken en de meest aangeklikte combinaties van product, staffel en korting. Die gegevens helpen u uw kortingen af te stellen door te zien welke staffels daadwerkelijk tot toevoegingen aan de winkelwagen leiden.

Vertalingen

De teksten van de module worden geleverd in het Engels, Frans, Duits, Italiaans, Spaans, Nederlands, Portugees en Pools. Ze passen zich automatisch aan de taal van de bezoeker en van de backoffice aan. Wilt u een formulering wijzigen, ga dan naar Internationaal > Vertalingen > Vertalingen van geïnstalleerde modules en kies dfquantitytiers.

De teksten die u in de configuratie invoert (bloktitel, verpakkingslabels) vult u per taal in via de taalkiezer van het formulier.

FAQ en probleemoplossing

Het blok verschijnt niet bij een product

Controleer of het product wel specifieke prijzen heeft met een beginhoeveelheid hoger dan 1, of die prijzen gelden voor de huidige klantengroep, valuta en land, en of de prijzen zichtbaar zijn voor deze klant (zie « Voorraad, minimale hoeveelheid en zichtbaarheid van de prijzen »).

De teksten verschijnen in het Frans in een winkel in een andere taal

U gebruikt een versie ouder dan 1.2.0, waarvan de teksten niet vertaald waren. Installeer de nieuwste versie en leeg daarna de cache via Geavanceerde instellingen > Prestaties.

De velden « Bloktitel » en « Verpakkingslabels » hebben geen invoerveld

Deze weergavefout van het configuratieformulier is sinds 1.2.0 verholpen. Na de update verschijnen beide velden met hun taalkiezer.

Het getoonde totaal of de besparing komt niet overeen met de bestelde hoeveelheid

Sinds 1.2.1 wordt de besparing per stuk getoond en klopt ze voor elke hoeveelheid binnen de staffel. De totaalprijs geldt alleen voor de exacte hoeveelheid van de staffel: schakel de optie Totaalprijs van de staffel tonen uit als u die niet wilt tonen.

De toevoegknop werkt niet met mijn thema

De module steunt op de standaard toevoegknop van het Classic-thema. Controleer bij een sterk aangepast thema of het hoeveelheidsveld (name="qty") en de toevoegknop (data-button-action="add-to-cart") de standaardmarkup van PrestaShop volgen.

Het blok verschijnt niet in de snelle weergave (quickview)

Dat is bewust: het venster voor de snelle weergave laadt de stijlen van de module niet. De staffels verschijnen op de volledige productpagina.

Werkt het met varianten?

Ja. De staffels worden per combinatie opnieuw berekend en het blok werkt zichzelf bij zodra de variant verandert, zonder de pagina te herladen.

Wat gebeurt er bij het verwijderen?

Het verwijderen wist netjes de hooks, de configuratievariabelen en de statistiektabel. Er blijven geen restgegevens in de database achter.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support