DataFirefly PWA: volledige gids
De PWA installeren, instellen en gebruiken op PrestaShop 1.7.8, 8 en 9: installeerbare winkel, pushmeldingen met voorafgaande toestemming, productmeldingen, campagnes, offlinemodus en diagnose.
Overzicht
De module DataFirefly PWA (dfpwa) maakt uw PrestaShop-winkel installeerbaar als Progressive Web App, verstuurt pushmeldingen die uw klanten hebben gekozen en toont een offlinepagina wanneer de verbinding wegvalt. De versleuteling gebeurt in native PHP: zonder Composer en zonder betaalde externe dienst. De meldingen lopen via de pushdiensten van de browsers (Google, Mozilla, Apple, Microsoft), zoals bij elke webpush.
Versie 2.0.0 is een herschrijving: assistent, toestemming na een klik, meertalige campagne-editor met voorbeelden, meldingencentrum in het klantaccount, cache beperkt tot openbare pagina’s, automatisch verwijderen van de service worker bij het uitschakelen van de module en een diagnosepagina.
Compatibiliteit en vereisten
- PrestaShop 1.7.8, 8.x en 9.x, enkele winkel en multishop (getest op 1.7.8.11, 8.2.1 en 9.1.5)
- PHP 7.1 of hoger; PHP 7.3 of hoger met de openssl-extensie voor pushmeldingen
- HTTPS: browsers staan installatie en push via HTTP niet toe
- Een crontaak voor geplande campagnes, productmeldingen, winkelwagenherinneringen en grote verzendingen
- Module vertaald in 8 talen: FR, EN, ES, DE, IT, PT, PL, NL
Installatie en update
- Back office: Modules > Modulebeheer > Een module uploaden en kies
dfpwa-2.0.0.zip. - Open Klanten > PWA & pushmeldingen.
- Volg de stappen van het Overzicht: naam en pictogram van de app, meldingen, cron, test in uw eigen browser.
- Kopieer de cron-URL uit Meldingen en laat de planner van uw hosting die elke 5 minuten aanroepen.
Update vanaf 1.x: upload de zip van 2.0.0 over de bestaande module. Abonnementen, voorkeuren, campagnes, meldingen, VAPID-sleutels en instellingen blijven behouden. De service worker van 1.4.1 wordt in de browsers van bezoekers vervangen en zijn caches, die back-officepagina’s konden bevatten, worden verwijderd.
Het uitschakelen of verwijderen van de module verwijdert de service worker en zijn caches wanneer bezoekers terugkomen. De pushabonnementen van die browsers werken dan niet meer: schakel de module alleen uit als u de meldingen wilt stoppen.
Het tabblad PWA & pushmeldingen
Alle instellingen staan in één tabblad met deze onderdelen: Overzicht, App & pictogram, Installatie, Offline, Meldingen, Automatiseringen, Campagnes, Statistieken en Diagnose. Een medewerker met alleen-lezenrechten ziet alle pagina’s maar kan niets wijzigen.

Het Overzicht toont het aantal geabonneerde apparaten, de geaccepteerde, getoonde en aangeklikte meldingen in de periode, de wachtrij en de nog openstaande configuratiestappen.
App & pictogram
- Naam, korte naam (onder het pictogram) en beschrijving, per taal.
- Themakleur en achtergrondkleur, weergavemodus en oriëntatie, startpagina.
- Pictogram: upload een vierkante PNG of JPG; de module maakt alle formaten aan (192, 512, maskable, Apple, meldingsbadge). SVG-bestanden worden geweigerd.
- Voorbeelden van de Android- en iPhone-beginschermen, het opstartscherm, het installatievenster en het gegenereerde manifest.

Installatie
Uitnodigingskaart
De kaart verschijnt na een aantal pagina’s (standaard 3), na een bestelling of in beide gevallen. Ze wordt nooit getoond in de winkelwagen of tijdens het afrekenen. Klikt de bezoeker op „Later”, dan blijft ze verborgen gedurende het gekozen aantal dagen (standaard 30).

