Настройки
Wagtail использует следующие настройки в дополнение к базовым настройкам Django:
Имя сайта
WAGTAIL_SITE_NAME
WAGTAIL_SITE_NAME = 'Stark Industries Skunkworks'
Это удобочитаемое имя вашей установки Wagtail, которое приветствует пользователей при входе в админку Wagtail.
Добавлять слеш
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, которые опускают конечный слеш, будут перенаправлены посредством CommonMiddleware на URL с конечным слешем.
Когда WAGTAIL_APPEND_SLASH установлено в False, запросы к страницам Wagtail будут обрабатываться как с, так и без конечного слеша. Однако ссылки на страницы, генерируемые Wagtail, не будут содержать конечный слеш.
Примечание
Если вы используете настройку False, помните, что обработка страниц как с, так и без слешей может повлиять на способность поисковых систем индексировать ваш сайт. Подробнее см. эту запись в блоге Google Search Central.
Базовый URL админки
WAGTAILADMIN_BASE_URL
WAGTAILADMIN_BASE_URL = 'http://example.com/'
Это базовый URL, используемый сайтом администрирования Wagtail. Он обычно используется для генерации ссылок, которые включаются в уведомления по электронной почте.
Если эта настройка отсутствует, Wagtail попытается использовать значение по умолчанию request.site.root_url или имя хоста запроса.
Изменено в версии 3.0: Эта настройка ранее называлась BASE_URL и не была документирована, использование BASE_URL будет удалено в будущих релизах.
Поиск
WAGTAILSEARCH_BACKENDS
WAGTAILSEARCH_BACKENDS = {
'default': {
'BACKEND': 'wagtail.search.backends.elasticsearch5',
'INDEX': 'myapp'
}
}
Определение поискового бэкенда. Для получения полной информации см. Бэкенды.
WAGTAILSEARCH_HITS_MAX_AGE
WAGTAILSEARCH_HITS_MAX_AGE = 14
Установите количество дней (по умолчанию 7), в течение которых сохраняются журналы поисковых запросов; они используются для определения популярных поисковых терминов для результатов поиска с продвижением. Запросы, старше этого периода, будут удалены командой search_garbage_collect.
Международные настройки
Wagtail поддерживает международные настройки контента, сохраняя отдельные деревья страниц для каждого языка.
Руководство по включению международных настроек на вашем сайте см. в руководстве по настройке.
WAGTAIL_I18N_ENABLED
(булево, по умолчанию False)
При установке в True, функции международных настроек Wagtail будут включены:
WAGTAIL_I18N_ENABLED = True
WAGTAIL_CONTENT_LANGUAGES
(список, по умолчанию [])
Список языков и/или локалей, в которых можно создавать контент Wagtail.
Например:
WAGTAIL_CONTENT_LANGUAGES = [
('en', _("English")),
('fr', _("French")),
]
Каждый элемент списка представляет собой пару из кода языка и его отображаемого названия. Код языка может быть просто кодом языка (например, en, fr) или включать код региона (например, en-gb, fr-fr). Вы можете комбинировать оба формата, если вам требуется локализация только в некоторых регионах.
Эта настройка следует той же структуре, что и настройка Django LANGUAGES, поэтому их можно установить одинаково:
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/, но оба будут отображать контент из одного дерева «испанский» в Wagtail.
Примечание
WAGTAIL_CONTENT_LANGUAGES должен быть подмножеством LANGUAGES
Обратите внимание, что все языки, существующие в WAGTAIL_CONTENT_LANGUAGES, также должны присутствовать в вашей настройке LANGUAGES. Это необходимо для того, чтобы Wagtail мог генерировать действующие URL-адреса этих страниц из контекста без перевода (например, интерфейс администрирования).
Вставки
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_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_MODERATION_ENABLED
WAGTAIL_MODERATION_ENABLED = True
Изменяет отображение кнопки «Отправить на модерацию» в меню действий.
Изображения
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 # i.e. 20MB
Эта настройка позволяет переопределить максимальный размер загружаемых изображений (в байтах). Если эта настройка отсутствует, Wagtail будет использовать значение по умолчанию 10 МБ.
WAGTAILIMAGES_MAX_IMAGE_PIXELS
WAGTAILIMAGES_MAX_IMAGE_PIXELS = 128000000 # i.e. 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
Указывает количество элементов на странице при просмотре использования изображения (см. WAGTAIL_USAGE_COUNT_ENABLED).
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_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. Если вы предпочитаете не получать уведомления о обновлениях или если вы хотите, чтобы ваш сайт оставался неизвестным, вы можете отключить его с помощью этой настройки.
Закрытые страницы/документы
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/'
Для получения более подробной информации см. документацию Настройка страницы входа.
Ограничение тегов
TAG_LIMIT
TAG_LIMIT = 5
Ограничение количества тегов, которые можно добавить к модели тегов (django-taggit). Значение по умолчанию None, что означает отсутствие ограничения на теги.
Unicode-адреса страниц
WAGTAIL_ALLOW_UNICODE_SLUGS
WAGTAIL_ALLOW_UNICODE_SLUGS = True
По умолчанию адреса страниц могут содержать любые буквенно-цифровые символы, включая нелатинские алфавиты. Установите это значение в False, чтобы ограничить адреса символами ASCII.
Автоматическое обновление предварительного просмотра
WAGTAIL_AUTO_UPDATE_PREVIEW
WAGTAIL_AUTO_UPDATE_PREVIEW = False
При включении данные с отредактированной страницы автоматически отправляются на сервер при каждом изменении, даже без сохранения. Таким образом, пользователям не нужно нажимать «Предварительный просмотр», чтобы обновить содержимое страницы предварительного просмотра. Однако вкладка предварительного просмотра страницы не обновляется автоматически, пользователям нужно делать это вручную. По умолчанию это поведение отключено.
Формы редактирования пользователей
См. Настраиваемые модели пользователей.
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']
Список дополнительных пользовательских полей, которые будут добавлены к стандартному списку.
Использование изображений, документов и сниппетов
WAGTAIL_USAGE_COUNT_ENABLED
WAGTAIL_USAGE_COUNT_ENABLED = True
При включении Wagtail отображает, где на сайте используется конкретное изображение, документ или сниппет. По умолчанию это отключено, так как это генерирует запрос, который может выполняться медленно на сайтах с большим количеством страниц.
Ссылка появится на странице редактирования (в крайнем правом столбце), показывая, сколько раз элемент используется. Нажатие на эту ссылку перенаправит вас на страницу «Использование», где показано, где используется сниппет, документ или изображение.
Ссылка также отображается на странице удаления, над кнопкой «Удалить».
Примечание
Подсчет использования применяется только к прямым (базовым) ссылкам. Использование документов, изображений и сниппетов внутри StreamFields или полей rich text не учитывается.
Ввод дат и дат и времени
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).
Временные зоны
Авторизованные пользователи могут выбрать свою текущую временную зону для админ-интерфейса в настройках учетной записи. Если пользователь не выбрал временную зону, будет использоваться TIME_ZONE. (Обратите внимание, что временные зоны применяются только к полям datetime, а не к полям времени или даты. Это решение Django.)
WAGTAIL_USER_TIME_ZONES
Список временных зон по умолчанию — это список common_timezones из pytz. Этот список можно переопределить с помощью настройки WAGTAIL_USER_TIME_ZONES. Если разрешено ноль или одна временная зона, форма настроек учетной записи будет скрыта.
WAGTAIL_USER_TIME_ZONES = ['America/Chicago', 'Australia/Sydney', 'Europe/Rome']
Языки админ-панели
Пользователи могут выбрать несколько языков для админ-интерфейса в настройках учетной записи. Список языков по умолчанию — все доступные языки Wagtail с покрытием не менее 90%. Чтобы изменить его, установите WAGTAILADMIN_PERMITTED_LANGUAGES.
WAGTAILADMIN_PERMITTED_LANGUAGES
WAGTAILADMIN_PERMITTED_LANGUAGES = [('en', 'English'),
('pt', 'Portuguese')]
Поскольку синтаксис аналогичен Django LANGUAGES, вы можете сделать так, чтобы пользователи могли выбирать только языки переднего плана:
LANGUAGES = WAGTAILADMIN_PERMITTED_LANGUAGES = [('en', 'English'),
('pt', 'Portuguese')]
Статические файлы
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 для работы.
Редактор богатого текста
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',
}
}
Настройка поведения полей rich text. По умолчанию RichTextField и RichTextBlock используют конфигурацию, указанную в ключе 'default', но это можно переопределить для каждого поля с помощью ключевого аргумента editor, например, body = RichTextField(editor='secondary'). В каждом блоке конфигурации распознаются следующие поля:
-
WIDGET: Реализация виджета rich text, которую нужно использовать. Wagtail предоставляетwagtail.admin.rich_text.DraftailRichTextArea(современный расширяемый редактор, который обеспечивает хорошо структурированную разметку). Другие виджеты могут предоставляться сторонними пакетами. -
OPTIONS: Параметры конфигурации для передачи виджету. Распознаваемые параметры зависят от виджета, ноDraftailRichTextAreaпринимает списокfeaturesактивных функций богатого текста (см. Ограничение функций в поле богатого текста).
Если редактор 'default' не указан, поля rich text, не указывающие аргумент editor, будут использовать редактор Draftail с включенным набором функций по умолчанию.
WAGTAILADMIN_EXTERNAL_LINK_CONVERSION
WAGTAILADMIN_EXTERNAL_LINK_CONVERSION = 'exact'
Настройка поведения Wagtail при вводе внутреннего URL-адреса страницы в выборе внешней ссылки. Возможные значения для этой настройки — 'all', 'exact', 'confirm, или ''. Значение по умолчанию, 'all', означает, что Wagtail автоматически преобразует переданные URL-адреса, которые точно совпадают с URL-адресами страниц, в соответствующие внутренние ссылки. Если URL-адрес неточный — например, переданный URL-адрес имеет параметры запроса — Wagtail подтвердит преобразование с пользователем. 'confirm' означает, что все неточные совпадения останутся внешними URL-адресами, а шаг подтверждения будет пропущен. '' означает, что каждый перевод ссылки будет подтверждён с пользователем, даже если совпадение точное. '' означает, что Wagtail не будет пытаться преобразовать вводимые URL-адреса во внутренние ссылки на страницы.
Блокировка страниц
WAGTAILADMIN_GLOBAL_PAGE_EDIT_LOCK
WAGTAILADMIN_GLOBAL_PAGE_EDIT_LOCK может быть установлено в 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_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/v3.0.3/reference/settings.html
Комментарии
WAGTAILADMIN_COMMENTS_ENABLEDУстанавливает, включены ли комментарии для страниц (
Trueпо умолчанию).