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
!
