PS PrestaShop Gemiddeld

dfgoogletryon: module voor virtueel passen met AI (Google Vertex AI)

Installatie en upgrade naar 2.0.0, assistent voor de Google Cloud-verbinding (serviceaccount, minimale rol, versleutelde sleutel), activering per product, limieten en budget, privacy, wat de klant ziet en probleemoplossing voor dfgoogletryon.

Bijgewerkt Moduleversie 2.0.0

Overzicht

dfgoogletryon voegt een venster voor virtueel passen toe aan uw PrestaShop-productpagina’s. De klant voegt een foto van het hele lichaam toe, geeft uitdrukkelijk toestemming, en uw server stuurt de foto en de afbeelding van het kledingstuk naar het model Google Cloud Vertex AI Virtual Try-On (virtual-try-on-001). Het venster toont daarna de door het model gegenereerde afbeelding, duidelijk gemarkeerd als AI-gegenereerd, met een voor/na-vergelijking, downloaden en “In winkelwagen”.

Versie 2.0.0 is een volledige herziening: PrestaShop 1.7.8, 8 en 9, Classic en Hummingbird, een assistent voor de Google Cloud-verbinding, een dashboard voor gebruik en budget, atomaire kostenlimieten, privacy-instellingen, een logboek en 8 talen.

De kwaliteit van de gegenereerde afbeelding hangt af van het model van Google en van de foto’s (persoon en kledingstuk). De module belooft geen enkel resultaat: test uw eigen producten met de testgeneratie in de back-office voordat u de widget inschakelt.

Wat is het verschil met virtueel passen in Google Shopping?

  • Merchant Center apparel try-on: een functie die alleen in Google Zoeken en Google Shopping wordt getoond. Deze kan niet in uw winkel worden ingebouwd.
  • Vertex AI Virtual Try-On: de generatieve API die deze module gebruikt. Het is een betaalde dienst van Google Cloud, gefactureerd per afbeelding aan uw eigen Google Cloud-project.

Vereisten

  • PrestaShop 1.7.8.0 tot 9.x, thema Classic of Hummingbird (of een thema dat de hooks displayProductAdditionalInfo en displayBeforeBodyClosingTag aanroept).
  • PHP 7.2 tot 8.5 met curl, openssl (AES-256-GCM) en gd. Uitgaand HTTPS-verkeer naar oauth2.googleapis.com en REGION-aiplatform.googleapis.com.
  • Een Google Cloud-project met facturering, de Vertex AI API (aiplatform.googleapis.com) en een serviceaccount (zie hieronder).

Google vermeldt virtual-try-on-001 sinds 14 september 2026 als verouderd (deprecated), met 15 maart 2027 als datum van uitfasering. De model-ID is een instelling van de module: controleer vóór die datum de modelpagina en voer de nieuwe ID in zodra Google er een publiceert. Het vroegere virtual-try-on-preview-08-04 is in januari 2026 vervangen door virtual-try-on-001.

Installatie en upgrade vanaf 1.0.0

  1. Open in de back-office Modules > Modulebeheer > Een module uploaden en upload dfgoogletryon-2.0.0.zip.
  2. Na een nieuwe installatie verschijnt er niets in de winkel totdat u virtueel passen voor ten minste één product inschakelt (standaardmodus: Geselecteerde producten).
  3. Het menu Catalogus > Virtueel passen wordt aangemaakt. Ook de configuratielink van de module opent dit menu.

Bij een upgrade vanaf 1.0.0 blijven uw instellingen behouden: de serviceaccountsleutel, die 1.0.0 onversleuteld opsloeg, wordt versleuteld en daarna onversleuteld verwijderd; “beperken tot categorie-ID’s” wordt de modus Geselecteerde categorieën (lege lijst = Alle producten, zoals voorheen); een aangepaste toestemmingstekst wordt naar elke taal gekopieerd; het vervangen preview-model wordt virtual-try-on-001; de waarden voor veiligheid en persoonsgeneratie worden herschreven in de gedocumenteerde vorm; het onversleuteld gecachte OAuth-token wordt verwijderd; de gecombineerde themacache wordt geleegd zodat het nieuwe script wordt geladen.

Versie 1.0.0 kon op PrestaShop 8.2 en 9.1 geen pasbeurt voltooien (de Ajax-controller eindigde met een fatale PHP-fout). Versie 2.0.0 lost dit op.

Assistent voor de Google Cloud-verbinding

