Как настроить свойства товаров на 1С-Битрикс для фильтра и карточки?

Как настроить свойства товаров на 1С-Битрикс для фильтра и карточки?

В админке свойства товаров битрикс уже есть, а на сайте тишина: в умном фильтре нет бренда и цвета, в карточке пустой блок характеристик. Типичная ошибка - искать вину в "магии темы", хотя на практике ломаются тип свойства, галочка показа и фасетный индекс на 1С-Битрикс: Управление сайтом. Ниже пройдете цепочку: создали свойство в каталоге, заполнили значения, включили фильтр и вывод на витрине. После гайда откроете раздел и карточку тестового товара и проверите чек-лист.

Свойства товаров в CMS - это поля инфоблока каталога: бренд, материал, толщина, цвет вариации. Для фильтра берите Список (L) или Число (N), не свободную строку и не Файл. Галочки "Показывать в умном фильтре" и "Показывать на детальной" сами по себе мало что делают: нужны значения у товаров, пересоздание фасета и коды в параметрах catalog. Размер и цвет SKU держите в инфоблоке предложений, общие характеристики - у товара.

Речь только про интернет-магазин на CMS "1С-Битрикс: Управление сайтом" - свой сайт, инфоблок каталога, компоненты catalog.*. Это не Bitrix24: в поиске по "свойства товаров" часто всплывает CRM и helpdesk облака, а не вкладка свойств торгового каталога на сайте.

Ниже - end-to-end по характеристикам: от выбора типа поля до витрины, без ухода в полный UI карточки и без SEO/ЧПУ фильтра.

1. Когда нужны свойства товаров в CMS: фильтр, карточка, SKU и выгрузки

Таблица сравнения: куда нужны свойства — фильтр, карточка, SKU и выгрузки

Свойство товара - характеристика, которую покупатель видит в фильтре раздела, в таблице на карточке или выбирает как вариант (цвет, размер). Без них каталог выглядит "голым": нельзя отфильтровать бренд, сравнить толщину, понять материал.

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

Не делайте: не ищите настройки витрины в уроках Bitrix24 CRM. На CMS всё живет в инфоблоке каталога и в параметрах компонентов магазина.

  1. Составьте список характеристик, которые покупатель реально использует.
  2. Отметьте, что должно быть в умном фильтре, а что только в карточке.
  3. Отдельно выпишите поля вариаций - они почти всегда в инфоблоке торговых предложений.
  4. Проверьте источник значений: вручную, обмен с 1С или прайс.
  5. Зафиксируйте символьные коды латиницей (BRAND, THICKNESS) - их потом пропишете в компонентах.
  6. В реальном проекте сразу решите, кто владеет справочником брендов: каталог или HL.
Схема:
Задача магазина → Тип свойства → Создание в инфоблоке → Заполнение у товаров → Умный фильтр / карточка → Чек-лист на витрине

2. Выберите тип свойства инфоблока под задачу

Схема выбора типа свойства инфоблока: список, число, строка, файл

Тип свойства - "форма поля". От него зависит, удобно ли фильтровать и не разъедутся ли значения после импорта.

Тип (код) Когда брать В умном фильтре
Список (L) Бренд, материал - фиксированный набор Да, лучший выбор для фасета
Число (N) Толщина, вес, диаметр - диапазон "от-до" Да, слайдер / min-max
Строка (S) Артикул, произвольный текст Плохо: строки размножаются
Файл (F) PDF, сертификат, доп. файл Нет (официально недоступно)
Привязка / HL Единый справочник брендов Да, если справочник аккуратный

Делайте: для фильтра и обмена с 1С используйте Список с XML_ID у значений или привязку к справочнику. Числа - для диапазонов. Строку оставляйте для артикула.

Не делайте: не создавайте "бренд" строкой: например, после импорта получите "Nike", "nike" и "NIKE " как три пункта. Не ждите умного фильтра от типа Файл - опция для файла и видео недоступна. Часто ломается и фасет, если значения списка без XML_ID.

3. Создайте свойство в каталоге и заполните значения у товаров

