Groepsaankoop en collectieve staffelprijzen — Complete handleiding
Groepsaankoop installeren, configureren en benutten: collectieve prijsniveaus, telmodi, terugwerkende terugbetaling, prijzen per hoeveelheidsniveau en realtime widget voor PrestaShop 8 en 9.
Presentatie en vereisten
Groepsaankoop introduceert een collectieve degressieve prijs: hoe meer kopers een product heeft, hoe lager de stuksprijs voor iedereen. U definieert niveaus (een kopersdrempel ontgrendelt een prijs) en de module past automatisch de prijs van het bereikte niveau toe via de native specifieke prijzen van PrestaShop. De actuele prijs wordt dus overal getoond zonder enige aanpassing van uw thema: productpagina, listings, winkelwagen en e-mails.
- Compatibel met PrestaShop 8.0 tot 9.x, Classic-thema en afgeleide thema’s.
- PHP 7.4 tot 8.3.
- Multistore en meertalig (FR/EN/ES/DE/IT).
- Geen CRON-taak vereist: de herberekening wordt aangestuurd door bestelgebeurtenissen.
- PrestaShop-conforme architectuur (ModuleAdminController, ObjectModel), zonder Composer-afhankelijkheden.
De actuele prijs wordt weggeschreven in een specifieke prijs die is afgestemd op de campagnedata. Hij geldt dus native voor de volledige weergave, zonder template-overrides.
Installatie
Installeer de module zoals elke andere PrestaShop-module:
- Download het archief
dfgroupbuy-1.0.2.zipvia uw klantaccount. - Ga in de backoffice naar Modules > Modulebeheer.
- Klik op Een module uploaden en sleep het archief erin.
- Klik na de installatie op Configureren.
Bij de installatie maakt de module haar tabellen aan (campagnes, niveaus, deelnemers), registreert haar hooks en voegt het tabblad Groepsaankoop toe onder Catalogus. U kunt direct uw eerste campagne aanmaken.
Algemene instellingen van de module
De configuratiepagina bundelt de globale instellingen die voor alle campagnes gelden:
- Hoofdkleur en accentkleur: toegepast op de widget van de productpagina (voortgangsbalk, badges, actuele prijs).
- E-mail versturen bij terugwerkende terugbetaling: informeert de koper wanneer hem een kortingsbon wordt toegekend.
- Geldigheidsduur van de bonnen: aantal dagen dat terugwerkende bonnen geldig zijn (standaard 30).
- Verversingsinterval: frequentie van de live-update van de widget, in seconden (standaard 30).
Een groepsaankoopcampagne aanmaken
Klik in het tabblad Catalogus > Groepsaankoop op Campagne toevoegen. Een campagne koppelt een product aan een niveautabel, binnen een datumvenster.
- Referentie: interne identificatie van de campagne (vrij te kiezen).
- Product: zoek en selecteer het betreffende product. U kunt een specifieke variant targeten of “alle varianten” laten staan.
- Naam en beschrijving: vertaalbare teksten, getoond in de widget.
- Telmodus: zie de aparte sectie hieronder.
- Alleen geldige bestellingen: telt alleen bevestigde bestellingen (aanbevolen).
- Referentieprijs: de startprijs (doorgestreept) voordat een niveau is bereikt.
- Begin- en einddatum: activiteitsvenster van de campagne.
- Terugwerkende terugbetaling: zie de aparte sectie.
- Actief: activeert of pauzeert de campagne.
Niveaus definiëren
Elk niveau koppelt een drempel (aantal kopers, eenheden of klanten, afhankelijk van de modus) aan een stuksprijs exclusief btw. Voeg zoveel niveaus toe als nodig, bijvoorbeeld:
10 kopers → 18,00 € excl. btw
50 kopers → 15,00 € excl. btw
100 kopers → 12,00 € excl. btwBij elke opslag herberekent de module het actuele niveau en werkt de specifieke prijs bij. De prijzen moeten dalen naarmate de drempel stijgt.
De referentieprijs en de niveauprijzen worden exclusief btw ingevoerd. De omrekening naar inclusief btw voor de weergave volgt de btw-regels van het product.
De telmodi
De telmodus bepaalt wat de collectieve teller doet oplopen:
- Bestellingen: aantal afzonderlijke bestellingen die het product bevatten.
- Verkochte eenheden: totaal aantal verkochte eenheden van het product.
- Unieke klanten: aantal verschillende klanten die het product hebben gekocht.
De optie Alleen geldige bestellingen beperkt het tellen tot bestellingen die PrestaShop als geldig beschouwt (betaling geaccepteerd, enz.), zodat geannuleerde of openstaande bestellingen niet meetellen.
De collectieve prijs in realtime
Zodra een bestelling wordt gevalideerd of van status verandert, telt de module de campagne opnieuw, bepaalt het bereikte niveau en werkt de specifieke prijs bij die voor alle kopers geldt. De nieuwe prijs wordt direct overal getoond, zonder tussenkomst. Er is geen CRON nodig: alles wordt aangestuurd door bestelgebeurtenissen.
Als een bestelling wordt geannuleerd of terugbetaald en u alleen geldige bestellingen telt, wordt de teller naar beneden bijgesteld en kan de prijs weer stijgen als het niveau niet meer wordt bereikt.
Prijzen per hoeveelheidsniveau (groothandel)
In de modus Verkochte eenheden kan een klant die in één keer een grote hoeveelheid bestelt zelf een niveau overschrijden: hij krijgt dan direct de prijs van dat niveau op zijn eigen bestelling, zonder te wachten tot het collectief het bereikt. Bijvoorbeeld: met een niveau op 10 eenheden betaalt een klant die 10 exemplaren in de winkelwagen legt meteen de prijs van niveau 10.
Deze logica blijft “de beste prijs voor iedereen”: als de actuele collectieve prijs al lager is dan de prijs van het hoeveelheidsniveau, geldt de collectieve prijs. Alles verloopt via de native specifieke prijzen (per hoeveelheidsniveau), dus het juiste tarief wordt al in de winkelwagen getoond.
Dit mechanisme werkt alleen in de modus Verkochte eenheden, waar de drempels eenheden vertegenwoordigen. In de modus Bestellingen of Klanten blijft een groothandelsaankoop één bestelling of één klant.
Terugwerkende terugbetaling
Wanneer de optie is ingeschakeld, geldt het principe “iedereen de beste prijs”: zodra een lager niveau wordt ontgrendeld, ontvangen eerdere kopers automatisch een kortingsbon ter hoogte van het verschil tussen de betaalde prijs en de nieuwe prijs, vermenigvuldigd met de gekochte hoeveelheid. Er wordt een notificatie-e-mail verstuurd als de verzendoptie actief is.
- De bon is een persoonlijke kortingscode (CartRule), geldig gedurende het geconfigureerde aantal dagen.
- Alleen kopers die meer hebben betaald dan de nieuwe prijs ontvangen een bon.
- De effectieve prijs van elke deelnemer wordt bijgewerkt om dubbele terugbetalingen bij volgende prijsdalingen te voorkomen.
De terugwerkende terugbetaling creëert echte kortingsbonnen. Controleer uw niveautabel voordat u een campagne met hoog volume activeert, zodat u het totale terugbetalingsbedrag beheerst.
De widget op de productpagina
Op de productpagina toont de module een widget die de collectieve dynamiek in beeld brengt:
- Een badge en de doorgestreepte referentieprijs tegenover de actuele prijs.
- De collectieve teller en een voortgangsbalk naar het volgende niveau.
- De volledige niveauschaal, met het actuele niveau uitgelicht.
- Een afteltimer tot het einde van de campagne.
- Een vermelding over de terugwerkende terugbetaling wanneer de optie actief is.
Het geheel wordt live ververst via AJAX, met het in de instellingen gedefinieerde interval, zonder de pagina te herladen.
FAQ en probleemoplossing
De widget verschijnt niet op het product
Controleer of een actieve campagne dit product target, of de datum van vandaag binnen de begin- en einddatum valt, en of de campagne bij de huidige winkel hoort. Als u een specifieke variant target, verschijnt de widget alleen voor die variant.
De prijs daalt niet terwijl de drempel is bereikt
De herberekening wordt getriggerd door het valideren van bestellingen en statuswijzigingen. Als u alleen geldige bestellingen telt, controleer dan of de betreffende bestellingen daadwerkelijk een geldige status hebben. Een campagne aanpassen en opslaan forceert eveneens een herberekening.
Een grote koper krijgt niet de prijs van zijn hoeveelheid
De prijs per hoeveelheidsniveau werkt alleen in de modus Verkochte eenheden, en voor drempels van 2 of hoger. In de modus Bestellingen of Klanten overschrijdt de hoeveelheid van één bestelling op zichzelf geen niveau.
Werkt het met varianten?
Ja. Een campagne kan een specifieke variant of alle varianten van een product targeten. Een campagne die een specifieke variant target heeft voorrang op een campagne “alle varianten”.
Wat gebeurt er bij deïnstallatie?
De deïnstallatie verwijdert de door de module aangemaakte specifieke prijzen, haar hooks en haar tabblad, en ruimt haar tabellen op. Reeds uitgegeven kortingsbonnen blijven geldig voor de klanten.