# RSS-каналы

← [Назад к разделу «Модули»](README.md)

Модуль `rss` публикует документы выбранной рубрики в формате RSS 2.0. Канал
имеет постоянный человекочитаемый адрес `/rss/<alias>` и не требует вставки тега
в шаблон сайта.

## Настройка канала

1. Откройте **Модули → RSS-каналы** и создайте канал.
2. Задайте название, уникальный alias и описание.
3. Выберите рубрику-источник.
4. Выберите поле заголовка или штатное название документа.
5. Выберите поле описания либо отключите описание элемента.
6. Укажите количество элементов и допустимую длину описания.

Alias может содержать латинские буквы, цифры, дефис и подчёркивание. Старый
адрес `/rss/rss-<id>.xml` перенаправляется на новый URL. Ответ имеет тип
`application/rss+xml` и публичный cache-control на пять минут.

В канал попадают доступные опубликованные документы выбранной рубрики. Ссылки
строятся по публичным URL документов. Ограничение длины `0` сохраняет текст до
штатного разделителя «more», если он присутствует.

Права:

- `view_rss` — просмотр списка и настроек;
- `manage_rss` — создание, изменение и удаление каналов.

Деинсталляция удаляет таблицу каналов, но не документы и рубрики.