Добавление собственных типов свойств инфоблока

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

Пользовательские свойства главного модуля "Связь с элементом" и "Связь с элементом в виде списка"

Собственно сабж.

Те, кто не знает что такое пользовательские поля главного модуля, могут про них почитать тут:
http://dev.1c-bitrix.ru/user_help/set..._admin.php
http://dev.1c-bitrix.ru/user_help/set...d_edit.php

А остальные наверняка заметили, что в стандартной поставке есть пользовательское поле для установки связи с секциями инфоблоков, но нет пользовательских полей для установки связи с элементами инфоблоков, а они бывают нужны. Давайте добавим их сами.

Итак, два варианта добавления этих типов полей:
1. Сокращенный вариант, без поддержки публичной части. Просто скопируйте приведенный ниже код в файл /bitrix/php_interface/init.php

2. Полный вариант, с поддержкой публичной части. Скачайте и распакуйте архив.
Содержимое соответствующих папок архива скопируйте на сайт. Для сайта в кодировке UTF-8 нужно копировать файлы, содержащиеся в директории "utf8" архива, для сайта в кодировке Windows-1251 - в директории "windows1251".
И, наконец, в файл /bitrix/php_interface/init.php добавьте код подключения скриптов пользовательских полей:

include('include/uf_iblock_element.php'); 
include('include/uf_iblock_element_list.php');

Код пользовательского свойства главного модуля "Связь с элементом":

// Регистрируем обработчик события главного модуля OnUserTypeBuildList
// Событие создается при построении списка типов пользовательских свойств
AddEventHandler('main', 'OnUserTypeBuildList', array('CUserTypeIBlockElement', 'GetUserTypeDescription'), 5000);
class CUserTypeIBlockElement {
   // ---------------------------------------------------------------------
   // Общие параметры методов класса:
   // @param array $arUserField - метаданные (настройки) свойства
   // @param array $arHtmlControl - массив управления из формы (значения свойств, имена полей веб-форм и т.п.)
   // ---------------------------------------------------------------------

   // Функция регистрируется в качестве обработчика события OnUserTypeBuildList
   function GetUserTypeDescription() {
      return array(
         // уникальный идентификатор
         'USER_TYPE_ID' => 'iblock_element',
         // имя класса, методы которого формируют поведение типа
         'CLASS_NAME' => 'CUserTypeIBlockElement',
         // название для показа в списке типов пользовательских свойств
         'DESCRIPTION' => 'Связь с элементами инфоблока',
         // базовый тип на котором будут основаны операции фильтра
         'BASE_TYPE' => 'int',
      );
   }

   // Функция вызывается при добавлении нового свойства
   // для конструирования SQL запроса создания столбца значений свойства
   // @return string - SQL
   function GetDBColumnType($arUserField) {
      switch(strtolower($GLOBALS['DB']->type)) {
         case 'mysql':
            return 'int(18)';
         break;
         case 'oracle':
            return 'number(18)';
         break;
         case 'mssql':
            return "int";
         break;
      }
   }

   // Функция вызывается перед сохранением метаданных (настроек) свойства в БД
   // @return array - массив уникальных метаданных для свойства, будет сериализован и сохранен в БД
   function PrepareSettings($arUserField) {
      // инфоблок, с элементами которого будет выполняться связь
      $iIBlockId = intval($arUserField['SETTINGS']['IBLOCK_ID']);
      return array(
         'IBLOCK_ID' => $iIBlockId > 0 ? $iIBlockId : 0
      );
   }

