Il problema
Chi parla italiano e vuole usare Claude trova soprattutto guide in inglese, sparse in molti posti. Il sito doveva raccogliere guide pratiche, prompt, tutorial e confronti in italiano, organizzati per professione. Oltre agli articoli, doveva anche insegnare in modo strutturato, certificare ciò che le persone hanno imparato e permettere agli sviluppatori di vendere progetti Claude pronti all’uso.
Cosa ho costruito
Ho realizzato un tema WordPress su misura che trasforma ClaudeItalia.it in un punto di riferimento italiano per imparare Claude, con corsi, certificazione e un marketplace.
- Contenuti strutturati: 6 tipi di contenuto (guide, prompt, tutorial, confronti, progetti e video) con tassonomie per argomento e professione, tempo di lettura e livello. Un mega menu raggruppa 12 categorie professionali, così un avvocato o un insegnante trova per primo il materiale che lo riguarda.
- Certificazione con esami: percorsi con livelli da A1 a C2 e un archivio di domande. Le domande e l’ordine delle risposte sono casuali, ogni domanda ha un timer e se si cambia scheda compare un avviso. Chi supera l’esame riceve un certificato con un codice univoco e un codice QR per verificarlo; i certificati si possono revocare.
- Lezioni: moduli, contenuti delle lezioni, FAQ e una chat per ogni percorso. Gli studenti caricano i loro progetti e il docente li valuta da 0 a 100 con un commento.
- Marketplace per sviluppatori: gli sviluppatori pubblicano i progetti dalla propria area nel front end. Le vendite passano da Stripe Checkout, con l’attivazione Stripe Connect Express per ricevere i compensi e una commissione predefinita del 30% per la piattaforma. Le fatture vengono generate in XML FatturaPA 1.2.2, il formato italiano della fatturazione elettronica, e inviate tramite l’API di Aruba.
- Pubblicazione sui social: i contenuti vanno su una Pagina Facebook, una pagina aziendale LinkedIn e X, con OAuth 2.0 e rinnovo automatico dei token. Ogni post riceve un link breve e un tweet suggerito.
- Gestione del sito: visitatori in tempo reale, visualizzazioni per articolo, spazi AdSense con un editor di ads.txt, conversione delle immagini in WebP, schema JSON-LD in aggiunta a Yoast, accesso con Google e una chat sul sito con il team.
Con cosa è fatto
Un tema WordPress su misura in PHP, con tabelle MySQL dedicate per tentativi d’esame, certificati, vendite e compensi agli sviluppatori. JavaScript puro nel front end. Stripe per i pagamenti, l’API di fatturazione elettronica di Aruba, OAuth con Google, Meta, LinkedIn e X, gestione dei feed RSS e un modulo di supporto per OpenAI. Un plugin must-use imposta gli header di cache sull’hosting cPanel.
Perché è fatto così
Per i visitatori in tempo reale non ho contato le richieste al server. Le pagine sono in cache, quindi un conteggio delle richieste perderebbe la maggior parte delle visite. Invece, un piccolo script su ogni pagina invia un ping ogni 30 secondi via AJAX, che funziona anche sulle pagine in cache. Per la privacy, l’indirizzo IP viene salvato solo come hash, il token del visitatore resta nel local storage del browser invece che in un cookie di tracciamento, e i vecchi record vengono cancellati ogni giorno.
