3.2 примечания к выпуску

django CMS 3.2 представляет поддержку сенсорных экранов, значительные улучшения в структуре-доске, а также множество других обновлений и исправлений для фронтенда. Автозагрузка после изменения конфигурации apphook упростит жизнь всем пользователям.

Предупреждение

Обновление с предыдущих версий

В 3.2 внесены некоторые изменения, которые требуют действий, если вы переходите с предыдущей версии. Пожалуйста, прочитайте Обновление django CMS 3.1 до 3.2 для получения пошагового руководства по процессу обновления с 3.1 до 3.2.

Что нового в версии 3.2

  • new welcome page в помощь новым пользователям

  • поддержка сенсорных экранов для большинства интерфейсов редактирования, для размеров от небольших планшетов до настольных устройств

  • улучшенный и отполированный пользовательский интерфейс

  • столь необходимые усовершенствования структуры-щита

  • усовершенствования таких компонентов, как всплывающий редактор плагинов, боковой фрейм (теперь он называется overlay) и панель инструментов

  • значительное улучшение скорости загрузки, HTTP-запросов и размеров файлов

  • перезагрузка больше не требуется при изменении конфигурации apphook

  • новая система мастера контента, адаптируемая к произвольным типам контента

Изменения, требующие внимания

Поддержка сенсорного интерфейса

Общую информацию о поддержке сенсорного интерфейса см. в документации touch screen device notes.

Важно

Эти заметки о поддержке сенсорного интерфейса относятся только к интерфейсам администрирования и редактирования CMS django. Опубликованный сайт, обращенный к посетителям, полностью независим от этого, и ответственность за него несет разработчик сайта. Хороший сайт уже должен хорошо работать для своих посетителей, какой бы интерфейс они не использовали!

Многочисленные аспекты CMS и ее интерфейса были обновлены, чтобы хорошо работать с устройствами с сенсорным экраном. При этом необходимо помнить о некоторых ограничениях и предупреждениях.

Поддержка устройств

Маленькие устройства, такие как большинство телефонов, слишком малы для адекватного использования. Например, ваши Apple Watch, к сожалению, вряд ли смогут обеспечить очень хороший опыт редактирования django CMS.

Старые устройства часто не обладают достаточной производительностью для поддержки удобного отзывчивого интерфейса редактирования/администрирования на передней панели.

Осталось решить некоторые вопросы, связанные с конкретными устройствами. Некоторые из них относятся к CKEditor (текстовый редактор django CMS по умолчанию). Мы продолжим работу над ними, и они будут решены в одном из будущих релизов.

Информацию об устройствах, которые были протестированы и подтвердили свою работоспособность, а также об известных проблемах, влияющих на поддержку устройств с сенсорным экраном, см. в разделе Поддержка устройств.

Требуется обратная связь

Мы активно тестировали интерфейс CMS, но будем очень рады получить отзывы от других пользователей - отчеты об устройствах, сообщения об ошибках и общие предложения и мнения приветствуются.

Исправления ошибок

  • Исправлена проблема, при которой теги шаблона {% placeholder %} игнорировали параметр lang.

    Однако это может повлиять на поведение ваших шаблонов, поскольку теперь ранее игнорируемый параметр будет распознаваться. Если вы использовали параметр lang в этих тегах шаблона, это может повлиять на работу шаблонов: проверьте поведение ваших шаблонов после обновления.

Мастера контента

Мастера создания контента может помочь упростить производство контента и может быть создан для работы с контентом, не относящимся к CMS.

Краткое введение в использование мастера в качестве редактора содержимого см. в разделе user tutorial.

Переименование модулей cms_app, cms_toolbar, меню

cms_app.py, cms_toolbar.py и menu.py были переименованы в cms_apps.py, cms_toolbars.py и cms_menus.py для согласованности.

Старые имена все еще поддерживаются, но устарели; их поддержка будет прекращена в версии 3.4.

Необходимые действия

