Одностраничный компонент, который служит для формирования и вывода календаря новостей или событий. Настройки позволяют настраивать внешний вид календаря, указывать его тип. Также компонент содержит стандартные настройки управления шаблоном, кешированием и т.д.
Пример вызова
<?$APPLICATION->IncludeComponent(
"bitrix:news.calendar",
"",
Array(
"IBLOCK_TYPE" => "news",
"IBLOCK_ID" => "33",
"MONTH_VAR_NAME" => "month",
"YEAR_VAR_NAME" => "year",
"WEEK_START" => "1",
"DATE_FIELD" => "DATE_ACTIVE_FROM",
"TYPE" => "EVENTS",
"SHOW_YEAR" => "Y",
"SHOW_TIME" => "Y",
"TITLE_LEN" => "0",
"SET_TITLE" => "Y",
"SHOW_CURRENT_DATE" => "Y",
"SHOW_MONTH_LIST" => "Y",
"NEWS_COUNT" => "0",
"DETAIL_URL" => "news_detail.php?ID=#ELEMENT_ID#",
"CACHE_TYPE" => "A",
"CACHE_TIME" => "3600"
)
);?>
Описание параметров
Основные параметры
- IBLOCK_TYPE
- Тип информационного блока.
- IBLOCK_ID
- Код информационного блока.
- MONTH_VAR_NAME
- Имя переменной для месяца. Имя переменной, в которой передается номер месяца.
- YEAR_VAR_NAME
- Имя переменной для года. Имя переменной, в которой передается номер года.
- WEEK_START
- Начало недели. Устанавливается день отсчета недели: понедельник либо воскресенье.
Внешний вид
- SHOW_YEAR
- Показывать переход по годам. При отсутствии опции в шаблоне по умолчанию не будет выведена ссылка на предыдущий год. В шаблоне compact в любом случае не выводится.
- SHOW_TIME
- Показывать время новостей. При отмеченной опции рядом с названием элемента будет выведено время начала активности, если оно определено для элемента (действует для шаблона по умолчанию).
- TITLE_LEN
- Длина заголовка (0 - не ограничивать) выводимая в календаре.
- SHOW_CURRENT_DATE
- Показывать текущий месяц и год. При установленной опции будут выведены текущий месяц и год над календарем в правом углу.
- SHOW_MONTH_LIST
- Показывать выпадающий список месяцев. В шаблоне по умолчанию при отмеченной опции будет выведен выпадающий список месяцев. В противном случае только ссылки на предыдущий и следующий месяцы.
- NEWS_COUNT
- Количество новостей в день (0 - не ограничивать). Если число отлично от нуля, то будут выбраны элементы с меньшим временем начала активности. Если время не определено, то элементы будут выбраны по индексу сортировки.
Шаблоны ссылок
- DETAIL_URL
- URL, ведущий на страницу с содержимым элемента инфоблока в календаре.
Настройки кеширования
- CACHE_TYPE
- Тип кеширования:
- А - Авто: действует при включенном автокешировании на странице Настройки кеширования (Настройки > Настройки продукта > Автокеширование) и при установленном времени кэширования в поле CACHE_TIME.
- Y - Кешировать:должно быть установлено время кеширования (CACHE_TIME). Настройки автокеширования не влияют на данный тип.
- N - Не кешировать: кеширование не происходит.
- CACHE_TIME
- Время кеширования в секундах.
Дополнительные настройки
- DATE_FIELD
- Поле даты. Если установлен тип календаря Событийный (EVENTS), то здесь установливается поле, по которому будет происходить "раскладывание" событий по датам, сортировка, выборка.
Доступны следующие значения:
- DATE_ACTIVE_TO - Дата активности по;
- DATE_ACTIVE_FROM - Дата активности с;
- TIME_STAMP_X - Время последнего изменения;
- DATE_CREATE - Дата создания;
- TYPE
- Тип календаря. Тип календаря может быть новостной (NEWS) и событийный (EVENTS). В новостном календаре все элементы сортируются и раскладываются по дате начала активности. В событийном календаре это будет происходить в соответствии с настройками поля даты.
- SET_TITLE
- Устанавливать заголовок страницы. При отмеченной опции в качестве заголовка страницы будет выведен текущий месяц и год.