Popup Pro Newsletter: complete gids

Popup Pro Newsletter toont op uw Shopware-shop een popup voor nieuwsbriefinschrijving die elke nieuwe abonnee beloont met een kortingscode die geldig is op zijn eerste bestelling. Het doel is tweeledig: uw mailinglijst laten groeien en een eerste verkoop uitlokken. De plugin steunt uitsluitend op het native promotiesysteem van Shopware, er wordt geen enkele eigen database-entiteit aangemaakt, en biedt twee codemodi (uniek per abonnee of vast), een korting instelbaar in percentage of bedrag, triggers op vertraging en op scrollen, en een inschrijving via de officiële nieuwsbriefroute met optionele double opt-in conform de AVG. Deze gids behandelt de installatie, de configuratie, de werking van de kortingscodes, de aanpassing en de probleemoplossing. Compatibel met Shopware 6.6 en 6.7.

Hoe de kortingscode werkt

Bij de allereerste registratie van een bezoeker maakt de plugin automatisch een Shopware-promotie aan met de naam “Popup Newsletter, Welcome”, toegewezen aan het huidige verkoopkanaal, met de korting die in de configuratie is ingesteld. Daarna geldt bij elke inschrijving:

• in de modus unieke code (aanbevolen) wordt er ter plekke een individuele code gegenereerd en via de native individuele promotiecodes van Shopware aan de promotie gekoppeld, en daarna aan de bezoeker teruggegeven: niet deelbaar, traceerbaar en te beperken tot één gebruik;
• in de modus vaste code draagt de promotie één publieke code (zoals WELCOME10) die aan alle abonnees wordt getoond.

De promotie blijft volledig stuurbaar via Marketing → Promoties: geldigheidsperiode, voorwaarden, geavanceerde regels. Om de aanbieding voor te behouden aan de allereerste bestelling, laat u de optie “één gebruik per klant” aan staan; voor een strengere afbakening voegt u rechtstreeks op de promotie een Shopware-regel toe (bijvoorbeeld “aantal bestellingen van de klant = 0”).

Installatie

1. Download het archief DataFireflyPopupProNewsletter-v1.0.0.zip vanuit uw DataFirefly-account.
2. Installeer het via Administration → Extensies → Mijn extensies → Extensie uploaden, of kopieer de uitgepakte map naar custom/plugins/.
3. Installeer en activeer de plugin:

   bin/console plugin:refresh
   bin/console plugin:install --activate DataFireflyPopupProNewsletter
   bin/console cache:clear

4. Compileer het thema om de stijlen van de popup mee te nemen:

   bin/console theme:compile

Als u de plugin zelf opnieuw bouwt

Op een volledige Shopware-ontwikkelinstallatie compileert u de JS als volgt:

bin/console plugin:refresh
bin/console plugin:install --activate DataFireflyPopupProNewsletter
bash bin/build-storefront.sh

Dat genereert src/Resources/app/storefront/dist/storefront/js/data-firefly-popup-pro-newsletter/data-firefly-popup-pro-newsletter.js. Zip de plugin opnieuw inclusief die map dist/ voordat u hem in productie uitrolt.

Configuratie

Open Extensies → Mijn extensies → Popup Pro Newsletter → ⋯ → Configureren. De instellingen zijn in kaarten geordend.

Algemeen

• Popup activeren: schakelt de weergave volledig in of uit.

Weergave

• Tonen na een vertraging (seconden): de popup verschijnt na X seconden. 0 schakelt deze trigger uit.
• Tonen na scrollen (% van de pagina): de popup verschijnt zodra dat scrollpercentage is bereikt. 0 schakelt deze trigger uit.
• Niet meer tonen gedurende (dagen): weergavefrequentie per bezoeker, onthouden in de browser.
• Verbergen voor ingelogde klanten: toont de popup niet aan klanten die al zijn ingelogd.

Inhoud

Titel, ondertitel, placeholder van het e-mailveld, tekst van de knop, succesbericht (gebruik de placeholder %code% om de code in te voegen), bericht in afwachting van de bevestiging (double opt-in), optionele URL van een illustratie en accentkleur. Al deze teksten zijn bewerkbaar en vertaalbaar.

Kortingscode

• Codemodus: uniek (aanbevolen) of vast.
• Vaste code of voorvoegsel: de publieke code in de vaste modus, of het voorvoegsel van de individuele codes in de unieke modus.
• Type en waarde van de korting: percentage of vast bedrag, vrije waarde.
• Eén gebruik per klant: beperkt de promotie tot één gebruik om de aanbieding voor te behouden aan de eerste bestelling.
• Double opt-in: stuurt een bevestigingsmail voordat de code wordt afgeleverd.

Double opt-in en AVG

De inschrijving verloopt via de officiële nieuwsbriefroute van Shopware (NewsletterSubscribeRoute), wat de synchronisatie met uw bestaande ontvangers waarborgt. Wanneer de double opt-in actief is, ontvangt de bezoeker zijn code pas nadat hij zijn adres per e-mail heeft bevestigd; ondertussen toont de popup het aanpasbare wachtbericht. Er wordt geen enkele cookie van derden gebruikt: de melding “niet meer tonen” wordt in de browser bewaard via localStorage.

De popup aanpassen

De weergave staat apart in views/storefront/component/datafirefly/popup-newsletter.html.twig, ingevoegd vanuit views/storefront/base.html.twig in het block base_body. Om de structuur van de popup te wijzigen, overschrijft u dat template in uw thema. De stijlen staan in app/storefront/src/scss/base.scss en de accentkleur wordt aangestuurd door de CSS-variabele --df-popup-accent, die zelf gevoed wordt door de instelling “accentkleur” uit de configuratie. Het gedrag (triggers, AJAX, kopiëren van de code) wordt verzorgd door de storefront-plugin PopupNewsletterPlugin.

FAQ en probleemoplossing

De popup verschijnt helemaal niet. In vrijwel alle gevallen ontbreekt de vooraf gecompileerde JavaScript: controleer of de geïnstalleerde ZIP de map dist/ bevat, voer daarna theme:compile uit en leeg de cache. Inspecteer de pagina: het element .df-popup-newsletter moet in de DOM aanwezig zijn met het attribuut hidden, want de JS maakt het zichtbaar.

Ik heb hem één keer gesloten en hij komt niet meer terug. Dat is het verwachte gedrag: de plugin onthoudt de sluiting gedurende het ingestelde aantal dagen, via de sleutel dfPopupNewsletterDismissedAt in de localStorage. Om opnieuw te testen, opent u een privévenster of leegt u de lokale opslag van de browser.

De popup verschijnt maar zonder stijlen. Het thema is niet opnieuw gecompileerd: voer bin/console theme:compile uit.

De code wordt niet toegepast op de winkelwagen. Controleer onder Marketing → Promoties of de promotie “Popup Newsletter, Welcome” actief is, aan het juiste verkoopkanaal is toegewezen en binnen haar geldigheidsperiode valt. Controleer in de unieke modus of de individuele code niet al is gebruikt.

Wat gebeurt er bij het verwijderen? De promotie en de reeds uitgedeelde codes blijven bewust bewaard, om codes die bij uw klanten in omloop zijn niet ongeldig te maken. Verwijder ze zo nodig handmatig via Marketing → Promoties.

Vertraagt de plugin mijn shop? Nee: geen eigen entiteiten, geen extra query bij het laden van de pagina’s, één licht JS-bestand en de SCSS gecompileerd in uw thema.