Shoppable Klantfotogalerij: volledige gids
Installatie, Instagram-verbinding, uploads door klanten, moderatie en de hotspot-editor van de module Shoppable Klantfotogalerij.
Overzicht
Shoppable Klantfotogalerij (dfugcgallery) toont echte foto’s van uw klanten op de homepage, op productpagina’s en op een aparte galerijpagina. Elke foto bevat klikbare punten die de zichtbare producten openen, met hun prijs en een knop om ze aan de winkelwagen toe te voegen. De foto’s komen uit twee bronnen: uploads door uw klanten vanuit een bestelling en de import van uw eigen Instagram-berichten. Niets verschijnt in de winkel zonder uw goedkeuring.

Nieuw in versie 2.0.0
- Compatibel met PrestaShop 1.7.8, 8 en 9 (PHP 7.4 tot en met 8.5).
- Upload gekoppeld aan een bestelling van de klant, met quota, eenvoudig bijsnijden en gedateerde toestemming met versienummer.
- Controle van de werkelijke inhoud van elk bestand, systematische hercodering, verwijdering van locatiegegevens (GPS) en correctie van de oriëntatie.
- Privé originelen, openbare kopieën alleen voor goedgekeurde foto’s, intrekking door de klant op elk moment.
- Nieuwe back-office: moderatiewachtrij in rasterweergave met toetsenbordbediening, punteneditor met slepen en neerzetten, Instagram-import met selectie, anonieme statistieken en instellingen met voorbeeld.
- Galerijpagina met filters, toegankelijke fotoviewer met toevoegen aan winkelwagen, responsieve afbeeldingen in WebP.
- Interface, winkel en e-mails in 8 talen: Frans, Engels, Spaans, Duits, Italiaans, Portugees, Pools en Nederlands.
Installatie
- Open in de back-office Modules → Modulebeheer → Een module uploaden en upload
dfugcgallery.zip. - De module maakt haar tabellen aan, het tabblad Catalogus → Klantfoto’s (UGC), een privémap
upload/dfugcgallery/en een openbare mapimg/dfugc/. - De knop Configureren opent direct het tabblad Instellingen.
Compatibel met PrestaShop 1.7.8, 8.x en 9.x, thema’s Classic en Hummingbird. Geen overrides. Gebruikte hooks: displayHome, displayFooterProduct, displayCustomerAccount en de aangepaste hook displayDfUgcGallery, die u overal in uw thema kunt plaatsen: {hook h='displayDfUgcGallery' product=12 limit=6 layout='grid'}.
Bijwerken vanaf versie 1.0
Upload de nieuwe zip in modulebeheer: de update verloopt automatisch.
- De foto’s, hun status, de klikbare punten en uw instellingen blijven behouden.
- Het Instagram-token wordt versleuteld en de leesbare waarde wordt verwijderd.
- De bestanden worden opnieuw gecodeerd, zonder metadata, en vervolgens uit de openbare map gehaald. Alleen goedgekeurde foto’s krijgen openbare kopieën.
- Oudere klantfoto’s krijgen het label ‘Toestemming niet vastgelegd’: versie 1.0 bewaarde noch de datum noch de versie van de geaccepteerde voorwaarden. U beslist zelf of u ze behoudt, de klant opnieuw benadert of ze intrekt.
- Een foto die door versie 1.0 gekanteld is opgeslagen, zet u recht met de draaiknoppen van de editor.
Een foto delen als klant
De link Mijn foto’s verschijnt in Mijn account. De klant:
- kiest een van zijn eigen bestellingen: betaald, verzonden of geleverd, afhankelijk van uw instelling;
- sleept of kiest zijn foto’s (JPG, PNG of WebP), ziet een voorbeeld en kan bijsnijden tot vierkant, staand of liggend;
- geeft aan welke producten uit die bestelling op de foto te zien zijn, voegt een bijschrift toe en, als u dat toestaat, een schuilnaam;
- vinkt twee niet vooraf aangevinkte vakjes aan: de toestemming voor publicatie, met een link naar uw voorwaardenpagina, en de verklaring over de zichtbare personen, inclusief toestemming van de ouders voor minderjarigen.