Open Catalogus > Virtueel passen > Google Cloud-verbinding. Elke stap bevat directe links naar de Google Cloud-console en de bijbehorende gcloud-opdrachten, klaar om te kopiëren.

Google Cloud-verbindingsassistent: project, Vertex AI-API, serviceaccount met minimale rol, versleutelde JSON-sleutel, regio en verbindingstest
Google Cloud-verbindingsassistent
  1. Project: maak een Google Cloud-project aan of gebruik een bestaand project en koppel een factureringsaccount. Voer de project-ID in (kleine letters, met koppeltekens), niet de naam of het nummer van het project.
  2. API: schakel aiplatform.googleapis.com in (weergegeven als “Vertex AI API” of “Agent Platform API”).
  3. Serviceaccount en minimale rol: maak een serviceaccount aan dat speciaal voor de winkel is bedoeld. Ken het Vertex AI User toe (roles/aiplatform.user, nu “Agent Platform User” genoemd) of, volgens het principe van minimale rechten, een aangepaste rol met als enige machtiging aiplatform.endpoints.predict. Ken het nooit Owner, Editor of Vertex AI Administrator toe.
  4. Sleutel: maak een JSON-sleutel voor het serviceaccount aan en upload het bestand (of plak de inhoud). De sleutel wordt versleuteld met AES-256-GCM, met een sleutel die is afgeleid van de cookiesleutel van uw winkel (buiten de database). Hij wordt nooit meer weergegeven en nooit naar de browser, de logs of de e-mails verzonden: alleen het e-mailadres van het account en het begin van de sleutel-ID blijven zichtbaar.
  5. Regio en model: kies een regio waarvoor Google Virtual Try-On vermeldt (voor een Europese winkel: europe-west1, europe-west4, europe-west8 of europe-west9). De model-ID is standaard virtual-try-on-001.
  6. Test: Opslaan en verbinding testen voert een gratis test uit: de sleutel wordt gelezen, er wordt een OAuth2-toegangstoken aangevraagd en de machtiging aiplatform.endpoints.predict wordt gecontroleerd. Er wordt geen afbeelding gegenereerd. Bij elke mislukte stap ziet u wat u moet doen, met een link naar de juiste consolepagina.

De Service Specific Terms van Google Cloud beperken generatieve AI-diensten op sites die gericht zijn op, of waarschijnlijk bezocht worden door, personen jonger dan 18 jaar. Controleer of deze voorwaarden passen bij uw winkel en uw doelgroep. De module levert neutrale teksten en garandeert geen naleving van welke regelgeving dan ook.

Producten

Kies waar virtueel passen wordt aangeboden: Geselecteerde producten (aanbevolen om de kosten te beheersen), Geselecteerde categorieën of Alle producten. Met een type kledingstuk (bovenstuk, onderstuk, jurk, bovenkleding, overig) kunt u virtueel passen per type in- of uitschakelen. Google publiceert geen lijst van ondersteunde categorieën kledingstukken: test uw producten.

Activering van virtueel passen per product, categorie of type kledingstuk, met keuze van de verzonden productafbeelding
Activering van virtueel passen per product, categorie of type kledingstuk

Voor elk product kiest u de afbeelding van het kledingstuk die naar Google wordt verzonden: Auto gebruikt de afbeelding van de gekozen combinatie, anders de hoofdafbeelding. Een los kledingstuk op een effen achtergrond is de beste referentie. Dezelfde instellingen zijn beschikbaar op de productpagina (tabblad Modules). De afbeelding van het kledingstuk wordt altijd uit de eigen afbeeldingenmap van de winkel gelezen: er wordt nooit een URL opgehaald.

Instellingen

Instellingen van de paswidget: tekst en stijl van de knop, resultaatopties, afbeeldingen per pasbeurt, fotoformaat en modelparameters
Instellingen van de paswidget
  • Widget: hoofdschakelaar, knoptekst in elke taal, stijl (omlijnd, gevuld, tekstlink), accentkleur en opties voor het resultaat (voor/na-vergelijking, “In winkelwagen”, downloaden met een zichtbaar label “AI-gegenereerd”, delen op apparaten die dit ondersteunen).
  • Generatie: afbeeldingen per pasbeurt (1 tot 4, elke afbeelding wordt gefactureerd), verzonden fotoformaat (1024, 1536 of 2048 px, het model retourneert een afbeelding van hetzelfde formaat), onzichtbaar watermerk (addWatermark).
  • Geavanceerde instellingen: persoonsgeneratie, veiligheidsfilter en stappen worden standaard niet verzonden (standaardwaarden van het model). Google geeft aan dat voor sommige veiligheidsdrempels goedkeuring van uw accountteam nodig is.

