 |
요약 | RSS/ATOM 피드에서 콘텐츠를 자동으로 가져와 Discourse 사이트의 주제로 가져올 수 있도록 합니다 |
 |
설치 가이드 | 이 플러그인은 Discourse 코어에 번들로 포함되어 있습니다. 플러그인을 별도로 설치할 필요가 없습니다. |
이 문서는 RSS Polling 플러그인을 구성하고 사용하여 RSS 피드에서 콘텐츠를 자동으로 가져와 Discourse 커뮤니티의 주제로 가져오는 방법을 다룹니다.
RSS 피드 구성
플러그인을 활성화하려면 관리자 → 설치된 플러그인으로 이동하여 RSS Polling 플러그인을 찾은 후 토글을 켜세요.
활성화되면 설정을 클릭한 다음 피드 추가 버튼을 클릭하여 첫 번째 피드를 구성하세요.
다음 정보를 추가해야 합니다:
- 피드 URL: 가져올 RSS 또는 Atom 피드의 URL입니다.
- 카테고리 필터 (선택 사항): 항목의 카테고리 메타데이터를 기반으로 가져올 피드 항목을 제한합니다. 입력한 값과 피드 카테고리가 일치하는 항목만 Discourse로 가져옵니다. 예를 들어, 피드에 여러 카테고리로 태그된 항목이 포함된 경우, 특정 카테고리 용어를 입력하여 해당 항목만 가져올 수 있습니다.
- 저자: 이 피드에서 가져온 모든 주제의 저자로 표시될 기존 Discourse 사용자입니다.
- 카테고리: 가져온 주제가 게시될 Discourse 카테고리입니다.
- 태그: 이 피드의 모든 주제에 적용될 하나 이상의 태그입니다.
저장을 클릭하여 피드를 추가하세요.
🎥 일반적인 예시: 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를 검색합니다.- 이 설정을 비활성화합니다.
전체 게시글 콘텐츠가 여전히 올바르게 표시되지 않으면, 가져올 HTML 요소를 지정하도록 embed whitelist selector 설정을 구성하세요.
일반적인 문제
피드가 업데이트되지 않음
- 피드 URL이 유효하고 공개적으로 접근 가능한지 확인합니다.
rss polling frequency가 너무 높게 설정되어 있지 않은지 확인합니다.- 마지막 폴링 이후 피드에 새 항목이 있는지 확인합니다.
- 피드 테스트 버튼을 사용하여 전체 폴링을 실행하지 않고 플러그인이 피드에서 무엇을 보는지 확인합니다.
- 각 폴링 중에 일어나는 일에 대한 자세한 내용을 위해
rss polling verbose logging을 활성화합니다.
잘못된 날짜로 생성된 주제
rss polling use pubdate 설정을 활성화하여 가져온 날짜 대신 피드 항목의 원래 게시 날짜를 사용하세요.
각 피드 URL은 한 번만 가져옴
같은 피드 URL을 삭제하고 다시 추가해도 이전에 처리된 항목이 다시 가져오지지 않습니다. 각 RSS 항목은 한 번만 가져옵니다.
This plugin is now bundled with Discourse core as part of 