 |
Описание | Позволяет автоматически импортировать контент из RSS/ATOM-лент на ваш сайт Discourse в виде тем |
 |
Руководство по установке | Этот плагин входит в состав ядра Discourse. Отдельная установка плагина не требуется. |
В этой документации описывается, как настроить и использовать плагин RSS Polling для автоматического импорта контента из RSS-лент в ваше сообщество Discourse в виде тем.
Настройка RSS-лент
Чтобы включить плагин, перейдите в раздел Администратор → Установленные плагины, найдите плагин RSS Polling и включите переключатель.
После включения нажмите кнопку Настройки, а затем кнопку Добавить ленту, чтобы настроить первую ленту.
Вам потребуется указать следующую информацию:
- URL ленты: URL RSS или Atom ленты для импорта.
- Фильтр категории (необязательно): Ограничивает импорт элементов ленты на основе метаданных их категории. В Discourse будут импортированы только те элементы, категория которых совпадает с указанным вами значением. Например, если лента содержит элементы с несколькими категориями, вы можете ввести конкретный термин категории, чтобы импортировать только соответствующие элементы.
- Автор: Существующий пользователь Discourse, который будет указан как автор всех тем, импортированных из этой ленты.
- Категория: Категория Discourse, в которой будут опубликованы импортированные темы.
- Теги: Один или несколько тегов, которые будут применены ко всем темам из этой ленты.
Нажмите Сохранить, чтобы добавить ленту.
🎥 Типичный пример: Ленты YouTube
Импорт плейлиста YouTube
Используйте конечную точку RSS-ленты YouTube для плейлистов:
https://www.youtube.com/feeds/videos.xml?playlist_id=<ID_ПЛЕЙЛИСТА>
Где <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=<ID_КАНАЛА>
Вы можете найти channel_id на YouTube в разделе Расширенные настройки для канала.
Использование стандартного URL канала, URL имени пользователя или пользовательского URL канала напрямую не сработает. Плагин RSS Polling требует явного формата URL ленты с
channel_id.
Тестирование лент
Перед сохранением новой или отредактированной ленты нажмите кнопку Тестировать ленту, чтобы получить и проанализировать ленту без импорта. Вы увидите:
- Сводное количество элементов, которые будут импортированы, уже импортированы или будут пропущены.
- Построчную разбивку первых элементов ленты, каждый с объяснением на простом языке, почему он будет импортирован или пропущен.
Это полезно для проверки вашей конфигурации — особенно фильтра категории — до того, как она повлияет на ваше сообщество.
Последние проверки
На странице редактирования любой существующей ленты в разделе Последние проверки отображаются последние несколько попыток проверки. Для каждой попытки показывается количество импортированных, обновленных, пропущенных и неудачных элементов. Вы можете развернуть любую попытку, чтобы увидеть подробную информацию по каждому элементу, включая ссылки на созданные или обновленные темы.
При нажатии кнопки Проверить сейчас результаты появляются в реальном времени без перезагрузки страницы.
Настройки
Вкладка Настройки содержит ссылки на соответствующие настройки сайта для 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 ленты импортируется только один раз
Удаление и повторное добавление одного и того же URL ленты не приведет к повторному импорту ранее обработанных элементов. Каждый элемент RSS импортируется только один раз.