 |
Zusammenfassung | Ermöglicht das automatische Importieren von Inhalten aus RSS/ATOM-Feeds in Ihre Discourse-Website als Themen |
 |
Installationsanleitung | Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich. |
Diese Dokumentation beschreibt, wie Sie das RSS Polling-Plugin konfigurieren und nutzen, um Inhalte automatisch aus RSS-Feeds in Ihre Discourse-Community als Themen zu importieren.
RSS-Feeds konfigurieren
Um das Plugin zu aktivieren, gehen Sie zu Admins → Installierte Plugins, suchen Sie das RSS Polling-Plugin und schalten Sie den Schalter ein.
Sobald es aktiviert ist, klicken Sie auf Einstellungen und dann auf die Schaltfläche Feed hinzufügen, um Ihren ersten Feed zu konfigurieren.
Sie müssen folgende Informationen angeben:
- Feed-URL: Die URL des RSS- oder Atom-Feeds, der importiert werden soll.
- Kategorie-Filter (optional): Beschränkt, welche Feed-Einträge basierend auf den Kategoriemetadaten des Eintrags importiert werden. Nur Einträge, deren Feed-Kategorie mit dem von Ihnen eingegebenen Wert übereinstimmt, werden in Discourse importiert. Wenn ein Feed beispielsweise Einträge mit mehreren Kategorien enthält, können Sie einen bestimmten Kategorieterm eingeben, um nur diese Einträge zu importieren.
- Autor: Ein bestehender Discourse-Benutzer, der als Autor aller aus diesem Feed importierten Themen aufgeführt wird.
- Kategorie: Die Discourse-Kategorie, in der importierte Themen veröffentlicht werden.
- Tags: Ein oder mehrere Tags, die auf alle Themen aus diesem Feed angewendet werden.
Klicken Sie auf Speichern, um den Feed hinzuzufügen.
🎥 Häufiges Beispiel: YouTube-Feeds
Import einer YouTube-Playlist
Verwenden Sie den RSS-Feed-Endpunkt von YouTube für Playlists:
https://www.youtube.com/feeds/videos.xml?playlist_id=<PLAYLIST-ID>
Dabei ist <PLAYLIST-ID> der Token, der in der Playlist-URL gefunden wird. Beispielsweise bei dieser Playlist-URL:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Ist die korrekte Feed-URL:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Import eines YouTube-Kanals
Verwenden Sie das RSS-Feed-Format für Kanäle:
https://www.youtube.com/feeds/videos.xml?channel_id=<CHANNEL-ID>
Sie können die channel_id auf YouTube unter Erweiterte Einstellungen für den Kanal finden.
Die direkte Verwendung einer Standard-Kanal-URL, einer Benutzernamen-URL oder einer benutzerdefinierten Kanal-URL funktioniert nicht. Das RSS Polling-Plugin erfordert das explizite
channel_id-Feed-URL-Format.
Feeds testen
Klicken Sie vor dem Speichern eines neuen oder bearbeiteten Feeds auf Feed testen, um den Feed abzurufen und zu analysieren, ohne etwas zu importieren. Sie sehen:
- Eine Zusammenfassung der Anzahl der Einträge, die importiert würden, bereits importiert sind oder übersprungen würden.
- Eine zeilenweise Aufschlüsselung der ersten Einträge im Feed, jeweils mit einer Erklärung in einfacher Sprache, warum sie importiert oder übersprungen würden.
Dies ist nützlich, um Ihre Konfiguration – insbesondere den Kategorie-Filter – zu überprüfen, bevor sie Auswirkungen auf Ihre Community hat.
Letzte Abfragen
Auf der Bearbeitungsseite für jeden vorhandenen Feed zeigt der Bereich Letzte Abfragen die letzten Abfrageversuche an. Jeder Versuch zeigt die Anzahl der importierten, aktualisierten, übersprungenen und fehlgeschlagenen Einträge. Sie können jeden Versuch erweitern, um Details pro Eintrag zu sehen, einschließlich Links zu den erstellten oder aktualisierten Themen.
Wenn Sie auf Jetzt abfragen klicken, erscheinen die Ergebnisse in Echtzeit, ohne dass die Seite neu geladen werden muss.
Einstellungen
Der Tab Einstellungen verlinkt auf die relevanten Site-Einstellungen für RSS Polling.
| Name | Beschreibung |
|---|---|
rss polling feed request timeout |
Wie lange (in Sekunden) gewartet wird, bevor eine langsame Feed-Anfrage abgebrochen wird. Standardmäßig 30 Sekunden. |
rss polling verbose logging |
Aktiviert detaillierte Protokollierung pro Eintrag für jeden Abfrageversuch. Standardmäßig deaktiviert; nützlich zur Fehlerbehebung. |
rss polling use pubdate |
Verwendet das ursprüngliche Veröffentlichungsdatum aus dem Feed-Eintrag als Thematdatum, anstatt das Importdatum. |
rss polling update tags |
Aktualisiert die Themen-Tags, wenn ein Thema aktualisiert wird; wenn deaktiviert, werden nur die anfänglichen Tags übernommen. |
Steuerung der Themen-Sichtbarkeit
Verhindern, dass Themen als nicht gelistet markiert werden
Standardmäßig sind eingebettete Themen nicht gelistet, bis sie eine Antwort erhalten. Um zu verhindern, dass RSS-importierte Themen als nicht gelistet markiert werden:
- Gehen Sie zu Admin → Alle Site-Einstellungen.
- Suchen Sie nach
embed unlisted. - Deaktivieren Sie diese Einstellung.
Vollständigen Beitragsinhalt anzeigen
Wenn die Einstellung embed truncate aktiviert ist (Standard), werden Feed-Themen nur einen Auszug anzeigen. Um den vollständigen Inhalt anzuzeigen:
- Gehen Sie zu Admin → Alle Site-Einstellungen.
- Suchen Sie nach
embed truncate. - Deaktivieren Sie diese Einstellung.
Wenn der vollständige Beitragsinhalt immer noch nicht korrekt angezeigt wird, konfigurieren Sie die Einstellung embed whitelist selector, um festzulegen, welche HTML-Elemente importiert werden sollen.
Häufige Probleme
Feed aktualisiert sich nicht
- Stellen Sie sicher, dass die Feed-URL gültig und öffentlich zugänglich ist.
- Überprüfen Sie, ob
rss polling frequencynicht zu hoch eingestellt ist. - Stellen Sie sicher, dass es neue Einträge im Feed seit der letzten Abfrage gibt.
- Verwenden Sie die Schaltfläche Feed testen, um zu prüfen, was das Plugin im Feed sieht, ohne eine vollständige Abfrage durchzuführen.
- Aktivieren Sie
rss polling verbose loggingfür mehr Details darüber, was während jeder Abfrage passiert.
Themen werden mit falschen Daten erstellt
Aktivieren Sie die Einstellung rss polling use pubdate, um das ursprüngliche Veröffentlichungsdatum aus dem Feed-Eintrag anstelle des Importdatums zu verwenden.
Jede Feed-URL wird nur einmal importiert
Das Löschen und erneute Hinzufügen derselben Feed-URL führt nicht zu einem erneuten Import zuvor verarbeiteter Einträge. Jeder RSS-Eintrag wird nur einmal importiert.