Discourse Rich JSON-LD Microdata
 |
Résumé | Améliore les balises méta standard de Discourse avec un ensemble complet et coordonné de balises Open Graph, de cartes Twitter et de balises JSON-LD Schema.org, offrant des performances SEO supérieures, une expérience de partage sur les réseaux sociaux enrichie et une meilleure découvrabilité par les IA et les LLM |
 |
Lien vers le dĂ©pĂŽt | 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 |
 |
Guide dâinstallation | Comment installer des plugins dans Discourse |
Ce que vous obtenez
Transformez lâapparence de votre forum dans les rĂ©sultats de recherche, sur les rĂ©seaux sociaux et auprĂšs des assistants intelligents. Ce plugin gĂ©nĂšre des donnĂ©es structurĂ©es de qualitĂ© professionnelle parfaitement comprises par Google, Yandex, les plateformes sociales et les grands modĂšles de langage (LLM).
Pour une documentation détaillée, consultez README.md
Pour les détails techniques et le développement, consultez CONTRIBUTING.md
Pour des exemples dâutilisation et le dĂ©pannage, consultez USAGE.md
Exemples de résultats de recherche enrichis
Avant : Extrait de texte brut dans Google
AprÚs : Extrait enrichi avec notes, nombre de réponses, auteur et date de publication
Avant : Aperçu de lien générique sur les réseaux sociaux
AprÚs : Carte accrocheuse avec image, description et identité visuelle
En savoir plus sur les RĂ©sultats enrichis du Centre dâaide Google Recherche
Fonctionnalités clés
1. Couverture complĂšte de Schema.org
- Schéma QAPage pour les sujets avec hiérarchie complÚte Q&R
- Prise en charge des notes de réponse et du statut résolu
- CollectionPage pour les catégories avec sous-catégories
- ProfilePage pour les profils utilisateurs avec indicateurs dâexpertise
- BreadcrumbList pour les chemins de navigation
- Schéma global WebSite avec action de recherche
2. Balises réseaux sociaux coordonnées
- Open Graph (Facebook, LinkedIn, Discord)
- Cartes Twitter (summary_large_image)
- Tout gĂ©nĂ©rĂ© Ă partir dâune source unique de vĂ©ritĂ© â pas de conflits
- Nettoyage automatique des balises par défaut de Discourse
3. OptimisĂ© pour lâIA et les LLM
- Relations dâentitĂ©s complĂštes utilisant les rĂ©fĂ©rences
@idde Schema.org - ComprĂ©hension complĂšte du contexte (sujets â catĂ©gories â rĂ©ponses â commentaires)
- MĂ©tadonnĂ©es dâexpertise de lâauteur
- ChatGPT, Claude et autres assistants IA obtiennent un contexte parfait
4. Internationalisation complĂšte 
- Traductions 100 % en anglais et en russe incluses
- DĂ©tection automatique de la langue (utilisateur â site â navigateur â secours)
- Toutes les descriptions Schema.org localisées
- Ajout facile de nouvelles langues
5. Performance intelligente
- Mise en cache Redis avec TTL de 1 heure (configurable)
- Invalidation automatique du cache lors des modifications de contenu
- < 5 ms pour les pages mises en cache
- ~50 ms pour la génération fraßche
6. ZĂ©ro maintenance
- Injection automatique pour les vues navigateur et crawler
- Fonctionne pour les sujets, les catégories et les profils utilisateurs
- Gestion Ă©lĂ©gante des erreurs â ne casse jamais votre site
- Journalisation complÚte pour le débogage
Avantages pour votre forum
Meilleur classement dans les recherches
- Les extraits enrichis dans Google augmentent le taux de clic de 30 Ă 50 %
- Panneaux Knowledge Graph pour les utilisateurs experts
- Présence dans les sections « Les gens demandent aussi »
- Les filiÚres dans les résultats de recherche améliorent la navigation
Partage professionnel sur les réseaux sociaux
- Cartes accrocheuses lors du partage sur Facebook, Twitter, LinkedIn
- Identité visuelle appropriée avec logos et descriptions
- Augmentation de lâengagement et du taux de clic
- Fonctionne sur plus de 40 plateformes sociales
PrĂȘt pour les assistants IA
- Votre contenu apparaßt avec précision dans les réponses de ChatGPT et Claude
- Attribution correcte avec liens vers votre forum
- Un contexte complet Ă©vite les hallucinations de lâIA
- PrĂ©parĂ© pour lâoptimisation des moteurs gĂ©nĂ©ratifs (GEO)
Public international
- DĂ©tection automatique de la langue
- Descriptions localisées pour une meilleure pertinence
- Le codage URL gÚre le cyrillique et les caractÚres spéciaux
- Extension facile Ă dâautres langues
Installation
Ătape 1 : Installation
Suivez Install plugins on a self-hosted site en utilisant le lien du dépÎt ci-dessus
Ătape 2 : Activer dans lâadministration
AccĂ©dez Ă Admin â ParamĂštres â Plugins â Rich Microdata
Définissez rich_microdata_enabled sur true (activé par défaut)
Ătape 3 : Configuration (facultative)
Tous les paramĂštres fonctionnent parfaitement dĂšs la sortie de la boĂźte, mais vous pouvez personnaliser :
- Durée du cache (par défaut : 1 heure)
- Nombre maximum de réponses à inclure (par défaut : 10)
- Identifiant Twitter @ pour votre site
- URL dâimage Open Graph par dĂ©faut
- Activer/désactiver des schémas spécifiques
Ătape 4 : VĂ©rification
Testez votre balisage :
- Test des résultats enrichis Google
- DĂ©bogueur de partage Facebook
- Validateur de cartes Twitter
- Validateur Schema.org
Configuration
| ParamÚtre | Par défaut | Description |
|---|---|---|
rich_microdata_enabled |
true |
Interrupteur principal du plugin |
rich_microdata_cache_ttl |
3600 |
Durée du cache en secondes |
rich_microdata_max_answers |
10 |
Nombre maximal de réponses dans le schéma QAPage |
rich_microdata_include_user_stats |
true |
Inclure les statistiques des utilisateurs |
rich_microdata_enable_breadcrumbs |
true |
Ajouter le schéma BreadcrumbList |
rich_microdata_enable_website_schema |
true |
Inclure le schéma WebSite |
rich_microdata_twitter_site |
"" |
Votre identifiant Twitter @ |
rich_microdata_og_image_default |
"" |
URL dâimage de secours pour Open Graph |
rich_microdata_debug_mode |
false |
Activer la journalisation du débogage |
DĂ©tails techniques
Architecture :
- Motif Ă trois couches : DataExtractor â Builders â Coordinator
- Une source unique de vérité évite les conflits de données
- Rendu séparé pour les balises
<head>et le contenu<body> - Fonctionne avec les mises en page
application.html.erbetcrawler.html.erb
Conformité aux normes :
- Spécification Schema.org JSON-LD
- Protocole Open Graph
- Balisage des cartes Twitter
- RFC 3986 (codage URL pour les caractĂšres internationaux)
Sécurité :
- VĂ©rifications des permissions Guardian
- Contenu privé automatiquement exclu
- Filtrage de sécurité au niveau SQL
- Séquences de repli sûres pour les données manquantes
Compatibilité :
- Discourse 2.7.0+
- Ruby 2.7+
- Testé sur Discourse 3.6.0.beta3
Exemples concrets
Balisage de page de sujet :
{
"@context": "https://schema.org",
"@type": "QAPage",
"name": "Comment optimiser les requĂȘtes de base de donnĂ©es ?",
"mainEntity": {
"@type": "Question",
"name": "Comment optimiser les requĂȘtes de base de donnĂ©es ?",
"text": "Je rencontre des requĂȘtes lentes...",
"answerCount": 5,
"upvoteCount": 12,
"acceptedAnswer": {
"@type": "Answer",
"text": "Vous devriez ajouter des index sur...",
"upvoteCount": 8,
"author": {
"@type": "Person",
"name": "John Doe",
"url": "https://forum.example.com/u/john"
}
}
}
}
Balisage de page de catégorie :
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Optimisation de base de données",
"description": "Astuces et astuces pour des requĂȘtes plus rapides",
"numberOfItems": 245,
"hasPart": [...]
}
Consultez USAGE.md pour des exemples complets.
Cas dâutilisation
Forums techniques :
Les développeurs trouvent vos solutions grùce aux extraits en vedette de Google et aux assistants de codage IA, avec le contexte du code correctement préservé.
Communautés de support :
Les moteurs de recherche affichent vos réponses avec des notes et un statut résolu, attirant un trafic qualifié vers votre meilleur contenu.
Forums de discussion :
Le partage sur les rĂ©seaux sociaux a un aspect professionnel avec des cartes personnalisĂ©es, augmentant lâengagement et rĂ©duisant les taux de rebond.
Communautés internationales :
La dĂ©tection automatique de la langue garantit que les utilisateurs voient le contenu dans leur langue prĂ©fĂ©rĂ©e, amĂ©liorant lâaccessibilitĂ©.
Maintenance
Fonctionnement sans maintenance :
- Actualisation automatique du cache lors des mises Ă jour de contenu
- Auto-guĂ©rison en cas dâerreur (ne casse jamais votre site)
- Journalisation complĂšte pour la surveillance
- Mode débogage facultatif pour le dépannage
Gestion du cache (facultative) :
# Console Rails
MetaGeneratorService.clear_all_cache
MetaGeneratorService.cache_stats
DĂ©pannage
Les balises mĂ©ta nâapparaissent pas :
- VĂ©rifiez que le plugin est activĂ© dans Admin â Plugins
- VĂ©rifiez les journaux :
./launcher logs app | grep RichMicrodata - Videz le cache :
MetaGeneratorService.clear_all_cache
Les extraits enrichis nâapparaissent pas dans Google :
- Google met 2 Ă 4 semaines pour re-crawler et mettre Ă jour
- Testez avec Test des résultats enrichis
- VĂ©rifiez les erreurs de validation dans la Search Console
Consultez USAGE.md pour un dépannage détaillé.
MĂ©triques de performance
- Taux de réussite du cache : 95 %+ pour les forums typiques
- Temps de réponse : < 5 ms mis en cache, ~50 ms frais
- Surcharge mémoire : Minime (utilise Redis)
- Charge de base de données : Négligeable (mis en cache 1 heure)
Feuille de route
Version actuelle : 2.0.0
Open Graph complet et cartes Twitter
Prise en charge complĂšte de Schema.org JSON-LD
Localisation EN/RU
Codage URL pour les caractĂšres internationaux
Prévu :
- Packs de langues supplémentaires (ES, DE, FR)
- Prise en charge du schéma vidéo
- Schéma événement pour les annonces
- Schéma produit pour les catégories de marché
Support
- ProblĂšmes : ProblĂšmes GitHub
- Documentation : README.md
- Contribution : CONTRIBUTING.md
Licence
Licence MIT â Logiciel libre et open source
Crédits
- Normes : Schema.org, Protocole Open Graph, Cartes Twitter
- Plateforme : Discourse
- Communauté : Tous les contributeurs et utilisateurs
Optionnel : Vue instantanée Telegram
Le dĂ©pĂŽt inclut des rĂšgles de modĂšle dâexemple dans TELEGRAM_IV_RULES.txt pour crĂ©er de magnifiques modĂšles de Vue instantanĂ©e Telegram. Utilisez ces rĂšgles sur instantview.telegram.org pour offrir une expĂ©rience de lecture rapide et sans distraction aux utilisateurs qui partagent le contenu de votre forum sur Telegram.
Transformez la visibilitĂ© de votre forum dĂšs aujourdâhui. Installez en moins de 5 minutes, voyez les rĂ©sultats dans Google en 2 Ă 4 semaines. 
pour la communauté Discourse
!