iPhone en iPad
Safari kent geen automatische installatieprompt. De module toont stapsgewijze instructies („Deel” en daarna „Zet op beginscherm”), met een aparte melding voor in-app-browsers en voor iOS-versies ouder dan 16.4.

Installatielinks
Om elke pop-up te vermijden, schakelt u de kaart uit en gebruikt u links: footer, bovenste navigatie, klantaccount, bestelbevestiging, productpagina. Er zijn drie weergaven (knop, tekstlink, banner) met een tekst per taal. In e-mails opent de link de winkel met ?dfpwa_install=1; geef de betrokken sjablonen op (standaard order_conf,shipped). Op elke andere plek voegt u {widget name='dfpwa'} aan een sjabloon toe. De links verbergen zich wanneer de app is geïnstalleerd of de browser hem niet kan installeren.

Meldingen
Toestemming
De toestemming van de browser wordt pas gevraagd na een klik: op de bel, op de suggestiekaart (standaard na 2 pagina’s, uit te schakelen) of op een knop voor productmeldingen. Vóór het inschakelen kiest de bezoeker de gewenste categorieën.

Categorieën en bel
Vijf categorieën: aanbiedingen en nieuws, weer op voorraad, prijsverlaging, bestelupdates, winkelwagenherinnering. Categorieën die u niet gebruikt, kunt u uitschakelen. De bel toont de status, de categorieën en een knop om meldingen op dit apparaat uit te zetten. Positie, afstanden voor desktop en mobiel en verbergen in de winkelwagen zijn instelbaar.

Verzendinstellingen
- Daglimiet per apparaat (standaard 3) en stille uren (standaard van 22:00 tot 08:00). Ze gelden voor campagnes en winkelwagenherinneringen; bestelupdates, productmeldingen en het welkomstbericht vallen er niet onder.
- Levensduur van een niet-bezorgd bericht (standaard 24 uur) en batchgrootte per cronrun (standaard 300).
- VAPID-sleutels: aangemaakt bij de installatie; de privésleutel wordt versleuteld opgeslagen en nooit getoond. Nieuwe sleutels aanmaken verwijdert alle bestaande abonnementen, daarom is een uitdrukkelijke bevestiging nodig.
- Pushadressen worden alleen geaccepteerd voor de bekende pushdiensten van de browsers, via https.

Productmeldingen
Op de productpagina verschijnt de knop „weer op voorraad” wanneer het product of de gekozen combinatie niet beschikbaar is; anders wordt de knop „prijsverlaging” aangeboden. Een account is niet nodig. U bepaalt de minimale verlaging (standaard 5%) en hoe lang een melding geldig blijft (standaard 90 dagen). Als ps_emailalerts de voorraadmeldingen verzorgt, kunt u beide knoppen tonen of die van de module verbergen.

Meldingencentrum van de klant
In Mijn account > Meldingen beheert de klant dit apparaat, zijn categorieën, de gevolgde producten, de recente meldingen en zijn andere apparaten. Bij het uitloggen wordt het apparaat losgekoppeld van zijn account.

Offline
Een pagina wordt alleen bewaard als de winkel haar als openbaar markeert. Nooit bewaard: pagina’s van een ingelogde klant of met een niet-lege winkelwagen, winkelwagen, afrekenen, account, inloggen, bestelgeschiedenis, modulepagina’s, AJAX-verzoeken, URL’s met een token en de hele back office. U kunt eigen uitsluitingen toevoegen.
- Pagina’s: eerst het netwerk, dan de bewaarde openbare kopie, daarna de offlinepagina.
- Statische bestanden (thema, modules, productafbeeldingen): stale-while-revalidate, netwerk eerst of cache eerst.
- Limieten: standaard 30 pagina’s en 150 bestanden, de oudste worden eerst verwijderd. Een knop leegt de cache van alle bezoekers.

De offlinepagina gebruikt uw titel en bericht en toont de producten die de bezoeker onlangs heeft bekeken.