   // Функция вызывается при выводе формы метаданных (настроек) свойства
   // @param bool $bVarsFromForm - флаг отправки формы
   // @return string - HTML для вывода
   function GetSettingsHTML($arUserField = false, $arHtmlControl, $bVarsFromForm) {
      $result = '';

      // добавлено 2010-12-08 (YYYY-MM-DD)
      if(!CModule::IncludeModule('iblock')) {
         return $result;
      }

      // текущие значения настроек 
      if($bVarsFromForm) {
         $value = $GLOBALS[$arHtmlControl['NAME']]['IBLOCK_ID'];
      } elseif(is_array($arUserField)) {
         $value = $arUserField['SETTINGS']['IBLOCK_ID'];
      } else {
         $value = '';
      }
      // выведем выпадающий список выбора связываемого инфоблока
      $result .= '
      <tr style="vertical-align: top;">
         <td>Информационный блок по умолчанию:</td>
         <td>
            '.GetIBlockDropDownList($value, $arHtmlControl['NAME'].'[IBLOCK_TYPE_ID]', $arHtmlControl['NAME'].'[IBLOCK_ID]').'
         </td>
      </tr>
      ';
      return $result;
   }

   // Функция валидатор значений свойства
   // вызвается в $GLOBALS['USER_FIELD_MANAGER']->CheckField() при добавлении/изменении
   // @param array $value значение для проверки на валидность
   // @return array массив массивов ("id","text") ошибок
   function CheckFields($arUserField, $value) {
      $aMsg = array();
      return $aMsg;
   }

   // Функция вызывается при выводе формы редактирования значения свойства
   // @return string - HTML для вывода
   function GetEditFormHTML($arUserField, $arHtmlControl) {
      $iIBlockId = intval($arUserField['SETTINGS']['IBLOCK_ID']);
      $sReturn = '';
      // получим элементы инфоблока по значению свойства, передаваемым в $arHtmlControl['VALUE']
      $arElements = CUserTypeIBlockElement::_getElements($arHtmlControl['VALUE']);
      // html поля веб-формы для текущего значения
      $sReturn .= '<div>'.CUserTypeIBlockElement::_getItemFieldHTML($arHtmlControl['VALUE'], $iIBlockId, $arElements, $arHtmlControl['NAME']).'</div>';
      return $sReturn;
   }

   // Функция вызывается при выводе формы редактирования значения множественного свойства
   // @return string - HTML для вывода
   function GetEditFormHTMLMulty($arUserField, $arHtmlControl) {
      $iIBlockId = intval($arUserField['SETTINGS']['IBLOCK_ID']);
      // получим элементы инфоблока по значениям свойства, передаваемым в массиве значений $arHtmlControl['VALUE']
      $arElements = CUserTypeIBlockElement::_getElements($arHtmlControl['VALUE']);

      $sReturn = '<table cellspacing="0" id="tb'.md5($arHtmlControl['NAME']).'">';
      // html поля веб-формы для каждого значения свойства
      foreach($arHtmlControl['VALUE'] as $iKey => $iValue) {
         $sReturn .= '<tr><td><div>'.CUserTypeIBlockElement::_getItemFieldHTML($iValue, $iIBlockId, $arElements, $arHtmlControl['NAME']).'</div></td></tr>';
      }
      // html поля веб-формы для добавления нового значения свойства
      $sReturn .= '<tr><td><div>'.CUserTypeIBlockElement::_getItemFieldHTML(0, $iIBlockId, array(), $arHtmlControl['NAME']).'</div></td></tr>';
      // html полей для кнопки Добавить... (режим множественного выбора элементов)
      $sReturn .= '<tr><td><div>'.CUserTypeIBlockElement::_getItemFieldHTML(0, $iIBlockId, array(), $arHtmlControl['NAME'], 'y').'</div></td></tr>';
      $sReturn .= '</table>';
      return $sReturn;
   }

   // Функция вызывается при выводе фильтра на странице списка
   // @return string - HTML для вывода
   function GetFilterHTML($arUserField, $arHtmlControl) {
      //$sVal = intval($arHtmlControl['VALUE']);
      //$sVal = $sVal > 0 ? $sVal : '';
      //return '<input type="text" name="'.$arHtmlControl['NAME'].'" size="20" value="'.$sVal.'" />';
      return CUserTypeIBlockElement::GetEditFormHTML($arUserField, $arHtmlControl);
   }

