 |
Zusammenfassung | Ermöglicht das automatische Importieren von Inhalten aus RSS/ATOM-Feeds in Ihre Discourse-Website als Themen |
 |
Installationsanleitung | Dieses Plugin ist im Discourse-Core enthalten. Eine separate Installation des Plugins ist nicht erforderlich. |
Diese Anleitung erklärt, wie Sie das RSS Polling-Plugin konfigurieren und verwenden, um Inhalte aus RSS/ATOM-Feeds automatisch als Themen in Ihre Discourse-Website zu importieren.
Erforderliche Benutzerstufe: Administrator
Zusammenfassung
Diese Dokumentation behandelt das Aktivieren des RSS Polling-Plugins, das Konfigurieren von Feed-URLs, das Verwalten von Einstellungen und das Beheben häufiger Probleme. Sie lernen, wie Sie Feeds so einrichten, dass sie in bestimmten Kategorien posten, Autoren zuweisen und steuern, wie Inhalte auf Ihrer Website dargestellt werden.
RSS Polling-Plugin aktivieren
Selbst gehostete Websites
Navigieren Sie zu Ihrem Admin-Panel unter Admin > Plugins und suchen Sie das RSS Polling-Plugin. Aktivieren Sie es mit dem Schalter:
Von Discourse gehostet
Wenn Ihre Website von Discourse gehostet wird, wenden Sie sich an das Support-Team, um die Aktivierung des RSS Polling-Plugins anzufordern. Das Plugin ist in allen gehosteten Plänen verfügbar.
RSS-Feeds konfigurieren
Nachdem das Plugin aktiviert wurde, rufen Sie die Konfigurationsseite für RSS Polling auf, indem Sie direkt zum Admin-Panel unter Admin > Plugin > RSS Polling navigieren oder zu /admin/plugins gehen und im Seitenmenü “RSS Polling” auswählen.
Einen neuen RSS-Feed hinzufügen
- Geben Sie die URL des RSS- oder ATOM-Feeds im Feld “Feed-URL” ein
- Wählen Sie einen bestehenden Benutzer Ihrer Website als “Autor” aus – dieser Benutzer wird alle aus dem Feed erstellten Beiträge besitzen
- Wählen Sie eine Discourse-Kategorie aus, in der die Themen des Feeds veröffentlicht werden sollen
- Klicken Sie auf die Schaltfläche
Speichern.
Optional: Fügen Sie Tags hinzu, die auf alle Themen dieses Feeds angewendet werden sollen, und/oder geben Sie einen Feed-Kategoriefilter ein, um zu begrenzen, welche Feed-Elemente importiert werden
Feed-Kategoriefilter
Mit der Einstellung für den Feed-Kategoriefilter können Sie begrenzen, welche Feed-Elemente basierend auf der Kategoriendaten des Elements veröffentlicht werden. Wenn Sie einen Kategorienterm in dieses Feld eingeben, werden nur Feed-Elemente, die mit dieser spezifischen Kategorie übereinstimmen, in Discourse importiert.
Wenn Sie beispielsweise den Feed unter https://blog.discourse.org/feed.xml prüfen, sehen Sie, dass jeder Eintrag Kategorieninformationen enthält. Sie würden den Wert der term-Eigenschaft der Kategorie eingeben, um nach bestimmten Kategorien zu filtern.
Konfiguration von YouTube-Feeds
Häufige Beispiele
YouTube ist eine der am häufigsten mit RSS Polling verwendeten Plattformen, aber es ist auch leicht, es falsch zu konfigurieren. Nachfolgend finden Sie die empfohlenen und unterstützten Feed-URL-Formate für die häufigsten YouTube-Anwendungsfälle.
Eine YouTube-Wiedergabeliste importieren
Um Videos aus einer YouTube-Wiedergabeliste zu importieren, müssen Sie den RSS-Feed-Endpunkt von YouTube für Wiedergabelisten verwenden.
Das korrekte Format lautet:
https://www.youtube.com/feeds/videos.xml?playlist_id=<PLAYLIST-ID>
Wobei <PLAYLIST-ID> das Token ist, das in der Wiedergabelisten-URL zu finden ist.
Beispielsweise, bei dieser Wiedergabelisten-URL:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Die korrekte RSS-Feed-URL wäre:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Einen YouTube-Kanal importieren
Um Videos aus einem YouTube-Kanal zu importieren, verwenden Sie das Kanal-RSS-Feed-Format:
https://www.youtube.com/feeds/videos.xml?channel_id=YOUR_CHANNEL_ID
Sie können die channel_id in YouTube unter Erweiterte Einstellungen für den Kanal finden.
Die direkte Verwendung einer Kanal-URL, einer Benutzernamen-URL oder einer benutzerdefinierten Kanal-URL funktioniert nicht. Das RSS Polling-Plugin erfordert die explizite Feed-URL mit der
channel_id.
Häufige Fehler, die Sie vermeiden sollten
- Verwendung von Standard-YouTube-Seiten-URLs anstelle von RSS-Feed-URLs
- Verwendung von Wiedergabelisten- oder Kanal-URLs, ohne die korrekte ID zu extrahieren
- Mischen von Wiedergabelisten- und Kanal-Parametern in derselben Feed-URL
Wenn ein YouTube-Feed falsch konfiguriert ist, kann das RSS Polling-Plugin fehlschlagen, ohne eine Meldung auszugeben, oder den Import neuer Themen stoppen.
Abfragehäufigkeit konfigurieren
Die Site-Einstellung rss polling frequency steuert, wie oft Discourse RSS-Feeds auf neue Inhalte überprüft. Der Standardwert beträgt 30 Minuten, der minimal zulässige Wert 10 Minuten und der maximale Wert 180 Minuten (3 Stunden).
Selbst gehostete Websites
Um die Abfragehäufigkeit anzupassen:
- Gehen Sie zu
/admin/site_settings - Suchen Sie nach “rss polling frequency”
- Legen Sie Ihr gewünschtes Intervall in Minuten fest
Gehostete Websites
Wenden Sie sich an das Support-Team, um eine Anpassung der Site-Einstellung rss_polling_frequency anzufordern.
Feed-Einstellungen verwalten
Feed-Autor ändern
Sie können den Autor aller Themen, die einem bestimmten RSS-Feed zugeordnet sind, ändern, indem Sie das Feld “Autor” auf der RSS Polling-Einstellungsseite aktualisieren. Dies aktualisiert automatisch alle bestehenden Themen aus diesem Feed mit dem neuen Autor. Diese Änderungen werden als System-Beitragsbearbeitungsereignisse in Ihren Admin-Protokollen angezeigt.
Feed-Kategorie oder Tags ändern
Das Ändern der Kategorie oder der Tags einer RSS-Feed-URL aktualisiert nicht automatisch bestehende Themen. Sie müssen:
- Administrative Massenoperationen verwenden, um bestehende Themen manuell in die neue Kategorie zu verschieben oder Tags zu aktualisieren
- Die RSS-Feed-Einstellungen aktualisieren, damit neue Themen die korrekte Kategorie und Tags verwenden
Einschränkungen der Feed-URL
Jede eindeutige RSS-Feed-URL wird nur einmal in Discourse importiert. Wenn Sie einen RSS-Feed zum ersten Mal konfigurieren, importiert Discourse den gesamten Feed. Das Löschen und erneute Hinzufügen derselben Feed-URL führt nicht zu einem erneuten Import bereits verarbeiteter Elemente.
Themen-Sichtbarkeit steuern
Verhindern, dass Themen als nicht gelistet markiert werden
Standardmäßig sind eingebettete Themen erst dann nicht gelistet, bis sie eine Antwort erhalten. Dieses Verhalten macht für RSS-importierte Themen keinen Sinn. Um zu verhindern, dass RSS-Themen als nicht gelistet markiert werden:
- Gehen Sie zu
/admin/site_settings - Suchen Sie nach “embed unlisted”
- Deaktivieren Sie diese Einstellung
Vollständigen Beitragstext anzeigen
Wenn die Site-Einstellung embed truncate aktiviert ist (Standard), zeigen Feed-Themen nur einen Auszug an. Benutzer können den vollständigen Inhalt anzeigen, indem sie auf die Schaltfläche “Vollständigen Beitrag anzeigen” klicken.
Um immer den vollständigen Inhalt anzuzeigen:
- Gehen Sie zu Admin > Site-Einstellungen
- Suchen Sie nach “embed truncate”
- Deaktivieren Sie diese Einstellung
Wenn der vollständige Beitragstext nicht korrekt angezeigt wird, konfigurieren Sie die Site-Einstellung embed whitelist selector, um anzugeben, welche HTML-Elemente importiert werden sollen.
Häufige Probleme und Lösungen
Feed wird nicht aktualisiert
Überprüfen Sie, ob:
- Die RSS-Feed-URL gültig und erreichbar ist
- Die Abfragehäufigkeit nicht zu hoch eingestellt ist
- Tatsächlich neue Elemente im RSS-Feed vorhanden sind, seit der letzten Abfrage
Plugin-Schnittstelle reagiert nicht
Einige Benutzer berichten von Problemen, bei denen die Konfigurationsschnittstelle von RSS Polling nicht reagiert. Dies wird oft durch Browser-Ad-Blocker verursacht, die die Admin-Oberfläche stören. Versuchen Sie:
- Deaktivieren Sie Ad-Blocker für Ihre Discourse-Website
- Verwenden Sie einen anderen Browser
- Aktualisieren Sie die Seite hart (Hard Refresh)
Themen werden mit falschen Daten erstellt
Standardmäßig verwenden RSS-Themen das aktuelle Datum beim Import. Wenn Sie das ursprüngliche Veröffentlichungsdatum aus dem RSS-Feed verwenden möchten, aktivieren Sie die Einstellung rss polling use pubdate.
FAQ
Wie oft kann ich RSS-Feeds abfragen?
Die minimale Abfragehäufigkeit beträgt 10 Minuten, das Maximum 180 Minuten (3 Stunden).
Kann ich Antworten aus RSS-Feeds importieren?
Nein, das RSS Polling-Plugin importiert nur die Haupt-Feed-Elemente als einzelne Themen. Es importiert keine Kommentare oder Antworten.
Führt das Löschen und erneute Hinzufügen eines Feeds zu Duplikaten?
Nein, jedes RSS-Feed-Element wird nur einmal importiert. Das erneute Hinzufügen eines Feeds erstellt keine Duplikate.
Wie debugge ich Probleme mit der RSS-Abfrage?
Derzeit hat das Plugin begrenzte Protokollierungsfunktionen. Überprüfen Sie Ihre Discourse-Protokolle unter Admins > Sicherheit > Protokolle-Panel auf Fehlermeldungen im Zusammenhang mit der RSS-Abfrage.