 |
Zusammenfassung | Ermöglicht den automatischen Import von Inhalten aus RSS/ATOM-Feeds in Ihre Discourse-Website als Themen |
 |
Installationsanleitung | Dieses Plugin ist im Discourse-Core enthalten. Es ist nicht erforderlich, das Plugin separat zu installieren. |
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 die Aktivierung des RSS Polling-Plugins, die Konfiguration von Feed-URLs, die Verwaltung der Einstellungen und die Fehlerbehebung bei häufigen Problemen. Sie erfahren, wie Sie Feeds einrichten, um Themen in bestimmten Kategorien zu veröffentlichen, Autoren zuzuweisen und zu steuern, wie Inhalte auf Ihrer Website angezeigt werden.
Aktivieren des RSS Polling-Plugins
Selbst gehostete Sites
Navigieren Sie zu Ihrem Admin-Bereich unter Admin > Plugins und suchen Sie das RSS Polling-Plugin. Aktivieren Sie es mit dem Schalter:
Von Discourse gehostet
Wenn Ihre Site von Discourse gehostet wird, wenden Sie sich an das Support-Team, um die Aktivierung des RSS Polling-Plugins anzufordern. Das Plugin ist auf allen gehosteten Plänen verfügbar.
RSS-Feeds konfigurieren
Sobald das Plugin aktiviert ist, rufen Sie die Konfigurationsseite für RSS Polling auf, indem Sie direkt zu 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 vorhandenen Benutzer Ihrer Site als “Autor” aus – dieser Benutzer wird Eigentümer aller aus dem Feed erstellten Beiträge sein
- 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-Einträge importiert werden
Feed-Kategoriefilter
Die Einstellung für den Feed-Kategoriefilter ermöglicht es Ihnen, zu begrenzen, welche Feed-Einträge basierend auf den Kategoriemetadaten des Eintrags veröffentlicht werden. Wenn Sie einen Kategoriebegriff in dieses Feld eingeben, werden nur Feed-Einträge, die mit dieser spezifischen Kategorie übereinstimmen, in Discourse importiert.
Wenn Sie beispielsweise den Feed unter https://blog.discourse.org/feed.xml untersuchen, sehen Sie, dass jeder Eintrag Kategorieninformationen enthält. Sie geben den Wert der term-Eigenschaft der Kategorie ein, 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, sie 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 lautet die Wiedergabelisten-URL:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Die korrekte RSS-Feed-URL wäre dann:
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 stillschweigend fehlschlagen 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, mit einem minimal zulässigen Wert von 10 Minuten und einem maximalen Wert von 180 Minuten (3 Stunden).
Selbst gehostete Sites
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 Sites
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 mit einem bestimmten RSS-Feed verknüpft sind, ändern, indem Sie das Feld “Autor” auf der Seite für die RSS Polling-Einstellungen aktualisieren. Dadurch werden automatisch alle vorhandenen Themen aus diesem Feed mit dem neuen Autor aktualisiert. Diese Änderungen erscheinen als System-Beitragsbearbeitungsereignisse in Ihren Admin-Protokollen.
Feed-Kategorie oder Tags ändern
Das Ändern der Kategorie oder der Tags einer RSS-Feed-URL aktualisiert nicht automatisch vorhandene Themen. Sie müssen:
- Administrative Massenoperationen verwenden, um vorhandene 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.
Sichtbarkeit der Themen steuern
Verhindern, dass Themen nicht gelistet werden
Standardmäßig sind eingebettete Themen nicht gelistet, bis sie eine Antwort erhalten. Dieses Verhalten ist für RSS-importierte Themen nicht sinnvoll. Um zu verhindern, dass RSS-Themen nicht gelistet werden:
- Gehen Sie zu
/admin/site_settings - Suchen Sie nach “embed unlisted”
- Deaktivieren Sie diese Einstellung
Vollständigen Beitragsinhalt 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 Settings
- Suchen Sie nach “embed truncate”
- Deaktivieren Sie diese Einstellung
Wenn der vollständige Beitragsinhalt 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, dass:
- Die RSS-Feed-URL gültig und zugänglich 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-Site
- 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 beträgt 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.
Verursacht das Löschen und erneute Hinzufügen eines Feeds doppelte Themen?
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 Protokollierung. Überprüfen Sie Ihre Discourse-Protokolle unter Admins > Security > Logs auf Fehlermeldungen, die sich auf die RSS-Abfrage beziehen.