PS PrestaShop Gemiddeld

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.

Bijgewerkt Moduleversie 2.0.0

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

  1. Back office: Modules > Modulebeheer > Een module uploaden en kies dfpwa-2.0.0.zip.
  2. Open Klanten > PWA & pushmeldingen.
  3. Volg de stappen van het Overzicht: naam en pictogram van de app, meldingen, cron, test in uw eigen browser.
  4. 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.

Dashboard: abonnees, geaccepteerde en getoonde meldingen, klikken en configuratiestappen

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.
Assistent: app-identiteit, gegenereerd pictogram en voorbeeld van het Android-startscherm

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).

Kaart die uitnodigt de winkel-app te installeren, getoond na enkele pagina’s

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.

Stapsgewijze instructies om de app aan het beginscherm van de iPhone toe te voegen

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.

Instellingen van de installatie-uitnodiging en -links

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.

Toestemmingskaart voor meldingen met keuze van categorieën, vóór de browservraag

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.

Belpaneel: meldingen aan, categorieën en uitschakelen op dit apparaat

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.
Meldingsinstellingen: toestemming, categorieën, bel, verzending, cron en VAPID-sleutels

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.

Knop „Laat het me weten als het weer op voorraad is” op een uitverkochte productpagina

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.

Meldingencentrum in het klantaccount: apparaat, categorieën, gevolgde producten, geschiedenis en apparaten

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.
Offline-instellingen: nooit opgeslagen pagina’s, limieten en offlinepagina

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

Offlinepagina met recent bekeken producten, beschikbaar zonder verbinding

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}.

Automatische meldingen: bestelling volgen, productmeldingen en winkelwagenherinnering

Campagnes

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

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.

Campagnestatistieken: ontvangers, geaccepteerd, getoond, klikken, per taal en bezorgproblemen

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.

Diagnose: HTTPS, VAPID-sleutels, cron, service worker, manifest, CSP en andere modules

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-bell op een element maakt er een meldingsknop van en vervangt de zwevende bel.
  • data-dfpwa-install maakt van een element een installatielink, data-dfpwa-share een 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.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support