Discourse Rich JSON-LD Mikrodaten
 |
Zusammenfassung | Erweitert die Standard-Metatags von Discourse um einen umfassenden, koordinierten Satz an Open Graph, Twitter Cards und Schema.org JSON-LD-Markup. Dies fĂĽhrt zu einer ĂĽberlegenen SEO-Leistung, reichhaltigeren Erlebnissen beim Teilen in sozialen Medien und einer verbesserten Auffindbarkeit durch KI/LLMs |
 |
Repository-Link | 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 |
 |
Installationsanleitung | So installieren Sie Plugins in Discourse |
Was Sie erhalten
Verwandeln Sie, wie Ihr Forum in Suchergebnissen, sozialen Medien und KI-gestĂĽtzten Assistenten erscheint. Dieses Plugin generiert strukturierte Daten auf professionellem Niveau, die von Google, Yandex, sozialen Plattformen und Large Language Modellen (LLMs) perfekt verstanden werden.
FĂĽr detaillierte Dokumentation siehe README.md
FĂĽr technische Details und Entwicklung siehe CONTRIBUTING.md
FĂĽr Anwendungsbeispiele und Fehlerbehebung siehe USAGE.md
Beispiele fĂĽr reichhaltige Suchergebnisse
Vorher: Reiner Text-Schnipsel in Google
Nachher: Reichhaltiger Schnipsel mit Bewertungen, Anzahl der Antworten, Autor und Veröffentlichungsdatum
Vorher: Generische Link-Vorschau in sozialen Medien
Nachher: Auffällige Karte mit Bild, Beschreibung und Branding
Erfahren Sie mehr ĂĽber Rich Results von Google Search Central
Hauptfunktionen
1. Vollständige Schema.org-Abdeckung
- QAPage-Schema für Themen mit vollständiger Q&A-Hierarchie
- Unterstützung für Antwortbewertungen und gelösten Status
- CollectionPage fĂĽr Kategorien mit Unterkategorien
- ProfilePage fĂĽr Benutzerprofile mit Kompetenzindikatoren
- BreadcrumbList fĂĽr Navigationspfade
- WebSite-Globales Schema mit Suchaktion
2. Koordinierte Social-Media-Tags
- Open Graph (Facebook, LinkedIn, Discord)
- Twitter Cards (summary_large_image)
- Alles generiert aus einer einzigen Wahrheit – keine Konflikte
- Automatische Bereinigung der Standard-Tags von Discourse
3. KI- & LLM-optimiert
- Vollständige Entitätsbeziehungen unter Verwendung von Schema.org
@id-Referenzen - Vollständiges Kontextverständnis (Themen → Kategorien → Antworten → Kommentare)
- Metadaten zur Expertise des Autors
- ChatGPT, Claude und andere KI-Assistenten erhalten perfekten Kontext
4. Vollständige Internationalisierung 
- 100 % englische und russische Ăśbersetzungen enthalten
- Automatische Spracherkennung (Benutzer → Site → Browser → Fallback)
- Alle Schema.org-Beschreibungen lokalisiert
- Einfache Erweiterung um weitere Sprachen
5. Intelligente Leistung
- Redis-Caching mit 1-Stunden-TTL (konfigurierbar)
- Automatische Cache-Invalidierung bei Inhaltsänderungen
- < 5 ms fĂĽr zwischengespeicherte Seiten
- ~50 ms fĂĽr frische Generierung
6. Wartungsfrei
- Automatische Einbindung sowohl fĂĽr Browser- als auch fĂĽr Crawler-Ansichten
- Funktioniert fĂĽr Themen, Kategorien und Benutzerprofile
- Graceful Error Handling – Ihr Forum wird nie beschädigt
- Umfassende Protokollierung zur Fehlerbehebung
Vorteile fĂĽr Ihr Forum
Bessere Suchplatzierungen
- Reichhaltige Schnipsel in Google erhöhen die Klickrate um 30–50 %
- Knowledge Graph-Panels fĂĽr Expertenbenutzer
- Erscheinung in den Abschnitten “Menschen fragen auch”
- Breadcrumbs in Suchergebnissen verbessern die Navigation
Professionelles Teilen in sozialen Medien
- Auffällige Karten beim Teilen auf Facebook, Twitter, LinkedIn
- Korrekte Branding mit Logos und Beschreibungen
- Erhöhte Engagement- und Klickraten
- Funktioniert auf ĂĽber 40 sozialen Plattformen
Bereit fĂĽr KI-Assistenten
- Ihr Inhalt erscheint genau in ChatGPT- und Claude-Antworten
- Korrekte Zuordnung mit Links zurĂĽck zu Ihrem Forum
- Vollständiger Kontext verhindert KI-Halluzinationen
- Zukunftssicher fĂĽr Generative Engine Optimization (GEO)
Internationales Publikum
- Automatische Spracherkennung
- Lokalisierte Beschreibungen fĂĽr bessere Relevanz
- URL-Codierung verarbeitet kyrillische und Sonderzeichen
- Einfache Erweiterung um weitere Sprachen
Installation
Schritt 1: Installieren
Folgen Sie Install plugins on a self-hosted site unter Verwendung des obigen Repository-Links
Schritt 2: In der Verwaltung aktivieren
Navigieren Sie zu Verwaltung → Einstellungen → Plugins → Rich Microdata
Setzen Sie rich_microdata_enabled auf true (standardmäßig aktiviert)
Schritt 3: Konfigurieren (Optional)
Alle Einstellungen funktionieren sofort out-of-the-box, aber Sie können Folgendes anpassen:
- Cache-Dauer (Standard: 1 Stunde)
- Maximale Anzahl der enthaltenen Antworten (Standard: 10)
- Twitter @Handle fĂĽr Ihre Site
- Standard-Open-Graph-Bild-URL
- Aktivieren/Deaktivieren bestimmter Schemata
Schritt 4: ĂśberprĂĽfen
Testen Sie Ihr Markup:
Konfiguration
| Einstellung | Standard | Beschreibung |
|---|---|---|
rich_microdata_enabled |
true |
Hauptschalter fĂĽr das Plugin |
rich_microdata_cache_ttl |
3600 |
Cache-Dauer in Sekunden |
rich_microdata_max_answers |
10 |
Maximale Anzahl von Antworten im QAPage-Schema |
rich_microdata_include_user_stats |
true |
Benutzerstatistiken einschlieĂźen |
rich_microdata_enable_breadcrumbs |
true |
BreadcrumbList-Schema hinzufĂĽgen |
rich_microdata_enable_website_schema |
true |
WebSite-Schema einschlieĂźen |
rich_microdata_twitter_site |
"" |
Ihr Twitter @Benutzername |
rich_microdata_og_image_default |
"" |
Fallback-OG-Bild-URL |
rich_microdata_debug_mode |
false |
Debug-Protokollierung aktivieren |
Technische Details
Architektur:
- Drei-Schichten-Muster: DataExtractor → Builders → Coordinator
- Eine einzige Wahrheit verhindert Datenkonflikte
- Separate Rendering fĂĽr
<head>-Tags und<body>-Inhalt - Funktioniert mit sowohl
application.html.erbals auchcrawler.html.erb-Layouts
Einhaltung von Standards:
- Schema.org JSON-LD-Spezifikation
- Open Graph Protocol
- Twitter Cards Markup
- RFC 3986 (URL-Codierung fĂĽr internationale Zeichen)
Sicherheit:
- Guardian-BerechtigungsprĂĽfungen
- Private Inhalte werden automatisch ausgeschlossen
- SQL-Level-Sicherheitsfilterung
- Sichere Fallbacks fĂĽr fehlende Daten
Kompatibilität:
- Discourse 2.7.0+
- Ruby 2.7+
- Getestet auf Discourse 3.6.0.beta3
Beispiele aus der Praxis
Themen-Seiten-Markup:
{
"@context": "https://schema.org",
"@type": "QAPage",
"name": "Wie optimiert man Datenbankabfragen?",
"mainEntity": {
"@type": "Question",
"name": "Wie optimiert man Datenbankabfragen?",
"text": "Ich habe langsame Abfragen...",
"answerCount": 5,
"upvoteCount": 12,
"acceptedAnswer": {
"@type": "Answer",
"text": "Sie sollten Indizes auf... hinzufĂĽgen",
"upvoteCount": 8,
"author": {
"@type": "Person",
"name": "John Doe",
"url": "https://forum.example.com/u/john"
}
}
}
}
Kategorien-Seiten-Markup:
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Datenbankoptimierung",
"description": "Tipps und Tricks fĂĽr schnellere Abfragen",
"numberOfItems": 245,
"hasPart": [...]
}
Siehe USAGE.md für vollständige Beispiele.
Anwendungsfälle
Technische Foren:
Entwickler finden Ihre Lösungen über die hervorgehobenen Schnipsel von Google und KI-Coding-Assistenten, wobei der korrekte Code-Kontext erhalten bleibt.
Support-Communities:
Suchmaschinen zeigen Ihre Antworten mit Bewertungen und gelöstem Status an und lenken qualifizierten Traffic zu Ihren besten Inhalten.
Diskussionsforen:
Das Teilen in sozialen Medien sieht mit benutzerdefinierten Karten professionell aus, was das Engagement erhöht und die Absprungraten senkt.
Internationale Communities:
Die automatische Spracherkennung stellt sicher, dass Benutzer Inhalte in ihrer bevorzugten Sprache sehen, was die Zugänglichkeit verbessert.
Wartung
Betrieb ohne Wartung:
- Automatische Cache-Aktualisierung bei Inhaltsänderungen
- Selbstheilung bei Fehlern (beschädigt Ihr Forum nie)
- Umfassende Protokollierung zur Ăśberwachung
- Optionaler Debug-Modus zur Fehlerbehebung
Cache-Verwaltung (optional):
# Rails-Konsole
MetaGeneratorService.clear_all_cache
MetaGeneratorService.cache_stats
Fehlerbehebung
Metatags erscheinen nicht:
- Überprüfen Sie, ob das Plugin in Verwaltung → Plugins aktiviert ist
- PrĂĽfen Sie die Protokolle:
./launcher logs app | grep RichMicrodata - Cache leeren:
MetaGeneratorService.clear_all_cache
Reichhaltige Schnipsel werden in Google nicht angezeigt:
- Google benötigt 2–4 Wochen für das erneute Crawlen und Aktualisieren
- Testen Sie mit Rich Results Test
- PrĂĽfen Sie auf Validierungsfehler in der Search Console
Siehe USAGE.md fĂĽr detaillierte Fehlerbehebung.
Leistungsmetriken
- Cache-Trefferquote: 95 %+ fĂĽr typische Foren
- Antwortzeit: < 5 ms zwischengespeichert, ~50 ms frisch
- Speicher-Overhead: Minimal (verwendet Redis)
- Datenbanklast: Vernachlässigbar (1 Stunde zwischengespeichert)
Roadmap
Aktuelle Version: 2.0.0
Vollständiges Open Graph und Twitter Cards
Vollständige Unterstützung von Schema.org JSON-LD
EN/RU-Lokalisierung
URL-Codierung fĂĽr internationale Zeichen
Geplant:
- Zusätzliche Sprachpakete (ES, DE, FR)
- UnterstĂĽtzung fĂĽr Video-Schema
- Event-Schema fĂĽr AnkĂĽndigungen
- Product-Schema fĂĽr Marktplatz-Kategorien
Support
- Issues: GitHub Issues
- Dokumentation: README.md
- Beitragen: CONTRIBUTING.md
Lizenz
MIT-Lizenz – Kostenlose und Open-Source-Software
Credits
- Standards: Schema.org, Open Graph Protocol, Twitter Cards
- Plattform: Discourse
- Community: Alle Mitwirkenden und Benutzer
Optional: Telegram Instant View
Das Repository enthält Beispielvorlagenregeln in TELEGRAM_IV_RULES.txt zum Erstellen schöner Telegram Instant View-Vorlagen. Verwenden Sie diese Regeln unter instantview.telegram.org, um Benutzern, die Ihre Forum-Inhalte in Telegram teilen, ein schnelles, ablenkungsfreies Leseerlebnis zu bieten.
Verwandeln Sie noch heute die Sichtbarkeit Ihres Forums. Installation in unter 5 Minuten, Ergebnisse in Google innerhalb von 2–4 Wochen sichtbar. 
fĂĽr die Discourse Community erstellt
!