Limieten en budget

Elke aanroep wordt door Google gefactureerd. Daarom controleert de module elke limiet voordat Google wordt aangeroepen en reserveert deze atomair in de database: gelijktijdige bezoekers kunnen een limiet niet overschrijden.

Limieten en budget: dag- en maandlimiet, maandbudget, e-mailwaarschuwing, limieten per sessie, IP en klant, wachttijd, burstvergrendeling en captcha
Limieten en budget
  • Budget en algemene limieten: afbeeldingen per dag, afbeeldingen per maand, maandbudget (omgerekend naar een limiet in afbeeldingen op basis van uw prijs per afbeelding; lijstprijs van Google op 9 november 2026: 0,06 USD per afbeelding), e-mail voor waarschuwingen die eenmaal per maand bij de gekozen drempel wordt verzonden.
  • Per bezoeker: pasbeurten per browsersessie, per IP-adres en per klantaccount per dag, wachttijd tussen twee pasbeurten, parallelle generaties voor de hele winkel en één tegelijk per bezoeker.
  • Voorbehouden aan ingelogde klanten: bezoekers wordt gevraagd eerst in te loggen.
  • Captcha (optioneel): Cloudflare Turnstile, hCaptcha of Google reCAPTCHA v2 met uw eigen sleutels; de geheime sleutel wordt versleuteld.

Afbeeldingen die door het model worden geweigerd, worden niet door Google gefactureerd en worden teruggegeven aan de limieten. Stel ook een budgetwaarschuwing in Google Cloud Billing in: alleen die ziet alle uitgaven van het project.

Dashboard voor gebruik en budget

Dashboard voor verbruik en budget: afbeeldingen vandaag en deze maand tegenover de limieten, geschatte kosten, laatste 30 dagen (demogegevens)
Dashboard voor verbruik en budget

Het dashboard toont de afbeeldingen van de dag en van de maand ten opzichte van de limieten, de geschatte kosten (gegenereerde afbeeldingen × uw prijs per afbeelding; uw Google Cloud-factuur blijft de referentie), de uitkomst van de verzoeken (gegenereerd, uit cache, geweigerd door het model, geblokkeerd door een limiet, fouten), de laatste 30 dagen, de meest gepaste producten en een checklist voor configuratie.

Privacy

Privacy: foto wordt nooit bewaard, cache van gegenereerde afbeeldingen standaard uit, bewaartermijn van het logboek, toestemmingsteksten per taal
Privacy
  • Foto van de klant: wordt nooit opgeslagen. De foto wordt gecontroleerd (JPEG, PNG of WebP, tot 12 MB, minimaal 256 px), gedraaid volgens de EXIF-oriëntatie en in het geheugen opnieuw gecodeerd, waardoor EXIF- en GPS-gegevens worden verwijderd, en daarna naar Google verzonden en weggegooid.
  • Gegenereerde afbeelding: wordt standaard niet opgeslagen. Een optionele versleutelde cache (15 minuten tot 24 uur) voorkomt dat dezelfde foto met hetzelfde product twee keer wordt gefactureerd; deze is gekoppeld aan de browsersessie van de bezoeker en wordt automatisch opgeschoond.
  • Geen openbaar adres: de afbeelding wordt in het antwoord teruggestuurd; geen enkele foto of resultaat is via een URL bereikbaar.
  • Logboek: datum, product, status, duur, HTTP-code, ingelogd ja/nee. Geen foto, geen IP-adres, geen naam. De tellers van de limieten gebruiken gesleutelde hashes die na twee dagen worden verwijderd.
  • Teksten die aan de bezoeker worden getoond: introductie, selectievakje voor toestemming en melding onder het resultaat, per taal (leeg = vertaalde standaardtekst), plus een link naar uw privacypagina. Laat ze controleren door uw adviseur.

Wat de klant ziet

Op ingeschakelde producten verschijnt een knop Virtueel passen met een AI-label. Het script en de stijlen worden alleen op die pagina’s geladen.

Knop "Virtueel passen" op de productpagina, met AI-vermelding (fictief product)
Knop "Virtueel passen" op de productpagina

