Примечания к выпуску 3.0¶

Новое редактирование фронтенда¶

django CMS 3.0 представляет новую систему редактирования фронтенда, а также настраиваемый скин администратора Django (djangocms_admin_style).

В новой системе Placeholders и их плагины больше не управляются в админке сайта, а только из фронтенда.

Кроме того, система теперь предлагает два вида редактирования:

• Вид содержание, для редактирования конфигурации и содержимого плагинов.

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

Заголовки страниц также можно изменять непосредственно во фронтенде.

Новая панель инструментов¶

Код панели инструментов был упрощен, а ее внешний вид обновлен. Теперь панель инструментов представляет собой более последовательный инструмент управления для добавления и изменения объектов. См. Как расширить панель инструментов.

Новые типы страниц¶

Теперь вы можете сохранять страницы как типы страниц. Если вы затем создадите новую страницу, вы можете выбрать тип страницы, и все плагины и содержимое будут предварительно заполнены.

Экспериментальная поддержка Python 3.3¶

Мы добавили экспериментальную поддержку Python 3.3. Поддержка Python 2.5 была прекращена.

Улучшенное многоязычное редактирование¶

Улучшения в среде django CMS для управления мультиязычным сайтом включают:

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

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

CMS_SEO_FIELDS¶

Настройка была удалена, вместе с набором полей SEO в админке.

• Максимальная длина поля meta_description теперь равна 155 для оптимальной интеграции с Google.

• page_title по умолчанию находится сверху.

• Поле meta_keywords было удалено, так как оно больше не служит никакой цели.

CMS_MENU_TITLE_OVERWRITE¶

Новое значение по умолчанию для этой настройки - True.

Языки отката плагинов¶

Теперь можно указывать запасные языки для плейсхолдера, если плейсхолдер пуст для текущего языка. Это должно быть активировано в CMS_PLACEHOLDER_CONF для каждого местозаполнителя. По умолчанию установлено значение False для сохранения поведения до версии 3.0.

переключатель языка¶

Тег шаблона language_chooser теперь отображает только общедоступные языки. Чтобы изменить язык на непубличный, воспользуйтесь выбором языка на панели инструментов.

Отмена и повтор¶

Если у вас установлен django-reversion, то теперь опции undo и redo доступны прямо на панели инструментов. Теперь они могут изменять содержимое плагина, а также содержимое страницы.

Плагины удалены¶

Мы удалили плагины из ядра. Это сделано не потому, что от вас не ждут их использования, а потому, что django CMS не должен навязывать своим пользователям ненужный выбор того, что устанавливать.

Наиболее значимым из этих удалений является cms.plugins.text.

Мы предоставляем djangocms-text-ckeditor, текстовый плагин на основе CKEditor. Он доступен по адресу https://github.com/django-cms/djangocms-text-ckeditor. Вы, конечно, можете использовать предпочитаемый вами редактор; доступны и другие.

Кроме того, мы удалили из ядра следующие плагины и перенесли их в отдельные репозитории.

Контекстные процессоры плагинов принимают новый аргумент¶

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

Apphooks¶

Apphooks переместились из заголовка в модель страницы. Это означает, что вы больше не можете иметь отдельные apphooks для каждого языка. Добавлено новое поле application instance name.

Если вы используете приложения apphook с app_name для пространств имен приложений, обязательно заполните поле пространства имен экземпляра application instance name, поскольку теперь требуется, чтобы пространство имен было определено, если вы используете пространства имен приложений.

Для дальнейшего чтения о пространствах имен приложений, пожалуйста, обратитесь к документации Django по этому вопросу по адресу https://docs.djangoproject.com/en/dev/topics/http/urls/#url-namespaces.

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

def my_view(request):
  current_app = resolve(request.path_info).namespace
  context = RequestContext(request, current_app=current_app)
  return render_to_response("my_templace.html", context_instance=context)

Подробности можно найти в Прикрепление приложения несколько раз.

PlaceholderAdmin¶

PlaceholderAdmin теперь является устаревшим. Вместо производных от admin.ModelAdmin введен новый класс-миксин PlaceholderAdminMixin, который должен использоваться вместе с admin.ModelAdmin. Поэтому при определении класса администратора модели, содержащего placeholder, теперь добавьте PlaceholderAdminMixin в список родительских классов вместе с admin.ModelAdmin.

В PlaceholderAdmin больше нет языковых вкладок, а редактор плагинов исчез. API плагина изменился и стал более последовательным. PageAdmin теперь использует тот же API, что и PlaceholderAdminMixin. Если ваше приложение взаимодействует с API плагина напрямую, обязательно прочитайте код и изменившиеся параметры. Если вы используете PlaceholderFields, вам следует добавить миксин PlaceholderAdminMixin, так как он предоставляет API для редактирования плагинов и заполнителей.

