Руководство редактора

Инструкция для тех, кто пишет контент в менеджере MODX. Настройки профилей и медиа — в Системных настройках.

Включение

1. Настройки → Системные настройки
2. which_editor = mxEditorJs
3. mxeditorjs.enabled = Да
4. Откройте ресурс — в поле контента появится Editor.js

Редактор не открылся — см. FAQ.

Блоки

Добавить блок: Enter в конце блока или «+» слева.

Переместить: иконка ⋮⋮ слева от блока, перетащите.

Удалить: ⋮⋮ → Delete.

Форматирование: выделите текст — панель B, I, Link, Code, Marker, U.

Блок	Назначение
Paragraph	Основной текст, выравнивание
Header	Заголовки H2–H5
List	Маркированный или нумерованный список
Checklist	Список с чекбоксами
Quote	Цитата с подписью
Table	Таблица, первая строка может быть заголовком
Code	Блок кода
Raw HTML	Произвольный HTML
Delimiter	Горизонтальная линия
Warning	Заголовок и текст предупреждения
Attaches	Файл для скачивания (PDF, DOC, ZIP)
Image	Одно изображение с подписью
Gallery	Несколько изображений, режимы fit или slider
Embed	Видео и iframe (вставка по URL, см. ниже)

Набор блоков задаёт администратор через профиль (default, minimal, blog, full) или mxeditorjs.enabled_tools.

Изображения

1. «+» → Image
2. Загрузить — drag-and-drop или выбор файла
3. Обзор — браузер Media Source

После вставки: подпись, рамка, растягивание, фон, CSS-пресет (если настроен).

Форматы: JPG, JPEG, PNG, GIF, WebP, SVG. Размер по умолчанию до 5 МБ (mxeditorjs.max_upload_size).

Галерея

1. «+» → Gallery
2. Картинки через Загрузить или Обзор (тот же Media Source, что у Image)
3. Перетащите миниатюры для порядка
4. В настройках блока: fit (сетка) или slider (горизонтальная прокрутка)
5. Общая подпись — по желанию

Лимит числа картинок — mxeditorjs.gallery_max_count (0 = без лимита).

Ссылки

1. Выделите текст → Link
2. URL или название ресурса MODX (автодополнение по pagetitle, longtitle, ID)
3. Target, rel и CSS-класс — если настроены пресеты

Embed (видео и iframe)

Отдельной кнопки Embed нет. Вставьте URL в пустой блок (Ctrl+V / Cmd+V) — редактор создаст блок сам.

Поддерживаются YouTube, Vimeo, RuTube (https://rutube.ru/video/...), Twitter/X, Instagram, CodePen и другие сервисы @editorjs/embed. На сайте выводится iframe.

TV (дополнительные поля)

Работает в TV Textarea с Rich Text = Да.

1. Создайте TV, назначьте шаблону
2. На ресурсе откройте Дополнительные поля

У каждого TV свой экземпляр редактора и своё JSON-хранилище. Автомиграция HTML для TV не выполняется.

Полноэкранный режим и HTML

Кнопка	Действие
Fullscreen	Редактор на весь экран (F11, выход — Escape)
Source	HTML-предпросмотр (Ctrl+U / Cmd+U), только чтение

Миграция из HTML

Если у ресурса есть HTML от TinyMCE/CKEditor, но нет JSON в sidecar, при первом открытии появится окно:

1. Превью: число блоков и размер HTML
2. Мигрировать — конвертация в Editor.js
3. Отмена — пустой редактор

Мигратор распознаёт заголовки, параграфы, списки, цитаты, картинки, таблицы, код, разделители. Embed, галерею, вложения и чеклисты из HTML не восстанавливает.

Миграция только для основного контента, не для TV. Подробнее: Интеграция.

Горячие клавиши

Клавиша	Действие
Enter	Новый блок
Backspace в пустом блоке	Удалить блок
Tab / Shift+Tab	Вложенность в списке
Ctrl+B / Cmd+B	Жирный
Ctrl+I / Cmd+I	Курсив
Ctrl+K / Cmd+K	Ссылка
Ctrl+Z / Cmd+Z	Отменить
Ctrl+Shift+Z / Cmd+Shift+Z	Повторить
Ctrl+U / Cmd+U	Source Preview
F11	Полноэкранный режим
Escape	Выйти из полноэкранного режима