заметки веб-разработчика

Обновление CKEditor с 3 версии на 4

19 сентября 2018 - 11:51 -- ikode

Источник - https://ckeditor.com/docs/ckeditor4/latest/guide/dev_upgrade_ckeditor_3.html

CKEditor 3 и 4 в основном совместимы, поэтому обновление до последней версии CKEditor 4 проходит почти всегда в штатном режиме.

CKEditor 3.х больше не обновляется. Новые функции, исправления ошибок и поддержка последних версий браузера не передаются из CKEditor 4 и доступны только при обновлении до текущей версии редактора.

Различия между CKEditor 3 and 4

Вот список наиболее заметных изменений между CKEditor 3 и 4.

  1. Установлена по умолчанию новая "шкурка" для редактора - Moono.
  2. Пакет установки больше не включает все возможные плагины CKEditor. Теперь вы можете выбрать один из заранее составленных пакетов (Basic, Standard, Full) или создать пользовательскую сборку, используя службу онлайн-строителя.
  3. Все плагины CKEditor, созданные командой редактора и сообществом, доступны в новом репозитории дополнений, где вы можете просматривать их и легко добавлять в свою сборку.
  4. Новый расширенный фильтр содержимого настраивает ваш контент на конфигурацию вашего редактора и разрешает запрещенный контент.
  5. Некоторые изменения в JavaScript API CKEditor 4 нарушают обратную совместимость. См. Список изменений между CKEditor 3.x и CKEditor 4.0. Обратите внимание, что со временем количество различий может увеличиться по мере того, как CKEditor 4 находится в активной разработке, поэтому рекомендуется проверить, работают ли ваши пользовательские плагины как ожидалось после обновления.
  6. Были удалены серверные интеграции (ASP, PHP). Вместо этого используется метод интеграции JavaScript.
  7. Изменено расположение некоторых файлов конфигурации. Например, ckeditor/plugins/styles/styles/default.js теперь просто ckeditor/styles.js.

Процедура обновления

Если вы ранее использовали CKEditor 3, вы можете либо попытаться создать сборку CKEditor 4, которая имитирует функциональность, используемую до или же выбрать желаемый установочный пакет CKEditor 4, а затем просто настроить свою конфигурацию. Смотри ссылку Compare Packages для изучения различий между ними.

Чтобы обновить CKEditor 3 до CKEditor 4, выполните следующие действия:

  1. Переименуйте существующую папку редактора в папку резервного копирования, например ckeditor_old.
  2. Загрузите последнюю версию с официального сайта.
    • Самый простой способ - выбрать один из предустановленных пресетов, таких как Standard или Full.
    • Если вы хотите включить какие-либо дополнительные плагины, используйте службу онлайн-строителя для создания пользовательской сборки.
  3. Извлеките (распакуйте) загруженный архив в каталог редактора, например с именем ckeditor.
  4. Просмотрите все файлы конфигурации, которые вы изменили в CKEditor 3 (см. Папку резервного копирования), и примените свои изменения к новым файлам CKEditor 4. Примерный список файлов, которых может затронуть обновление:
    • config.js
    • contents.css
    • plugins/styles/styles/default.js
    • файлы настраиваемых шаблонов

Готово!

 

P.S.: Скоро постараюсь сделать статью о переходе с 4-й версии на 5-ю.