Урок 14. Универсальные списки

HR-специалист просит создать на сайте справочник команды. В нем нужно показать структуру компании: отделы и сотрудников. У каждого сотрудника должны быть указаны должность, рабочая почта и телефон.

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

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

Основа списка: инфоблок и страница

Универсальный список не существует сам по себе. Он работает поверх инфоблока, а в публичной части ему нужна отдельная страница с компонентом Универсальные списки.

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

Начнем с инфоблока.

Создаем тип инфоблока для списков

1. В административной части откройте Контент > Инфоблоки > Типы инфоблоков и создайте отдельный тип для универсальных списков через команду Добавить новый тип.
   
2. В открывшейся форме задайте идентификатор и названия на разных языках. Включите опцию Использовать древовидный классификатор элементов по разделам: без нее в списке нельзя будет создавать разделы.
   
3. Сохраните изменения.

Связываем тип инфоблока с модулем

Затем перейдите в Настройки > Настройки продукта > Настройки модулей > Универсальные списки. Укажите созданный тип как основной для списков и выберите группы пользователей, которые смогут управлять списками. Сохраните настройки.

После этого перейдите в публичную часть и создайте страницу в нужном разделе сайта.

Добавляем компонент на страницу

1. Перейдите в раздел, где должна появиться страница с универсальным списком, и на панели управления выберите Создать страницу > Создать страницу. Если на первом экране оставить опцию Перейти к редактированию страницы, после создания страницы вы сразу попадете в визуальный редактор.
2. В визуальном редакторе справа найдите панель компонентов. Если панель скрыта, раскройте ее стрелкой. Через поиск найдите компонент Универсальные списки и перетащите его на страницу. Настройки компонента откроются автоматически.
   
3. В настройках в блоке Источник данных укажите созданный тип инфоблока.
   
4. В блоке Управление адресами страниц включите поддержку ЧПУ, чтобы компонент понимал, какой элемент или раздел открывать. В поле Каталог ЧПУ (относительно корня сайта) укажите путь до текущей страницы. Если страница находится в корневом разделе, укажите просто /.
   
5. Сохраните компонент и страницу.

Не пугайтесь, если сначала увидите пустую страницу с заголовком Списки. Чтобы на ней появилась кнопка создания списка, нужно подключить панель инструментов.

Подключаем панель инструментов

1. На панели управления выберите Изменить страницу > В режиме PHP-кода.
   
2. Откроется окно редактирования файла. Скопируйте указанный ниже фрагмент — он нужен, чтобы добавить панель инструментов на страницу.

   
      <?php
      $APPLICATION->IncludeComponent(
          "bitrix:ui.toolbar",
          "",
          []
      );
      ?>
      

3. Вставьте этот фрагмент перед кодом <?php $APPLICATION->IncludeComponent("bitrix:lists"..), который отвечает за компонент Универсальные списки.
   
4. Сохраните изменения.

На странице со списками появится кнопка Создать новый.

Создаем универсальный список

Когда тип инфоблока настроен, а страница с компонентом работает, можно создать сам список. В нашем примере это будет справочник Команда.

1. Откройте страницу с компонентом Универсальные списки и нажмите Создать новый.
   
2. На вкладке Настройки укажите название списка.
   
3. При необходимости задайте сортировку. Чем больше число, тем ниже список будет в общем перечне.
4. На вкладке Подписи можно заменить общие слова на более понятные для задачи. Например, вместо элемент — сотрудник.
5. На вкладке Доступ укажите, кто может просматривать и изменять список. Для справочника команды достаточно выдать администратору и контент-редакторам полный доступ, а зарегистрированным пользователям — право на чтение. Чтобы добавить новую группу, нажмите Добавить.
   
6. Сохраните список.

Настраиваем поля списка

После создания списка в нем уже есть базовое поле Название. Чтобы справочник стал полезнее, добавьте дополнительные поля — например, для должности, телефона и email.

Поля настраиваются внутри конкретного списка.

1. Откройте список. В нашем случае это список Команда.
2. Нажмите на шестеренку в правой части таблицы и в выпадающем списке выберите Настроить поля.
   
3. На странице Настройка полей нажмите Добавить поле.
   
4. Откроется форма создания поля. Укажите название и тип поля. В зависимости от типа поля будут меняться параметры его настроек.
   
5. Сохраните и повторите действия для каждого нового поля.

Поле Название можно использовать как ФИО сотрудника, поэтому отдельное поле создавать необязательно. При желании его можно переименовать: нажмите на иконку в виде трех полос, а затем выберите Изменить.

Структура из разделов и элементов

Поля описывают элемент, а разделы помогают разложить элементы по смысловым группам. В универсальном списке это работает как папки: сначала создаете раздел, при необходимости добавляете подразделы, а уже внутри размещаете элементы.

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

В нашем примере структура может быть такой:

• разделы верхнего уровня — Коммерческий отдел, Маркетинг, Поддержка, Администрация
• подразделы внутри отдела — например, Продажи и Работа с партнерами
• элементы внутри разделов — сотрудники с должностью, телефоном и email

Такой список легче поддерживать: HR-специалист открывает нужный отдел, добавляет сотрудника в правильное место и заполняет его карточку. Если структура компании изменится, можно добавить новый раздел или перенести элементы, а не перестраивать таблицу вручную.

Создайте верхний уровень структуры.

Создаем разделы и подразделы списка

1. Откройте созданный список.
2. Нажмите кнопку Добавить и в выпадающем списке выберите Добавить раздел.
   
3. Введите название раздела и нажмите Добавить.
   

По такому же принципу создавайте другие разделы. Чтобы создать подраздел, сначала перейдите в нужный раздел и уже внутри него нажмите Добавить > Добавить раздел.

После сохранения разделы и подотделы появятся в списке как структура. Теперь в каждый из них можно добавлять элементы.

Добавляем первый элемент в список

Заполните список элементами.

1. Откройте раздел или подраздел, в который нужно добавить элемент.
2. Нажмите Добавить > Добавить элемент. Откроется форма создания элемента списка.
3. Заполните все созданные ранее поля.
   
4. Сохраните элемент.

После сохранения элемент появится в выбранном разделе списка. Вернитесь к списку и проверьте, что запись лежит на правильном уровне структуры, а в карточке видны заполненные поля.

Если элемент появился не в том разделе, нажмите иконку в виде трех полос, затем Изменить и на вкладке Разделы отметьте нужный раздел.

Теперь проверьте страницу как пользователь с обычными правами. Откройте ее и убедитесь, что список виден тем, кому он нужен, а редактирование недоступно тем, кто не должен менять данные. Если список пустой или не открывается, проверьте активность списка, права доступа и настройки компонента.