1С-Битрикс Разработчикам - Эксперименты с веб-мессенджером: модифицируем список контактов

Допустим, у нас есть интернет-мессенджер и желание сформировать список контактов в нем произвольным образом: задать любые группы и любых пользователей. В текущей версии список контактов формируется 3-мя способами: структура компании в модуле «Интранет», группы «Экстранета», друзья пользователя в социальной сети.

В модуле «Интранет» группы формируются по структуре компании, каждой группе назначается id равное id раздела. Пользователи выбираются стандартным гетлистом и раскидываются по группам (поле UF_DEPARTMENT)
В модуле «Экстранет» группы формируются из тех, в которых состоит пользователь экстранета. Каждой группе присваивается id = SGид группы и название «Экстранет: имя группы». Пользователи раскидываются по полученным группам, а так же добавляются в группу extranet
Третий вариант создания групп – из списка друзей пользователя (если доступен функционал друзей в соцсети). Получаются все друзья и добавляются в группы friends и all
Дополнительно могут создаваться виртуальные группы: last – Последние контакты, all – Все контакты, other – Вне структуры / Вне списка, extranet – группа всех пользователей экстранета.

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

Модуль, как обещают, разработчики будет переписан, поэтому сделаем добавление групп с минимальными потерями (вынеся все в отдельный класс). В любом случае, в дальнейшем хотелось бы иметь возможность делать добавление групп и пользователей стандартно через API (http://idea.1c-bitrix.ru/kontaktlist-...sendzhere/)

1. Копируем компонент bitrix:im.messenger в своё пространство имен и подключаем его в шаблоне сайта:

<?if (CModule::IncludeModule("im") && CBXFeatures::IsFeatureEnabled('WebMessenger')) { ?>
<?$APPLICATION->IncludeComponent("pixelplus:im.messenger", "", Array(), false);?>
<?}?>

2. Находим строчку получение контакт-листа

$arResult['CONTACT_LIST'] = $CIMContactList->GetList();

и вставляем после неё

CIMModify::IMModifyContactList($arResult['CONTACT_LIST']);

Данный метод будет модифицировать контакт лист как нам нужно. Так выглядит контакт-лист в Битрикс-24

Array (
         [users] => Array(
           [505] => Array(
             [id] => 505
             [name] => Антипов Андрей
                [avatar] => /upload/resize_cache/main/282/32_32_2/1.png
             [status] => online
             [profile] =>/company/personal/user/505/             )
           )           [groups] => Array(                 [last] => Array(           
            [id] => last
            [status] => open
            [name] => Последние контакты                   )
         [241] => Array(
            [id] => 241
            [status] => open
            [name] => Пиксель Плюс                  )               [other] => Array(
            [id] => other
            [status] => open
            [name] => Вне структуры                  )
      )
      [woGroups] => Array(
         [last] => Array(
            [id] => last
            [status] => open
            [name] => Последние контакты          )                 [all] => Array(
            [id] => all
            [status] => open
            [name] => Все контакты          )               )       [userInGroup] => Array(
         [last] => Array(
            [id] => last
            [users] => Array(
               [0] => 545
               [1] => 521
               [2] => 535
            ) 
         )
           [243] => Array(
               [id] => 243
               [users] => Array(
                  [0] => 544
                  [1] => 505                           [2] => 512
               )                        )  
         ) 
         [woUserInGroup] => Array(
            [last] => Array(
               [id] => last
               [users] => Array(
                   [0] => 545
                   [1] => 521
                )                  )                  [all] => Array(

          [id] => all
                [users] => Array(
                  [0] => 544
                  [1] => 505
                  [2] => 545
                 )
             )
          )
      )

В данную структуру можно подмешивать любые данные, для чего и предназначен метод CIMModify::IMModifyContactList. Нас по сути интересуют ключи: users – список пользователей, groups – список групп и userInGroup – пользователи в группах Главное чтобы массив users включал в себя всех пользователей.
Некоторые особенности:

Чтобы определить, открыта или свернута группа в контакте листе, необходимо вызвать
$arGroupStatus = CUserOptions::GetOption('IM', 'groupStatus');
а затем посмотреть статус конкретной группы, например manager:
'status' => (isset($arGroupStatus['manager']) && $arGroupStatus['manager'] == 'open'? 'open': 'close')
Массив с данными пользователя можно получить с помощью метода CIMContactList::GetUserData, передав в качестве параметра массив с ключом ID = ID пользователей.
$arIMUC = CIMContactList::GetUserData(Array("ID"=>$arContactListEx['users']));
Онлайн пользователей определяется массово по ID через CUser::GetList

$arSelect = array("ID", "IS_ONLINE");
$arFilter = array('ACTIVE' => 'Y', 'LAST_ACTIVITY' => '120');

Т.е. у тех пользователей, которые были выбраны гетлистом, надо проставить 'status' => 'online'
3. Компонент постоянно обновляет данные файлом /bitrix/js/im/im.js, запрашивая их у /bitrix/components/bitrix/im.messenger/im.ajax.php. К сожалению, данный путь жестко прописан в js файле. Чтобы напрямую не лезть в ядро, вставляем в кастомизированный компонент вместо строчки

$APPLICATION->AddHeadScript("/bitrix/js/im/im.js");

следующий код:

$jsfile = $this->GetPath()."/im.js";
if (!file_exists($_SERVER['DOCUMENT_ROOT'].$jsfile)) {
   $content = file_get_contents($_SERVER['DOCUMENT_ROOT']."/bitrix/js/im/im.js");
   $content = str_r eplace("/bitrix/components/bitrix/im.messenger",$this->GetPath(),$content);
   RewriteFile($_SERVER['DOCUMENT_ROOT'].$jsfile,$content);
}
$APPLICATION->AddHeadScript($jsfile);

Это код копирует файл в /bitrix/js/im/im.js папку компонента, изменяя путь, куда будет обращаться ajax и позволяет обновить js файл в любой момент, удалив его из папки компонента.
4. Модифицируем файл im.ajax.php для корректного обновления страницы:
a. В блоке if ($_POST['IM_UPDATE_STATE'] == 'Y') находим строчку $arOnline = $CIMContactList->GetStatus(); Которая возвращает пользователей онлайн:

$arUsers[$arUser["ID"]] = Array(   
   'id'=> $arUser["ID"],
   'status'=> 'online',
);
return Array('users' => $arUsers);

и вместо неё вызываем свой метод

$CIMContactList = new CIMContactList(); 
$arOnline = CIMModify::IMGetStatus($CIMContactList);

В методе сначала получаем стандартный контакт-лист $arContactList = $CIMContactList->GetList(); А затем модифицируем его с помощью нашего CIMModify::IMModifyContactList
Запрашиваем онлайн пользователей из модифицированного контакт-листа.
b. В блоке else if ($_POST['IM_CONTACT_LIST'] == 'Y') после
$arContactList = $CIMContactList->GetList();
Вызываем CIMModify::IMModifyContactList($arContactList);
Контакт-лист готов

Эксперименты с веб-мессенджером: модифицируем список контактов

Продукты

Управление сайтом

Битрикс24

Интернет-магазин + CRM

Решения

Для интернет-магазинов

Каталог готовых решений

Внедрение

Выбрать партнера

Проверить партнера

Стать партнером