Discourse Rich JSON-LD Microdata
 |
Riepilogo | Migliora i metadati standard di Discourse con un insieme completo e coordinato di markup Open Graph, Twitter Cards e JSON-LD di Schema.org, garantendo prestazioni SEO superiori, esperienze di condivisione sui social media più ricche e una migliore individuabilità da parte di AI/LLM |
 |
Link al Repository | GitHub - kaktaknet/discourse-rich-json-ld-microdata: 🏆 Discourse Rich JSON-LD Microdata Plugin. Comprehensive, coordinated Open Graph and Schema.org JSON-LD microdata for 200% SEO and LLM coverage · GitHub |
 |
Guida all’Installazione | Come installare i plugin in Discourse |
Cosa Ottieni
Trasforma il modo in cui il tuo forum appare nei risultati di ricerca, sui social media e negli assistenti basati sull’intelligenza artificiale. Questo plugin genera dati strutturati di livello professionale che Google, Yandex, le piattaforme social e i Large Language Models comprendono perfettamente.
Per la documentazione dettagliata, consulta README.md
Per i dettagli tecnici e lo sviluppo, consulta CONTRIBUTING.md
Per esempi d’uso e risoluzione dei problemi, consulta USAGE.md
Esempi di Risultati di Ricerca Arricchiti
Prima: Frammento di testo semplice in Google
Dopo: Frammento arricchito con valutazioni, numero di risposte, autore e data di pubblicazione
Prima: Anteprima generica di un link sui social media
Dopo: Card accattivante con immagine, descrizione e branding
Scopri di più sui Risultati Arricchiti di Google Search Central
Caratteristiche Principali
1. Copertura Completa di Schema.org
- Schema QAPage per i topic con una gerarchia completa di domande e risposte
- Supporto per le valutazioni delle risposte e lo stato risolto
- CollectionPage per le categorie con sottocategorie
- ProfilePage per i profili utente con indicatori di competenza
- BreadcrumbList per i percorsi di navigazione
- Schema globale WebSite con azione di ricerca
2. Tag Social Media Coordinati
- Open Graph (Facebook, LinkedIn, Discord)
- Twitter Cards (summary_large_image)
- Tutti generati da un’unica fonte di verità: nessun conflitto
- Pulizia automatica dei tag predefiniti di Discourse
3. Ottimizzato per AI e LLM
- Relazioni complete tra entità utilizzando i riferimenti
@iddi Schema.org - Comprensione completa del contesto (topic → categorie → risposte → commenti)
- Metadati di competenza dell’autore
- ChatGPT, Claude e altri assistenti AI ricevono un contesto perfetto
4. Internazionalizzazione Completa 
- Traduzioni al 100% in inglese e russo incluse
- Rilevamento automatico della lingua (utente → sito → browser → fallback)
- Tutte le descrizioni di Schema.org localizzate
- Facile aggiungere altre lingue
5. Prestazioni Intelligenti
- Caching Redis con TTL di 1 ora (configurabile)
- Invalidazione automatica della cache in caso di modifiche ai contenuti
- < 5ms per le pagine in cache
- ~50ms per la generazione iniziale
6. Manutenzione Zero
- Iniezione automatica sia per le visualizzazioni del browser che per quelle dei crawler
- Funziona per topic, categorie e profili utente
- Gestione elegante degli errori: non rompe mai il tuo sito
- Logging completo per il debug
Vantaggi per il Tuo Forum
Migliori Posizionamenti nei Motori di Ricerca
- I frammenti arricchiti in Google aumentano il tasso di clic del 30-50%
- Pannelli Knowledge Graph per gli utenti esperti
- Inclusi nelle sezioni “Le persone chiedono anche”
- I breadcrumb nei risultati di ricerca migliorano la navigazione
Condivisione Professionale sui Social Media
- Card accattivanti quando condivise su Facebook, Twitter, LinkedIn
- Branding corretto con loghi e descrizioni
- Aumento dell’engagement e del tasso di clic
- Funziona su oltre 40 piattaforme social
Pronto per gli Assistenti AI
- I tuoi contenuti appaiono accuratamente nelle risposte di ChatGPT e Claude
- Attribuzione corretta con link di ritorno al tuo forum
- Un contesto completo previene le allucinazioni dell’AI
- Futuro-proof per l’Ottimizzazione dei Motori Generativi (GEO)
Pubblico Internazionale
- Rilevamento automatico della lingua
- Descrizioni localizzate per una maggiore pertinenza
- La codifica URL gestisce i caratteri cirillici e speciali
- Facile espansione ad altre lingue
Installazione
Passaggio 1: Installa
Segui Install plugins on a self-hosted site utilizzando il link al repository sopra
Passaggio 2: Attiva nell’Admin
Vai su Admin → Impostazioni → Plugin → Rich Microdata
Imposta rich_microdata_enabled su true (abilitato di default)
Passaggio 3: Configura (Opzionale)
Tutte le impostazioni funzionano perfettamente fuori dalla scatola, ma puoi personalizzare:
- Durata della cache (default: 1 ora)
- Numero massimo di risposte da includere (default: 10)
- @handle Twitter per il tuo sito
- URL dell’immagine Open Graph predefinita
- Abilita/disabilita schemi specifici
Passaggio 4: Verifica
Testa il tuo markup:
Configurazione
| Impostazione | Predefinito | Descrizione |
|---|---|---|
rich_microdata_enabled |
true |
Interruttore principale per il plugin |
rich_microdata_cache_ttl |
3600 |
Durata della cache in secondi |
rich_microdata_max_answers |
10 |
Numero massimo di risposte nello schema QAPage |
rich_microdata_include_user_stats |
true |
Includi statistiche utente |
rich_microdata_enable_breadcrumbs |
true |
Aggiungi lo schema BreadcrumbList |
rich_microdata_enable_website_schema |
true |
Includi lo schema WebSite |
rich_microdata_twitter_site |
"" |
Il tuo @username Twitter |
rich_microdata_og_image_default |
"" |
URL immagine OG di fallback |
rich_microdata_debug_mode |
false |
Abilita il logging di debug |
Dettagli Tecnici
Architettura:
- Pattern a tre livelli: DataExtractor → Builders → Coordinator
- Un’unica fonte di verità previene conflitti di dati
- Rendering separato per i tag
<head>e il contenuto<body> - Funziona sia con i layout
application.html.erbchecrawler.html.erb
Conformità agli Standard:
- Specifica JSON-LD di Schema.org
- Open Graph Protocol
- Markup Twitter Cards
- RFC 3986 (codifica URL per caratteri internazionali)
Sicurezza:
- Controlli delle autorizzazioni Guardian
- Contenuti privati esclusi automaticamente
- Filtri di sicurezza a livello SQL
- Fallback sicuri per dati mancanti
Compatibilità:
- Discourse 2.7.0+
- Ruby 2.7+
- Testato su Discourse 3.6.0.beta3
Esempi dal Mondo Reale
Markup Pagina Topic:
{
"@context": "https://schema.org",
"@type": "QAPage",
"name": "Come ottimizzare le query del database?",
"mainEntity": {
"@type": "Question",
"name": "Come ottimizzare le query del database?",
"text": "Sto riscontrando query lente...",
"answerCount": 5,
"upvoteCount": 12,
"acceptedAnswer": {
"@type": "Answer",
"text": "Dovresti aggiungere indici su...",
"upvoteCount": 8,
"author": {
"@type": "Person",
"name": "John Doe",
"url": "https://forum.example.com/u/john"
}
}
}
}
Markup Pagina Categoria:
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Ottimizzazione Database",
"description": "Suggerimenti e trucchi per query più veloci",
"numberOfItems": 245,
"hasPart": [...]
}
Consulta USAGE.md per esempi completi.
Casi d’Uso
Forum Tecnici:
Gli sviluppatori trovano le tue soluzioni tramite i frammenti in evidenza di Google e gli assistenti di codifica AI, con il contesto del codice preservato correttamente.
Comunità di Supporto:
I motori di ricerca mostrano le tue risposte con valutazioni e stato risolto, attirando traffico qualificato verso i tuoi contenuti migliori.
Forum di Discussione:
La condivisione sui social media appare professionale con card personalizzate, aumentando l’engagement e riducendo il tasso di rimbalzo.
Comunità Internazionali:
Il rilevamento automatico della lingua garantisce che gli utenti vedano i contenuti nella loro lingua preferita, migliorando l’accessibilità.
Manutenzione
Operatività a manutenzione zero:
- Aggiornamento automatico della cache in caso di modifiche ai contenuti
- Auto-riparazione in caso di errori (non rompe mai il tuo sito)
- Logging completo per il monitoraggio
- Modalità debug opzionale per la risoluzione dei problemi
Gestione della cache (opzionale):
# Console Rails
MetaGeneratorService.clear_all_cache
MetaGeneratorService.cache_stats
Risoluzione dei Problemi
I metadati non appaiono:
- Verifica che il plugin sia abilitato in Admin → Plugin
- Controlla i log:
./launcher logs app | grep RichMicrodata - Svuota la cache:
MetaGeneratorService.clear_all_cache
I frammenti arricchiti non appaiono su Google:
- Google impiega 2-4 settimane per ricreare e aggiornare
- Esegui il test con Rich Results Test
- Controlla eventuali errori di validazione in Search Console
Consulta USAGE.md per la risoluzione dettagliata dei problemi.
Metriche delle Prestazioni
- Tasso di hit della cache: 95%+ per forum tipici
- Tempo di risposta: < 5ms in cache, ~50ms per la generazione iniziale
- Overhead di memoria: Minimo (utilizza Redis)
- Carico sul database: Trascurabile (cache di 1 ora)
Roadmap
Versione corrente: 2.0.0
Open Graph e Twitter Cards completi
Supporto completo JSON-LD di Schema.org
Localizzazione EN/RU
Codifica URL per caratteri internazionali
Pianificato:
- Pacchetti linguistici aggiuntivi (ES, DE, FR)
- Supporto schema video
- Schema eventi per annunci
- Schema prodotti per categorie marketplace
Supporto
- Issue: GitHub Issues
- Documentazione: README.md
- Contributi: CONTRIBUTING.md
Licenza
Licenza MIT - Software libero e open-source
Crediti
- Standard: Schema.org, Open Graph Protocol, Twitter Cards
- Piattaforma: Discourse
- Comunità: Tutti i contributori e gli utenti
Opzionale: Telegram Instant View
Il repository include regole di esempio nel file TELEGRAM_IV_RULES.txt per creare splendidi template di Telegram Instant View. Utilizza queste regole su instantview.telegram.org per offrire un’esperienza di lettura veloce e priva di distrazioni agli utenti che condividono i contenuti del tuo forum su Telegram.
Trasforma oggi stesso la visibilità del tuo forum. Installa in meno di 5 minuti, vedi i risultati su Google entro 2-4 settimane. 
per la Community di Discourse
!