Чеклист: создать свойство каталога и заполнить значения у товаров

Создать свойство можно через "Магазин → Свойства товаров" или "Контент → Инфоблоки → каталог → вкладка Свойства". Результат один: поле в инфоблоке с кодом CODE.

  1. Откройте инфоблок каталога и вкладку "Свойства" (или раздел магазина "Свойства товаров").
  2. Нажмите "Добавить": название, символьный код латиницей, сортировка SORT.
  3. Выберите тип: бренд - Список (L), толщина - Число (N), артикул - Строка (S).
  4. Для списка добавьте значения и сразу проставьте XML_ID.
  5. Сохраните. Откройте 2-3 тестовых товара в нужном разделе и заполните значения.
  6. Если свойство для вариаций - создавайте его в инфоблоке торговых предложений, не в товаре.

Делайте: сначала заполните тестовые позиции в одном разделе, потом массово.

Не делайте: не оставляйте CODE пустым или кириллицей - без кода свойство не попадёт в параметры компонента.

4. Включите умный фильтр и показ характеристик на витрине

Две разные галочки и два потребителя: фильтр раздела и карточка товара. Их часто путают.

Для умного фильтра:

  1. Включите "Показывать в умном фильтре" и выберите вид (чекбоксы, слайдер для числа).
  2. Если свойства привязаны к разделам - проверьте доступность в нужном разделе.
  3. При API-включении сначала убедитесь, что у инфоблока SECTION_PROPERTY=Y: иначе SMART_FILTER может молча не сохраниться.
  4. Пересоздайте фасетный индекс и сбросьте кеш.
  5. Откройте раздел: свойство должно появиться в catalog.smart.filter с реальными значениями.

ЧПУ, SEO meta и AJAX фильтра - в отдельном материале: как настроить умный фильтр на Битрикс. Здесь задача одна: свойство попало в фасет.

Для карточки и списка:

  1. Включите "Показывать на детальной странице" (DETAIL_PAGE_SHOW).
  2. В параметрах catalog / catalog.element добавьте код в DETAIL_PROPERTY_CODE (или PROPERTY_CODE).
  3. В шаблоне характеристики берутся из $arResult['DISPLAY_PROPERTIES'] - пустой массив значит, код или флаг не дошли.

Шаблон element.php, галерея и кнопка "Купить" - в гайде по карточке товара. Здесь достаточно попадания в DISPLAY_PROPERTIES.

Делайте: проверяйте фильтр и карточку на одном тестовом товаре в одном разделе.

Не делайте: не ждите, что галочка умного фильтра сама выведет характеристику на детальной - это разные флаги.

5. Чек-лист: видно в карточке, участвует в фильтре, не ломает импорт и SKU

  1. Тип подходит задаче: L/N (или HL) для фильтра, S для артикула, F только для файлов.
  2. У тестовых товаров в разделе заполнены значения; в фильтре не нули.
  3. Фасет пересоздан после SMART_FILTER; кеш сброшен.
  4. На карточке код в DETAIL_PROPERTY_CODE / PROPERTY_CODE, DETAIL_PAGE_SHOW включен, DISPLAY_PROPERTIES не пуст.
  5. Вариации лежат в инфоблоке предложений; на товаре нет бессмысленных дублей "Цвет/Размер".
  6. У значений списка есть XML_ID; строковый бренд не размножается после обмена с 1С.
  7. В инкогнито проверены раздел с фильтром и детальная страница.

Делайте: держите чек-лист рядом с ТЗ на каталог. Одна пропущенная галочка = "в админке есть, на сайте нет".

Не делайте: не чините отсутствие фильтра правкой ЧПУ или шаблона карточки, пока не закрыты тип, SMART_FILTER и фасет. Пустой блок характеристик фасетом не лечится.

Что дальше

  1. Создайте 2-3 свойства (бренд списком, одно число, артикул строкой) и заполните тестовые товары.
  2. Включите нужные в умный фильтр, пересоздайте фасет, проверьте раздел.
  3. Добавьте коды в параметры карточки и убедитесь, что DISPLAY_PROPERTIES заполнен.
  4. Если нужны вариации цвета/размера - настройте SKU отдельно; если застряли на импорте или связке фильтр-карточка - напишите в контакты, разберём на вашем каталоге.
