| |
|—|—|—|
| 
| Резюме | Позволяет автоматически импортировать контент из 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.