Недоступно в редакциях: Старт

Сообщения блога

Описание blog.blog

Компонент выводит сообщения блога с возможностью их фильтрации по категории и дате. Компонент стандартный и входит в дистрибутив модуля.

В структуре визуального редактора компонент расположен по пути Общение > Блоги > Сообщения блога.

Компонент относится к модулю Блоги.

Параметры

Основные параметры
Поле	Параметр	Описание
Год для фильтрации	YEAR	Указывается код, в котором передается год для фильтрации. По умолчанию поле содержит ={$year}.
Месяц для фильтрации	MONTH	Указывается код, в котором передается месяц фильтрации. По умолчанию поле содержит ={$month}.
День для фильтрации	DAY	Указывается код, в котором передается день для фильтрации. По умолчанию поле содержит ={$day}.
Идентификатор тега для фильтрации	CATEGORY_ID	Указывается код, в котором передается идентификатор тега для фильтрации. По умолчанию поле содержит ={$category}.
Источник данных
Путь блога	BLOG_URL	Указывается код, в котором передается идентификатор блога. По умолчанию поле содержит ={$blog}.
Имя массива со значениями фильтра для фильтрации сообщений	FILTER_NAME	Задается имя переменной, в которой передается массив параметров из фильтра. Служит для определения выходящих из фильтра элементов. Поле может быть оставлено пустым, тогда используется значение по умолчанию.
Внешний вид
Количество сообщений, выводимых на страницу	MESSAGE_COUNT	Указывается число сообщений блогов, отображаемых на одной странице. Все сообщения будут выведены с помощью постраничной навигации.
Формат показа даты и времени	DATE_TIME_FORMAT	Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Имя шаблона для постраничной навигации	NAV_TEMPLATE	Указывается имя шаблона для постраничной навигации.
Максимальная ширина изображения	IMAGE_MAX_WIDTH	Указывается максимально допустимая ширина картинки, которую можно вставить в сообщение
Максимальная высота изображения	IMAGE_MAX_HEIGHT	Указывается максимально допустимая высота картинки, которую можно вставить в сообщение
Шаблоны ссылок
Шаблон пути к странице блога	PATH_TO_BLOG	Указывается путь к главной странице блога. Например, blog_blog.php?page=blog&blog=#blog#.
Шаблон пути к странице блога c фильтром по тегу	PATH_TO_BLOG_CATEGORY	Указывается путь к странице блога с фильтром по тегу. Например, blog_filter.php?page=blog&blog=#blog#&category=#category#.
Шаблон пути к странице с сообщением блога	PATH_TO_POST	Указывается путь к странице детального просмотра сообщения блога. Например, blog_post.php?page=post&blog=#blog#&post_id=#post_id#.
Шаблон пути к странице редактирования сообщения блога	PATH_TO_POST_EDIT	Указывается путь к странице редактирования сообщения блога. Например, blog_p_edit.php?page=post_edit&blog=#blog#&post_id=#post_id#.
Шаблон пути к странице пользователя блога	PATH_TO_USER	Указывается путь к странице профиля пользователя блога. Например, blog_user.php?page=user&user_id=#user_id#.
Настройки кеширования
Тип кеширования	CACHE_TYPE	Тип кеширования: A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных; Y - Кешировать: для кеширования необходимо определить время кеширования; N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)	CACHE_TIME	Время кеширования, указанное в секундах.
Время кеширования остальных страниц	CACHE_TIME_LONG	Указывается время кеширования страниц, начиная со второй.
Дополнительные настройки
Путь к папке со смайликами относительно корня сайта	PATH_TO_SMILE	Указывается путь к папке со смайликами относительно корня сайта.
Добавлять пункт в цепочку навигации	SET_NAV_CHAIN	[Y\|N] При отмеченной опции в цепочку навигации будет добавлен пункт с названием блога.
Устанавливать заголовок страницы	SET_TITLE	[Y\|N] При отмеченной опции в качестве заголовка страницы будет установлено название блога.
Показывать доп. свойства сообщения в блоге	POST_PROPERTY_LIST	Указываются пользовательские свойства сообщения, которые необходимо дополнительно отобразить в блоге.
Включить рейтинг	SHOW_RATING	Указывается, будет ли будет использован функционал рейтингов: да; нет; по умолчанию - значение берется из настроек рейтингов.	Примечание: С версии 17.6.0 добавлена поддержка рейтингов с реакциями.
Вид кнопок рейтинга	RATING_TYPE	Указывается тип кнопок рейтинга: по умолчанию; Мне нравится (текстовый); Мне нравится (графический); Нравится / Не нравится (текстовый); Нравится / Не нравится (графический). Значение По умолчанию берется из настроек рейтингов.
Запретить индексацию ссылки на профиль пользователя поисковыми ботами	SEO_USER	[Y\|N] При отмеченной опции поисковые боты не смогут индексировать ссылки на профиль пользователя.
Имена переменных
Имя переменной для идентификатора блога	BLOG_VAR	Указывается имя переменной, в которой передается идентификатор (ID) блога.
Имя переменной для идентификатора сообщения блога	POST_VAR	Указывается имя переменной, которой передается идентификатор (ID) сообщения блога.
Имя переменной для идентификатора пользователя блога	USER_VAR	Указывается имя переменной, которой передается идентификатор (ID) пользователя блога.
Имя переменной для страницы	PAGE_VAR	Указывается имя переменной, которой передается страница блога.

Пример вызова

<?$APPLICATION->IncludeComponent(
"bitrix:blog.blog",
	"",
	Array(
		"SEO_USER" => "Y",
		"MESSAGE_COUNT" => "25",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"PATH_TO_BLOG" => "",
		"PATH_TO_BLOG_CATEGORY" => "",
		"PATH_TO_POST" => "",
		"PATH_TO_POST_EDIT" => "",
		"PATH_TO_USER" => "",
		"PATH_TO_SMILE" => "",
		"BLOG_VAR" => "",
		"POST_VAR" => "",
		"USER_VAR" => "",
		"PAGE_VAR" => "",
		"BLOG_URL" => $blog,
		"YEAR" => $year,
		"MONTH" => $month,
		"DAY" => $day,
		"CATEGORY_ID" => $category,
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "7200",
		"CACHE_TIME_LONG" => "604600",
		"SET_NAV_CHAIN" => "Y",
		"SET_TITLE" => "Y",
		"FILTER_NAME" => "arFilter",
		"NAV_TEMPLATE" => "",
		"POST_PROPERTY_LIST" => array("UF_BLOG_POST_DOC"),
		"IMAGE_MAX_WIDTH" => "600",
		"IMAGE_MAX_HEIGHT" => "600"
	)	
);?>