Het venster is toegankelijk: de focus blijft binnen het venster, Escape sluit het, elke actie is met het toetsenbord bereikbaar, meldingen voor schermlezers. De klant maakt een foto (camera op mobiel), kiest er een uit de galerij of sleept er een naartoe, en bepaalt daarna de uitsnede (zoomen, verslepen, draaien). Een poseerhulp geeft aan wat het beste werkt.

Fotostap: poseerhulp, foto maken of uploaden, uitsnede met zoom en draaien (getekende houten ledenpop, geen echte persoon)
Fotostap

Voordat er iets wordt verzonden, ziet de klant dat de foto naar Google Cloud (Vertex AI) gaat, wat de winkel bewaart en dat het resultaat een AI-gegenereerde afbeelding is, en vinkt daarna het vakje voor toestemming aan.

Uitdrukkelijke toestemming vóór verzending: foto naar Google Cloud (Vertex AI), bewaring, door AI gegenereerde afbeelding
Uitdrukkelijke toestemming vóór verzending
Genereren bezig: laadstatus met stappen en annuleerknop
Genereren bezig

Het resultaat toont de gegenereerde afbeelding met het label “AI-gegenereerde afbeelding”, een voor/na-schuifregelaar, downloaden en “In winkelwagen”. Als dezelfde foto voor hetzelfde product op de geopende pagina opnieuw wordt gegenereerd, wordt er geen nieuw verzoek verzonden.

Resultaatscherm met voor/na-vergelijking, vermelding "door AI gegenereerde afbeelding", downloaden en toevoegen aan winkelwagen; afbeelding: schematische illustratie van de lokale simulator, geen echt resultaat
Resultaatscherm (schematische illustratie)

Duidelijke meldingen dekken elke situatie: daglimiet bereikt, limiet van de winkel bereikt, dienst bezet, foto geweigerd door het model (minderjarige herkend, geen persoon herkend, veiligheidsfilters), foto te klein of te groot, inloggen vereist.

Daglimiet voor pasbeurten bereikt: duidelijke melding voor de bezoeker, geen betaalde aanroep
Daglimiet voor pasbeurten bereikt

Op mobiel opent het venster schermvullend, met de cameraknop als eerste.

Passen op mobiel: venster op volledig scherm, foto met de camera, uitsnede met aanraking (getekende ledenpop)
Passen op mobiel

Logboek en voorbeeld

Het Logboek toont elk verzoek met de uitkomst (filters, CSV-export). Het Voorbeeld toont de widget met uw teksten en kleur en biedt een testgeneratie met uw eigen foto van een volwassene die toestemming heeft gegeven: deze wordt door Google gefactureerd zoals een pasbeurt van een bezoeker en telt mee voor de limieten.

Problemen oplossen

Melding of symptoom Wat te doen
invalid_grant De sleutel is verwijderd of uitgeschakeld in Google Cloud, of de serverklok staat verkeerd. Maak een nieuwe sleutel aan en controleer de servertijd (NTP).
Ontbrekende machtiging aiplatform.endpoints.predict Ken het serviceaccount in het project Vertex AI User toe of een aangepaste rol met deze machtiging.
Machtiging niet gecontroleerd De gratis controle vereist de Cloud Resource Manager API. Deze is optioneel; gebruik een testgeneratie om de hele keten te controleren.
Vertex AI API niet ingeschakeld Schakel aiplatform.googleapis.com in, wacht enkele minuten en test opnieuw.
Model niet gevonden in deze regio Controleer de model-ID en kies een regio die op de modelpagina wordt vermeld.
Te veel verzoeken (429) De module probeert het al twee keer opnieuw met een toenemende vertraging. Verlaag het aantal parallelle generaties of vraag Google om meer capaciteit.
De opgeslagen sleutel kan niet worden ontsleuteld De cookiesleutel van de winkel is gewijzigd (migratie). Upload de JSON-sleutel opnieuw.
Geen knop bij het product Controleer de hoofdschakelaar, de activeringsmodus, de aangeboden typen kledingstuk en of het product actief is.
Google Cloud niet bereikbaar Vraag uw hostingprovider om uitgaand HTTPS-verkeer naar oauth2.googleapis.com en *-aiplatform.googleapis.com toe te staan.

Verwijderen

Bij het verwijderen worden de instellingen, de versleutelde sleutel, het logboek, de statistieken, de cache en het menu gewist. Verwijder ook de sleutel van het serviceaccount in Google Cloud (IAM > Service accounts > Keys).

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support