   // Функция вызывается при выводе значения свойства в списке элементов
   // @return string - HTML для вывода
   function GetAdminListViewHTML($arUserField, $arHtmlControl) {
      $iElementId = intval($arHtmlControl['VALUE']);
      if($iElementId > 0) {
         $arElements = CUserTypeIBlockElement::_getElements($iElementId);
         // выводим в формате: [ID элемента] имя элемента (если найдено)
         return '['.$iElementId.'] '.(isset($arElements[$iElementId]) ? $arElements[$iElementId]['NAME'] : '');
      } else {
         return ' ';
      }
   }

   // Функция вызывается при выводе значения множественного свойства в списке элементов
   // @return string - HTML для вывода
   function GetAdminListViewHTMLMulty($arUserField, $arHtmlControl) {
      $sReturn = '';
      static $bWasJs = false;
      // костыль для добавления js-функции, отвечающей за добавление новых полей значения множественного свойства
      // т.к. в режиме массового редактирования значений свойства из-за ajax изменяется область видимости функций js
      // добавляется один раз на странице
      if(!$bWasJs) {
         $bWasJs = true;
         // здесь пляски с бубном из-за гениальности передачи данных 
         // из попап-окна /bitrix/admin/iblock_element_search.php на вызывающую страницу
         ob_start();
         ?><script type="text/javascript">
            var oIBListUF = {
               oCounter: {},
               addNewRowIBListUF: function(mFieldCounterName, sTableId, sFieldName, sOpenWindowUrl, sSpanId) {
                  var oTbl = document.getElementById(sTableId);
                  var oRow = oTbl.insertRow(oTbl.rows.length-1);
                  var oCell = oRow.insertCell(-1);
                  if(!this.oCounter.mFieldCounterName) {
                     this.oCounter.mFieldCounterName = 0;
                  }
                  var sK = 'n'+this.oCounter.mFieldCounterName;
                  this.oCounter.mFieldCounterName = parseInt(this.oCounter.mFieldCounterName) + 1;
                  sOpenWindowUrl += '&k='+sK;
                  sSpanId += '_'+sK;
                  oCell.innerHTML = '<input type="text" id="'+sFieldName+'['+sK+']" name="'+sFieldName+'['+sK+']" value="" size="5" />';
                  oCell.innerHTML += '<input type="button" value="..." onclick="jsUtils.OpenWindow(\''+sOpenWindowUrl+'\', 600, 500);" />';
                  oCell.innerHTML += ' <span id="'+sSpanId+'"></span>';
            }
            };
         </script><?
         $sReturn .= ob_get_clean();
      }
      
      if(!empty($arHtmlControl['VALUE']) && is_array($arHtmlControl['VALUE'])) {
         $arElements = CUserTypeIBlockElement::_getElements($arHtmlControl['VALUE']);
         $arPrint = array();
         // выводим в формате: [ID элемента] имя элемента (если найдено) с разделителем " / " для каждого значения
         foreach($arHtmlControl['VALUE'] as $iElementId) {
            $arPrint[] = '['.$iElementId.'] '.(isset($arElements[$iElementId]) ? $arElements[$iElementId]['NAME'] : '');
         }
         $sReturn .= implode(' / ', $arPrint);
      } else {
         $sReturn .=  ' ';
      }
      return $sReturn;
   }

   // Функция вызывается при выводе значения свойства в списке элементов в режиме редактирования
   // @return string - HTML для вывода
   function GetAdminListEditHTML($arUserField, $arHtmlControl) {
      return CUserTypeIBlockElement::GetEditFormHTML($arUserField, $arHtmlControl);
   }

