La Carta del Docente è un'iniziativa del Ministero dell'Istruzione che offre un bonus di €500 ai docenti, da spendere in beni e servizi per lo sviluppo professionale e culturale. Per i commercianti che operano con WooCommerce, accettare la Carta del Docente rappresenta un'opportunità significativa per ampliare la propria base di clienti.

In questa guida passo-passo, ti mostreremo come configurare il plugin ilGhera Carta Docente for WooCommerce per accettare pagamenti con Carta del Docente nel tuo negozio, dall'installazione al primo pagamento.

Cos'è il plugin WC Carta del Docente?

Il plugin ti consente di abilitare i pagamenti con Carta del Docente sul tuo negozio WooCommerce. Al checkout, il voucher inserito dall'utente viene verificato per validità, credito disponibile e pertinenza in termini di tipologia di prodotto, garantendo la conformità alle regole del programma’s.

Versione gratuita vs Premium

Prima di iniziare, è importante sapere cosa fa ciascuna versione, perché diversi passaggi di seguito si applicano solo alla versione Premium.

La free version, disponibile su WordPress.org, include: caricamento del proprio certificato .pem, mappatura delle categorie di prodotti WooCommerce con le categorie merceologiche della Carta del Docente, visualizzazione del logo Carta del Docente al checkout e modalità Sandbox con il certificato demo incluso nel plugin.

La Premium version aggiunge: generazione della richiesta del certificato (.der) e del certificato finale (.pem) direttamente dalla pagina delle impostazioni, il controllo del prodotto che nasconde il metodo di pagamento quando il carrello non è idoneo, la validazione manuale dei voucher sugli ordini in attesa, l'esclusione dei costi di spedizione, la conversione automatica del voucher in coupon e la personalizzazione completa delle email inviate al cliente.

In tutta questa guida, i passaggi e le opzioni riservati alla versione Premium sono contrassegnati come (Premium).

Requisiti

• WordPress 4.0+
• WooCommerce (testato fino alla versione 11)
• PHP con l' estensione SOAP abilitata — il plugin comunica con il servizio web del Ministero tramite SOAP con autenticazione tramite certificato client
• Certificato digitale Carta del Docente (solo per la produzione — non necessario per testare in modalità Sandbox)

Passaggio 1: Installazione del plugin

Installa il plugin ilGhera Carta Docente for WooCommerce dal pannello di amministrazione di WordPress:

1. Vai su Plugin → Aggiungi nuovo.
2. Cerca “ilGhera Carta Docente for WooCommerce” e installalo. Questa è la versione gratuita; la versione Premium viene scaricata dal tuo account ilGhera e caricata manualmente.
3. Attiva il plugin dalla pagina Plugin.
4. Una volta attivato vai in WooCommerce → Carta Docente per WC per impostare le tue preferenze.

Passo 2: Test in Modalità Sandbox Prima

Non hai bisogno del tuo certificato per provare il plugin: in modalità Sandbox il plugin utilizza il certificato demo incluso e comunica con il servizio di test del Ministero, quindi questo è il posto giusto per iniziare — prima di richiedere qualsiasi cosa.

1. Abilita la casella “Sandbox” nella pagina delle impostazioni.
2. Richiedi voucher di prova scrivendo a docenti@sogei.it.
3. Testa il flusso di pagamento completo con i voucher di test.

La modalità Sandbox è disponibile anche nella versione gratuita. Una volta che il flusso funziona come previsto, disattivala e passa al certificato reale.

Passo 3: Inserimento della Chiave Premium (Premium)

Se stai utilizzando la versione Premium, inserisci la tua Chiave Premium nel campo dedicato in cima alla pagina delle impostazioni del plugin. Questa chiave è ciò che mantiene il plugin aggiornato. Il campo non è presente nella versione gratuita.

Passo 4: Configurazione del Certificato

Il certificato digitale è essenziale per la connessione sicura con il servizio Carta del Docente di produzione. La pagina delle impostazioni si apre sulla scheda Certificato , che offre tre percorsi:

Opzione A: Carica il tuo certificato

Se hai già un certificato (.pem), tutto ciò che devi fare è caricarlo con la sua password:

1. Nella scheda Certificato , sotto “Carica certificato”, seleziona il file .pem dal tuo computer.
2. Inserisci la password utilizzata per generare il certificato.
3. Clicca su "Salva certificato".

Il plugin verificherà automaticamente la validità del certificato e ne visualizzerà la data di scadenza, evidenziandola quando il certificato sta per scadere o è già scaduto.

