Как использовать заполнители за пределами CMS¶

Интеграция администратора¶

Ваша модель с PlaceholderFields все еще может быть отредактирована в админке. Однако, любые поля PlaceholderFields в ней будут только доступны для редактирования из фронтенда. PlaceholderFields должен не присутствовать ни в одном атрибуте определения поля fieldsets, fields, form или другого ModelAdmin.

Чтобы обеспечить поддержку администратора для модели с PlaceholderField в админке вашего приложения, вам необходимо использовать миксин PlaceholderAdminMixin вместе с ModelAdmin. Обратите внимание, что PlaceholderAdminMixin должен предшествовать ModelAdmin в определении класса:

from django.contrib import admin
from cms.admin.placeholderadmin import PlaceholderAdminMixin
from myapp.models import MyModel

class MyModelAdmin(PlaceholderAdminMixin, admin.ModelAdmin):
    pass

admin.site.register(MyModel, MyModelAdmin)

I18N Placeholders¶

Из коробки PlaceholderAdminMixin поддерживает несколько языков и отображает языковые вкладки. Если вы расширите свою модель класса администратора, полученного из PlaceholderAdminMixin и перепишите change_form_template, посмотрите admin/placeholders/placeholder/change_form.html, чтобы увидеть, как отображать языковые вкладки.

Если вам нужно перевести и другие поля, в django CMS есть поддержка django-hvad. Если вы используете модель TranslatableModel, убедитесь, что не включаете поля-заполнители в число переведенных полей:

class MultilingualExample1(TranslatableModel):
    translations = TranslatedFields(
        title=models.CharField('title', max_length=255),
        description=models.CharField('description', max_length=255),
    )
    placeholder_1 = PlaceholderField('placeholder_1')

    def __unicode__(self):
        return self.title

Убедитесь, что при регистрации модели в админке вы объединили оба значения TranslatableAdmin и PlaceholderAdminMixin:

from cms.admin.placeholderadmin import PlaceholderAdminMixin
from django.contrib import admin
from hvad.admin import TranslatableAdmin
from myapp.models import MultilingualExample1

class MultilingualModelAdmin(TranslatableAdmin, PlaceholderAdminMixin, admin.ModelAdmin):
    pass

admin.site.register(MultilingualExample1, MultilingualModelAdmin)

Шаблоны¶

Для отображения заполнителя в шаблоне используется тег render_placeholder из библиотеки тегов шаблонов cms_tags:

{% load cms_tags %}

{% render_placeholder mymodel_instance.my_placeholder "640" %}

Тег render_placeholder принимает следующие параметры:

• PlaceholderField экземпляр

• width параметр для контекстно-зависимых плагинов (необязательно)

• language ключевое слово плюс language-code строка для отображения содержимого на указанном языке (необязательно)

Представление, в котором вы отображаете ваше поле-заполнитель, должно возвращать объект request в контексте. Обычно это достигается в приложениях Django с помощью RequestContext:

from django.shortcuts import get_object_or_404, render

def my_model_detail(request, id):
    object = get_object_or_404(MyModel, id=id)
    return render(request, 'my_model_detail.html', {
        'object': object,
    })

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

{% load cms_tags %}

{% render_placeholder mymodel_instance.my_placeholder language 'en' %}

Опции¶

Если вам нужно изменить ?edit на пользовательскую строку (скажем, ?admin_on), вы можете установить переменную CMS_TOOLBAR_URL__EDIT_ON в вашей settings.py на "admin_on".

Вы также можете изменить другие URL-адреса с аналогичными настройками:

• ?edit_off (CMS_TOOLBAR_URL__EDIT_OFF)

• ?build (CMS_TOOLBAR_URL__BUILD)

• ?toolbar_off (CMS_TOOLBAR_URL__DISABLE)

При изменении этих параметров, пожалуйста, будьте осторожны, поскольку вы можете случайно заменить зарезервированные строки в системе (например, ?page). Мы рекомендуем вам использовать безопасные уникальные строки для этой опции (например, secret_admin или company_name).

Разрешения¶

Чтобы иметь возможность редактировать заполнитель, пользователь должен быть членом staff и должен иметь права на редактирование модели, которая содержит PlaceholderField, или права для конкретного экземпляра этой модели. Необходимыми разрешениями для действий редактирования являются:

• к add: требуется add или change разрешение на связанную Модель или экземпляр.

• к change: требуется add или change разрешение на связанную Модель или экземпляр.

• к delete: требуется add или change или delete разрешение на связанную Модель или экземпляр.

С помощью этой логики пользователь, который может change экземпляр Модели, но не может add новый экземпляр Модели, сможет добавить некоторые заполнители или плагины к существующим экземплярам Модели.

Разрешения модели обычно добавляются через стандартное приложение Django auth и его интерфейс администратора. Разрешения на уровне объектов могут быть обработаны путем написания пользовательского бэкенда аутентификации, как описано в django docs.

Например, если есть UserProfile модель, которая содержит PlaceholderField, то пользовательский бэкенд может обратиться к has_perm методу (на модели), который предоставляет все права только текущему пользователю на основе UserProfile объекта пользователя:

def has_perm(self, user_obj, perm, obj=None):
    if not user_obj.is_staff:
        return False
    if isinstance(obj, UserProfile):
        if user_obj.get_profile()==obj:
            return True
    return False