Knop In Winkelwagen Vervangen in PrestaShop Productlijsten: installatie en instellingen

Overzicht

De module vervangt de knop In winkelwagen in productminiaturen (categoriepagina’s, zoekresultaten, homepage, carrousels, gerelateerde producten) door een knop die naar de productpagina leidt. Daar kiest de klant het gewicht, de maat of het formaat voordat hij het product toevoegt. U stelt regels in: welke producten het betreft, welke tekst de knop toont en of de laagste combinatieprijs met „Vanaf” wordt getoond.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en stuur het bestand dflistingbutton-1.0.0.zip.
2. De module maakt de tabellen ps_dflb_rule, ps_dflb_rule_lang, ps_dflb_rule_shop, ps_dflb_rule_category en ps_dflb_rule_product aan en voegt het menu Catalogus > Knoppen in productlijsten toe.
3. Er wordt een uitgeschakelde voorbeeldregel aangemaakt: „Voorbeeld: alle producten met combinaties”. U kunt hem zo inschakelen of verwijderen.
4. Open na het aanmaken of inschakelen van een regel een categoriepagina van de winkel. Verschijnt de knop niet, leeg dan de cache in Geavanceerde instellingen > Prestaties.

Een regel aanmaken

Klik in Catalogus > Knoppen in productlijsten op Regel toevoegen. Het formulier heeft drie blokken.

Regel en doelgroep

• Naam van de regel: interne naam, niet zichtbaar voor klanten.
• Actief: een uitgeschakelde regel wordt genegeerd.
• Prioriteit: als meerdere regels op een product van toepassing zijn, wint de regel met het laagste getal. Standaardwaarde: 10.
• Van toepassing op: Alle producten, Categorieën of Specifieke producten.
• Categorieën: boom met selectievakjes en een filterveld. Voor dit type regel is minstens één categorie verplicht.
• Subcategorieën meenemen: producten van alle subcategorieën van de aangevinkte categorieën vallen er ook onder.
• Categorie-overeenkomst: Product zit in een van de categorieën (alle categorieën van het product tellen) of Alleen de standaardcategorie van het product.
• Producten: voor het type Specifieke producten, zoeken op naam, referentie of ID.
• Voorwaarde: Geen voorwaarde, Producten met combinaties of Producten met een attribuutgroep. Met Producten met combinaties houden eenvoudige producten in dezelfde categorie hun knop In winkelwagen.
• Attribuutgroep: voor de laatste voorwaarde, bijvoorbeeld Gewicht of Maat. Alleen producten met een combinatie uit deze groep vallen eronder.
• Uitgesloten producten: deze producten krijgen nooit de knop van deze regel, wat de doelgroep ook is.
• Winkelkoppeling: kies in multistore de winkels waar de regel geldt.

Knop

• Knoptekst: één tekst per taal, bijvoorbeeld „Bekijk alle gewichten”. Een lege taal neemt de eerst ingevoerde tekst over.
• Stijl: Primaire knop van het thema (klassen btn btn-primary), Omlijnde knop van het thema (btn btn-outline-primary) of Eigen kleuren, met achtergrondkleur, tekstkleur en voorbeeld.
• Pictogram: pijl, opties, weegschaal, oog of geen.
• Volledige breedte: de knop beslaat de volle breedte van de miniatuur.
• Extra CSS-klassen: toegevoegd aan de knop, handig om een klasse van uw thema te hergebruiken.
• Aantalkiezer verbergen: verbergt het aantalveld dat sommige thema’s in productlijsten tonen.

Prijs in productlijsten

Dit blok geldt alleen voor producten met minstens twee combinaties.

• Laagste combinatieprijs tonen: PrestaShop berekent de prijs van elke combinatie (btw, klantgroep, specifieke prijzen en kortingen inbegrepen). Wijkt de laagste af van de prijs die het thema toont, dan vervangt hij die, en worden de doorgestreepte oude prijs en het kortingslabel van de miniatuur verborgen.
• Voorvoegsel Vanaf toevoegen: verschijnt alleen vóór de prijs als de combinatieprijzen verschillen en de getoonde prijs de laagste is. Als u de vorige optie uitschakelt en de standaardcombinatie niet de goedkoopste is, wordt het voorvoegsel niet getoond, zodat er geen verkeerde prijs wordt aangekondigd.
• Tekst van het voorvoegsel: één tekst per taal („Vanaf”, „From”, „Desde” enz.).

Voorbeeld: kaas en vleeswaren per gewicht

