Одно из самых популярных дополнений для MODX Revolution - визуальный редактор TinyMCE.
Оно и понятно, редко какой сайт может обойтись без хорошего richtext редактора для контента.
В этой статье рассматривается установка и настройка редактора TinyMCE.
Установка
Для установки необходимо скачать пакет из репозитория (http://modx.com/extras/package/TinyMCE) и установить его через раздел "Управление пакетами" вашего сайта.
После установки пакета вы сразу же можете открыть любой ресурс для редактирования и убедиться в том, что редактор появился.
Вы можете сразу же начать писать в нем текст, однако для более комфортного использования рекомендуем произвести настройку редактора.
Настройка TinyMCE будет включать несколько этапов:
- Подключение файла стилей
- Добавление кнопок для работы с таблицами
Подключаем файл со стилями к TinyMCE
Это нужно для того, что бы в визуальном редакторе текст выглядел один в один, как на сайте: шрифт, размер и цвет текста, оформление картинок и внешний вид таблиц.
Открываем "Настройки системы," и в фильтре выбираем "Визуальный редактор":
В этом разделе всего доступно 5 настроек:
- Путь к CSS файлу (editor_css_path) - указываете путь к вашему файлу со стилями текста. Обратите внимание,что использовать не полный css файл вашего сайта, а отдельный файл, в который вынести только стили, непосредственно относящиеся к оформлению текста (заголовки h1-h6, параграфы p, ссылки a, таблицы tables и другие). Редактор будет работать быстрее и корректнее.
- Использовать текстовый редактор (use_editor) - можно отключить редактор при необходимости на время, не удаляя при этом TinyMCE.
- Редактор (which_editor) - MODX Revolution позволяет установить несколько различных редакторов на сайт, при необходимости можно переключаться между ними. Кстати, можно переопределить эту настройку для администраторов сайта, назначив таким образом разным администраторам разный редактор.
- Редактор для элементов (which_element_editor) - укажите редактор для сниппетов, плагинов, чанков. Например это может быть CodeMirror или Ace.
Добавляем в TinyMCE кнопки для работы с таблицами
В TinyMCE, который устанавливается из репозитория MODX Revolution, по какой то причине по умолчанию отключена работа с таблицами. Нет, вы конечно можете переключится в режим HTML и написать код вручную, но зачем! Гораздо проще потратить 2 минуты и включить поддержку таблиц.
Итак, открываем настройки системы, и в первом фильтре выбираем tinymce :
Откроется список доступных параметров. Нас интересуют 2:
- tiny.custom_plugins - список подключенных плагинов к TinyMCS. В конец списка необходимо добавить "table" , подключив тем самым плагин для работы с таблицами. Плагин идет вместе с TinyMCE, и устанавливаеть его не надо, его надо просто включить.
- tiny.custom_buttons3 - список кнопок, отображаемых на 3-й строке. Укажите там "tablecontrols" , добавив тем самым набор кнопок для работы с таблицами. Понятное дело, что эти кнопки можно разместить на любой другой строке. Если вы посмотрите на другие строки, вы увидите список предустановленных кнопок, таких как undo,redo,selectall и много других. Можно "поиграть" ими, размещая кнопки в разном порядке.
Практически каждый веб-мастер использует тот или иной визуальный редактор (WYSIWYG) для размещения контента на сайте. Визуальные редакторы позволяют не только работать с HTML как с обычным текстом в текстовом редакторе, но и обладают функционалом, облегчающим жизнь вебмастеру. Однако последнее может не только упростить жизнь, но и усложнить.
В MODX Revolution в основном пользуюсь редактором TinyMCE , который устанавливается отдельным пакетом. Говорить о его достоинствах и недостатках не буду, а коснусь сегодня только тех моментов, которые я использую для облегчения работы с ним.
Дефолтные настройки
Сразу после установки пакета TinyMCE проверяю в системных настройках блоке tinymce:
Tiny.forced_root_block делаю пустой tiny.path_options должна быть пустая tiny.base_url должна быть пустая
Так же меняю опцию convert_urls на No в настройках плагина TinyMCE. Делаю я это, чтобы редактор никак не пытался изменять ссылки, которые я задаю.
Подключение файла стилей
Не всегда подключаю, но иногда это бывает полезным и упрощает работу с контентом. Делается через указание системной настройки editor_css_path в блоке системных настроек Rich-Text Editor настройка Path to CSS file (Путь до CSS файла) или.
HTML5 тэги
Честно говоря, включение HTML5 тэгов и их обработка по уму у меня не получилась. Поэтому я пошел путем разрешения любых тэгов путем добавления в файл core/components/tinymce/templates/script.tpl после строки после строки
Tiny.config = modx->toJSON($this->properties); ?>;
Tiny.config.valid_elements = "*[*]";
Которая разрешает прохождение любых тэгов. Для желающих заморочиться, этой переменной можно присвоить перечень всех возможных HTML тэгов, включая HTML5 тэги из файла xconfig.js входящего в пакет.
Так как MODX Revolution изначально поставляется пустым и для того чтобы заработал сайт, могу с 99% уверенностью сказать, что вам придется установить хотя бы одно дополнение — пакет . В связи с этим я решил написать небольшой список пакетов которые многим пригодятся при создании сайтов на MODx Revolution.
(статья обновлена 11.02.2018)
Дополнения из основного репозитория modx
Ace - подсветка кода при редактировании шаблонов, чанков, снипетов + встроенный emmet .
TinyMCE Rich Text Editor - симпатичный визуальный редактор для контента, может быть расширен за счет дополнительных функций, смотрите сайт разработчика.
filetranslit - переименовывает в латиницу при загрузке файлы с кириллицы (например: загружаете картинку с именем (названием) модх-плагин.png (при переносе сайта, такие имена картинок превратятся в козебряки и перестанут выводиться)), в админку зальется файл с именем modx-plagin.png .
translit – транслитерация псевдонимов для страниц (url) – необходим для .
FormIt - работа с формами (создание контактных форм любой сложности).
Collections - группировка документов (ресурсов) – больше для больших сайтов, где в категориях много документов – помогает разгрузить (ускорить) админку, т.к. если у вас будет огромное дерево ресурсов, у вас оно начнет глючить.
simpleUpdater - обновление модекса в 1 клик.
SEO Pro - SEO помощник! Проверяет длину полей – title, description, добавляет фокусное ключевое слово (keywords) и показывает как страницы будут выглядеть в поисковой выдаче.
Image SEO alt and title tags - автоматом подставляет alt и title для изображений, если они не прописаны. Осторожно применять на рабочем сайте, может поломать некоторые выводы, которые идут через CODE
Gallery – галереи изображений
migx - очень клевая вещь! Вывод нескольких тв в контенте, можно создать слайдер, галерею к примеру и т.п.
SimpleSearch – организация поиска по сайту.
Tagger - теги для записей, облако тегов.
ClientConfig – создание клиентских настроек, которые в дальнейшем смогут редактировать менеджеры. Т.е. заносим в него все что часто меняется, либо просто то к примеру контакты, адрес, слоган и т.д. – чтобы заказчик смог все легко и быстро менять.
Inherit Template — устанавливает шаблон для дочерних элементов.
VersionX – компонент для тех кто отдает сайты на доработку фрилансерам, ну возможно еще новичкам. Предназначен для создания локальных бекапов всех элементов - (чанки, сниппеты, ресурсы). Можно посмотреть старую версию и при необходимости восстановить ее. Так же, позволяет узнать, кто внес те или иные изменения.
Console – позволяет из бэкенда запускать PHP код.
AjaxManager — ускорение работы админки.
Captcha – капча для входа в админку – доп защита.
backupMODX – создание бекапов с работающего сайта в 1 клик.
logPageNotFound –лог 404 ошибок. Отлично подходит для отслеживания битых ссылок.
cacheClear – позволяет удалить все из папки /core/cache/ одним кликом.
Дополнения из репозитория modstore.pro
О том как подключить дополнительный репозиторий, читаем .
AjaxForm - Отправка контактных форм без перезагрузки страницы, через Ajax . Использует FormIt, но по сути можно указать и свой снипет.
DateAgo - Приятное форматирование дат как у CMS LiveStreet.
autoRedirector - создает 301 редиректы на автомате, так же можно создать редиректы в ручную.
Tickets - создание блога, формы комментирования, отзывов и тому подобное.
Jevix - что-то типа типографа, устанавливается на автомате с Tickets
mixedImage - смешанная загрузка файлов (замена дополнительного поля (для картинок, вложений и прочего)
pdoTools
- целый комбайн, в состав которого входят следующие снипеты:
pdoRecources
- предназначен в первую очередь для вывода списка ресурсов, но на самом деле при помощи него можно сделать очень много интересного: карту сайта (для людей), фото галереи, портфолио, кейсы из ресурсов, и т.д.
pdoMenu
- создание меню.
pdoPage
- как и pdoRecources выводит список ресурсов + создает постраничную навигацию, в том числе из выбоки других сниппетов.
pdoCrumbs
- для создания хлебных крошек (bread crumbs)
pdoUsers
— вывод пользователей
pdoSitemap
— создание авто генерируемого sitemap.xml
pdoNeighbors
— выводит предыдущие и следующие документы (полезно для блогов, статей и т.д.)
pdoField
— выводит любое поле указанного ресурса или его родителя, включая TV параметры.
pdoTitle
— предназначен для визульного различия документов с постраничной навигацией.
pdoArchive
— вывод архива документов сайта с разбивкой на дни, месяцы и годы
Парсер
— перехватывает обработку тегов на странице.
Это, пожалуй самый необходимый пакет, без него нормального сайта не собрать. Да еще он добавляет поддержку Fenom шаблонизатора, который побыстрее встроенного.
miniShop2 - создание интернет магазина.
BannerY - Компонент для управления баннерами (рекламой). На нем по сути легко реализовать слайдер.
phpThumbOn - миниатюры для изображений (вывод изображений с нужными размерами).
MinifyX – минификация и склейка скриптов и стилей в два файла (css и js) – позволяет уменьшить количество запросов и увеличить скорость загрузки страниц.
xPoller2 — Мультиязычные опросы.
AdminTools – смена цветовой схемы админки, избранные элементы, заметки, авторизация в админке через email и прочее.
frontendManager — Редактирование страниц с frontend’a.
dbAdmin – просмотр листинга таблиц БД из админки MODx Revo. Так же позволяет производить экспорт как отдельной таблицы, так и всей базы в целом. Еще умеет удалять и очищать таблицы (будьте аккуратны при его использовании) и производить разного рода SQL-запросы.
modDevTools – быстрый поиск и замена элементов в чанка, сниппетах.
debugParser – поиск узких мест на сайте.
tagElementPlugin – позволяет редактировать сниппеты или чанки по выделению его тега и нажатию сочетаний клавиш ctrl+enter.
controlErrorLog – добавляет иконку на панели верхнего меню, которая сообщает о наличии записей в журнале ошибок.
Универвальные плагины
— автоматическое сжатие картинок на любых сайтах, сервис платный, но нее дорогой, со старта дается 10мб — их хватает на сжатие примерно 500 картинок — что хватит для любой визитки, так же можно дополнительно получить до 200мб бесплатно.
Скорее всего после обновления системы MODX Evolution у Вас не работает текстовый редактор TinyMCE. Вот какая картина у меня на всех обнеовленных сайтах:
1. Скачиваем плагин от сюда .
2. Разархивируем.
3. Заливаем папку ckeditor в папку assets/plugins/
4. Создаем плагин ckeditor
5. Копируем в него содержимое из ckeditor.tpl
Ставим галочки в системных событиях «OnRichTextEditorInit», «OnRichTextEditorRegister» и «OnInterfaceSettingsRender»
6. Включаем CKEditor
Включить CKEditor можно в Инструменты>Конфигурация>Интерфейс и Представление , в графе "Редактор :" выбрать CKEditor
7. Заходим в любой документ и видим такую картинку
8. Дружим CKEditor с с файловым менеджером KCFinder
Чтобы редактор грамотно работал с файловым менеджером KCFinder заменяем этот код в файле /assets/plugins/ckeditor/functions.php :
$mcpuk_path["base"] = MODX_BASE_URL . "manager/media/browser/mcpuk/browser.php" . $cke_query ; $mcpuk_path["image"] = $mcpuk_path["base"] . "&Type=images"; $mcpuk_path["flash"] = $mcpuk_path["base"] . "&Type=flash"; $mcpuk_path["link"] = $mcpuk_path["base"] . "&Type=files";$mcpuk_path["base"] = MODX_BASE_URL . "manager/media/browser/mcpuk/browse.php";// . $cke_query ; $mcpuk_path["image"] = $mcpuk_path["base"] . "?type=images"; $mcpuk_path["flash"] = $mcpuk_path["base"] . "?type=flash"; $mcpuk_path["link"] = $mcpuk_path["base"] . "?type=files";
9. Я собрал свою сборку нужных мне кнопок
В файле /assets/plugins/ckeditor/modx_config.js вы можете менять местали, удалять или добавлять кнопки. Для себя я собрал вот такую комбинацию.
Кому интересно, можете заменить строчку кода:
Config.toolbar_modx = [ ["Source"], ["Bold","Italic","Underline","Strike","-","Subscript","Superscript"], ["PasteText","PasteFromWord"], ["Undo","Redo","-","Find","-","RemoveFormat"], "/", ["NumberedList","BulletedList","-","Outdent","Indent","Blockquote"], ["JustifyLeft","JustifyCenter","JustifyRight"], ["Link","Unlink","Anchor"], ["Image","Flash","Table","HorizontalRule","Smiley","SpecialChar"], "/", ["Format","Font","FontSize"], ["TextColor","BGColor"], ["Maximize", "ShowBlocks","-","About"] ];
Config.toolbar_simple = [ ["Source","-","Maximize","RemoveFormat"], ["PasteText","Find","Replace"], ["Link","Unlink"], ["Image","SpecialChar"], ["Format"], "/", ["Bold","Italic","Underline","Strike","-","Subscript","Superscript"], ["TextColor","BGColor"], ["NumberedList","BulletedList","-","Blockquote"], ["JustifyLeft","JustifyCenter","JustifyRight","JustifyBlock"] ];
Здесь я оставил только нужное мне: Исходный код, Увеличитель (чтобы удобнее было писать), форматирование текста, Вставить только текст, Поиск и Замена, Ссылки, Вставка изображений, Символы, Заголовки, Текстовые атрибуты, цвет текста и фона, пункты, цитата и выключка текста.
Установка дополнительных плагинов
У CKeditor куча всяких интересных плагинов. Вы их можете найти в интернете и на официальном сайте CKeditor. Все плагины устанавливаются в папку /manager/assets/components/ckeditor/ckeditor/plugins/.
Далее в «Системных настройках» выбираем «ckeditor» и в поле дополнительные плагины (extra_plugins ) вставляем имя устанавливаемого плагина. А в группы кнопок (toolbar ) вставляем в нужном месте "имя плагина". Дополнение установлено и готово к работе.