   // Функция вызывается при выводе множественного значения свойства в списке элементов в режиме редактирования
   // @return string - HTML для вывода
   function GetAdminListEditHTMLMulty($arUserField, $arHtmlControl) {
      $iIBlockId = intval($arUserField['SETTINGS']['IBLOCK_ID']);
      $arElements = CUserTypeIBlockElement::_getElements($arHtmlControl['VALUE']);

      // поля редактирования значений свойства 
      $sTableId = 'tb'.md5($arHtmlControl['NAME']);
      $sReturn = '<table cellspacing="0" id="'.$sTableId.'">';
      foreach($arHtmlControl['VALUE'] as $iKey => $iValue) {
         $sReturn .= '<tr><td><div>'.CUserTypeIBlockElement::_getItemFieldHTML($iValue, $iIBlockId, $arElements, $arHtmlControl['NAME']).'</div></td></tr>';
      }
      // поле добавления нового значения свойства 
      $sReturn .= '<tr><td><div>'.CUserTypeIBlockElement::_getItemFieldHTML(0, $iIBlockId, array(), $arHtmlControl['NAME']).'</div></td></tr>';

      // кнопка Добавить... (вызывает js-функцию, которая была добавлена методом GetAdminListViewHTMLMulty)
      $sFieldName_ = str_replace('[]', '', $arHtmlControl['NAME']);
      $mFieldCounterName = md5($sFieldName_);
      $sOpenWindowUrl = '/bitrix/admin/iblock_element_search.php?lang='.LANG.'&amp;IBLOCK_ID='.$iIBlockId.'&amp;n='.$sFieldName_.'&amp;m=n';
      $sSpanId = 'sp_'.$mFieldCounterName;
      $sReturn .= '<tr><td><div><input type="button" onclick="oIBListUF.addNewRowIBListUF(\''.$mFieldCounterName.'\', \''.$sTableId.'\', \''.$sFieldName_.'\', \''.$sOpenWindowUrl.'\', \''.$sSpanId.'\')" value="Добавить" /></div></td></tr>';
      $sReturn .= '</table>';
      return $sReturn;
   }

   // Функция должна вернуть представление значения поля для поиска
   // @return string - посковое содержимое
   function OnSearchIndex($arUserField) {
      if(is_array($arUserField['VALUE'])) {
         return implode("\r\n", $arUserField['VALUE']);
      } else {
         return $arUserField['VALUE'];
      }
   }

   // Функция вызывается перед сохранением значений в БД
   // @param mixed $value - значение свойства
   // @return string - значение для вставки в БД
   function OnBeforeSave($arUserField, $value) {
      if(intval($value) > 0) {
         return intval($value);
      }
   }