В собственных приложениях, использующих эти модули, переименуйте cms_app.py в cms_apps.py, cms_toolbar.py в cms_toolbars.py и menu.py в cms_menus.py.

Новый ApphookReloadMiddleware

До сих пор изменения в apphooks требовали перезапуска сервера, чтобы вступить в силу. Новый необязательный класс промежуточного ПО, cms.middleware.utils.ApphookReloadMiddleware, делает это автоматически.

Для разработчиков

Были реализованы различные улучшения, чтобы облегчить разработку с django CMS и для django CMS. К ним относятся:

  • улучшения в коде фронтенда, чтобы лучше соответствовать aldryn-boilerplate-bootstrap3

  • изменения в структуре каталогов для компонентов, связанных с фронтендом, таких как JavaScript и SASS.

  • Мы больше не используем develop.py; теперь мы используем manage.py для всех задач разработки. Примеры см. в Как внести свой вклад в исправление.

  • Мы переместили наш widgets.py JavaScript на static/cms/js/widgets.

Форматирование кода

Мы перешли от табуляции (в некоторых местах) к четырем пробелам всюду. Подробнее о форматировании см. в Внесение кода.

gulp.js

Теперь мы используем gulp.js для линтинга, сжатия и пакетирования файлов фронтенда.

.editorconfig файл

Мы добавили .editorconfig (в корне проекта), чтобы обеспечить подсказки для текстовых редакторов.

Автоматизированная проверка орфографии в документации

Документация теперь проверяется на орфографию. Команда make spelling теперь доступна при работе над документацией, а наша команда Travis Continuous Integration server также выполняет эти проверки.

См. раздел Правописание в документации.

Совет директоров новой структуры

Доска структуры стала чище и проще для понимания. Теперь она отображает элементы в виде дерева, а не в виде ряда вложенных друг в друга ячеек.

Вы можете включить старый внешний вид и поведение с помощью параметра CMS_TOOLBAR_SIMPLE_STRUCTURE_MODE (этот параметр будет удален в версии 3.3).

Замените боковую рамку на накладную

Боковой фрейм, который можно было разворачивать и сворачивать, чтобы открыть вид на администратора и другие элементы управления, был заменен на более простой и элегантный механизм наложения.

В документации API по-прежнему упоминается sideframe, потому что он вызывается тем же способом, и изменилось только поведение в браузере пользователя.

Другими словами, sideframe и overlay относятся к разным версиям одного и того же.

Новая стартовая страница

Новый режим запуска облегчает пользователям (особенно новым) погружение в редактирование при запуске нового сайта. Подробнее см. в Учебник.

Известные проблемы

sub-pages of a page with an apphook will be unreachable (404 page not found), из-за внутренних механизмов разрешения URL в CMS. Хотя маловероятно, что большинству пользователей понадобятся подобные подстраницы (обычно страница, подключенная к apphooked, создает свои собственные подстраницы), эта проблема будет решена в одном из ближайших релизов.

Обратно несовместимые изменения

См. документацию Frontend code.

Других известных несовместимых назад изменений нет.

Обновление django CMS 3.1 до 3.2

Пожалуйста, обратите внимание на все изменения, которые требуют принятия мер выше, и примите соответствующие меры.

Требуется миграция базы данных (новая модель, UrlconfRevision была добавлена как часть механизма перезагрузки apphook):

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

Затем запустите:

python manage.py migrate

мигрировать.

В остальном django CMS 3.2 представляет собой довольно простой путь обновления.

Ожидаемые изъятия

В django CMS 3.3:

Django 1.6, 1.7 и Python 2.6 больше не будут поддерживаться. Если вы все еще используете эти версии, вам настоятельно рекомендуется начать изучать процесс обновления до более новой версии.

Настройка CMS_TOOLBAR_SIMPLE_STRUCTURE_MODE будет удалена.

3.2.1 примечания к выпуску
Примечания к выпуску 3.1.5
Вернуться на верх