mxEditorJs

блочный редактор Editor.js для MODX 3
Версия 1.0.0-beta1
Дата выпуска 07.03.2026
Загрузки 20
Просмотры 389
Внимание, этот компонент требует PHP 8.2 или выше!
Внимание, этот компонент требует MODX 3 или выше.
⚡ mxEditorJs — блочный редактор Editor.js для MODX 3

Интегрирует Editor.js в административную панель MODX 3 в качестве замены стандартного Rich Text Editor. Контент хранится в каноническом JSON-формате Editor.js, на фронтенде автоматически генерируется HTML-снимок.

🪟 Блочный редактор
  • 13 типов блоков: параграф, заголовок, список, чеклист, цитата, таблица, код, raw HTML, embed, изображение, вложение, разделитель, предупреждение
  • Inline-инструменты: marker, inline-code, underline, link
  • Выравнивание текста (tune) для параграфов, заголовков, списков, цитат
  • Undo/Redo — поддержка отмены действий

📺 Embed — встраиваемый контент
  • YouTube, RuTube, Vimeo, Twitch, Instagram, Facebook, Twitter/X и другие сервисы
  • Вставка по URL через Paste API — достаточно скопировать ссылку и вставить в редактор
  • Корректный рендер на фронтенде — блоки отображаются как iframe с поддержкой allowfullscreen и loading=«lazy»
  • Возможность добавить кастомные сервисы через конфигурацию

✨ Ключевые возможности
  • Поддержка TV-полей — редактор работает в основном контенте и в дополнительных полях (textarea + richtext)
  • Загрузка медиа — drag-and-drop изображений и файлов через MODX Media Sources
  • Браузер файлов — встроенный просмотр с навигацией по директориям
  • Автодополнение ссылок — поиск ресурсов MODX при вставке ссылок
  • Миграция HTML → Editor.js — автоматическая конвертация существующего HTML-контента
  • Профили инструментов — предустановленные (default, minimal, blog, full) и пользовательские
  • Полноэкранный режим и режим Source Preview (просмотр сгенерированного HTML)
  • Локализация — русский и английский, наследование локали менеджера
  • CSS-пресеты — настраиваемые классы для изображений и ссылок

🚀 Быстрый старт
  1. Установите пакет через Extras → Installer
  2. В системных настройках установите which_editor = mxEditorJs
  3. Откройте любой ресурс — в поле контента появится Editor.js

📋 Требования
  • MODX Revolution 3.0.3+
  • PHP 8.2+
  • Node.js 18+ (только для сборки из исходников)

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0-beta1] - 2026-03-07

First beta release of mxEditorJs for MODX 3.

Added

  • Block-style editor for resource content field based on Editor.js
  • Canonical JSON storage in dedicated sidecar table (mxeditorjs_content)
  • HTML snapshot rendering to modResource.content for frontend compatibility
  • Core block types: Paragraph, Header, List
  • Extended block types: Quote, Code, Delimiter, Table, Raw HTML
  • Image upload integration with MODX Media Sources
  • Smart internal linking with resource autocomplete (LinkAutocomplete tool)
  • External, email, and anchor link support
  • Fullscreen editing mode
  • Source preview (read-only HTML view)
  • HTML-to-JSON migration for legacy content
  • Content validation with JSON schema (ContentValidator)
  • MIME type validation for uploads via finfo_file()
  • Permission checks for save_document on all operations
  • Filename sanitization with incremental naming for duplicates
  • Graceful fallback to textarea on editor initialization failure
  • Full lexicon support (Russian, English)

Technical

  • MODX 3 only (no MODX 2 support)
  • PHP 8.2+ required
  • TypeScript frontend with esbuild bundling
  • Plugin events: OnRichTextEditorRegister, OnDocFormPrerender, OnResourceDelete
  • Namespace: mxeditorjs

Dependencies

  • Editor.js 2.x (bundled)
  • MODX 3.0.3+

Последние обсуждения в сообществе MODX.pro