1. Naam: Kaas per gewicht. Van toepassing op: Categorieën. Vink Kaas en vleeswaren aan en houd Subcategorieën meenemen aan.
2. Voorwaarde: Producten met een attribuutgroep, groep Gewicht.
3. Knoptekst: „Bekijk alle gewichten” in het Nederlands, „Ver todas las opciones de peso” in het Spaans.
4. Houd Laagste combinatieprijs tonen en Vanaf ingeschakeld en sla op.

In de categorie toont elke kaas per 250 g, 500 g en 1 kg „Vanaf” met de prijs van 250 g en de knop naar de productpagina. Een product dat per stuk wordt verkocht, zonder gewichtscombinatie, houdt zijn knop In winkelwagen.

Algemene instellingen

De configuratiepagina van de module (knop Instellingen boven de lijst met regels) bevat:

• Module inschakelen: schakelt alle regels uit zonder ze te verwijderen.
• Themadetectie: Automatisch (aanbevolen), Altijd de AJAX-opvraging gebruiken of Alleen hooks. Zie de volgende sectie.
• Ook de standaard link In winkelwagen uitschakelen: maakt aan de serverkant de winkelwagen-URL van de betrokken producten leeg, via de hook actionPresentProductListing. Sommige thema’s tonen dan een eigen link „Product bekijken”: krijgt u twee knoppen, laat deze optie dan uit.
• Knop Snel bekijken verbergen: alleen bij de betrokken producten.
• Uitverkochte combinaties negeren voor de laagste prijs: geldt als voorraadbeheer actief is en het product geen bestellingen zonder voorraad accepteert. Zijn alle combinaties uitverkocht, dan tellen ze allemaal mee.

Compatibiliteit met uw thema

Hoe de module producten herkent

Tijdens het tonen van een miniatuur draait de module in de hooks displayProductPriceBlock en displayProductListReviews, die het thema Classic, Hummingbird en de meeste thema’s aanroepen. Voor elk betrokken product schrijft hij een onzichtbare markering. Het script van de module zoekt de miniatuur met de markering, verbergt de winkelwagenknop, het winkelwagenformulier eromheen en de aantalkiezer, en plaatst de nieuwe knop waar de verborgen knop stond.

Toont het thema geen winkelwagenknop in productlijsten (zoals het thema Classic), dan komt de knop direct na het prijsblok.

In de modus Automatisch stuurt het script, als geen enkele miniatuur op de pagina deze hooks heeft geactiveerd, de ID’s van de zichtbare producten naar de controller van de module, die de betrokken producten terugstuurt (maximaal 60 producten per verzoek, alleen actieve en zichtbare producten). Miniaturen die na een facetfilter, een sortering of oneindig scrollen verschijnen, worden automatisch verwerkt.

CSS-selectors

Het blok Themacompatibiliteit (CSS-selectors) in de configuratie bevat de selectors van het script:

• Container van de productminiatuur: blok dat één product omvat (.product-miniature, .ajax_block_product enz.).
• Knop In winkelwagen: vervangen elementen (.add-to-cart, [data-button-action="add-to-cart"] enz.).
• Aantalkiezer, Prijs, Oude prijs en korting, Invoegpunt, Knop Snel bekijken.

Voeg de klassen van uw thema toe aan de lijst, gescheiden door komma’s. De knop Standaardselectors herstellen zet de oorspronkelijke waarden terug.

De stijl aanpassen

De knop heeft de klasse .dflb-btn, plus .dflb-full bij volledige breedte en .dflb-style-custom bij eigen kleuren (variabelen --dflb-bg en --dflb-color). Het prijsvoorvoegsel heeft de klasse .dflb-from, en de verwerkte miniatuur krijgt .dflb-has-btn.

Wat de module niet wijzigt

• het hoofdproduct van de productpagina en de snelle weergave ervan;
• de winkelwagen, het afrekenproces en het klantaccount;
• bestanden van de kern en het thema (geen override, geen gewijzigde templates).

Bekende beperkingen

• De module wijzigt de weergave van productlijsten. Hij blokkeert geen toevoeging aan de winkelwagen via een andere weg (directe link, module van derden).
• De laagste prijs en het voorvoegsel worden in de browser toegepast. De oorspronkelijke HTML en de gestructureerde gegevens van het thema behouden de prijs van de standaardcombinatie.
• Boven 150 combinaties van één product worden alleen de eerste 150 gebruikt voor de laagste prijs.