В будущем рабочий процесс должен выглядеть следующим образом:

1. Создавайте новые экземпляры моделей с помощью панели инструментов или через администратора.

2. Перейдите к представлению, которое представляет экземпляр модели, и добавьте содержимое с помощью редактирования во внешнем интерфейсе.

Разрешения на объекты-заполнители¶

В дополнение к разрешениям на уровне модели, Placeholder теперь проверяет, есть ли у пользователя разрешения на конкретный объект этой модели. Подробности можно найти здесь в Разрешения.

Места для размещения плагинов предварительно заполняются плагинами по умолчанию¶

В CMS_PLACEHOLDER_CONF для каждой конфигурации placeholder вы можете указать через „default_plugins“ список плагинов для автоматического добавления в placeholder, если он пуст. См. default_plugins in CMS_PLACEHOLDER_CONF.

Пользовательские ярлыки модулей и плагинов в пользовательском интерфейсе панели инструментов¶

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

Новая подкоманда copy-lang¶

Добавлена команда управления для копирования содержимого (заголовков и плагинов) с одного языка на другой.

Команда может быть запущена с помощью:

manage.py cms copy_lang from_lang to_lang

Пожалуйста, прочитайте cms copy lang перед использованием.

Фронтенд-редактор для моделей Django¶

Фронтенд-редактор доступен для любой модели Django; подробности см. в documentation.

Новый Page related_name к Site¶

Объект Page раньше имел по умолчанию related_name (page) к модели Site, что могло привести к конфликту с другими приложениями Django; related_name теперь djangocms_pages.

Переместите все теги шаблонов в cms_tags.¶

Все теги шаблонов теперь находятся в пространстве имен cms_tags, поэтому для использования любых тегов шаблонов cms вы можете просто сделать:

{% load cms_tags %}

getter и setter для переводимого содержимого плагина¶

Переводимое содержимое плагина теперь может быть прочитано и установлено через get_translatable_content() и set_translatable_content(). Более подробную информацию смотрите в Custom Plugins.

Больше никакой магии с именами таблиц БД для плагинов¶

Начиная с django CMS 2.0 имена таблиц плагинов начинались с cmsplugin_. Мы убрали это поведение в версии 3.0 и будем выводить предупреждение об устаревании со старым и новым именем таблицы. Если ваш плагин использует юг для миграций, создайте новую пустую схему миграции и переименуйте таблицу вручную.

>>> from cms.plugin_pool import plugin_pool
>>> plugin_pool.set_plugin_meta()

Добавлена поддержка пользовательских моделей пользователей¶

Начиная с Django 1.5 появилась возможность заменить модель пользователя по умолчанию на пользовательскую модель. Теперь это полностью поддерживается DjangoCMS, и, кроме того, в бегунок тестирования была добавлена новая опция, позволяющая указать модель пользователя для тестов (например, --user=customuserapp.User).

Кэширование страниц¶

Теперь страницы кэшируются по умолчанию. Вы можете отключить это поведение с помощью CMS_PAGE_CACHE.

Кэширование заполнителей¶

У плагинов появилось новое свойство по умолчанию: cache=True. Если все плагины, находящиеся на панели инструментов, установили это свойство в значение True, то вся панель инструментов будет кэшироваться, если панель инструментов не находится в режиме редактирования.

Кэширование плагинов¶

У плагинов появился новый атрибут: cache=True. Его значение по умолчанию может быть настроено с помощью CMS_PLUGIN_CACHE.

Защита от Clickjacking на каждой странице¶

Добавлена расширенная опция, которая управляет заголовком X-Frame-Options на каждой странице. По умолчанию он наследуется от родительской страницы. Если ни один из предков не укажет значение, заголовок не будет установлен, позволяя собственному промежуточному программному обеспечению Django обработать его (если включено).

Контекстная переменная CMS_TEMPLATE¶

В контексте теперь доступна новая переменная CMS_TEMPLATE: она содержит путь к текущему шаблону страницы. Подробнее см. в CMS_TEMPLATE reference.

placeholder_tags¶

placeholder_tags теперь устарел, тег шаблона render_placeholder теперь может быть загружен из библиотеки тегов шаблона cms_tags.

Использование placeholder_tags приведет к возникновению DeprecationWarning.

placeholder_tags будет удален в версии 3.1.

cms.context_processors.media¶

cms.context_processors.media теперь устарел, пожалуйста, используйте cms.context_processors.cms_settings, обновив TEMPLATE_CONTEXT_PROCESSORS в настройках

Использование cms.context_processors.media приведет к возникновению DeprecationWarning.

cms.context_processors.media будет удален в версии 3.1.