Руководство и модуль 0.133.5
Актуальный проверенный выпуск — модуль 0.133.5, интерфейс 0.103.3. Основные инструкции для пользователей и справочники для разработчиков сохраняют базовую версию 0.133.0 / 0.103.0. Эта страница объясняет отличия, которые нужно учитывать в более новом выпуске.
Сверка исходников выполнена 5 октября 2026 года. Обычные способы редактирования, сохранения, публикации и подключения расширений остаются применимыми. Изменения ниже не требуют переносить сохранённые документы в другой формат.
Что учесть пользователю и администратору
| Область | Поведение в 0.133.5 | Что проверить |
|---|---|---|
| Команда Node.js | Менять исполняемый файл может только полный администратор Битрикс | Пользователь с правом модуля [W] может менять остальные разрешённые настройки, но не эту команду |
| Навигация по странице | Пункты формируются по порядку заголовков H2/H3; скрытые заголовки и заголовки внутри скрытых контейнеров учитываются при показе меню | Переместите раздел, проверьте меню в разных режимах экрана и после публикации |
| Параметры компонента в административной части | Сайт редактируемого документа определяется отдельно от языка административного интерфейса | В многосайтовой установке проверьте шрифты, кнопки и блоки именно нужного сайта |
| Переходы формата блоков | Кнопка показывается после успешной проверки наличия доступных переходов | Отсутствие кнопки само по себе не означает, что редактор сломан |
Настройка Node.js
Ограничение введено в 0.133.1. Оно относится и к сохранению формы, и к импорту JSON, и к сбросу настроек. При действиях пользователя с правом [W] прежняя команда Node.js сохраняется. Если импортируемый файл пытается изменить её, весь импорт отклоняется до записи параметров. Для такого переноса нужен полный администратор; другой вариант — импортировать файл без изменения этой настройки.
Node.js по-прежнему необязателен. Редактирование, публикация, импорт и восстановление могут формировать HTML в браузере. Браузерную обработку очереди актуализации запускает полный администратор.
Навигация и скрытые разделы
Блок «Навигация по странице» собирает ссылки на заголовки H2 и H3 с постоянными якорями. В 0.133.5 новый список следует порядку этих заголовков в документе. Он учитывает скрытие самого заголовка и его родительских контейнеров, в том числе для отдельных размеров экрана.
При публичном выводе модуль также проверяет сохранённое меню: убирает ссылки на отсутствующие или полностью скрытые заголовки и добавляет признаки, необходимые для адаптивного скрытия пунктов. Это не редактирует исходный JSON. Такая проверка существующего HTML не переставляет старые пункты меню: если требуется обновить их порядок, заново сохраните и опубликуйте документ обычным способом.
Настройка содержимого меню описана в главе о макетах, скрытие блоков — в главе об оформлении.
Сайт документа в параметрах компонента
В 0.133.3 исправлено определение сайта при открытии параметров компонента из административной части и её AJAX-запросов. Например, язык интерфейса ru не должен использоваться вместо ID сайта s1.
Модуль проверяет переданный сайт и, при необходимости, определяет его по контексту редактируемой страницы. Для автора порядок действий не меняется: открыть редактор, нажать «Готово» и завершить сохранение внешнего окна. На многосайтовой установке полезно проверить настройки редактора отдельно для каждого сайта.
Кнопка перехода формата блоков
В 0.133.5 действие «Переходы формата блоков» появляется только после проверки доступных обновлений. На публичной странице это небольшая кнопка с шестерёнкой рядом с управлением редактированием; у поддерживаемого поля инфоблока — отдельная текстовая кнопка. Этот отложенный вход предусмотрен для публичного режима и поля инфоблока, а не для окна параметров компонента. При отсутствии переходов, отказе в доступе или ошибке проверки кнопка остаётся скрытой; обычное открытие редактора доступно отдельно.
Проверка наличия переходов не занимает блокировку документа. При запуске перехода модуль заново проверяет права и исходные данные и получает блокировку для самой операции. Не запускайте переход только ради обновления номера редактора: он нужен, когда разработчик расширения подготовил преобразование данных его блоков.
Совместимость программных интерфейсов
Page Agent API остаётся версии 1.23. Проверенные TypeScript-контракты, PHP-контракты расширений и провайдеров из архивов руководства 0.133.0 совпадают с исходниками 0.133.5. Поэтому примеры SDK, Provider SDK, события и схемы узлов сохраняют свою базовую версию.
Для интеграции с механизмом переходов в 0.133.5 добавлены два действия Bitrix:
| Действие | Назначение |
|---|---|
globalit:wysiwyg.api.migration.availability |
Проверка переходов опубликованного документа компонента |
globalit:wysiwyg.api.migration.nativeAvailability |
Проверка переходов документа поля инфоблока |
Оба принимают payload с contentUid и возвращают catalogVersion: 1, тот же contentUid и логическое available. Нужны авторизация, POST, CSRF и право редактирования документа. Для этой проверки sessionUid и lockVersion не требуются. Ответ служит только для отображения кнопки; он не подтверждает право выполнить переход позднее. Эти действия появились после 0.133.0 и не входят в контракт базового выпуска.
Границы проверки
Проверены исходники выпуска 0.133.5, различия с 0.133.0 и файлы программных контрактов. Существующие снимки настроек, истории и выбора источника на 0.133.5 остаются помечены своей фактической версией.
В рамках этой сверки полный цикл редактирования, импорта, восстановления и публикации на установленном Битрикс заново не выполнялся. Прежняя приёмка базового выпуска и новые проверки исходников описаны раздельно в сведениях о версиях. Модуль и его номер версии для обновления документации менять не требуется.