Op dezelfde pagina volgt de klant zijn foto’s (in afwachting, gepubliceerd, niet geaccepteerd met de reden) en kan hij ze op elk moment intrekken. Intrekken wist de foto, de bestanden en de openbare kopieën; het adres daarvan geeft daarna een 404-fout.

Beveiligingen bij elke upload:
- controle van het werkelijke bestandstype;
- weigering van SVG’s, bestanden met code of een archief, en enorme afbeeldingen (meer dan 8.000 px per zijde of 40 Mpx, bestandsgrootte boven de ingestelde limiet);
- afbeelding altijd opnieuw gecodeerd: oriëntatie gecorrigeerd, GPS-gegevens en andere metadata verwijderd;
- 5 foto’s per bestelling en 10 per dag per klant (instelbaar), en een limiet op het aantal uploads per uur.
Moderatie
Het tabblad Moderatie toont de foto’s in een raster, per status: in afwachting, gemeld, gepubliceerd, geweigerd. Sneltoetsen:
- pijltjestoetsen: navigeren;
- A: goedkeuren;
- R: weigeren;
- E of Enter: de editor openen;
- X: selecteren;
- Shift+A of Shift+R: de hele selectie verwerken.
Elke kaart toont de auteur, de bestelling, het aantal geplaatste producten, het ontbreken van alternatieve tekst en de meldingen.

Kies bij een weigering een reden (vooraf ingesteld of vrij). Deze verschijnt in de klantomgeving en, optioneel, in een e-mail.

Publiceren zonder moderatie (instelling Klantfoto’s zonder moderatie publiceren) is standaard uitgeschakeld en wordt afgeraden: een ongepaste foto, een foto van een kind of een onbekende, of een beschermde afbeelding zou direct zichtbaar zijn. Meldingen van bezoekers verbergen een foto automatisch zodra de gekozen drempel wordt overschreden (standaard 3).
Editor voor klikbare punten
- Zoek een product op naam, referentie of ID.
- Klik op de foto op de plek waar het product te zien is, of druk op Enter om het in het midden te plaatsen.
- Verplaats een punt door het te slepen, of met de pijltjestoetsen (1 %, 5 % met Shift). Delete verwijdert het.
- Voer de alternatieve tekst van de foto in elke taal in (toegankelijkheid en SEO), het bijschrift en de weergegeven naam.
- Draai de foto indien nodig: de punten draaien mee. Klik daarna op Opslaan of Opslaan en publiceren.

De posities worden in procenten opgeslagen: ze blijven nauwkeurig op zowel mobiel als desktop. In de winkel worden alleen actieve, zichtbare en voor de klant toegankelijke producten getoond, met live berekende prijs en beschikbaarheid.
Weergave in de winkel
- Homepage: mozaïek, raster of carrousel, met het aantal producten per foto en een knop ‘Deel uw foto’.
- Productpagina: alleen de foto’s waarop het bekeken product staat.
- Galerijpagina: alle foto’s, filters op categorie of product, knop ‘Meer foto’s tonen’ zonder de pagina te herladen.


De fotoviewer is een toegankelijk dialoogvenster:
- focus blijft in het venster, sluiten met Esc, volgende foto’s met de pijltjestoetsen;
- punten genummerd en benoemd naar het product;
- productkaarten met de knop In winkelwagen (of ‘Opties kiezen’ voor producten met combinaties).


De afbeeldingen hebben responsieve formaten (srcset), een WebP-versie, lazy loading en vaste afmetingen: de lay-out verspringt niet. Vanuit de winkel wordt geen enkel verzoek naar Instagram gestuurd.


Instagram koppelen
De module gebruikt Instagram API with Instagram Login (professioneel Business- of Creator-account, machtiging instagram_business_basic).
- Genereer in het ontwikkelaarsdashboard van Meta een langlopend token voor het Instagram-account van uw winkel.
- Plak het in het tabblad Instagram van de module en klik op Verbinden. Het wordt versleuteld in uw database opgeslagen en nooit meer weergegeven.
- Vink de foto’s aan die u wilt importeren (carrousels worden uitgevouwen, video’s genegeerd) en klik op Selectie importeren. Ze komen binnen als ‘in afwachting’, zodat u de producten kunt plaatsen.

