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
!
