Документация для разработчиков
Темная тема

Дни рождения


Описание intranet.structure.birthday.nearest

Компонент выводит список ближайших именинников. Компонент доступен при использовании решения Внутренний портал учебного заведения и содержит следующие шаблоны: .default и include_area. Компонент является стандартным и входит в дистрибутив модуля.

В визуальном редакторе компонент находится в Компоненты > Корпоративный портал > HR.



Параметры

Поле Параметр Описание
Дополнительно
Отображать фильтр SHOW_FILTER [Y|N] При отмеченной опции будет отображатся панель выбора подразделения. Если опция не отмечена, то будет показан весь список именниников.
Показывать год рождения SHOW_YEAR Поле определяет кому показываеть год рождения:
  • всем (Y);
  • только мужчинам (M);
  • никому (N).
Пользовательские поля для вывода USER_PROPERTY Указываются поля пользователей, которые будут показаны в визитных карточках сотрудников.
Отдел/офис DEPARTMENT Указывается офис, филиал или отдел, список ближайших именинников которого будет отображен.
Фильтрация на сайте экстранета EXTRANET_TYPE Выбирается фильтрация на сайте экстранета:
  • Контакты;
  • Сотрудники.
Группы пользователей SHOW_GROUP_ID C помощью клавиши Ctrl выбираются группы пользователей.
Управление режимом AJAX
Включить режим AJAX AJAX_MODE [Y|N] При отмеченной опции для компонента будет включен режим AJAX.
Включить прокрутку к началу компонента AJAX_OPTION_JUMP [Y|N] Если пользователь совершит AJAX-переход, то при установленой опции по окончании загрузки произойдет прокрутка к началу компонента.
Включить подгрузку стилей AJAX_OPTION_STYLE [Y|N] Если параметр принимает значение Y, то при совершении AJAX-переходов будет происходить подгрузка и обработка списка стилей, вызванных компонентом.
Включить эмуляцию навигации браузера AJAX_OPTION_HISTORY [Y|N] Когда пользователь выполняет AJAX-переходы, то при включенной опции можно использовать кнопки браузера Назад и Вперед.
Основные параметры
Страница структуры компании STRUCTURE_PAGE Указывается путь к странице структуры компании.
Страница отправки личного сообщения PM_URL Указывается путь к странице отправки личного сообщения.
Шаблон пути к странице подразделения PATH_TO_CONPANY_DEPARTMENT Указывается шаблон пути к странице подразделения компании.
Имя фильтра страницы структуры компании STRUCTURE_FILTER Задается имя фильтра страницы структуры компании.
Количество выводимых пользователей NUM_USERS Параметр определяет количество отображаемых на странице записей.
Отображение имени NAME_TEMPLATE Указывается шаблон для отображения ФИО пользователя социальной сети. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество.
Показывать логин, если не задано имя SHOW_LOGIN [Y|N] При отмеченной опции будет отображен логин пользователя, если не задано имя.
Дополнительные настройки
Формат показа даты DATE_FORMAT Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат показа даты без года DATE_FORMAT_NO_YEAR Указывается формат показа даты без года. В выпадающем списке перечислены все возможные варианты показа даты без года, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат показа даты и времени DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты и времени, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Настройки кеширования
Тип кеширования CACHE_TYPE Указывается тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.


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

<?$APPLICATION->IncludeComponent(
"campus:intranet.structure.birthday.nearest",
	"",
	Array(
		"SHOW_FILTER" => "Y",
		"AJAX_MODE" => "Y",
		"STRUCTURE_PAGE" => "structure.php",
		"PM_URL" => "/company/personal/messages/chat/#USER_ID#/",
		"PATH_TO_CONPANY_DEPARTMENT" => "/company/structure.php?set_filter_structure=Y&structure_UF_DEPARTMENT=#ID#",
		"STRUCTURE_FILTER" => "structure",
		"NUM_USERS" => "10",
		"NAME_TEMPLATE" => "#LAST_NAME# #NAME# #SECOND_NAME#",
		"SHOW_LOGIN" => "Y",
		"DATE_FORMAT" => "d.m.Y",
		"DATE_FORMAT_NO_YEAR" => "d.m",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"SHOW_YEAR" => "Y",
		"USER_PROPERTY" => array("PERSONAL_PHOTO"),
		"DEPARTMENT" => "73",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"SHOW_GROUP_ID" => array("5"),
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "N"
	)
);?>


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

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

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

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

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