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.
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
displayProductAdditionalInfoendisplayBeforeBodyClosingTagaanroept). - PHP 7.2 tot 8.5 met
curl,openssl(AES-256-GCM) engd. Uitgaand HTTPS-verkeer naaroauth2.googleapis.comenREGION-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
- Open in de back-office Modules > Modulebeheer > Een module uploaden en upload
dfgoogletryon-2.0.0.zip. - Na een nieuwe installatie verschijnt er niets in de winkel totdat u virtueel passen voor ten minste één product inschakelt (standaardmodus: Geselecteerde producten).
- 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.

- 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.
- API: schakel
aiplatform.googleapis.comin (weergegeven als “Vertex AI API” of “Agent Platform API”). - 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 machtigingaiplatform.endpoints.predict. Ken het nooit Owner, Editor of Vertex AI Administrator toe. - 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.
- Regio en model: kies een regio waarvoor Google Virtual Try-On vermeldt (voor een Europese winkel:
europe-west1,europe-west4,europe-west8ofeurope-west9). De model-ID is standaardvirtual-try-on-001. - 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.predictwordt 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.

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

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

- 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

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

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

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.

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.


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.

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.

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

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