 |
概要 | RSS/ATOM フィードからのコンテンツを自動的にインポートして、Discourse サイトのトピックとして作成できます |
 |
インストールガイド | このプラグインは Discourse コアにバンドルされています。プラグインを個別にインストールする必要はありません。 |
このガイドでは、RSS Polling プラグインの設定と使用方法、RSS/ATOM フィードからのコンテンツを自動的にインポートして Discourse サイトのトピックとして作成する方法について説明します。
必要なユーザーレベル: 管理者
概要
このドキュメントでは、RSS Polling プラグインの有効化、フィード URL の設定、設定の管理、一般的な問題のトラブルシューティングについて説明します。特定のトピックにフィードを投稿する方法、著者を割り当てる方法、コンテンツがサイトにどのように表示されるかを制御する方法を学びます。
RSS Polling プラグインを有効にする
セルフホストサイト
Admin > Plugins パネルに移動し、RSS Polling プラグインを見つけます。トグルスイッチを使用して有効にします。
Discourse によるホスティング
サイトが Discourse によってホスティングされている場合、サポートチームに連絡して RSS Polling プラグインのアクティブ化をリクエストしてください。このプラグインはすべてのホスティングプランで利用可能です。
RSS フィードを設定する
プラグインを有効にすると、Admin > Plugin > RSS Polling パネルに直接アクセスするか、/admin/plugins に移動してサイドバーメニューから「RSS Polling」を選択して、RSS Polling 設定ページにアクセスできます。
新しい RSS フィードを追加する
- 「Feed URL」フィールドに RSS または ATOM フィードの URL を入力します
- サイトの既存ユーザーから「Author」を選択します - このユーザーがフィードから作成されたすべての投稿の所有者になります
- フィードのトピックが公開される Discourse カテゴリを選択します
保存ボタンをクリックします。
オプション: このフィードからのすべてのトピックに適用するタグを追加し、および/またはインポートされるフィードアイテムを制限するためにフィードカテゴリフィルターを入力します
フィードカテゴリフィルター
フィードカテゴリフィルター設定を使用すると、アイテムのカテゴリメタデータに基づいて、公開されるフィードアイテムを制限できます。このフィールドにカテゴリ用語を入力すると、その特定のカテゴリに一致するフィードアイテムのみが Discourse にインポートされます。
たとえば、https://blog.discourse.org/feed.xml のフィードを調べると、各エントリにカテゴリ情報があることがわかります。特定のカテゴリをフィルターするには、カテゴリの term プロパティの値を入力します。
YouTube フィードの設定
一般的な例
YouTube は RSS Polling と共に使用される最も一般的なプラットフォームの一つですが、設定を誤りやすいのも事実です。以下に、最も一般的な YouTube のユースケースに対応する推奨およびサポートされているフィード URL フォーマットを示します。
YouTube プレイリストをインポートする
YouTube プレイリストからの動画をインポートするには、プレイリスト用の YouTube の RSS フィードエンドポイントを使用する必要があります。
正しいフォーマットは次の通りです:
https://www.youtube.com/feeds/videos.xml?playlist_id=<PLAYLIST-ID>
ここで <PLAYLIST-ID> は、プレイリスト URL に見つかるトークンです。
たとえば、このプレイリスト URL の場合:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
正しい RSS フィード URL は次のようになります:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
YouTube チャンネルをインポートする
YouTube チャンネルからの動画をインポートするには、チャンネル RSS フィードフォーマットを使用します:
https://www.youtube.com/feeds/videos.xml?channel_id=YOUR_CHANNEL_ID
channel_id は、YouTube のチャンネルの詳細設定で見つけることができます。
チャンネル URL、ユーザー名 URL、またはカスタムチャンネル URL を直接使用することはできません。RSS Polling プラグインでは、明示的な
channel_idフィード URL が必要です。
避けるべき一般的なミス
- RSS フィード URL ではなく標準の YouTube ページ URL を使用している
- プレイリストまたはチャンネル URL を使用しているが、正しい ID を抽出していない
- 同じフィード URL でプレイリストとチャンネルのパラメータを混在させている
YouTube フィードが誤って設定されている場合、RSS Polling プラグインはサイレントに失敗するか、新しいトピックのインポートを停止する可能性があります。
ポーリング頻度を設定する
rss polling frequency サイト設定は、Discourse が RSS フィードを新しいコンテンツのためにチェックする頻度を制御します。デフォルト値は 30 分で、最小値は 10 分、最大値は 180 分（3 時間）です。
セルフホストサイト
ポーリング頻度を変更するには:
/admin/site_settingsに移動します- “rss polling frequency” を検索します
- 希望の間隔を分単位で設定します
ホスティングサイト
rss_polling_frequency サイト設定の変更をリクエストするには、サポートチームに連絡してください。
フィード設定を管理する
フィードの著者を変更する
RSS Polling 設定ページで「Author」フィールドを更新することで、特定の RSS フィードに関連付けられているすべてのトピックの著者を変更できます。これにより、そのフィードからの既存のすべてのトピックが自動的に新しい著者に更新されます。これらの変更は、管理者ログのシステム投稿編集イベントとして表示されます。
フィードのカテゴリまたはタグを変更する
RSS フィード URL のカテゴリまたはタグを変更しても、既存のトピックは自動的に更新されません。次の手順が必要です:
- 管理者一括操作を使用して、既存のトピックを手動で新しいカテゴリに移動するか、タグを更新します
- RSS フィード設定を更新して、新しいトピックが正しいカテゴリとタグを使用するようにします
フィード URL の制限
各一意の RSS フィード URL は、Discourse に 1 回だけインポートされます。RSS フィードを初めて設定すると、Discourse はフィード全体をインポートします。同じフィード URL を削除して再追加しても、以前に処理されたアイテムが再インポートされることはありません。
トピックの表示を制御する
トピックが非公開リストにされないようにする
デフォルトでは、埋め込みトピックは返信がない限り非公開リストになります。この動作は RSS からのインポートされたトピックには意味をなしません。RSS トピックが非公開リストにされないようにするには:
/admin/site_settingsに移動します- “embed unlisted” を検索します
- この設定を無効にします
全文の投稿を表示する
embed truncate サイト設定が有効になっている場合（デフォルト）、フィードトピックは抜粋のみを表示します。ユーザーは「全文を表示」ボタンをクリックして全文を表示できます。
常に全文を表示するには:
- Admin > Site Settings に移動します
- “embed truncate” を検索します
- この設定を無効にします
全文の投稿が正しく表示されない場合は、embed whitelist selector サイト設定を設定して、インポートする HTML 要素を指定します。
一般的な問題と解決策
フィードが更新されない
以下を確認してください:
- RSS フィード URL が有効でアクセス可能である
- ポーリング頻度が高すぎない
- 前回ポーリング以降、RSS フィードに実際に新しいアイテムがある
プラグインインターフェースが応答しない
一部のユーザーは、RSS Polling 設定インターフェースが応答しないという問題を報告しています。これは通常、ブラウザの広告ブロッカーが管理インターフェースに干渉することが原因です。以下を試してください:
- Discourse サイトの広告ブロッカーを無効にする
- 別のブラウザを使用する
- ページをハードリフレッシュする
間違った日付でトピックが作成される
デフォルトでは、RSS トピックはインポート時に現在の日付を使用します。RSS フィードからの元の公開日を使用したい場合は、rss polling use pubdate 設定を有効にします。
FAQ
RSS フィードをどのくらいの頻度でポーリングできますか？
最小ポーリング頻度は 10 分、最大は 180 分（3 時間）です。
RSS フィードからの返信をインポートできますか？
いいえ、RSS Polling プラグインはメインフィードアイテムのみを個別のトピックとしてインポートします。コメントや返信はインポートされません。
フィードを削除して再追加すると、重複したトピックが作成されますか？
いいえ、各 RSS フィードアイテムは 1 回だけインポートされます。フィードを再追加しても、重複は作成されません。
RSS ポーリングの問題をどのようにデバッグしますか？
現在、プラグインには限られたログ機能があります。管理者 > セキュリティ > ログパネルで、RSS ポーリングに関連するエラーメッセージがないか Discourse ログを確認してください。