Источник - 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.
- Установлена по умолчанию новая "шкурка" для редактора - Moono.
- Пакет установки больше не включает все возможные плагины CKEditor. Теперь вы можете выбрать один из заранее составленных пакетов (Basic, Standard, Full) или создать пользовательскую сборку, используя службу онлайн-строителя.
- Все плагины CKEditor, созданные командой редактора и сообществом, доступны в новом репозитории дополнений, где вы можете просматривать их и легко добавлять в свою сборку.
- Новый расширенный фильтр содержимого настраивает ваш контент на конфигурацию вашего редактора и разрешает запрещенный контент.
- Некоторые изменения в JavaScript API CKEditor 4 нарушают обратную совместимость. См. Список изменений между CKEditor 3.x и CKEditor 4.0. Обратите внимание, что со временем количество различий может увеличиться по мере того, как CKEditor 4 находится в активной разработке, поэтому рекомендуется проверить, работают ли ваши пользовательские плагины как ожидалось после обновления.
- Были удалены серверные интеграции (ASP, PHP). Вместо этого используется метод интеграции JavaScript.
- Изменено расположение некоторых файлов конфигурации. Например, ckeditor/plugins/styles/styles/default.js теперь просто ckeditor/styles.js.
Процедура обновления
Если вы ранее использовали CKEditor 3, вы можете либо попытаться создать сборку CKEditor 4, которая имитирует функциональность, используемую до или же выбрать желаемый установочный пакет CKEditor 4, а затем просто настроить свою конфигурацию. Смотри ссылку Compare Packages для изучения различий между ними.
Чтобы обновить CKEditor 3 до CKEditor 4, выполните следующие действия:
- Переименуйте существующую папку редактора в папку резервного копирования, например ckeditor_old.
- Загрузите последнюю версию с официального сайта.
- Самый простой способ - выбрать один из предустановленных пресетов, таких как Standard или Full.
- Если вы хотите включить какие-либо дополнительные плагины, используйте службу онлайн-строителя для создания пользовательской сборки.
- Извлеките (распакуйте) загруженный архив в каталог редактора, например с именем ckeditor.
- Просмотрите все файлы конфигурации, которые вы изменили в CKEditor 3 (см. Папку резервного копирования), и примените свои изменения к новым файлам CKEditor 4. Примерный список файлов, которых может затронуть обновление:
- config.js
- contents.css
- plugins/styles/styles/default.js
- файлы настраиваемых шаблонов
Готово!
P.S.: Скоро постараюсь сделать статью о переходе с 4-й версии на 5-ю.