 |
概要 | RSS/ATOM フィードからのコンテンツを Discourse サイトのトピックとして自動的にインポートすることを可能にします |
 |
インストールガイド | このプラグインは Discourse コアにバンドルされています。プラグインを個別にインストールする必要はありません。 |
このドキュメントでは、RSS Polling プラグインを設定し、RSS フィードからのコンテンツを Discourse コミュニティのトピックとして自動的にインポートする方法について説明します。
RSS フィードの設定
プラグインを有効にするには、管理者 → インストール済みプラグインに移動し、RSS Polling プラグインを見つけて、トグルをオンにします。
有効化後、設定をクリックし、フィードを追加ボタンをクリックして、最初のフィードを設定します。
以下の情報を入力する必要があります。
- フィード URL: インポートする RSS または Atom フィードの URL。
- カテゴリフィルター (オプション): アイテムのカテゴリメタデータに基づいて、インポートされるフィードアイテムを制限します。入力した値と一致するフィードカテゴリを持つアイテムのみが Discourse にインポートされます。例えば、フィードに複数のカテゴリでタグ付けされたアイテムが含まれている場合、特定の用語を入力して、そのアイテムのみをインポートできます。
- 著者: このフィードからインポートされたすべてのトピックの著者としてリストされる既存の Discourse ユーザー。
- カテゴリ: インポートされたトピックが公開される Discourse カテゴリ。
- タグ: このフィードからのすべてのトピックに適用される 1 つ以上のタグ。
保存をクリックしてフィードを追加します。
🎥 一般的な例: 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
正しいフィード URL は次のようになります。
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
YouTube チャンネルのインポート
チャンネル RSS フィード形式を使用します。
https://www.youtube.com/feeds/videos.xml?channel_id=<CHANNEL-ID>
channel_id は YouTube のチャンネルの詳細設定で見つけることができます。
標準的なチャンネル URL、ユーザー名 URL、またはカスタムチャンネル URL を直接使用しても動作しません。RSS Polling プラグインには、明示的な
channel_idフィード URL 形式が必要です。
フィードのテスト
新しいまたは編集したフィードを保存する前に、フィードをテストをクリックして、何もインポートせずにフィードを取得して分析します。次の内容が表示されます。
- インポートされるアイテム数、既にインポートされているアイテム数、またはスキップされるアイテム数の概要。
- フィードの最初のアイテムの行ごとの内訳。各アイテムには、インポートされるかスキップされるかの理由が平易な言葉で説明されています。
これは、コミュニティに影響を与える前に、特にカテゴリフィルターを含む設定を確認するのに役立ちます。
最近のポーリング
既存のフィードの編集ページでは、最近のポーリング領域に、直近のいくつかのポーリング試行が表示されます。各試行には、インポート、更新、スキップ、および失敗したアイテムの数が表示されます。任意の試行を展開して、作成または更新されたトピックへのリンクを含む、アイテムごとの詳細を確認できます。
今すぐポーリングをクリックすると、ページをリフレッシュせずにリアルタイムで結果が表示されます。
設定
設定タブは、RSS Polling に関連するサイト設定へのリンクです。
| 名前 | 説明 |
|---|---|
rss polling feed request timeout |
遅いフィードリクエストを諦める前に待つ時間（秒）。デフォルトは 30 秒です。 |
rss polling verbose logging |
各ポーリング試行に対して詳細なアイテムごとのログを有効にします。デフォルトではオフです。トラブルシューティングに役立ちます。 |
rss polling use pubdate |
インポートされた日付ではなく、フィードアイテムの元の公開日付をトピック日付として使用します。 |
rss polling update tags |
トピックが更新されたときにトピックタグを更新します。無効にすると、初期タグのみを取得します。 |
トピックの表示制御
トピックの非公開化を防止する
デフォルトでは、埋め込みトピックは返信が来るまで非公開です。RSS でインポートされたトピックの非公開化を防止するには:
- 管理者 → すべてのサイト設定に移動します。
embed unlistedを検索します。- この設定を無効にします。
投稿の全文を表示する
embed truncate 設定が有効になっている場合（デフォルト）、フィードトピックは抜粋のみを表示します。全文を表示するには:
- 管理者 → すべてのサイト設定に移動します。
embed truncateを検索します。- この設定を無効にします。
全文がまだ正しく表示されない場合は、embed whitelist selector 設定を設定して、インポートする HTML 要素を指定します。
一般的な問題
フィードが更新されない
- フィード URL が有効で、公開されていることを確認します。
rss polling frequencyが高すぎないことを確認します。- 最後のポーリング以降にフィードに新しいアイテムがあることを確認します。
- フィードをテストボタンを使用して、完全なポーリングを実行せずにプラグインがフィードで何を見ているかを確認します。
- 各ポーリング中に何が起こっているかについて詳細を確認するには、
rss polling verbose loggingを有効にします。
間違った日付で作成されたトピック
rss polling use pubdate 設定を有効にして、インポート日付ではなく、フィードアイテムの元の公開日付を使用します。
各フィード URL は 1 回だけインポートされる
同じフィード URL を削除して再追加しても、以前処理されたアイテムは再インポートされません。各 RSS アイテムは 1 回だけインポートされます。