Настройки
Wagtail использует следующие настройки в дополнение к базовым настройкам Django`:
Сайты
WAGTAIL_SITE_NAME
WAGTAIL_SITE_NAME = 'Stark Industries Skunkworks'
Это имя сайта Wagtail для отображения пользователям после входа в админку Wagtail.
WAGTAILADMIN_BASE_URL
WAGTAILADMIN_BASE_URL = 'http://example.com'
Это базовый URL, используемый сайтом админки Wagtail. Он обычно используется для генерации ссылок, которые нужно включить в уведомления по электронной почте.
Если эта настройка отсутствует, Wagtail попытается использовать request.site.root_url или имя хоста запроса.
Изменено в версии 3.0: Эта настройка ранее называлась BASE_URL и не была документирована. Использование BASE_URL будет удалено в будущих версиях.
Добавление слеша
WAGTAIL_APPEND_SLASH
# Don't add a trailing slash to Wagtail-served URLs WAGTAIL_APPEND_SLASH = False
Аналогично настройке Django APPEND_SLASH, эта настройка управляет тем, как Wagtail будет обрабатывать запросы, не заканчивающиеся слешем.
Когда WAGTAIL_APPEND_SLASH установлено в True (по умолчанию), запросы к страницам Wagtail без заключительного слеша будут перенаправлены Django через CommonMiddleware на URL со слешем.
Когда WAGTAIL_APPEND_SLASH установлено в False, запросы к страницам Wagtail будут обрабатываться как с, так и без заключительного слеша. Однако ссылки на страницы, сгенерированные Wagtail, не будут содержать слеш.
Примечание
Если вы используете настройку False, помните, что обслуживание страниц как с, так и без слеша может повлиять на возможность индексации сайта поисковыми системами. См. данную запись в блоге Google Search Central для получения дополнительной информации.
Поиск
WAGTAILSEARCH_BACKENDS
WAGTAILSEARCH_BACKENDS = {
'default': {
'BACKEND': 'wagtail.search.backends.elasticsearch5',
'INDEX': 'myapp'
}
}
Определяет поиск бэкенда. Для более подробного описания см. Бэкенды.
WAGTAILSEARCH_HITS_MAX_AGE
WAGTAILSEARCH_HITS_MAX_AGE = 14
Устанавливает количество дней (по умолчанию 7), в течение которых сохраняются журналы запросов поиска; они используются для определения популярных поисковых запросов для результатов поиска с приоритетом. Запросы, старше этого значения, будут удалены командой rebuild_references_index.
Международная локализация
Wagtail поддерживает международную локализация контента, сохраняя отдельные деревья страниц для каждого языка.
Для получения руководства по включению международной локализации на вашем сайте, см. руководство по конфигурации.
WAGTAIL_I18N_ENABLED
(boolean, по умолчанию False)
Когда установлено в True, будут включены возможности международной локализации Wagtail:
WAGTAIL_I18N_ENABLED = True
WAGTAIL_CONTENT_LANGUAGES
(список, по умолчанию [])
Список языков и/или регионов, на которых можно создавать контент Wagtail.
Например:
WAGTAIL_CONTENT_LANGUAGES = [
('en', _("English")),
('fr', _("French")),
]
Каждый элемент списка представляет собой пару (код языка, отображаемое имя). Код языка может быть только кодом языка (например, en, fr) или включать код региона (например, en-gb, fr-fr). Вы можете смешивать оба формата, если вам нужно локализовать только некоторые регионы, но не все.
Эта настройка соответствует структуре LANGUAGES Django, поэтому их можно установить на одно и то же значение:
LANGUAGES = WAGTAIL_CONTENT_LANGUAGES = [
('en-gb', _("English (United Kingdom)")),
('en-us', _("English (United States)")),
('es-es', _("Spanish (Spain)")),
('es-mx', _("Spanish (Mexico)")),
]
Однако, раздельная настройка позволяет настроить множество различных регионов на вашем сайте, но при этом использовать общий контент Wagtail (но отложить форматирование дат, валюты и т. д.):
LANGUAGES = [
('en', _("English (United Kingdom)")),
('en-us', _("English (United States)")),
('es', _("Spanish (Spain)")),
('es-mx', _("Spanish (Mexico)")),
]
WAGTAIL_CONTENT_LANGUAGES = [
('en', _("English")),
('es', _("Spanish")),
]
Это означает, что ваш сайт будет отвечать на URL https://www.mysite.com/es/ и https://www.mysite.com/es-MX/, но оба URL будут отображать контент из одного дерева «испанского» языка Wagtail.
Примечание
WAGTAIL_CONTENT_LANGUAGES должен быть подмножеством LANGUAGES
Обратите внимание, что все языки, присутствующие в WAGTAIL_CONTENT_LANGUAGES, также должны присутствовать в вашей настройке LANGUAGES. Это необходимо, чтобы Wagtail мог генерировать активные ссылки на эти страницы из контекста без перевода (например, интерфейс администрирования).
Встраивание
Wagtail поддерживает генерацию кода встраивания из URL-адресов контента на сторонних платформах, таких как YouTube или Twitter. По умолчанию Wagtail будет получать код встраивания напрямую с сайта соответствующего поставщика с помощью протокола oEmbed. Wagtail имеет встроенный список наиболее распространённых поставщиков.
Загрузку встраиваемых элементов можно полностью настроить с помощью настройки WAGTAILEMBEDS_FINDERS. Подробная документация находится в Настройка поиска встраиваемых элементов.
WAGTAILEMBEDS_RESPONSIVE_HTML
WAGTAILEMBEDS_RESPONSIVE_HTML = True
Добавляет class="responsive-object" и встроенный padding-bottom стиль для встраиваемых элементов, чтобы обеспечить их адаптивность. Подробности см. в Адаптивные встраиваемые элементы.
Панель мониторинга
WAGTAILADMIN_RECENT_EDITS_LIMIT
WAGTAILADMIN_RECENT_EDITS_LIMIT = 5
Эта настройка позволяет изменить количество элементов, отображаемых в разделе «Ваши последние правки» на панели мониторинга.
Общие настройки редактирования
WAGTAILADMIN_RICH_TEXT_EDITORS
WAGTAILADMIN_RICH_TEXT_EDITORS = {
'default': {
'WIDGET': 'wagtail.admin.rich_text.DraftailRichTextArea',
'OPTIONS': {
'features': ['h2', 'bold', 'italic', 'link', 'document-link']
}
},
'secondary': {
'WIDGET': 'some.external.RichTextEditor',
}
}
Настройте поведение полей с богатым текстом. По умолчанию RichTextField и RichTextBlock используют конфигурацию, заданную в ключе 'default', но это можно переопределить для каждого поля с помощью ключевого слова editor, например body = RichTextField(editor='secondary'). В каждом блоке конфигурации распознаются следующие поля:
-
WIDGET: Реализация виджета богатого текста для использования. Wagtail предоставляетwagtail.admin.rich_text.DraftailRichTextArea(современный расширяемый редактор, который обеспечивает структурированную разметку). Другие виджеты могут предоставляться сторонними пакетами. -
OPTIONS: Параметры конфигурации для передачи виджету. Распознаваемые параметры зависят от виджета, ноDraftailRichTextAreaпринимают списокfeaturesс указанием активных функций богатого текста (см. Ограничение функций в поле с богатым текстом).
Если редактор 'default' не указан, поля богатого текста, которые не указывают аргумент editor, будут использовать редактор Draftail с включенным набором функций по умолчанию.
WAGTAILADMIN_EXTERNAL_LINK_CONVERSION
WAGTAILADMIN_EXTERNAL_LINK_CONVERSION = 'exact'
Настройте поведение Wagtail при вводе URL-адреса внутренней страницы в выборе внешней ссылки. Возможные значения для этой настройки — 'all', 'exact', 'confirm, или ''. По умолчанию, 'all', Wagtail автоматически преобразует введённые URL-адреса, точно совпадающие с URL-адресами страниц, в соответствующие внутренние ссылки. Если URL-адрес неточный — например, введённый URL-адрес имеет параметры запроса — Wagtail подтвердит преобразование с пользователем. 'exact' означает, что неточные совпадения останутся внешними ссылками, и шаг подтверждения будет пропущен. 'confirm' означает, что каждое преобразование ссылки будет подтверждаться с пользователем, даже если совпадение точное. '' означает, что Wagtail не будет пытаться преобразовывать введённые URL-адреса во внутренние ссылки на страницы.
WAGTAIL_DATE_FORMAT, WAGTAIL_DATETIME_FORMAT, WAGTAIL_TIME_FORMAT
WAGTAIL_DATE_FORMAT = '%d.%m.%Y.' WAGTAIL_DATETIME_FORMAT = '%d.%m.%Y. %H:%M' WAGTAIL_TIME_FORMAT = '%H:%M'
Указывает формат даты, времени и даты и времени, который будет использоваться в полях ввода в Wagtail админке. Формат задаётся в синтаксисе модуля Python datetime и должен совпадать с одним из распознаваемых форматов в настройках DATE_INPUT_FORMATS, TIME_INPUT_FORMATS, или DATETIME_INPUT_FORMATS соответственно (см. DATE_INPUT_FORMATS).
Редактирование страниц
WAGTAILADMIN_COMMENTS_ENABLED
# Disable commenting WAGTAILADMIN_COMMENTS_ENABLED = False
Устанавливает, включены ли комментарии для страниц (по умолчанию True).
WAGTAIL_ALLOW_UNICODE_SLUGS
WAGTAIL_ALLOW_UNICODE_SLUGS = True
По умолчанию, ссылки страниц могут содержать любые буквенно-цифровые символы, включая нелатинские алфавиты. Установите значение в False, чтобы ограничить ссылки символами ASCII.
WAGTAIL_AUTO_UPDATE_PREVIEW
WAGTAIL_AUTO_UPDATE_PREVIEW = True
При включении панель предварительного просмотра в редакторе страниц автоматически обновляется при каждом изменении. Если установлено False, будет показана кнопка обновления, и предварительный просмотр будет обновляться только при нажатии на неё. По умолчанию это поведение включено.
Чтобы полностью отключить панель предварительного просмотра, установите режимы предварительного просмотра на пустое значение в вашей модели preview_modes = [].
WAGTAIL_AUTO_UPDATE_PREVIEW_INTERVAL
WAGTAIL_AUTO_UPDATE_PREVIEW_INTERVAL = 500
Интервал (в миллисекундах) проверки изменений, внесенных в редакторе страниц, перед обновлением предварительного просмотра. Значение по умолчанию 500.
WAGTAILADMIN_GLOBAL_PAGE_EDIT_LOCK
WAGTAILADMIN_GLOBAL_PAGE_EDIT_LOCK можно установить в True, чтобы предотвратить редактирование страниц, которые заблокированы.
WAGTAILADMIN_UNSAFE_PAGE_DELETION_LIMIT
WAGTAILADMIN_UNSAFE_PAGE_DELETION_LIMIT = 20
Это настройка включает дополнительный шаг подтверждения при удалении страницы с большим количеством дочерних страниц. Если количество страниц больше или равно этому пределу (по умолчанию 10), пользователь должен ввести имя сайта (как определено WAGTAIL_SITE_NAME).
Изображения
WAGTAILIMAGES_IMAGE_MODEL
WAGTAILIMAGES_IMAGE_MODEL = 'myapp.MyImage'
Эта настройка позволяет предоставить собственную модель изображений для использования в Wagtail, которая должна расширять встроенный класс AbstractImage.
WAGTAILIMAGES_IMAGE_FORM_BASE
WAGTAILIMAGES_IMAGE_FORM_BASE = 'myapp.forms.MyImageBaseForm'
Эта настройка позволяет предоставить собственную базу формы для изображений для использования в Wagtail, которая должна расширять встроенный класс BaseImageForm. Вы можете использовать ее для задания или переопределения виджетов, используемых в форме администратора.
WAGTAILIMAGES_MAX_UPLOAD_SIZE
WAGTAILIMAGES_MAX_UPLOAD_SIZE = 20 * 1024 * 1024 # 20MB
Эта настройка позволяет переопределить максимальный размер загрузки для изображений (в байтах). Если опущена, Wagtail вернется к значению по умолчанию 10 МБ.
WAGTAILIMAGES_MAX_IMAGE_PIXELS
WAGTAILIMAGES_MAX_IMAGE_PIXELS = 128000000 # 128 megapixels
Эта настройка позволяет переопределить максимальное количество пикселей, которое может иметь изображение. Если опущена, Wagtail вернется к значению по умолчанию 128 мегапикселей. Подсчет пикселей учитывает кадры анимации — например, 25-кадровая анимация размера 100x100 считается имеющей 100 _ 100 _ 25 = 250000 пикселей.
WAGTAILIMAGES_FEATURE_DETECTION_ENABLED
WAGTAILIMAGES_FEATURE_DETECTION_ENABLED = True
Эта настройка включает обнаружение функций после установки OpenCV, ознакомьтесь со всеми подробностями в документации Обнаружение функций.
WAGTAILIMAGES_INDEX_PAGE_SIZE
WAGTAILIMAGES_INDEX_PAGE_SIZE = 20
Указывает количество изображений на странице, отображаемых на главной странице списка изображений в административной панели Wagtail.
WAGTAILIMAGES_USAGE_PAGE_SIZE
WAGTAILIMAGES_USAGE_PAGE_SIZE = 20
Указывает количество элементов на странице при просмотре использования изображения.
WAGTAILIMAGES_CHOOSER_PAGE_SIZE
WAGTAILIMAGES_CHOOSER_PAGE_SIZE = 12
Указывает количество отображаемых изображений на странице в модальном окне выбора изображений.
WAGTAILIMAGES_RENDITION_STORAGE
WAGTAILIMAGES_RENDITION_STORAGE = 'myapp.backends.MyCustomStorage'
Эта настройка позволяет хранить визуализации изображений с помощью альтернативного хранилища. По умолчанию None, которое будет использовать стандартное хранилище Django FileSystemStorage.
Пользовательские классы хранилища должны быть подклассами django.core.files.storage.Storage. См. API хранилищ файлов Django.
Документы
WAGTAILDOCS_DOCUMENT_MODEL
WAGTAILDOCS_DOCUMENT_MODEL = 'myapp.MyDocument'
Эта настройка позволяет предоставить собственную модель документов для использования в Wagtail, которая должна расширять встроенный класс AbstractDocument.
WAGTAILDOCS_DOCUMENT_FORM_BASE
WAGTAILDOCS_DOCUMENT_FORM_BASE = 'myapp.forms.MyDocumentBaseForm'
Эта настройка позволяет предоставить собственную базу формы документов для использования в Wagtail, которая должна расширять встроенный класс BaseDocumentForm. Вы можете использовать ее для задания или переопределения виджетов, используемых в форме администратора.
WAGTAILDOCS_SERVE_METHOD
WAGTAILDOCS_SERVE_METHOD = 'redirect'
Определяет, как ссылки на загрузки документов будут связаны и переданы. Обычно запросы на документы отправляются через Django-представление для проверки конфиденциальности (см.) и потенциально для выполнения других задач, таких как подсчёт просмотров. Чтобы полностью защитить от обхода пользователями этой проверки, она должна происходить в том же запросе, где документ передаётся, однако это накладывает нагрузку на производительность, так как документ затем должен передаваться сервером Django. В частности, это снижает преимущество размещения документов на внешних хранилищах, таких как S3 или CDN.
По этой причине Wagtail предоставляет ряд методов передачи, которые жертвуют строгие проверки прав на производительность:
-
'direct'- ссылки на документы указывают непосредственно на URL, предоставленный базовым хранилищем, минуя Django-представление, которое выполняет проверку прав. Это наиболее полезно при развертывании сайтов в виде полностью статического HTML (например, с использованием wagtail-bakery или Gatsby). -
'redirect'- ссылки на документы указывают на Django-представление, которое проверяет права пользователя; в случае успеха оно перенаправляет на URL, предоставленный базовым хранилищем, чтобы документ мог быть загружен. Это наиболее подходит для удалённых хранилищ, таких как S3, так как это позволяет документу передаваться независимо от сервера Django. Обратите внимание, что если пользователь может угадать последний URL, он сможет обойти проверку прав; некоторые хранилища могут предоставить параметры конфигурации для генерации случайного или временного URL для смягчения этого. -
'serve_view'- ссылки на документы указывают на Django-представление, которое проверяет права пользователя и передаёт документ. Передача будет обрабатываться django-sendfile, если оно установлено и поддерживается вашей конфигурацией сервера, или как поток ответа Django, если нет. При использовании этого метода рекомендуется настроить ваш веб-сервер на *запрет* прямой передачи документов из их местоположения подMEDIA_ROOT, так как это предоставит способ обхода проверки прав.
Если WAGTAILDOCS_SERVE_METHOD не указано или установлено в None, метод по умолчанию — 'redirect' при использовании удалённого хранилища (хранилище, которое раскрывает URL, но не локальный путь к файлу), и 'serve_view' в противном случае. Наконец, некоторые хранилища могут вообще не раскрывать URL; в этом случае передача будет продолжена, как и для 'serve_view'.
WAGTAILDOCS_CONTENT_TYPES
WAGTAILDOCS_CONTENT_TYPES = {
'pdf': 'application/pdf',
'txt': 'text/plain',
}
Указывает тип MIME-контента, который будет возвращён для заданного расширения файла при использовании метода serve_view. Типы контента, не указанные здесь, будут угадываться с помощью функции Python mimetypes.guess_type или application/octet-stream при неудаче.
WAGTAILDOCS_INLINE_CONTENT_TYPES
WAGTAILDOCS_INLINE_CONTENT_TYPES = ['application/pdf', 'text/plain']
Список MIME-типов контента, которые будут отображаться внутри браузера (путем передачи заголовка HTTP Content-Disposition: inline) вместо передачи для загрузки, при использовании метода serve_view. По умолчанию application/pdf.
WAGTAILDOCS_EXTENSIONS
WAGTAILDOCS_EXTENSIONS = ['pdf', 'docx']
Список разрешённых расширений документов, которые будут проверены во время загрузки документа. Если это не указано, все расширения документов разрешены. Предупреждение: это не всегда гарантирует, что загружаемый файл является допустимым, так как файлы могут быть переименованы для получения расширения, независимо от содержащихся данных.
Управление пользователями
WAGTAIL_PASSWORD_MANAGEMENT_ENABLED
WAGTAIL_PASSWORD_MANAGEMENT_ENABLED = True
Указывает, разрешено ли пользователям менять свои пароли (по умолчанию включено).
WAGTAIL_PASSWORD_RESET_ENABLED
WAGTAIL_PASSWORD_RESET_ENABLED = True
Указывает, разрешено ли пользователям сбрасывать свои пароли. По умолчанию совпадает с WAGTAIL_PASSWORD_MANAGEMENT_ENABLED. Почтовые уведомления о сбросе пароля будут отправляться с адреса, указанного в настройке Django DEFAULT_FROM_EMAIL.
WAGTAILUSERS_PASSWORD_ENABLED
WAGTAILUSERS_PASSWORD_ENABLED = True
Указывает, отображаются ли поля пароля при создании или редактировании пользователей через Настройки -> Пользователи (по умолчанию включено). Установите значение False (вместе с WAGTAIL_PASSWORD_MANAGEMENT_ENABLED и WAGTAIL_PASSWORD_RESET_ENABLED), если ваши пользователи аутентифицированы через внешнюю систему, например, LDAP.
WAGTAILUSERS_PASSWORD_REQUIRED
WAGTAILUSERS_PASSWORD_REQUIRED = True
Указывает, является ли пароль обязательным полем при создании нового пользователя. По умолчанию True; игнорируется, если WAGTAILUSERS_PASSWORD_ENABLED равно false. Если это значение установлено в False, а поле пароля оставлено пустым при создании пользователя, у этого пользователя не будет используемого пароля; для входа в систему ему потребуется сбросить пароль (если WAGTAIL_PASSWORD_RESET_ENABLED равно True) или использовать альтернативную систему аутентификации, такую как LDAP (если она настроена).
WAGTAIL_EMAIL_MANAGEMENT_ENABLED
WAGTAIL_EMAIL_MANAGEMENT_ENABLED = True
Указывает, разрешено ли пользователям изменять свой адрес электронной почты (по умолчанию включено).
WAGTAILADMIN_USER_PASSWORD_RESET_FORM
WAGTAILADMIN_USER_PASSWORD_RESET_FORM = 'users.forms.PasswordResetForm'
Разрешает расширить стандартную форму PasswordResetForm дополнительными полями.
WAGTAIL_USER_EDIT_FORM
WAGTAIL_USER_EDIT_FORM = 'users.forms.CustomUserEditForm'
Разрешает переопределить стандартный класс UserEditForm пользовательской формой при использовании настраиваемой модели пользователя и необходимости дополнительных полей в форме редактирования пользователя.
Для получения дополнительной информации см. Настраиваемые модели пользователей.
WAGTAIL_USER_CREATION_FORM
WAGTAIL_USER_CREATION_FORM = 'users.forms.CustomUserCreationForm'
Разрешает переопределить стандартный класс UserCreationForm пользовательской формой при использовании настраиваемой модели пользователя и необходимости дополнительных полей в форме создания пользователя.
Для получения дополнительной информации см. Настраиваемые модели пользователей.
WAGTAIL_USER_CUSTOM_FIELDS
WAGTAIL_USER_CUSTOM_FIELDS = ['country']
Список дополнительных пользовательских полей, которые нужно добавить к стандартному списку.
Для получения дополнительной информации см. Настраиваемые модели пользователей.
WAGTAILADMIN_USER_LOGIN_FORM
WAGTAILADMIN_USER_LOGIN_FORM = 'users.forms.LoginForm'
Разрешает расширить стандартную форму LoginForm дополнительными полями.
Настройки пользователей
WAGTAIL_GRAVATAR_PROVIDER_URL
WAGTAIL_GRAVATAR_PROVIDER_URL = '//www.gravatar.com/avatar'
Если пользователь не загрузил фотографию профиля, Wagtail будет искать аватар, связанный с его адресом электронной почты на gravatar.com. Эта настройка позволяет указать альтернативный поставщик, например, robohash.org, или установить None, чтобы полностью отключить использование удаленных аватаров.
WAGTAIL_USER_TIME_ZONES
Авторизованные пользователи могут выбрать свою текущую часовую зону для интерфейса администратора в настройках учетной записи. Если пользователь не выбрал часовую зону, используется TIME_ZONE. (Обратите внимание, что часовые зоны применяются только к полям datetime, а не к обычным полям времени или даты. Это решение по разработке Django.)
Список часовых поясов по умолчанию — это список common_timezones из pytz. Можно переопределить этот список, используя настройку WAGTAIL_USER_TIME_ZONES. Если разрешено ноль или одна часовая зона, форма настроек учетной записи будет скрыта.
WAGTAIL_USER_TIME_ZONES = ['America/Chicago', 'Australia/Sydney', 'Europe/Rome']
WAGTAILADMIN_PERMITTED_LANGUAGES
Пользователи могут выбрать несколько языков для интерфейса администратора в настройках учетной записи. Список языков по умолчанию — все доступные языки Wagtail с покрытием не менее 90%. Для изменения установите WAGTAILADMIN_PERMITTED_LANGUAGES:
WAGTAILADMIN_PERMITTED_LANGUAGES = [('en', 'English'),
('pt', 'Portuguese')]
Поскольку синтаксис аналогичен синтаксису Django LANGUAGES, можно сделать так, чтобы пользователи могли выбирать только языки переднего плана:
LANGUAGES = WAGTAILADMIN_PERMITTED_LANGUAGES = [('en', 'English'), ('pt', 'Portuguese')]
Уведомления по электронной почте
WAGTAILADMIN_NOTIFICATION_FROM_EMAIL
WAGTAILADMIN_NOTIFICATION_FROM_EMAIL = 'wagtail@myhost.io'
Wagtail отправляет электронные уведомления, когда контент отправляется на модерацию и когда контент принимается или отклоняется. Эта настройка позволяет выбрать адрес электронной почты, с которого будут приходить эти автоматические уведомления. Если она отсутствует, Wagtail будет использовать настройку Django DEFAULT_FROM_EMAIL.
WAGTAILADMIN_NOTIFICATION_USE_HTML
WAGTAILADMIN_NOTIFICATION_USE_HTML = True
Уведомления по электронной почте отправляются в формате text/plain по умолчанию, измените это, чтобы использовать форматирование HTML.
WAGTAILADMIN_NOTIFICATION_INCLUDE_SUPERUSERS
WAGTAILADMIN_NOTIFICATION_INCLUDE_SUPERUSERS = False
Уведомления по электронной почте отправляются модераторам и суперпользователям по умолчанию. Можно изменить это, чтобы исключить суперпользователей и уведомлять только модераторов.
Уведомления о обновлениях Wagtail
WAGTAIL_ENABLE_UPDATE_CHECK
WAGTAIL_ENABLE_UPDATE_CHECK = True
Только для администраторов, Wagtail выполняет проверку на панели управления, чтобы узнать, доступны ли новые версии. Это также предоставляет команде Wagtail имя хоста вашего сайта Wagtail. Если вы не хотите получать уведомления об обновлениях или хотите, чтобы ваш сайт оставался неизвестным, вы можете отключить это настройкой.
Если администраторы должны быть проинформированы только о новых версиях с долгосрочной поддержкой (LTS), установите эту настройку в "lts" (настройка регистронезависима).
Аутентификация на переднем плане
PASSWORD_REQUIRED_TEMPLATE
PASSWORD_REQUIRED_TEMPLATE = 'myapp/password_required.html'
Это путь к шаблону Django, который будет использоваться для отображения формы «требуется пароль» при доступе пользователя к закрытой странице. Дополнительные сведения см. в документации Закрытые страницы.
DOCUMENT_PASSWORD_REQUIRED_TEMPLATE
DOCUMENT_PASSWORD_REQUIRED_TEMPLATE = 'myapp/document_password_required.html'
Аналогично вышесказанному, но для ограничений пароля на документах. Дополнительные сведения см. в документации Закрытые страницы.
WAGTAIL_FRONTEND_LOGIN_TEMPLATE
Основную страницу входа можно настроить с помощью настраиваемого шаблона.
WAGTAIL_FRONTEND_LOGIN_TEMPLATE = 'myapp/login.html'
WAGTAIL_FRONTEND_LOGIN_URL
Или страница входа может быть перенаправлением на внешний или внутренний URL.
WAGTAIL_FRONTEND_LOGIN_URL = '/accounts/login/'
Дополнительные сведения см. в документации Настройка страницы входа.
Статические файлы
WAGTAILADMIN_STATIC_FILE_VERSION_STRINGS
WAGTAILADMIN_STATIC_FILE_VERSION_STRINGS = False
URL статических файлов в административном интерфейсе Wagtail получают строку запроса с указанием версии в формате ?v=1a2b3c4d, чтобы предотвратить сохранение устаревших кэшированных копий файлов JavaScript и CSS после обновления Wagtail. Чтобы отключить это, установите WAGTAILADMIN_STATIC_FILE_VERSION_STRINGS в False.
API
Полную документацию по настройке API, включая эти параметры, см. в документации Руководство по настройке Wagtail API v2.
WAGTAILAPI_BASE_URL
WAGTAILAPI_BASE_URL = 'http://api.example.com/'
Требуется при использовании проверки кеша на переднем плане, используется для генерации абсолютных URL-адресов файлов документации и аннулирования кеша.
WAGTAILAPI_LIMIT_MAX
WAGTAILAPI_LIMIT_MAX = 500
Значение по умолчанию — 20, используется для изменения максимального числа результатов, которые пользователь может запросить за один раз, установлено в None для отсутствия ограничений.
WAGTAILAPI_SEARCH_ENABLED
WAGTAILAPI_SEARCH_ENABLED = False
Значение по умолчанию — true, установка в false отключит полнотекстовый поиск на всех конечных точках.
WAGTAILAPI_USE_FRONTENDCACHE
WAGTAILAPI_USE_FRONTENDCACHE = True
Требует установки приложения wagtailfrontendcache, указывает, что API должен использовать кеш переднего плана.
Кэш переднего плана
Полная документация по очистке кэша переднего плана, включая эти настройки, доступна по ссылке Очиститель кэша переднего плана.
WAGTAILFRONTENDCACHE
WAGTAILFRONTENDCACHE = {
'varnish': {
'BACKEND': 'wagtail.contrib.frontend_cache.backends.HTTPBackend',
'LOCATION': 'http://localhost:8000',
},
}
Полный список доступных опций смотрите по ссылке выше.
Примечание
WAGTAILFRONTENDCACHE_LOCATION больше не является предпочтительным способом установки расположения кэша, вместо этого установите LOCATION в элементе WAGTAILFRONTENDCACHE.
WAGTAILFRONTENDCACHE_LANGUAGES
WAGTAILFRONTENDCACHE_LANGUAGES = [l[0] for l in settings.LANGUAGES]
По умолчанию это пустой список, должен содержать список языков для очистки URL-адресов каждого языка при очистке URL-адреса. Для работы этой настройки settings.USE_I18N должно быть True.
Перенаправления
WAGTAIL_REDIRECTS_FILE_STORAGE
WAGTAIL_REDIRECTS_FILE_STORAGE = 'tmp_file'
По умолчанию импортер перенаправлений отслеживает загруженный файл как временный, но в некоторых средах (с балансировкой нагрузки/облачных средах) нельзя сохранить общий файл между средами. В таких случаях можно использовать встроенный кэш для хранения файла вместо этого.
WAGTAIL_REDIRECTS_FILE_STORAGE = 'cache'
Формостроитель
WAGTAILFORMS_HELP_TEXT_ALLOW_HTML
WAGTAILFORMS_HELP_TEXT_ALLOW_HTML = True
Если значение True, теги HTML в подсказках полей формы будут отображаться без экранирования (по умолчанию: False).
Предупреждение
Включение этой опции позволит редакторам вставлять произвольный HTML на страницу, включая скрипты, которые могут позволить редактору получить права администратора при просмотре страницы другим администратором. Включите эту настройку только если редакторы полностью надёжны.
Рабочий процесс
WAGTAIL_MODERATION_ENABLED
WAGTAIL_MODERATION_ENABLED = True
Определяет, отображается ли кнопка «Отправить на модерацию» в меню действий.
WAGTAIL_WORKFLOW_ENABLED
WAGTAIL_WORKFLOW_ENABLED = False
Указывает, включены ли рабочие процессы модерации (по умолчанию: True). При отключении редакторам больше не будет предоставлена возможность отправлять страницы в рабочий процесс, и области настроек для администраторов по настройке рабочих процессов и задач станут недоступны.
WAGTAIL_WORKFLOW_REQUIRE_REAPPROVAL_ON_EDIT
WAGTAIL_WORKFLOW_REQUIRE_REAPPROVAL_ON_EDIT = True
Рабочие процессы модерации могут использоваться в двух режимах. Первый режим требует, чтобы все задачи утвердили конкретную ревизию страницы для завершения рабочего процесса. В результате, если изменения внесены на страницу во время модерации, все одобренные задачи должны быть повторно одобрены для новой ревизии до завершения рабочего процесса. Это по умолчанию, WAGTAIL_WORKFLOW_REQUIRE_REAPPROVAL_ON_EDIT = True . Второй режим не требует повторного утверждения: если изменения внесены, когда задачи уже одобрены, эти задачи не нужно повторно утверждать. Это больше подходит для иерархической системы рабочих процессов. Чтобы использовать рабочие процессы в этом режиме, установите WAGTAIL_WORKFLOW_REQUIRE_REAPPROVAL_ON_EDIT = False.
WAGTAIL_FINISH_WORKFLOW_ACTION
WAGTAIL_FINISH_WORKFLOW_ACTION = 'wagtail.workflows.publish_workflow_state'
Это задаёт функцию, которая будет вызвана при успешном завершении рабочего процесса — по умолчанию wagtail.workflows.publish_workflow_state, которая публикует страницу. Функция должна принимать объект WorkflowState в качестве единственного позиционного аргумента.
WAGTAIL_WORKFLOW_CANCEL_ON_PUBLISH
WAGTAIL_WORKFLOW_CANCEL_ON_PUBLISH = True
Это определяет, отменяет ли публикация страницы текущий рабочий процесс (если True) или не затрагивает рабочий процесс (False). Отключение этого может быть полезным, если на вашем сайте есть длинные многоступенчатые рабочие процессы, и вы хотите иметь возможность публиковать срочные обновления страниц, пока рабочий процесс продолжает предоставлять менее срочные отзывы.
© 2014-present Torchbox Ltd and individual contributors.
All rights are reserved.
Licensed under the BSD License.
https://docs.wagtail.org/en/stable/reference/settings.html