Alleen berichten van uw eigen account worden geïmporteerd. Berichten van anderen (hashtags, vermeldingen, tags) nooit: hun auteurs hebben er niet mee ingestemd in uw winkel te verschijnen. De afbeeldingen worden naar uw server gekopieerd: geen script, geen cookie en geen verzoek aan Instagram in de winkel. Het token wordt automatisch vernieuwd wanneer het ouder is dan 24 uur en binnenkort verloopt; het is na elke vernieuwing 60 dagen geldig.
Statistieken
Het tabblad Statistieken toont over 7, 30 of 90 dagen:
- de weergaven, het openen van foto’s, de klikken naar producten en de toevoegingen aan de winkelwagen vanuit de fotoviewer;
- de meest aangeklikte foto’s en producten.
Het zijn anonieme dagelijkse tellers: geen cookies, geen IP-adressen, geen klant-ID’s. De cijfers zijn indicatief (bots en adblockers worden niet uitgefilterd).

Instellingen
- Weergave: blokken op de homepage, de productpagina en de galerijpagina; lay-out, aantal foto’s, kolommen, afronding en kleur, met direct voorbeeld.
- Uploads door klanten:
- geaccepteerde bestellingen (betaald, verzonden of geleverd), maximale grootte, foto’s per bestelling en per dag;
- weergegeven naam (voornaam en initiaal, alleen voornaam of geen naam), schuilnaam;
- pagina en versie van de publicatievoorwaarden;
- ondertekende link voor gastklanten.
- Moderatie en e-mails: e-mails bij publicatie en weigering, melden door bezoekers en verbergdrempel, uitnodiging om een foto te delen na verzending of levering (met wachttijd en URL van de geplande taak).
- Persoonsgegevens: bij verwijdering van een klantaccount verwijdering of anonimisering van diens foto’s; anonieme statistieken; bij de-installatie behoud of volledige verwijdering van de foto’s.

De module biedt hulpmiddelen (gedateerde toestemming met versienummer, intrekking, wissen, minimale namen, export en wissen via de officiële AVG-module van PrestaShop). Ze maakt uw winkel op zichzelf niet AVG-conform en ook niet conform het portretrecht: laat uw voorwaarden en uw gebruik controleren door uw adviseur. Wijzig de ‘versie van de voorwaarden’ bij elke aanpassing van uw voorwaardenpagina.
Compatibiliteit met andere modules
- DF Reviews toont ook foto’s die bij beoordelingen zijn gevoegd: houd beide blokken op de productpagina alleen als ze verschillende inhoud bieden.
- DF PWA slaat afbeeldingen op in de cache: voeg
/img/dfugc/toe aan de uitsluitingen, zodat een ingetrokken foto ook offline verdwijnt. - DF Security Headers: het standaard CSP-beleid volstaat, omdat de afbeeldingen lokaal zijn.
- Tarteaucitron: niets te declareren, geen trackers van derden.
- De hook
actionDfUgcGalleryPhotoChangedwordt uitgezonden bij elke publicatie, weigering, intrekking of wijziging, bijvoorbeeld om een full-page cache te legen.
Probleemoplossing
- ‘Het Instagram-token is verlopen’: genereer een nieuw langlopend token en maak opnieuw verbinding. Een token dat 60 dagen niet wordt vernieuwd, verloopt.
- Een klant ziet het formulier niet: hij heeft nog geen bestelling die aan de gekozen regel voldoet (betaald, verzonden of geleverd).
- Een foto wordt bij het uploaden geweigerd: het bericht vermeldt de reden (formaat, bestandsgrootte, afmetingen, inhoud die geen foto is).
- Een foto wordt niet weergegeven: deze moet gepubliceerd zijn en het betreffende blok moet ingeschakeld zijn. Blokkeer onder nginx de directe toegang tot
/upload/, zoals de standaardconfiguratie van PrestaShop voorschrijft. - Uitnodigingen met wachttijd: roep eenmaal per dag de URL van de geplande taak aan die in de instellingen wordt vermeld.
De-installatie
Afhankelijk van uw keuze in de instellingen behoudt de de-installatie de foto’s en hun gegevens (standaard; ze zijn bij herinstallatie weer beschikbaar) of verwijdert ze alle foto’s, bestanden en tabellen. Het tabblad, de instellingen en het Instagram-token worden altijd verwijderd.