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

Как писать контент в менеджере MODX. Профили и медиа: Системные настройки.

Включение

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

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

В колонке MIGX с "inputTVtype": "richtext" редактор подключается тем же which_editor. Значение хранится как HTML в JSON строки, не в sidecar.

Блоки

Добавить блок: 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
mxGallery	Медиа или коллекция пакета mxGallery (toolbox только если пакет установлен)
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). Редактор создаст блок сам.

В buildTools() заданы шесть сервисов: YouTube, Vimeo, Twitter/X, Instagram, CodePen, RuTube. Остальные сервисы @editorjs/embed по умолчанию отключены. Новый сервис: только правка mxeditorjs.ts. На сайте выводится 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	Выйти из полноэкранного режима