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

Добавление элементов инфоблока (комплексный компонент)

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

В визуальном редакторе компонент расположен по пути: Контент > Добавление элементов > Добавление элементов инфоблока.

Компонент относится к модулю Информационные блоки.

Пример вызова компонента iblock.element.add

Секции настроек компонента:

  • Параметры компонента
  • Источник данных
  • Свойства инфоблока
  • Параметры доступа
  • Управление адресами страниц
  • Управление режимом AJAX
  • Собственные названия полей
  • Описание параметров

    Поле Параметр Описание
    Параметры компонента
    Количество элементов на странице NAV_ON_PAGE Задается количество элементов на одной странице. Все элементы будут выведены с помощью постраничной навигации.
    Использовать CAPTCHA USE_CAPTCHA [Y|N] При отмеченной опции будет выводиться изображение и поле ввода CAPTCHA в форме добавления элемента.
    Сообщение об успешном добавлении USER_MESSAGE_ADD Задается сообщение, которое выводится при успешном добавлении элемента.
    Сообщение об успешном сохранении USER_MESSAGE_EDIT Задается сообщение, которое выводится при успешном сохранении элемента.
    Размер полей ввода DEFAULT_INPUT_SIZE Указывается размер полей ввода в форме создания/редактирования элемента.
    Использовать настройки инфоблока для обработки изображений RESIZE_IMAGES [Y|N] При отмеченной функции элементы, добавленные через публичную часть будут преобразовываться согласно настройкам инфоблока.
    Источник данных
    Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
    Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается необходимый информационный блок.
    Свойства инфоблока
    Свойства, выводимые на редактирование PROPERTY_CODES Указываются поля и свойства инфоблока, которые выводятся в форме создания/редактирования элемента.
    Свойства, обязательные для заполнения PROPERTY_CODES_REQUIRED Указываются обязательно заполняемые поля и свойства инфоблока в форме создания/редактирования элемента.

    Примечание: указанные здесь поля и свойства должны быть обязательно указаны в параметре PROPERTY_CODES.
    Параметры доступа
    Группы пользователей, имеющие право на добавление/редактирование GROUPS Указываются группы пользователей, имеющие право на добавление/редактирование элементов инфоблока.
    Редактирование возможно для статуса STATUS Указываются статусы, находясь в которых элементы будут доступны для редактирования и удаления.
    Статус после сохранения STATUS_NEW Указывается статус, в который переводятся элементы при их создании/редактировании.
    Разрешать редактирование ALLOW_EDIT [Y|N] При отмеченной опции будут выведены ссылки на редактирование доступных пользователю элементов.
    Разрешать удаление ALLOW_DELETE [Y|N] При отмеченной опции будут выведены ссылки на удаление доступных пользователю элементов.
    Привязка к пользователю ELEMENT_ASSOC Задается привязка к пользователю:
    • создателю (CREATED_BY) - привязка по создателю: пользователю будут показаны только созданные им элементы.
    • по свойству инфоблока --> (PROPERTY_ID) - привязка по свойству инфоблока. В этом случае доступен параметр ELEMENT_ASSOC_PROPERTY.
    по свойству инфоблока --> ELEMENT_ASSOC_PROPERTY Указывается свойство, по которому выполняется привязка. Компонент поддерживает отображение свойств только типов: Строка, Число, Список, Файл, Дата/Время.
    Ограничить кол-во элементов для одного пользователя MAX_USER_ENTRIES Указывается максимальное количество элементов, которые может добавить пользователь.
    Ограничить кол-во рубрик, в которые можно добавлять элемент MAX_LEVELS Указывается максимальное количество разделов инфоблока, в которые пользователь может добавить один и тот же элемент.
    Разрешить добавление только на последний уровень рубрикатора LEVEL_LAST [Y|N] При отмеченной опции пользователям разрешено добавлять элементы только в последний раздел дерева разделов инфоблока.
    Максимальный размер загружаемых файлов, байт (0 - не ограничивать) MAX_FILE_SIZE Указывается максимальный размер загружаемых файлов. Если указано 0, то размер файлов не ограничен.
    Использовать упрощенный визуальный редактор для редактирования текста анонса PREVIEW_TEXT_USE_HTML_EDITOR Разрешает использование упрощенного редактора вместо полного при добавлении и редактировании.
    Использовать упрощенный визуальный редактор для редактирования подробного текста DETAIL_TEXT_USE_HTML_EDITOR Разрешает использование упрощенного редактора вместо полного при добавлении и редактировании.
    Управление адресами страниц
    Включить поддержку ЧПУ SEF_MODE [Y|N] При отмеченной опции будет включена поддержка ЧПУ.

    Если режим поддержки ЧПУ включен, то необходимо настроить следующие параметры:
    Каталог ЧПУ (относительно корня сайта) SEF_FOLDER Каталог ЧПУ: путь до папки, с которой работает компонент. Этот путь может как совпадать с физическим путём, так и не совпадать.
    Имена переменных VARIABLE_ALIASES Имена переменных для управления страницами.
    SEF_FOLDER.
    Управление режимом 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-переходы, то при включенной опции можно использовать кнопки браузера "Назад" и "Вперед".
    Собственные названия полей
    *поле_инфоблока* CUSTOM_TITLE_<поле_инфоблока> Задаются названия полей инфоблока для отображения пользователям. Вместо <поле_инфоблока> указывается следующее:
    • NAME - наименование;
    • TAGS - теги;
    • DATE_ACTIVE_FROM - дата начала;
    • DATE_ACTIVE_TO - дата завершения;
    • IBLOCK_SECTION - раздел инфоблока;
    • PREVIEW_TEXT - текст анонса;
    • PREVIEW_PICTURE - картинка анонса;
    • DETAIL_TEXT - подробный текст;
    • DETAIL_PICTURE - подробная картинка.


    © «Битрикс», 2001-2020, «1С-Битрикс», 2020
    Наверх