   // Функция генерации html для поля редактирования свойства
   // @param int $iValue - значение свойства
   // @param int $iIBlockId - ID информационного блока для поиска элементов по умолчанию
   // @param array $arElements - массив элементов инфоблока с ключами = идентификаторам элементов инфоблока
   // @param string $sFieldName - имя для поля веб-формы
   // @param string $sMulty - n|y - поэлементная (n) или множественная вставка значений 
   // @return string - HTML для вывода
   // @private
   function _getItemFieldHTML($iValue, $iIBlockId, $arElements, $sFieldName, $sMulty = 'n') {
      $sReturn = '';
      $iValue = intval($iValue);
      $sKey = randstring(3);
      $sName = 'UF_IBELEMENT_'.randstring(3);
      $sRandId = $sName.'_'.$sKey;
      $sElementName = '';
      if(!empty($arElements[$iValue])) {
         $sElementName = '<a href="'.BX_PERSONAL_ROOT.'/admin/iblock_element_edit.php?ID='.$arElements[$iValue]['ID'].'&type='.$arElements[$iValue]['IBLOCK_TYPE_ID'].'&lang='.LANG.'&IBLOCK_ID='.$arElements[$iValue]['IBLOCK_ID'].'&find_section_section=-1">'.$arElements[$iValue]['NAME'].'</a>';
      }
      $md5Name = md5($sName);
      $sValue = $iValue > 0 ? $iValue : '';
      $sButtonValue = $sMulty == 'y' ? 'Добавить ...' : '...';
      $sReturn .= '<input type="text" name="'.$sFieldName.'" id="'.$sName.'" value="'.$sValue.'" size="5" />';
      $sReturn .= '<input type="button" value="'.$sButtonValue.'" onclick="jsUtils.OpenWindow(\'/bitrix/admin/iblock_element_search.php?lang='.LANG.'&amp;IBLOCK_ID='.$iIBlockId.'&amp;n='.$sName.'&amp;m='.$sMulty.'&amp;k='.$sKey.'\', 600, 500);" />';
      $sReturn .= ' <span id="sp_'.$md5Name.'_'.$sKey.'" >'.$sElementName.'</span>';

      if($sMulty == 'y') {
         $sJsMV = 'MV_'.$md5Name;
         // уберем пустые скобки
         $sFieldName_ = str_replace('[]', '', $sFieldName);
         $sJsFuncName = 'InS'.$md5Name;
         ob_start();
         ?><script type="text/javascript">
            var <?=$sJsMV?> = 0;
            var <?=$sJsFuncName?> = function(sId, sName) {
               var oTbl = document.getElementById('tb<?=md5($sFieldName)?>');
               var oRow = oTbl.insertRow(oTbl.rows.length-1);
               var oCell = oRow.insertCell(-1);
               var sK = 'n'+<?=$sJsMV?>;
               oCell.innerHTML = '<input type="text" id="<?=$sFieldName_?>['+sK+']" name="<?=$sFieldName_?>['+sK+']" value="'+sId+'" size="5" />';
               oCell.innerHTML += '<input type="button" value="..." onclick="jsUtils.OpenWindow(\'/bitrix/admin/iblock_element_search.php?lang=<?=LANG?>&amp;IBLOCK_ID=<?=$iIBlockId?>&amp;n=<?=$sFieldName_?>&amp;k='+sK+'\', 600, 500);" />';
               oCell.innerHTML += ' <span id="sp_<?=md5($sFieldName_)?>_'+<?=sK?>+'">'+sName+'</span>';
               <?=$sJsMV?>++;
            };
         </script><?
         $sReturn .= ob_get_clean();
      }
      return $sReturn;
   }

   // Функция генерации массива элементов по значениям свойства
   // @param mixed $mElementId - значение свойства (массив или целое число)
   // @return array - массив элементов инфоблока с ключами = идентификаторам элементов инфоблока
   // @private
   function _getElements($mElementId = array()) {
      $arReturn = array();

      if(!empty($mElementId)) {

         // добавлено 2010-12-08 (YYYY-MM-DD)
         if(!CModule::IncludeModule('iblock')) {
            return $arReturn;
         }

         $arFilter = array(
            'ID' => array()
         );
         $mElementId = is_array($mElementId) ? $mElementId : array($mElementId);
         foreach($mElementId as $iValue) {
            $iValue = intval($iValue);
            if($iValue > 0) {
               $arFilter['ID'][] = $iValue;
            }
         }
         if(!empty($arFilter['ID'])) {
            $arSelect = array(
               'ID',
               'NAME',
               'IBLOCK_ID',
               'IBLOCK_TYPE_ID'
            );
            $rsItems = CIBlockElement::GetList(array(), $arFilter, false, false, $arSelect);
            while($arItem = $rsItems->GetNext(false, false)) {
               $arReturn[$arItem['ID']] = $arItem;
            }
         }
      }
      return $arReturn;
   }
}

Код пользовательского свойства главного модуля "Связь с элементом в виде списка":