Автор: Максим Мольков, разработчик 1С-Битрикс.
Источники: официальная документация 1С-Битрикс - user help по свойствам инфоблока, курс "Интернет-магазин" (свойства товаров/SKU, умный фильтр, привязка к разделам), API CIBlockProperty::Add / Update; практика внедрений на CMS.

Частые вопросы

Как добавить свойство товара в Битрикс?

Откройте инфоблок каталога → вкладка "Свойства" (или "Магазин → Свойства товаров"), нажмите "Добавить", задайте название, латинский CODE и тип. Сохраните и заполните значение у 2-3 тестовых товаров в нужном разделе.

Почему свойство не видно в карточке товара?

Проверьте три слоя: значение заполнено у элемента, включен показ на детальной (DETAIL_PAGE_SHOW), код добавлен в DETAIL_PROPERTY_CODE / PROPERTY_CODE. В шаблоне смотрите DISPLAY_PROPERTIES - пустой массив значит, компонент не получил свойство.

Как сделать свойство для умного фильтра?

Выберите тип Список или Число (не Файл), включите "Показывать в умном фильтре", заполните значения у товаров раздела и пересоздайте фасетный индекс. Если галочка не сохраняется через API - проверьте SECTION_PROPERTY у инфоблока.

Чем свойство товара отличается от свойства торгового предложения?

Свойство товара описывает карточку целиком (бренд, материал). Свойство предложения (SKU) отличает варианты - цвет, размер. Вариации создавайте в инфоблоке торговых предложений, иначе фильтр и выбор оффера путаются.

Какой тип свойства выбрать для бренда?

Для фильтра и обмена с 1С берите Список (L) с XML_ID или справочник. Строка (S) быстро размножает "Nike / nike / NIKE" и ломает фасет. Артикул оставляйте строкой.

Свойство заполнено, галочка фильтра стоит, а в разделе пусто. Что проверить?

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

Читайте также

Интеграции с 1С и API
949 6 мин.

Как настроить регистрацию и личный кабинет покупателя на 1С-Битрикс?

Пошаговая настройка регистрации на сайте битрикс: Главный модуль, main.register, system.auth.form и sale.personal.section с историей заказов и 152-ФЗ.
Интеграции с 1С и API
679 15 мин.

Что такое компонент в Битриксе и как он работает

Каждый разработчик, впервые столкнувшийся с Битриксом, проходит через своеобразный обряд посвящения. Вначале кажется, что это просто CMS, где можно поправить HTML в визуальном редакторе или дописать пару строк CSS. Но однажды наступает момент, когда нужно изменить логику вывода новостей, отфильтровать товары по хитрому свойству или добавить на страницу нечто совершенно новое. И тут он впервые слышит это слово — «компонент». Для многих этот момент становится стеной. Система, казавшаяся понятной, вдруг превращается в черный ящик, полный непонятных файлов и странных переменных. Но стоит лишь раз заглянуть под капот, как эта стена рассыпается, превращаясь в набор удивительно логичных и мощных строительных блоков. Понимание компонентов — это тот самый щелчок, после которого разработка на Битрикс из мучения превращается в творчество.

Эта статья — ваш проводник в мир компонентов «1С-Битрикс». Мы не будем сыпать сухими терминами из документации. Вместо этого мы совершим путешествие: от философии, заложенной в эту архитектуру, до мельчайших деталей её работы. Мы разберем компонент на атомы — его файлы, логику, шаблон, параметры — и соберем обратно, чтобы вы не просто знали, что это, но и глубоко понимали, почему это работает именно так. Это знание — ключ к эффективной и профессиональной разработке на Битрикс.

Интеграции с 1С и API
605 2 мин.

Установка Composer в 1С-Битрикс

Установка Composer в проекте на 1С-Битрикс требует учета особенностей платформы, чтобы обеспечить корректную работу и интеграцию с системой.