PS PrestaShop Beginner

Shoppable Klantfotogalerij: volledige gids

Installatie, Instagram-verbinding, uploads door klanten, moderatie en de hotspot-editor van de module Shoppable Klantfotogalerij.

Bijgewerkt Moduleversie 2.0.0

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.

Mozaïekgalerij „Onze klanten in beeld” op de startpagina, met het aantal producten per foto
Mozaïekgalerij op de startpagina

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

  1. Open in de back-office Modules → Modulebeheer → Een module uploaden en upload dfugcgallery.zip.
  2. De module maakt haar tabellen aan, het tabblad Catalogus → Klantfoto’s (UGC), een privémap upload/dfugcgallery/ en een openbare map img/dfugc/.
  3. 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:

  1. kiest een van zijn eigen bestellingen: betaald, verzonden of geleverd, afhankelijk van uw instelling;
  2. sleept of kiest zijn foto’s (JPG, PNG of WebP), ziet een voorbeeld en kan bijsnijden tot vierkant, staand of liggend;
  3. geeft aan welke producten uit die bestelling op de foto te zien zijn, voegt een bijschrift toe en, als u dat toestaat, een schuilnaam;
  4. 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.
Mijn account: foto’s van een bestelling uploaden met slepen en neerzetten, voorbeeld, vierkant bijsnijden en producten van de bestelling
Foto van een bestelling delen

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.

Mijn gedeelde foto’s: status (wacht op beoordeling, gepubliceerd, niet geselecteerd met reden) en knop „Intrekken”
Mijn foto’s: status en intrekken

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.

Backoffice: moderatiewachtrij als raster, meervoudige selectie en sneltoetsen (A, R, E, X)
Moderatiewachtrij

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

Foto weigeren: reden voor de klant en optionele e-mail
Weigering met reden

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

  1. Zoek een product op naam, referentie of ID.
  2. Klik op de foto op de plek waar het product te zien is, of druk op Enter om het in het midden te plaatsen.
  3. Verplaats een punt door het te slepen, of met de pijltjestoetsen (1 %, 5 % met Shift). Delete verwijdert het.
  4. Voer de alternatieve tekst van de foto in elke taal in (toegankelijkheid en SEO), het bijschrift en de weergegeven naam.
  5. Draai de foto indien nodig: de punten draaien mee. Klik daarna op Opslaan of Opslaan en publiceren.
Editor: versleepbare punten, product zoeken, alternatieve tekst in elke taal
Editor van klikbare punten

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.
Productpagina: carrousel „Gezien bij onze klanten” met alleen de foto’s van dit product
Klantfoto’s op de productpagina
Volledige galerijpagina met klantfoto’s, knop „Deel uw foto” en geleidelijk laden
Galerijpagina met klantfoto’s

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).
Viewer: klantfoto met genummerde klikbare punten, producten, prijzen en de knop „In winkelwagen”
Viewer met klikbare producten
Toetsenbordnavigatie: geselecteerd punt en de bijbehorende productkaart gemarkeerd
Klikbare punten met toetsenbord

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.

Galerij met klantfoto’s op mobiel: mozaïek in twee kolommen
Galerij op mobiel
Viewer op mobiel: foto, genummerde punten en producten met in winkelwagen
Viewer op mobiel

Instagram koppelen

De module gebruikt Instagram API with Instagram Login (professioneel Business- of Creator-account, machtiging instagram_business_basic).

  1. Genereer in het ontwikkelaarsdashboard van Meta een langlopend token voor het Instagram-account van uw winkel.
  2. Plak het in het tabblad Instagram van de module en klik op Verbinden. Het wordt versleuteld in uw database opgeslagen en nooit meer weergegeven.
  3. 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.
Instagram-import: alleen foto’s van het eigen winkelaccount, één voor één gekozen, versleuteld token
Instagram-import

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

Anonieme statistieken (demogegevens): weergaven, geopende foto’s, productklikken en toevoegingen aan winkelwagen
Anonieme statistieken

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.
Instellingen: indeling, kolommen, hoeken en kleur met live voorbeeld, uploads en moderatie
Instellingen met voorbeeld

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 actionDfUgcGalleryPhotoChanged wordt 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.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support