GitHub

AgeChecker

Inhaltsverzeichnis

Kostenlose 15-minütige Erstberatung direkt mit unseren Experten.

Kostenlose Beratung +49 421 438 1919-0

Introduzione

Il plugin AgeChecker per Shopware 6 è una soluzione efficace che aiuta i merchant a far rispettare la verifica dell’età nei propri shop online. Grazie all’integrazione con un servizio esterno e affidabile di verifica dell’età, il plugin garantisce che i clienti soddisfino i requisiti di età richiesti prima di visualizzare i prodotti o completare un acquisto.

Questo plugin è particolarmente utile per le aziende che vendono prodotti soggetti a limiti di età, come alcolici, tabacchi o contenuti per adulti, perché offre a merchant e clienti un livello di protezione affidabile e conforme alle norme. Per gli shop online in Italia, dove la vendita di alcolici e prodotti del tabacco ai minori di 18 anni è vietata, una verifica dell’età integrata nel checkout è un tassello importante. AgeChecker è configurabile in modo flessibile, così i gestori degli shop possono adattare il processo di verifica alle proprie esigenze senza penalizzare l’esperienza di acquisto.

Il plugin si integra perfettamente con i canali di vendita di Shopware ed esegue automaticamente la verifica dell’età nei punti chiave del customer journey, tra cui pagine prodotto, carrello e checkout. Con AgeChecker i merchant possono ridurre i rischi legali, migliorare la compliance e offrire un ambiente di acquisto professionale e affidabile, che rassicura i clienti e allo stesso tempo protegge l’attività. solution25 affianca anche i merchant in Italia nell’installazione e nella configurazione del plugin.

Funzionalità principali

Integrazione dei sales channel
Aggiunga chiavi API per ogni sales channel per una configurazione flessibile.

1. Opzioni di verifica dell’età
I clienti possono verificare la propria età inserendo la data di nascita.

2. Gestione dei tentativi
Per impostazione predefinita, gli utenti hanno 3 tentativi per verificare la propria età.

3. Logica di blocco temporaneo
Dopo 3 tentativi falliti, gli utenti vengono bloccati temporaneamente.

4. Configurazione nel pannello di amministrazione
Le impostazioni si gestiscono facilmente dal pannello di amministrazione di Shopware.

Compatibilità

  • Shopware 6.6.x

Per iniziare

Installazione e attivazione
1. Download

Git

  • Clonare il repository del plugin:

  • Apra il terminale ed esegua il seguente comando nella directory dei plugin personalizzati di Shopware 6 (di solito custom/plugins/):

git clone https://github.com/solution25com/agechecker-shopware-6-solution25.git

Packagist 

composer require solution25/age-checker

2. Installare il plugin in Shopware 6

  • Acceda all'area di amministrazione di Shopware 6.

  • Vada su Estensioni > Le mie estensioni.

  • Cerchi il plugin appena clonato e clicchi su Installa.

3. Attivare il plugin

  • Dopo l'installazione, clicchi su Attiva oppure usi l'interruttore per attivare il plugin.

4. Verificare l’installazione

  • Dopo l'attivazione, AgeChecker compare nell'elenco dei plugin installati.

  • Devono essere visualizzati nome del plugin, versione e data di installazione, come mostrato nello screenshot qui sotto.

438103110 719ab524 7636 45b9 966a 66670f356c47 1

Configurazione del plugin

1. Accedere alle impostazioni del plugin

  • Vada su Impostazioni > Sistema > Plugin.

  • Cerchi AgeChecker e clicchi sull'icona con i tre puntini (…) o sul nome del plugin per aprire le impostazioni.

2. Configurare la chiave API

  • Vada su Estensioni > Le mie estensioni > AgeChecker.

  • Selezioni il sales channel desiderato.

  • Inserisca la chiave API fornita da AgeChecker.net. Per ottenerla è necessario creare un account sul sito del servizio.

438103364 01e9a268 1dae 4eea B6dd Db453b959765 1

3. Salvare la configurazione

  • Clicchi su Salva in alto a destra per memorizzare le impostazioni.

Come funziona

1. L’utente avvia il checkout

  • AgeChecker apre un popup in base al metodo configurato.

2. Tentativo di verifica

  • L'utente inserisce la propria data di nascita.

438103650 Cfc8b2aa Edb9 4d43 996b E395f9223d11 1

  • Se la verifica ha esito positivo, il checkout prosegue.

438103745 3f110c91 8364 4093 A441 Deab0a3385d5 1

  • Se la verifica non va a buon fine:

L’utente può riprovare fino a 3 volte.

Dopo 3 tentativi falliti, l’accesso viene temporaneamente negato.

438103809 A43fda8d 86b8 40f8 9314 707e8c6b7c9c 1

3. Logica di blocco temporaneo

  • Gli utenti a cui è stato negato l'accesso vengono bloccati per 24 ore prima di poter effettuare un nuovo tentativo

Plugin AgeChecker: documentazione API

Il plugin AgeChecker per Shopware 6 è una soluzione efficace che aiuta i merchant a far rispettare la verifica dell’età nei propri shop online. Grazie all’integrazione con un servizio esterno e affidabile di verifica dell’età, il plugin garantisce che i clienti soddisfino i requisiti di età richiesti prima di visualizzare i prodotti o completare un acquisto.

Questo plugin è particolarmente utile per le aziende che vendono prodotti soggetti a limiti di età, come alcolici, tabacchi o contenuti per adulti, perché offre a merchant e clienti un livello di protezione affidabile e conforme alle norme. AgeChecker è configurabile in modo flessibile, così i gestori degli shop possono adattare il processo di verifica alle proprie esigenze senza penalizzare l’esperienza di acquisto.

Aggiornare lo stato di verifica dell'età del cliente

Endpoint

POST /age-checker-user-status

Descrizione

custom_age_confirmed_

Aggiorna il campo personalizzato di un cliente che ha effettuato l’accesso, in base all’esito della verifica dell’età ricevuto dal servizio AgeChecker.net.

Controlli di sistema

  • Il cliente deve aver effettuato l'accesso.

  • Deve essere fornito l'UUID di AgeChecker.net.

  • Viene richiamata l'API di AgeChecker.net per verificare il risultato.

  • Il campo personalizzato

Header della richiesta 

sw-context-token:
Content-Type: application/json

Esempio di body della richiesta 

{
  "uuid": "8e7c35e2-3f48-4fc9-9283-fb0e198b0fd5"
}

Risposta di successo 

{
  "message": "Customer age verification status updated"
}

Esempio di risposta di errore 

{
  "message": "uuid is required"
}

Risoluzione dei problemi

Verificare il funzionamento

  • Verifichi che il popup compaia nel checkout.

  • Testi entrambi i metodi di verifica.

  • Simuli 3 tentativi falliti per verificare che l'utente venga poi bloccato.

FAQ

1. È necessaria una chiave API?
Sì. Senza una chiave API valida la verifica dell’età non funziona.

2. Posso limitarlo a determinati sales channel?
Sì. Può attivare o disattivare il plugin per ogni sales channel.

3. Questo plugin blocca il checkout?
Sì, finché l’utente non ha completato con successo la verifica dell’età.

4. Cosa succede dopo 3 tentativi falliti?
L’utente viene reindirizzato a una pagina di blocco temporaneo e può ripetere la verifica solo allo scadere del periodo di blocco.