// Регистрируем обработчик события главного модуля OnUserTypeBuildList
// Событие создается при построении списка типов пользовательских свойств
AddEventHandler('main', 'OnUserTypeBuildList', array('CUserTypeIBlockElementList', 'GetUserTypeDescription'), 5000);
class CUserTypeIBlockElementList {
   // ---------------------------------------------------------------------
   // Общие параметры методов класса:
   // @param array $arUserField - метаданные (настройки) свойства
   // @param array $arHtmlControl - массив управления из формы (значения свойств, имена полей веб-форм и т.п.)
   // ---------------------------------------------------------------------

   // Функция регистрируется в качестве обработчика события OnUserTypeBuildList
   function GetUserTypeDescription() {
      return array(
         // уникальный идентификатор
         'USER_TYPE_ID' => 'iblock_element_list',
         // имя класса, методы которого формируют поведение типа
         'CLASS_NAME' => 'CUserTypeIBlockElementList',
         // название для показа в списке типов пользовательских свойств
         'DESCRIPTION' => 'Связь с элементами инфоблока в виде списка',
         // базовый тип на котором будут основаны операции фильтра
         'BASE_TYPE' => 'int',
      );
   }

   // Функция вызывается при добавлении нового свойства
   // для конструирования SQL запроса создания столбца значений свойства
   // @return string - SQL
   function GetDBColumnType($arUserField) {
      switch(strtolower($GLOBALS['DB']->type)) {
         case 'mysql':
            return 'int(18)';
         break;
         case 'oracle':
            return 'number(18)';
         break;
         case 'mssql':
            return "int";
         break;
      }
   }

   // Функция вызывается перед сохранением метаданных (настроек) свойства в БД
   // @return array - массив уникальных метаданных для свойства, будет сериализован и сохранен в БД
   function PrepareSettings($arUserField) {
      // инфоблок, с элементами которого будет выполняться связь
      $iIBlockId = intval($arUserField['SETTINGS']['IBLOCK_ID']);
      return array(
         'IBLOCK_ID' => $iIBlockId > 0 ? $iIBlockId : 0
      );
   }

   // Функция вызывается при выводе формы метаданных (настроек) свойства
   // @param bool $bVarsFromForm - флаг отправки формы
   // @return string - HTML для вывода
   function GetSettingsHTML($arUserField = false, $arHtmlControl, $bVarsFromForm) {
      $result = '';

      // добавлено 2010-12-08 (YYYY-MM-DD)
      if(!CModule::IncludeModule('iblock')) {
         return $result;
      }

      // текущие значения настроек 
      if($bVarsFromForm) {
         $value = $GLOBALS[$arHtmlControl['NAME']]['IBLOCK_ID'];
      } elseif(is_array($arUserField)) {
         $value = $arUserField['SETTINGS']['IBLOCK_ID'];
      } else {
         $value = '';
      }
      $result .= '
      <tr style="vertical-align: top;">
         <td>Информационный блок по умолчанию:</td>
         <td>
            '.GetIBlockDropDownList($value, $arHtmlControl['NAME'].'[IBLOCK_TYPE_ID]', $arHtmlControl['NAME'].'[IBLOCK_ID]').'
         </td>
      </tr>
      ';
      return $result;
   }

   // Функция валидатор значений свойства
   // вызвается в $GLOBALS['USER_FIELD_MANAGER']->CheckField() при добавлении/изменении
   // @param array $value значение для проверки на валидность
   // @return array массив массивов ("id","text") ошибок
   function CheckFields($arUserField, $value) {
      $aMsg = array();
      return $aMsg;
   }

   // Функция вызывается при выводе формы редактирования значения свойства
   // она же вызывается (в цикле) и при выводе формы редактирования множественного свойства
   // @return string - HTML для вывода
   function GetEditFormHTML($arUserField, $arHtmlControl) {
      $iIBlockId = intval($arUserField['SETTINGS']['IBLOCK_ID']);
      $sReturn = '';
      $sReturn .= '<div>'.CUserTypeIBlockElementList::_getItemFieldHTML($arHtmlControl['VALUE'], $iIBlockId, $arHtmlControl['NAME']).'</div>';
      return $sReturn;
   }

