Variant Wijzigen in de Winkelwagen PrestaShop: installatie en instellingen

Overzicht

Met de module wijzigt de klant de combinatie van een product (maat, kleur of een ander kenmerk) direct op de winkelwagenpagina, zonder de regel te verwijderen. De nieuwe combinatie behoudt het aantal, het afleveradres en de positie van de regel. Voorraad en minimale hoeveelheid worden vóór de wissel door de server gecontroleerd.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en verstuur het bestand dfcartcombination-1.0.0.zip.
2. De module registreert de hooks displayCartExtraProductActions en actionFrontControllerSetMedia en maakt de tabel ps_dfcartcombination_log aan voor de geschiedenis.
3. Open de moduleconfiguratie. Alles staat standaard aan, in de modus knop met venster.
4. Voeg een product met minstens twee combinaties toe aan de winkelwagen en open de winkelwagenpagina om de weergave te controleren. Verschijnt er niets, leeg dan de cache in Geavanceerde instellingen > Prestaties.

Instellingen

• Module inschakelen: uitgeschakeld wordt er niets geladen op de winkelwagenpagina.
• Weergavemodus: Knop met keuzevenster (één link „Wijzigen” per regel) of Keuzelijsten in de winkelwagenregel (één lijst per kenmerkgroep, meteen toegepast bij selectie).
• Onder de productkenmerken plaatsen: verplaatst de keuze onder de kenmerken van de regel. Schakel uit om hem te laten staan waar uw thema de hook aanroept, meestal in de actiekolom naast de prullenbak.
• Prijs per combinatie tonen: prijs van de gekozen combinatie, doorgestreepte prijs bij korting en verschil met de huidige regel. De prijs volgt de weergave incl. of excl. btw van de klantgroep.
• Voorraadstatus tonen: Op voorraad, Nog maar X op voorraad, Leverbaar op nabestelling of Niet op voorraad. „Nog maar X” gebruikt de drempel voor resterende hoeveelheid die in PrestaShop is ingesteld. Er wordt niets getoond als voorraadbeheer uit staat.
• Afbeelding van de combinatie tonen: eerste afbeelding van de combinatie, anders de hoofdafbeelding van het product.
• Niet-beschikbare combinaties: Uitgeschakeld tonen of Verbergen. De waarde van de huidige regel blijft altijd zichtbaar.
• Uitgesloten producten: product-ID’s gescheiden door komma’s. Voor deze producten verschijnt geen keuze en de server weigert elke wijziging.
• Accentkleur: kleur van de hoofdknop en van geselecteerde waarden.
• Wijzigingsgeschiedenis bijhouden: levert de statistieken onder het formulier.

Klantzijde

Venstermodus

De knop Wijzigen opent een venster met de afbeelding van de combinatie, de productnaam en het aantal van de regel. De kenmerkgroepen volgen de volgorde van de catalogus:

• kleurgroepen: stalen, met de textuur van het kenmerk als die bestaat;
• radio- of lijstgroepen: knoppen, of een keuzelijst vanaf meer dan 8 waarden.

Onderaan worden prijs, prijsverschil en voorraadstatus van de keuze bij elke klik bijgewerkt. De knop Winkelwagen bijwerken blijft inactief zolang de keuze gelijk is aan de regel of niet beschikbaar is. Het venster sluit met Escape, het kruisje of een klik erbuiten, en werkt met het toetsenbord (pijltjestoetsen tussen de waarden van een groep). Op mobiel schuift het venster vanaf de onderkant omhoog.

Keuzelijstmodus

Elke kenmerkgroep wordt een lijst in de regel. De wijziging wordt verstuurd zodra een waarde is gekozen. De kenmerkregels die het thema al toont (bijvoorbeeld „Maat: S”) worden verborgen om dubbele weergave te voorkomen. Een melding onder de lijsten toont de lopende update of een eventuele fout.

Combinatie die niet bestaat

Bestaat de gekozen waarde niet samen met de andere gekozen kenmerken (bijvoorbeeld M Blauw ontbreekt in de catalogus), dan schakelt de module over naar de bestaande combinatie met deze waarde die de meeste huidige kenmerken behoudt, bij voorkeur een bestelbare.

Controles vóór de wissel

De browser stuurt het product, de huidige en de gekozen combinatie. De server controleert dan:

• het sessietoken;
• dat het product actief en bestelbaar is, en dat de catalogusmodus uit staat;
• dat de gekozen combinatie bij het product en de winkel hoort;
• dat de oorspronkelijke regel nog in de winkelwagen zit, zonder personalisatie;
• dat het product niet gekoppeld is aan een cadeau-winkelwagenregel van deze winkelwagen;
• dat het eindaantal de minimale hoeveelheid van de combinatie haalt;
• dat de voorraad het eindaantal dekt, tenzij bestellen zonder voorraad voor het product is toegestaan.

De nieuwe combinatie wordt toegevoegd met de standaardmethode updateQty, daarna wordt de oude verwijderd met deleteProduct. Mislukt het verwijderen, dan wordt de toevoeging teruggedraaid. Zit de gekozen combinatie al in de winkelwagen, dan worden de aantallen op één regel opgeteld. Anders neemt de nieuwe regel de toevoegdatum van de oude over, zodat hij zijn plaats in de winkelwagen houdt.

Na de wissel activeert de module het PrestaShop-event updateCart. Het thema laadt dan de lijst, de totalen en de mini-winkelwagen opnieuw. Reageert het thema niet binnen 3 seconden, dan wordt de pagina herladen.

Regels die buiten de module vallen

• producten zonder combinaties of met één combinatie;
• regels met personalisatie (tekst, bestand);
• producten die via een winkelwagenregel cadeau worden gegeven;
• producten die in de configuratie zijn uitgesloten.

Geschiedenis en statistieken

Onder het configuratieformulier toont het blok Wijzigingsgeschiedenis:

• het aantal wijzigingen en betrokken winkelwagens over 30 dagen;
• het aantal gewijzigde winkelwagens dat een bestelling werd, met het percentage;
• de 10 meest gewijzigde producten;
• de laatste 20 wijzigingen, met de begincombinatie en de gekozen combinatie.

De knop Geschiedenis wissen verwijdert de gegevens van de huidige winkel. Een product dat vaak naar de maat erboven wordt gewijzigd, wijst op een maattabel of productpagina die herzien moet worden.

Thema’s en aanpassing

Het Classic-thema en de meeste afgeleide thema’s roepen displayCartExtraProductActions aan in elke winkelwagenregel. Roept uw thema hem niet aan, dan bouwt het script de keuze op basis van de verwijderlinks van de regels (data-id-product en data-id-product-attribute). Het JavaScript-bestand wordt alleen op de winkelwagenpagina geladen.

Om de stijl aan te passen, overschrijft u in de CSS van uw thema de variabelen --dfcc-accent, --dfcc-text en --dfcc-border, of de klassen .dfcc-edit, .dfcc-modal__dialog en .dfcc-option.

Voor ontwikkelaars

Na elke geslaagde wijziging voert de module de hook actionDfCartCombinationChange uit met de parameters cart, id_product, id_product_attribute_from, id_product_attribute_to en quantity. Een externe module kan daarop inhaken om een CRM of een analysetool te synchroniseren.

Bekende beperkingen

• Gepersonaliseerde regels behouden in versie 1.0.0 hun combinatie.
• De wijziging gebeurt op de winkelwagenpagina, niet in het overzicht van het bestelproces of in de mini-winkelwagen.
• Een zijwinkelwagenmodule die het event updateCart niet gebruikt, wordt pas bijgewerkt wanneer de pagina herlaadt.