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

Популярные сообщения


Описание blog.popular_posts

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

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

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



Параметры

Поле Параметр Описание
Источник данных
Группа блогов для отображения GROUP_ID Указывается группа блогов, популярные сообщения блогов которой будут отображены. Если не указано, то выборка производится по всем группам блогов.
Адрес блога для отображения BLOG_URL Указывается адрес блога, популярные сообщения которого будут отображены. Если не указано, то выборка производится по всем блогам.
Внешний вид
Сортировать по SORT_BY1 Выбирается способ сортировки сообщений блога:
  • количество просмотров;
  • рейтинг сообщения;
  • количество голосов.
Количество результатов, выводимых на страницу MESSAGE_COUNT Указывается число сообщений блогов, отображаемых на одной странице. Все последние сообщения блогов будут выведены с помощью постраничной навигации.
Количество дней для выбора популярных сообщений PERIOD_DAYS Указывается количество дней для выбора популярных сообщений блогов, которые будут отображены.
Длина выводимого текста сообщения MESSAGE_LENGTH Задается длина выводимого текста сообщения.
Ширина картинки предпросмотра PREVIEW_WIDTH Указывается ширина картинки предпросмотра.
Высота картинки предпросмотра PREVIEW_HEIGHT Указывается ширина картинки предпросмотра.
Формат показа даты и времени DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Шаблоны ссылок
Шаблон пути к странице блога PATH_TO_BLOG Указывается путь к главной странице блога.
Шаблон пути к странице с сообщением блога PATH_TO_POST Указывается путь к странице просмотра сообщения блога.
Шаблон пути к странице пользователя блога PATH_TO_USER Указывается путь к странице профиля пользователя блога.
Шаблон пути к странице с сообщением блога группы PATH_TO_GROUP_BLOG_POST Указывается путь к странице с сообщением блога группы.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Путь к папке со смайликами относительно корня сайта PATH_TO_SMILE Указывается путь к папке со смайликами относительно корня сайта.
Запретить индексацию ссылки на профиль пользователя поисковыми ботами SEO_USER [Y|N] При отмеченной опции поисковые боты не смогут индексировать ссылки на профиль пользователя.
Имена переменных
Имя переменной для идентификатора блога BLOG_VAR Указывается имя переменной, которой передается идентификатор блога.
Имя переменной для идентификатора сообщения блога POST_VAR Указывается имя переменной, которой передается идентификатор сообщения блога.
Имя переменной для идентификатора пользователя блога USER_VAR Указывается имя переменной, которой передается идентификатор пользователя блога.
Имя переменной для страницы PAGE_VAR Указывается имя переменной, которой передается страница блога.


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

<?$APPLICATION->IncludeComponent(
"bitrix:blog.popular_posts",
	"",
	Array(
		"SEO_USER" => "Y",
		"SORT_BY1" => "RATING_TOTAL_VALUE",
		"MESSAGE_COUNT" => "6",
		"PERIOD_DAYS" => "30",
		"MESSAGE_LENGTH" => "100",
		"PREVIEW_WIDTH" => "100",
		"PREVIEW_HEIGHT" => "100",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"PATH_TO_BLOG" => "",
		"PATH_TO_POST" => "",
		"PATH_TO_USER" => "",
		"PATH_TO_GROUP_BLOG_POST" => "",
		"PATH_TO_SMILE" => "",
		"BLOG_VAR" => "",
		"POST_VAR" => "",
		"USER_VAR" => "",
		"PAGE_VAR" => "",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "86400",
		"GROUP_ID" => "",
		"BLOG_URL" => ""
	)
);?>



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

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

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

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

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