Решение проблем
Проверяйте настройки по порядку. Не переустанавливайте модуль и не удаляйте таблицы как первый способ исправления.
Не появилась кнопка редактирования
- Убедитесь, что пользователь авторизован.
- Проверьте права на конкретный HL, а для областей — на оба Content-хранилища.
- Включите режим правки Битрикса и наведите указатель на саму карточку.
- Проверьте
ENABLE_PUBLIC_EDIT=Yи наличие обёртки в собственном шаблоне. - Проверьте загрузку JS-ресурсов и ошибки браузера.
Если настройки верны, сравните поведение со стандартным шаблоном. Отключение флага или отсутствие обёртки не исправляется выдачей пользователю полного административного доступа.
Область пустая на втором сайте
Проверьте точные SITE_ID и LANGUAGE_ID страницы. Значение другого сайта или языка не подставляется. Откройте область в нужном контексте и заполните её. Если на странице показывается код, определение ещё не подготовлено или исходное значение не заменено.
Не используйте setScope('home') вместе с полным кодом home.intro: получится home.home.intro. После группы областей сбрасывайте scope.
Компонент не находит HL-блок
Проверьте HLBLOCK_NAME: нужен технический NAME сущности, а не название таблицы, перевод или старый числовой ID. После переименования блока откройте настройки и выберите его заново. Проверьте установку обоих модулей: highloadblock и kokhanenko.hlblocks.
Список пуст или новая запись не видна
Проверьте фильтр, UF_ACTIVE, LIMIT/OFFSET и порядок сортировки. Сравните записи с административным списком. ACTIVE_ONLY не является календарным фильтром дат. Не создавайте запись второй раз, пока не убедились, что первая не сохранилась.
Некорректный JSON в FILTER_JSON — ошибка конфигурации, а не пустая выборка. Если одновременно передан массив FILTER, он имеет приоритет.
Детальная запись не найдена
Проверьте выбранный режим поиска. Для ID нужен положительный ELEMENT_ID, для CODE — значение ELEMENT_CODE и одиночное строковое поле UF_UNIC_CODE. Режим CODE не ищет по UF_CODE или произвольному полю.
Проверьте активность записи. Дубли уникального кода требуют исправления данных; компонент не должен молча выбирать первую строку. Для собственной страницы 404 проверьте существование FILE_404 и её доступность.
Вместо изображения выводится число
В SELECT и EXPAND_FIELDS должно быть файловое поле. Используйте <FIELD>_DATA['SRC'] для одиночного поля, а не исходный ID. Для множественного поля переберите список _DATA. Данные связанной записи раскрываются только на один уровень.
Поле не сохраняется или форма устарела
Проверьте обязательность, тип, допустимые значения, EDIT_IN_LIST и права на цель связи. После изменения прав или структуры закройте форму и откройте её снова. Неподдержанный тип не нужно заменять текстовым вводом в браузере — требуется поддержанный адаптер или работа через штатную админку.
Если сообщение говорит, что запись сохранена, но кеш не обновлён, не повторяйте создание: проверьте данные и выполните штатную очистку кеша.
SEO/OpenGraph не появился
Проверьте профиль и два независимых флага SET_SEO и SET_OPEN_GRAPH у detail-компонента. Источник должен существовать и содержать допустимое значение. Сначала сохраните изменённые поля записи, затем выполните предпросмотр. Проверьте исходный HTML публичной страницы, а не только видимый H1.
Если на странице несколько компонентов, проверьте владельца метаданных. Для композита обновите HTML-копию страницы. Кеш социальной сети модуль не очищает.
Установка остановилась
Проверьте PHP, main, highloadblock, права на файлы и состояние схемы. Сообщение NEEDS_BITRIX_VERIFICATION означает неподтверждённый путь совместимости, который не следует включать обходом проверки. При конфликте таблиц или кодов сохраните данные и разберите причину с разработчиком.
Что передать в поддержку
Укажите версию модуля, PHP и Битрикса, ожидаемый результат, порядок воспроизведения, параметры компонента без секретов и точный текст ошибки. Приложите скриншот нужной формы. Пароли, cookies, токены и полные дампы базы в обращение не включайте.