   // Функция вызывается при выводе фильтра на странице списка
   // @return string - HTML для вывода
   function GetFilterHTML($arUserField, $arHtmlControl) {
      //$sVal = intval($arHtmlControl['VALUE']);
      //$sVal = $sVal > 0 ? $sVal : '';
      //return '<input type="text" name="'.$arHtmlControl['NAME'].'" size="20" value="'.$sVal.'" />';
      return CUserTypeIBlockElementList::GetEditFormHTML($arUserField, $arHtmlControl);
   }

   // Функция вызывается при выводе значения свойства в списке элементов
   // @return string - HTML для вывода
   function GetAdminListViewHTML($arUserField, $arHtmlControl) {
      $iElementId = intval($arHtmlControl['VALUE']);
      if($iElementId > 0) {
         $arElements = CUserTypeIBlockElementList::_getElements($arUserField['SETTINGS']['IBLOCK_ID']);
         // выводим в формате: [ID элемента] имя элемента (если найдено)
         return '['.$iElementId.'] '.(isset($arElements[$iElementId]) ? $arElements[$iElementId]['NAME'] : '');
      } else {
         return ' ';
      }
   }

   // Функция вызывается при выводе значения множественного свойства в списке элементов
   // @return string - HTML для вывода
   function GetAdminListViewHTMLMulty($arUserField, $arHtmlControl) {
      $sReturn = '';
      if(!empty($arHtmlControl['VALUE']) && is_array($arHtmlControl['VALUE'])) {
         $arElements = CUserTypeIBlockElementList::_getElements($arUserField['SETTINGS']['IBLOCK_ID']);
         $arPrint = array();
         // выводим в формате: [ID элемента] имя элемента (если найдено) с разделителем " / " для каждого значения
         foreach($arHtmlControl['VALUE'] as $iElementId) {
            $arPrint[] = '['.$iElementId.'] '.(isset($arElements[$iElementId]) ? $arElements[$iElementId]['NAME'] : '');
         }
         $sReturn .= implode(' / ', $arPrint);
      } else {
         $sReturn .=  ' ';
      }
      return $sReturn;
   }

   // Функция вызывается при выводе значения свойства в списке элементов в режиме редактирования
   // она же вызывается (в цикле) и для множественного свойства
   // @return string - HTML для вывода
   function GetAdminListEditHTML($arUserField, $arHtmlControl) {
      return CUserTypeIBlockElementList::GetEditFormHTML($arUserField, $arHtmlControl);
   }

   // Функция должна вернуть представление значения поля для поиска
   // @return string - посковое содержимое
   function OnSearchIndex($arUserField) {
      if(is_array($arUserField['VALUE'])) {
         return implode("\r\n", $arUserField['VALUE']);
      } else {
         return $arUserField['VALUE'];
      }
   }

   // Функция вызывается перед сохранением значений в БД
   // @param mixed $value - значение свойства
   // @return string - значение для вставки в БД
   function OnBeforeSave($arUserField, $value) {
      if(intval($value) > 0) {
         return intval($value);
      }
   }

   // Функция генерации html для поля редактирования свойства
   // @param int $iValue - значение свойства
   // @param int $iIBlockId - ID информационного блока для поиска элементов
   // @param string $sFieldName - имя для поля веб-формы
   // @return string - HTML для вывода
   // @private
   function _getItemFieldHTML($iValue, $iIBlockId, $sFieldName) {
      $sReturn = '';
      // получим массив всех элементов инфоблока
      $arElements = CUserTypeIBlockElementList::_getElements($iIBlockId);
      $sReturn = '<select size="1" name="'.$sFieldName.'">
      <option value=""> </option>';
      foreach($arElements as $arItem) {
         $sReturn .= '<option value="'.$arItem['ID'].'"';
         if($iValue == $arItem['ID']) {
            $sReturn .= ' selected="selected"';
         }
         $sReturn .= '>'.$arItem['NAME'].'</option>';
      }
      $sReturn .= '</select>';
      return $sReturn;
   }

