Теги модуля RSS
Примечание: Модуль снабжен шаблонами RSS, для самых общих версий RSS, просто как образец, так как создание RSS feed "с нуля" имеет некоторые особенности.
Основная задача тега RSS. - вывод начальной части канала RSS, которая содержит имя автора, кодировку символов, и т.д., в то время как основной тег раздела выводит фактические строки.
Тег модуля RSS предназначен для использования совместно с тегом weblog entries.
Весь код канала RSS находиться между тегами:
{exp:rss:feed}
{/exp:rss:feed}
Параметры
Если вы используете любой из следующих параметров, то, вероятно, захотите отразить те же самые настройки для вашего тега {exp:weblog:entries}, который находится внутри тега RSS.
status=
status="open"
Вы можете указать отдельный статус. Вы можете указать несколько статусов, разделяя их символом ("|"):
status="draft|reviewed|published"
Или исключите некоторые статусы, используя "not"
status="not submitted|processing|closed"
username=
username="petunia"
Этот параметр ограничивает запрос логином пользователя. Вы можете использовать символ ("|"), для указания нескольких пользователей:
username="tom|dick|harry"
Или вы можете добавить "not" для исключения некоторых пользователей:
username="not tom|dick|harry|fred"
Вы можете также использовать константу "CURRENT_USER", чтобы отобразить записи текущего авторизованного пользователя.
username="CURRENT_USER"
Таким образом, каждый авторизованный пользователь может получить только свои записи. Не авторизованные пользователи не увидят ничего. Также вы можете использовать константу "NOT_CURRENT_USER", чтобы показать все записи кроме записей текущего авторизованного пользователя.
username="NOT_CURRENT_USER"
weblog=
weblog="which"
Из какого раздела будет отображаться информация. Вы должны указать один раздел.
show_expired=
show_expired="yes"
Вы можете указать, чтобы отображались "просроченные" записи.
show_future_entries=
show_future_entries="yes"
С помощью этого тега вы можете указать, отображать или нет записи с "будущей" датой. Эта опция полезна для создания, например, списка событий, некоторые из которых еще не произошли. Заметим, что EE по-прежнему будет отображать "просроченные" записи; этот параметр просто указывает EE включать "будущие записи".
Переменные
- {author}
- {email}
- {encoding}
- {version}
- {weblog_description}
- {weblog_id}
- {weblog_language}
- {weblog_name}
- {weblog_url}
author
{author}
Имя автора, который создал последнюю запись.
{email}
Адрес электронной почты автора, создавшего последнюю запись.
encoding
{encoding}
Кодировка XML для раздела.
version
{version}
Версия ExpressionEngine, которую вы используете (1,0, 1,1, и т.д.). Эти данные читаются из файла system/core/core.system.php.
weblog_description
{weblog_description}
Описание раздела.
weblog_id
{weblog_id}
Идентификатор (ID) раздела (не записи раздела, а самого раздела).
weblog_language
{weblog_language}
Код языка раздела (en-us, ru и т.д.).
weblog_name
{weblog_name}
Полное имя раздела.
weblog_url
{weblog_url}
URL раздела, как указано в настройке "URL раздела" на странице управление разделами.
Одиночная переменная даты
Для использования доступны несколько переменных даты. Как и с другими переменными даты, необходимо использовать параметр "format", чтобы определить формат отображения даты. Смотрите страницу изменяемое форматирование даты для получения дополнительной информации.
- {date format="%Y %m %d"}
- {edit_date format="%Y %m %d"}
- {gmt_date format="%Y %m %d"}
- {gmt_edit_date format="%Y %m %d"}
date
{date format="%Y %m %d"}
Дата публикации последней записи. Примечание: как со всеми датами, необходимо использовать коды форматирования: {date format="%Y"}
edit_date
{edit_date format="%Y %m %d"}
Дата последнего редактирования записи.
gmt_entry_date
{gmt_date format="%Y %m %d"}
Дата публикации записи по Гринвичу. Эта переменная не локализированная, т.е. не учитывает настройки даты пользователя.
gmt_edit_date
{gmt_edit_date format="%Y %m %d"}
Дата последнего редактирования записи, по Гринвичу. Эта переменная не локализированная, т.е. не учитывает настройки даты пользователя.
Поддержка RFC3229
В ExpressionEngine имеется возможность передавать только новый контент, если система получает RFC3229-совместимый запрос(RFC_ info). Это означает, что EE может выдавать только новый контент, который появился с момента последнего обращения к каналу, если программы или серверы, сконфигурированы соответствующим образом. Это позволяет вам снизить нагрузку на сервер, и объем передаваемой информации, выдавая только необходимый контент.
Эта возможность включается добавлением специального параметра dynamic_start="on" к открывающему тегу {exp:weblog:entries}. Например:
{exp:weblog:entries weblog="default_site" limit="10" rdf="off" dynamic_start="on"}