Questa opzione è disponibile anche nella versione gratuita.

Opzione B: Genera la richiesta del certificato (.der) (Premium)

Se non hai ancora un certificato, puoi generare la richiesta direttamente dal plugin:

1. Compila i campi obbligatori: Stato, Provincia, Località, Ragione sociale, Dipartimento aziendale, Nome, Email e Password.
2. Clicca su "Scarica file .der".
3. Carica il file .der sul portale Carta del Docente per richiedere il certificato.

Opzione C: Genera il certificato finale (.pem) (Premium)

Dopo aver ottenuto il file .cer dal portale Carta del Docente:

1. Carica il file .cer nel plugin.
2. Clicca su "Genera certificato".
3. Il plugin genererà automaticamente il certificato finale .pem.

Nota che gli strumenti per le opzioni B e C vengono visualizzati solo quando non è presente alcun certificato .pem: una volta salvato un certificato valido, la scheda Certificato lo mostra — con la sua data di scadenza e un pulsante per rimuoverlo — invece dei moduli di generazione.

Passaggio 5: Configurazione delle categorie

La Carta del Docente può essere utilizzata solo per beni e servizi specifici. Configura le categorie dei prodotti acquistabili:

1. Nella scheda Opzioni , seleziona le categorie di prodotti corrispondenti ai beni acquistabili.
2. Ogni categoria WooCommerce è abbinata alla corrispondente categoria merceologica Carta del Docente dal menu a tendina accanto ad essa.
3. Puoi aggiungere altri abbinamenti cliccando sull'icona + alla fine dell'elenco.

La mappatura delle categorie è disponibile nella versione gratuita.

Passaggio 6: Opzioni avanzate

Il plugin offre diverse opzioni per personalizzare il comportamento del pagamento:

• Utilizzo dell'immagine — Mostra il logo Carta del Docente nella pagina di checkout. Disponibile nella versione gratuita.
• Controllo del prodotto (Premium) — Mostra il metodo di pagamento solo se i prodotti nel carrello sono acquistabili con i voucher Carta del Docente.
• Ordini in attesa (Premium) — I voucher vengono validati al completamento manuale degli ordini.
• Costi di spedizione (Premium) — Escludi i costi di spedizione dai pagamenti con Carta del Docente.
• Conversione in coupon (Premium) — Se il voucher inserito è inferiore al totale del carrello, viene convertito in un codice promozionale e applicato all'ordine.

Passaggio 7: Personalizzazione delle email (Premium)

La versione Premium ti consente di personalizzare le email inviate ai clienti. Questi campi sono visibili ma disabilitati nella versione gratuita:

• Ordine ricevuto — Messaggio inviato all'utente alla ricezione dell'ordine.
• Oggetto dell'email — Oggetto dell'email inviata in caso di validazione non riuscita.
• Intestazione dell'email — Intestazione dell'email in caso di validazione fallita.
• Ordine non riuscito — Messaggio inviato quando la validazione del voucher non riesce (supporta lo shortcode [checkout-url] ).

Passo 8: Andare in Produzione e il Primo Pagamento

Una volta completata la configurazione e disattivata la modalità Sandbox, il metodo di pagamento Carta del Docente è disponibile al checkout. Il gateway è abilitato per impostazione predefinita; il suo titolo e il messaggio mostrato al cliente possono essere modificati in WooCommerce → Impostazioni → Pagamenti → Carta del Docente.

1. Il cliente aggiunge i prodotti al carrello e procede al checkout.
2. Seleziona il metodo di pagamento Carta del Docente.
3. Inserisce il proprio codice voucher.
4. Il plugin verifica automaticamente la validità del voucher, il credito disponibile e la pertinenza del prodotto.
5. Se il voucher è valido, l'ordine viene completato e il voucher viene consumato.

Conclusione

Configurare i pagamenti con Carta del Docente nel tuo negozio WooCommerce è semplice con il plugin ilGhera Carta Docente for WooCommerce. Seguendo questa guida passo-passo, puoi accettare pagamenti con Carta del Docente in modo conforme e automatizzato, ampliando la tua base di clienti e offrendo un'esperienza di acquisto fluida ai tuoi clienti.

Pronto per iniziare? Prova ilGhera Carta Docente for WooCommerce gratuitamente su WordPress.org, poi passa a ilGhera Carta Docente for WooCommerce — Premium per la generazione di certificati (.der), la conversione da voucher a coupon e il supporto prioritario.