Wanneer u een nieuwe versie publiceert, stelt een melding voor om te herladen, nooit in de winkelwagen of tijdens het afrekenen. Een gewone wijziging van de instellingen geldt zonder melding.
Automatiseringen
- Bestelupdates: vink de statussen aan die een melding versturen, in de taal van de klant.
- Winkelwagenherinnering (standaard uit): één keer verstuurd, na de gekozen termijn (standaard 4 uur), naar geabonneerde klanten.
- Weer op voorraad en prijsverlaging: door de cron verstuurd naar de apparaten die erom hebben gevraagd.
- Welkomstbericht wanneer een apparaat zich abonneert.
Elke automatisering heeft een titel en een bericht per taal, met variabelen zoals {reference}, {status} en {product}.

Campagnes
- Open Campagnes > Nieuwe campagne.
- Schrijf titel, bericht en link in elke taal; een lege taal neemt de standaardtaal over.
- Voeg een afbeelding toe (door de module opnieuw gecodeerd) en maximaal twee knoppen.
- Kies het publiek: winkel, taal, klantengroep, apparaat of abonnees van meldingen. De schatting wordt meteen bijgewerkt.
- Verstuur direct of plan een datum in de tijdzone van uw keuze. Urgentie en levensduur zijn instelbaar.
- Controleer de voorbeelden (Android, Windows, macOS, iPhone) en klik op testen in mijn browser: uw browser wordt een testapparaat, uitgesloten van publiek en statistieken.

Verzendingen lopen via een wachtrij die de cron in batches verwerkt, met gespreide nieuwe pogingen wanneer een pushdienst overbelast is. Verlopen abonnementen worden automatisch verwijderd.
Statistieken
Per campagne: ontvangers, geaccepteerd (door de pushdienst), getoond en aangeklikt (gemeld door de browser en één keer geteld), per taal, en bezorgproblemen. Voor deze tellingen worden geen persoonsgegevens bewaard.

Diagnose
De pagina controleert HTTPS, de VAPID-sleutels (met een handtekeningtest), de cron, de service worker en het manifest, de Content Security Policy (worker-src, manifest-src, connect-src) en modules die invloed kunnen hebben (cookiebanners, ps_emailalerts, andere PWA-modules). Een tweede deel draait in uw browser.

Persoonsgegevens
- Per apparaat bewaard: pushadres, sleutels, winkel, taal, browserfamilie (niet de volledige user agent), categorieën en de klant als die is ingelogd.
- Bezorgdetails worden na 60 dagen gewist; inactieve apparaten en verlopen meldingen worden verwijderd.
- De export- en verwijderhooks van PrestaShop dekken abonnementen en meldingen; het verwijderen van een klant verwijdert zijn gegevens.
- De CSV-export van abonnees bevat geen e-mailadressen.
De module biedt toestemming, afmelden, export en verwijdering, maar garandeert geen naleving van de AVG of de ePrivacy-regels: uw privacyverklaring en uw cookiebanner blijven uw verantwoordelijkheid.
Thema aanpassen
data-dfpwa-bellop een element maakt er een meldingsknop van en vervangt de zwevende bel.data-dfpwa-installmaakt van een element een installatielink,data-dfpwa-shareeen deelknop.{widget name='dfpwa'}plaatst de installatielink in elk sjabloon.
Problemen oplossen
Op Android wordt niets aangeboden
Bekijk de pagina Diagnose en voer daarna dfpwaDiagnose() uit in de browserconsole op de winkel. Als de app al op het apparaat is geïnstalleerd, verwijder hem dan voordat u opnieuw test.
Meldingen komen niet aan
Controleer of de cron wordt aangeroepen en of de sleutels in Diagnose kloppen, en test in uw eigen browser. Controleer op het apparaat van een klant zijn categorieën, de daglimiet en de stille uren.
Een campagne blijft gepland
Ze wacht op haar datum of op het einde van de stille uren; daarna verstuurt de cron haar in batches. Vanuit het Overzicht kunt u de wachtrij direct verwerken.
Na de update verschijnen oude pagina’s
De service worker van 2.0.0 verwijdert de caches van 1.4.1 zodra hij het overneemt. Een browser die nooit naar de winkel terugkeert, houdt ze tot zijn eigen opschoning.