Spec-Zone.ru › Wagtail 3

Настраиваемые модели изображений

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

Для этого необходимо добавить две модели в ваш проект:

  • Саму модель изображения, которая наследуется от wagtail.images.models.AbstractImage. Здесь вы добавите свои дополнительные поля.
  • Модель представлений, которая наследуется от wagtail.images.models.AbstractRendition. Она используется для хранения представлений новой модели.

Вот пример:

# models.py
from django.db import models

from wagtail.images.models import Image, AbstractImage, AbstractRendition


class CustomImage(AbstractImage):
    # Add any extra fields to image here

    # eg. To add a caption field:
    # caption = models.CharField(max_length=255, blank=True)

    admin_form_fields = Image.admin_form_fields + (
        # Then add the field names here to make them appear in the form:
        # 'caption',
    )


class CustomRendition(AbstractRendition):
    image = models.ForeignKey(CustomImage, on_delete=models.CASCADE, related_name='renditions')

    class Meta:
        unique_together = (
            ('image', 'filter_spec', 'focal_point_key'),
        )

Затем установите настройку WAGTAILIMAGES_IMAGE_MODEL для указания на неё:

WAGTAILIMAGES_IMAGE_MODEL = 'images.CustomImage'

Миграция с встроенной моделью изображений

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

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

Обращение к модели изображений

© 2014-present Torchbox Ltd and individual contributors.
All rights are reserved.
Licensed under the BSD License.
https://docs.wagtail.org/en/v3.0.3/advanced_topics/images/custom_image_model.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API