Документация для разработчиков
Темная тема
Недоступно в редакциях: Старт

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


Описание 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"
	)	
);?>



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх