Модель Справочник

wagtail.core.models разделен на подмодули для поддержания. Все определения, предназначенные для публичного использования, должны импортироваться сюда (с комментариями ‘noqa’, если необходимо), а внешний код должен продолжать импортировать их из wagtail.core.models (например, from wagtail.core.models import Site, а не from wagtail.core.models.sites import Site.)

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

Этот документ содержит справочную информацию по классам моделей в модуле wagtailcore.

Page

Базовые поля данных

Методы и свойства

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

Site

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

Функция find_for_request() возвращает объект Site, который будет обрабатывать данный HTTP-запрос.

Базовые поля данных

Методы и свойства

Локализация

Модель Locale определяет набор языков и/или локалей, которые могут быть использованы на сайте. Каждый Locale запись соответствует «коду языка», определенному в настройке WAGTAIL_CONTENT_LANGUAGES.

Wagtail первоначально настроит один Locale в качестве языка по умолчанию для всего существующего контента. Эта первая локали автоматически выберет значение из WAGTAIL_CONTENT_LANGUAGES, которое наиболее точно соответствует коду языка сайта по умолчанию, определенному в LANGUAGE_CODE. Если код первичного языка будет изменен позже, Wagtail не автоматически создаст новую запись Locale или обновит существующую.

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

Изменение WAGTAIL_CONTENT_LANGUAGES

Языки могут добавляться или удаляться из WAGTAIL_CONTENT_LANGUAGES со временем.

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

Методы и свойства

Миксин Переводимого

TranslatableMixin — это абстрактная модель, которую можно добавить к любой модели Django, которая не является страницей, чтобы сделать ее переводимой. Страницы уже включают этот миксин, поэтому добавлять его не нужно.

Методы и свойства

Поля locale и translation_key имеют ограничение уникального ключа, чтобы предотвратить перевод объекта на один и тот же язык более одного раза.

PageRevision

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

• Ревизии могут быть созданы из любого объекта Page, вызвав его метод save_revision()
• Содержание страницы сериализовано в формате JSON и хранится в поле content_json
• Вы можете получить PageRevision как объект Page, вызвав метод as_page_object()

Базовые поля данных

Менеджеры

Методы и свойства

GroupPagePermission

Базовые поля данных

PageViewRestriction

Базовые поля данных

Orderable (абстрактный)

Базовые поля данных

Workflow

Рабочие процессы представляют собой последовательности задач, которые должны быть одобрены для выполнения действия на странице — обычно публикации.

Базовые поля данных

Методы и свойства

WorkflowState

Состояния рабочих процессов представляют собой состояние запущенного рабочего процесса на странице.

Базовые поля данных

Методы и свойства

Task

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

Базовые поля данных

Методы и свойства

TaskState

Состояния задач хранят информацию о состоянии выполнения задачи на конкретной ревизии страницы.

Базовые поля данных

Методы и свойства

WorkflowTask

Представляет порядок задачи в определенном рабочем процессе.

Базовые поля данных

WorkflowPage

Представляет назначение рабочего процесса странице и ее потомкам.

Базовые поля данных

BaseLogEntry

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

Базовые поля данных

Методы и свойства

PageLogEntry

Представляет запись об действии, выполненном над Page, наследует от BaseLogEntry.

Базовые поля данных

Comment

Представляет комментарий к странице.

Базовые поля данных

CommentReply

Представляет ответ к комментарию.

Базовые поля данных

PageSubscription

Представляет подписку пользователя на уведомления по электронной почте о событиях на странице. В настоящее время используется только для уведомлений о комментариях.

Базовые поля данных