 |
Резюме | Позволяет автоматически импортировать контент из RSS/ATOM-лент на ваш сайт Discourse в виде тем |
 |
Руководство по установке | Этот плагин включен в ядро Discourse. Отдельная установка плагина не требуется. |
Это руководство объясняет, как настроить и использовать плагин RSS Polling для автоматического импорта контента из RSS/ATOM-лент на ваш сайт Discourse в виде тем.
Требуемый уровень пользователя: Администратор
Резюме
В этой документации рассматриваются включение плагина RSS Polling, настройка URL-адресов лент, управление параметрами и устранение распространенных проблем. Вы узнаете, как настроить ленты для публикации в конкретных категориях, назначить авторов и контролировать отображение контента на вашем сайте.
Включение плагина RSS Polling
Сайты с самостоятельным размещением
Перейдите в панель администратора по пути Администратор > Плагины и найдите плагин RSS Polling. Включите его с помощью переключателя:
Размещено компанией Discourse
Если ваш сайт размещен компанией Discourse, обратитесь в службу поддержки для запроса активации плагина RSS Polling. Плагин доступен во всех тарифных планах с размещением.
Настройка RSS-лент
После включения плагина перейдите на страницу конфигурации RSS Polling, посетив панель Администратор > Плагины > RSS Polling напрямую или перейдя по адресу /admin/plugins и выбрав “RSS Polling” в боковом меню.
Добавление новой RSS-ленты
- Введите URL-адрес RSS или ATOM-ленты в поле “URL-адрес ленты”.
- Выберите существующего пользователя вашего сайта в качестве “Автора” — этот пользователь будет владельцем всех сообщений, созданных из ленты.
- Выберите категорию Discourse, в которой будут публиковаться темы из ленты.
- Нажмите кнопку сохранения
.
Опционально: добавьте теги, которые будут применяться ко всем темам из этой ленты, и/или введите фильтр категорий ленты, чтобы ограничить импорт элементов ленты
Фильтр категорий ленты
Настройка фильтра категорий ленты позволяет ограничить импорт элементов ленты на основе метаданных категории элемента. Когда вы вводите термин категории в это поле, в Discourse импортируются только элементы ленты, соответствующие этой конкретной категории.
Например, если вы изучите ленту по адресу https://blog.discourse.org/feed.xml, вы увидите, что каждая запись содержит информацию о категории. Для фильтрации по конкретным категориям введите значение свойства term категории.
Настройка лент YouTube
общие примеры
YouTube — одна из самых распространенных платформ, используемых с RSS Polling, но её также легко настроить неправильно. Ниже приведены рекомендуемые и поддерживаемые форматы URL-адресов лент для наиболее распространенных сценариев использования YouTube.
Импорт плейлиста 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-адрес RSS-ленты будет:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Импорт канала YouTube
Для импорта видео из канала YouTube используйте формат RSS-ленты канала:
https://www.youtube.com/feeds/videos.xml?channel_id=ВАШ_ID_КАНАЛА
channel_id можно найти в YouTube в разделе Расширенные настройки канала.
Использование прямого URL-адреса канала, URL-адреса с именем пользователя или пользовательского URL-адреса канала не сработает. Плагин RSS Polling требует явного URL-адреса ленты с
channel_id.
Распространенные ошибки, которых следует избегать
- Использование стандартных URL-адресов страниц YouTube вместо URL-адресов RSS-лент
- Использование 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-лентой, обновив поле “Автор” на странице настроек RSS Polling. Это автоматически обновит все существующие темы из этой ленты новым автором. Эти изменения отображаются как события редактирования системных сообщений в логах администратора.
Изменение категории или тегов ленты
Изменение категории или тегов URL-адреса RSS-ленты не приведет к автоматическому обновлению существующих тем. Вам потребуется:
- Использовать административные массовые операции для ручного перемещения существующих тем в новую категорию или обновления тегов.
- Обновить настройки RSS-ленты, чтобы новые темы использовали правильную категорию и теги.
Ограничения URL-адресов лент
Каждый уникальный URL-адрес RSS-ленты импортируется в Discourse только один раз. При первой настройке RSS-ленты Discourse импортирует всю ленту. Удаление и повторное добавление того же URL-адреса ленты не приведет к повторному импорту ранее обработанных элементов.
Управление видимостью тем
Предотвращение скрытия тем из списка
По умолчанию встроенные темы скрываются из списка до получения ответа. Такое поведение не имеет смысла для тем, импортированных из RSS. Чтобы предотвратить скрытие тем из RSS:
- Перейдите по адресу
/admin/site_settings. - Найдите “embed unlisted”.
- Отключите эту настройку.
Отображение полного содержимого сообщения
Если включена настройка сайта embed truncate (по умолчанию), темы из ленты будут отображать только фрагмент. Пользователи могут просмотреть полный контент, нажав кнопку “Показать полное сообщение”.
Чтобы всегда отображать полный контент:
- Перейдите в
Администратор > Настройки сайта. - Найдите “embed truncate”.
- Отключите эту настройку.
Если полное содержимое сообщения отображается неправильно, настройте параметр сайта embed whitelist selector, чтобы указать, какие HTML-элементы должны импортироваться.
Распространенные проблемы и решения
Лента не обновляется
Проверьте следующее:
- URL-адрес RSS-ленты действителен и доступен
- Частота опроса не установлена слишком высокой
- В RSS-ленте действительно есть новые элементы с момента последнего опроса
Интерфейс плагина не отвечает
Некоторые пользователи сообщают о проблемах с интерфейсом конфигурации RSS Polling, который не отвечает. Это часто вызвано блокировщиками рекламы в браузере, которые мешают работе интерфейса администратора. Попробуйте:
- Отключить блокировщики рекламы для вашего сайта Discourse
- Использовать другой браузер
- Выполнить жесткую перезагрузку страницы
Темы создаются с неправильными датами
По умолчанию темы RSS используют текущую дату при импорте. Если вы хотите использовать исходную дату публикации из RSS-ленты, включите настройку rss polling use pubdate.
Часто задаваемые вопросы
Как часто можно опрашивать RSS-ленты?
Минимальная частота опроса — 10 минут, максимальная — 180 минут (3 часа).
Можно ли импортировать ответы из RSS-лент?
Нет, плагин RSS Polling импортирует только основные элементы ленты в виде отдельных тем. Комментарии или ответы не импортируются.
Приведет ли удаление и повторное добавление ленты к дублированию тем?
Нет, каждый элемент RSS-ленты импортируется только один раз. Повторное добавление ленты не создаст дубликатов.
Как отладить проблемы с опросом RSS?
В настоящее время у плагина ограниченное ведение журналов. Проверьте журналы Discourse в панели Администраторы > Безопасность > Журналы на наличие любых сообщений об ошибках, связанных с опросом RSS.