   // Функция генерации массива элементов тнфоблока
   // @param int $iIBlockId - ID информационного блока для поиска элементов
   // @param bool $bResetCache - перезаписать "виртуальный кэш" для инфоблока
   // @return array - массив элементов инфоблока с ключами = идентификаторам элементов инфоблока
   // @private
   function _getElements($iIBlockId = false, $bResetCache = false) {
      static $arVirtualCache = array();
      $arReturn = array();
      $iIBlockId = intval($iIBlockId);
      if(!isset($arVirtualCache[$iIBlockId]) || $bResetCache) {

         // добавлено 2010-12-08 (YYYY-MM-DD)
         if(!CModule::IncludeModule('iblock')) {
            return $arReturn;
         }

         if($iIBlockId > 0) {
            $arFilter = array(
               'IBLOCK_ID' => $iIBlockId
            );
            $arSelect = array(
               'ID',
               'NAME',
               'IBLOCK_ID',
               'IBLOCK_TYPE_ID'
            );
            $rsItems = CIBlockElement::GetList(array(), $arFilter, false, false, $arSelect);
            while($arItem = $rsItems->GetNext(false, false)) {
               // добавлено 2011-02-15 для GetList
               $arItem['VALUE'] = $arItem['NAME'];
               $arReturn[$arItem['ID']] = $arItem;
            }
         }
         $arVirtualCache[$iIBlockId] = $arReturn;
      } else {
         $arReturn = $arVirtualCache[$iIBlockId];
      }
      return $arReturn;
   }

   // добавлено 2011-02-15
   function GetList($arUserField) {
      $dbReturn = new CDBResult;
      $arElements = self::_getElements($arUserField['SETTINGS']['IBLOCK_ID']);
      $dbReturn->InitFromArray($arElements);
      return $dbReturn;
   }
}

Как это будет выглядеть.

Список доступных типов свойств на странице редактирования пользовательского поля (красным выделены наши новые типы):

Пример добавления пользовательского поля привязки к элементам инфоблока в виде списка. Поле это будет принадлежать секции выбранного инфоблока:

На этом скриншоте показаны уже добавленные три пользовательских поля для секции инфоблока:

Поле "Руководители" - множественная связь с элементами в виде списка
Поле "Места проведения" - простая связь с элементами
Поле "Категории участников" - множественная связь с элементами

Процесс добавления множественной связи с элементами:

Процесс группового редактирования секций инфоблока и пользовательских полей:

На скриншоте также продемонстрированы и фильтры для данных типов полей.

----
Update (08.12.2010): в методах GetSettingsHTML() и _getElements() классов пользовательских типов добавлено подключение модуля информационных блоков.

В GetSettingsHTML() добавлены строчки:

      // добавлено 2010-12-08 (YYYY-MM-DD) 
      if(!CModule::IncludeModule('iblock')) { 
         return $result; 
      }

В _getElements() добавлены строчки:

         // добавлено 2010-12-08 (YYYY-MM-DD) 
         if(!CModule::IncludeModule('iblock')) { 
            return $arReturn; 
         }

Код и файлы для скачивания уже содержат исправления.

Спасибо Руслану за обнаруженную ошибку.

----
Update (15.02.2011):
- добавлен метод CUserTypeIBlockElementList::GetList();
- добавлены шаблоны iblock_element и iblock_element_list для компонентов bitrix:system.field.edit и system.field.view. Теперь пользовательские поля доступны для вывода и редактирования в публичной части. Шаблоны находятся в архиве для скачивания.

Назад в раздел

Подписаться на новые материалы раздела:

Загрузка...