О настройках CKeditor 4.x

О настройке интерфейса редактора CKeditor 4.x.

Причина написания этой заметки

Давно хотел перепостить свои комменты, сделанные мной на этом ресурсе. Автор этого плагина — Feodor, так что все лавры должны принадлежать ему. Я лишь дополняю его материал своей информацией.

О плагине p_ckeditor

Плагин устанавливается на iCMS v.1.10.3 без проблем, содержащийся в нем эдитор прекрасно работает. Этот эдитор более продвинут, чем штатный, который был неоднократно замечен в вырезании тегов, которые не он сам создал.(этакий ревнивец) . Новый эдитор предлагает больше возможностей для редактирования и меньше загрязняет код, чем штатный. У него в комплекте четыре темы оформления (moono, moono-dark, ozone, silver), можете выбрать ту, которая вам больше по вкусу, или сотворить свою. По умолчанию прописана moono, вы можете переключить тему из админки плагина, прописав ее название в поле "Тема редактора". Если сотворите еще одну, не забудьте поделиться!
Предупреждение.По многочисленным сообщениям, у данного редактора возникают конфликты с Универсальным Каталогом. Конфликт заключается в том, что из контента вырезаются все HTML-теги форматирования, и на страницу попадает только неотформатированный текст. Причина не в редакторе и не в УК, причина в версии php, поскольку на Денвере эта связка ckeditor+УК работает. Просьба заинтересованным лицам уделить внимание этой проблеме. Если кто-то может помочь, пишите мне в личку, я укажу точку в УК, в которой возникает трабла. Если ничего не найдем, можно пойти по тому варианту, который избрал я — написал костыль к УК. Хоть и некрасиво, но работает.

Настройка интерфейса редактора.

Разный вид интерфейса для разных пользователей

Например, вы решили дать возможность редактирования статей трем группам пользователей. Пусть это будут админы, редакторы и модераторы. Однако вы считаете нужным дать каждому разные возможности редактирования. Для этого вы создаете в папке plugins/p_ckeditor/editor/ три файла: admin_config.js, editor_config.js и moder_config.js. Содержание этих файлов аналогично и будет рассмотрено чуть позже. В стандартном плагине, который вы скачали, два файла уже есть — это admin_config.js и user_config.js

Для подключения этих конфигов к плагину следует изменить в файле plugins/p_ckeditor/plugin.php значение переменной $conf. На 54 строчке ей присваивается значение по умолчанию Ниже пишем: И строчки (тут я думаю, сами сообразите) которые присваивают переменной $conf значения editor или moder, если юзер относится к группе редакторов или модераторов. Например, на свежеустановленном сайте id групп у вас такие: 7 — у редакторов и 9 — у модераторов. Если вы id групп не меняли, можете сделать так: Естественно, это не единственно возможный способ присвоить переменной значение, можете сделать так, как вам удобно.

Что должно быть в конфигах

Интерфейс эдитора состоит из секций. Секции можно переставить местами и расположить на разных строчках. Каждая секция содержит кнопки.
Для того, чтобы включить ВСЕ секции и ВСЕ кнопки надо в конфиге написать такой код:
Каждая секция начинается с name и содержит имя секции, например, name: 'editing'. Убрав секцию из конфига, вы убираете с интерфейса редактора секцию целиком. Будте осторожны с последней секцией: если вы ее уберете, не убрав запятой с предпоследней, у вас эдитор просто выключится.
Перенос строки происходит с помощью кода '/'
Каждая секция содержит перечисление кнопок. Этот список начинается с items и внутри фигурных скобок заключает имена кнопок, поддерживаемых эдитором. Если вы добавите кнопку, она отобразиться, но работать не будет, поскольку надо в код эдитора добавлять для нее действие. Зато, убрав кнопку из секции, вы ненужную кнопку просто выключаете.
Если перенести в конфиге имя кнопки из одной секции в другую, при запуске эдитора вы увидите кнопку на новом месте интерфейса.
Внутрь секции можно вставить визуальный разделитель между кнопками, вставив код '-'.

Пользуясь этими правилами, вы легко настроите конфиги для любого юзера. Оставьте им те кнопки, которые, по вашему мнению, им нужны и пусть пользуются.

Еще кое что о конфигурационных файлах редактора.

Приведенный выше массив config.toolbar=[...]; не единственный возможный, который поддерживается эдитором. Точно так же воспринимается массив config.toolbarGroups=[...]; Он по структуре точно такой же, только перед названиями кнопок стоит не items, а groups. Главное, чтобы у вас в одном файле был один из возможных массивов: или первый или второй, но не оба. Пример массива config.toolbarGroups и сейчас лежит в файле user_config.js, который вы получите при загрузке плагина.

Еще один способ отключить ненужные кнопки в конфиге, это перечислить их названия в методе config.removeButtons, например: Даже если названия кнопок перечислены в массивах config.toolbar или config.toolbarGroups, при упоминании в методе config.removeButtons кнопка отключается.

Краткая инструкция по добавлению тем.

Добавляю для "тех кто в танке" краткую инструкцию по добавлению тем редактора, хотя чего уж проще:
1. Идем на сайт производителя редактора и открываем страничку skins
2. Выбираем тему и щелкаем по картинке-превьюшке, которая показывает внешний вид интерфейса. Вас перебросит на страничку этого скина, где есть кнопка "Download".
3. Жмете на эту кнопку и указываете, куда сохранить архив.
4. В архиве лежит папка с именем темы редактора. Распаковываете архив.
5. Перебрасываете папку с темой в папку эдитора plugins/p_ckeditor/editor/skins/
6. Идете в админку Дополнения->Плагины, ищите свой плагин и жмете на его шестеренку. Попадаете в админку плагина.
7. В поле "Тема редактора" прописываете имя темы редактора. Она совпадает с именем папки, которую вы только что загрузили.
8. Жмете на кнопку "Сохранить"
9. Открываете для редактирования любую статью и наслаждаетесь своей заоблачной крутостью по смене тем редактора)))

Удачи в программировании!