Инфоблоки в Битрикс: как создать и наполнить с нуля

Через полчаса у вас будет собственный раздел данных в «1С-Битрикс: Управление сайтом»: инфоблок «Кейсы» с тремя свойствами, две записи с картинками и страница, которая их выводит. На инфоблоках держатся новости, каталоги, вакансии и отзывы, так что принцип пригодится дальше. Инструкция написана для актуальных версий продукта (ветка 23.x–24.x). В старых сборках названия пунктов могут отличаться.

Что нужно до начала

• Доступ в админку (/bitrix/admin/) с правами администратора.
• Установленный модуль «Информационные блоки». В стандартной установке он есть.
• Возможность создать файл на сайте: по FTP, SSH или через файловый менеджер Битрикса.
• Две небольшие картинки для проверки загрузки файлов.
• Резервная копия, если работаете на боевом сайте: структура инфоблоков хранится в базе.

Что куда вписывать

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

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

Тип — папка, инфоблок — таблица, свойства — столбцы, элементы — строки. С этой картинкой в голове админка Битрикса перестаёт выглядеть лабиринтом.

Пошаговая инструкция

1. Создайте тип инфоблоков. Откройте «Контент → Инфоблоки → Типы инфоблоков», нажмите «Добавить», впишите в «ID типа» значение content и заполните название на вкладке языка. Тип группирует инфоблоки в меню и в параметрах компонентов. Проверка: тип «Контент» появился в списке типов.
2. Создайте инфоблок. Перейдите в «Контент → Инфоблоки → Контент» (пункт появится после создания типа, при необходимости обновите страницу) и нажмите «Добавить». Укажите название «Кейсы», символьный код cases, отметьте свой сайт и сохраните кнопкой «Применить», чтобы остаться в форме. Без привязки к сайту компоненты инфоблок не увидят. Проверка: в списке есть строка «Кейсы», в колонке ID стоит число. Запишите его.
3. Добавьте свойства. Откройте вкладку «Свойства» формы инфоблока и заполните три строки по таблице: название, тип, код. Для «Галереи» включите флажок «Множ.», иначе загрузится одна картинка. Код пишите латиницей: по нему свойство вызывают шаблоны, и переименование потом сломает вывод. Проверка: после «Сохранить» Битрикс возвращает к списку без красного сообщения об ошибке, а при повторном открытии вкладки видны три свойства.
4. Добавьте элементы. Откройте «Контент → Инфоблоки → Контент → Кейсы», нажмите «Добавить» и создайте элемент: оставьте активность включённой, впишите название, клиента, год и загрузите две картинки в «Галерею». Текст для списка пишется на вкладке «Анонс», подробный текст на вкладке «Подробно». Сделайте так две записи. Проверка: в списке элементов обе записи с отметкой об активности.
5. Выведите записи на странице. Создайте файл /cases/index.php с кодом ниже и подставьте ID из шага 2. Проверка: откройте /cases/ в браузере. Вы увидите названия двух кейсов и, если стандартный шаблон показывает свойства, их значения.

Код страницы для шага 5

Компонент bitrix:news.list входит в стандартный набор, его параметры описаны в документации Битрикса.

<?php
// Страница /cases/index.php: список кейсов из инфоблока
require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/header.php");
$APPLICATION->SetTitle("Кейсы");

$APPLICATION->IncludeComponent(
    "bitrix:news.list",
    ".default",
    [
        "IBLOCK_TYPE" => "content",  // ID типа из шага 1
        "IBLOCK_ID" => "5",          // замените на ID инфоблока из шага 2
        "NEWS_COUNT" => "10",        // сколько записей показать
        "SORT_BY1" => "SORT",
        "SORT_ORDER1" => "ASC",
        "PROPERTY_CODE" => ["CLIENT", "YEAR", "GALLERY"],
        "CACHE_TYPE" => "N",         // на время проверки кеш выключен
    ]
);

require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/footer.php");

Ссылки в списке ведут на детальную страницу, которой у нас нет. Детальный вывод через bitrix:news.detail — отдельная тема, здесь её не разбираем.

Если не получилось

Точные тексты сообщений зависят от версии и языка интерфейса, поэтому ниже симптомы.

• Записи созданы, на странице пусто. Проверьте, что в IBLOCK_ID стоит число из списка инфоблоков, а не код cases, и что IBLOCK_TYPE равен content. Затем убедитесь, что элементы активны и дата начала активности не в будущем.
• Страница показывает старые данные. Компонент кеширует результат. В примере кеш выключен, но если вы его включили, сбросьте кеш на панели управления сайтом.
• Свойство не выводится. Добавьте его код в PROPERTY_CODE: компонент показывает только перечисленные свойства. Код должен совпадать с заданным на вкладке «Свойства» символ в символ.
• Картинка не загружается. Чаще всего упёрлись в лимиты PHP: upload_max_filesize и post_max_size. Значения меняются в php.ini или в настройках хостинга.
• Инфоблок недоступен гостю. Проверьте привязку к сайту и вкладку «Доступ»: группа «Все пользователи (в том числе неавторизованные)» должна иметь право на чтение.

Что делать дальше

• Верните автокеширование: в CACHE_TYPE поставьте A и следите, чтобы новые записи появлялись на странице после сброса кеша.
• Соберите детальную страницу кейса на bitrix:news.detail и настройте URL детальной страницы в форме инфоблока.
• Для массового наполнения изучите импорт из CSV в документации вашей версии и сначала прогоните его на копии сайта.
• Записывайте ID инфоблока для каждого окружения: на тестовом и боевом сайте, созданных вручную, числа могут не совпасть.