diff options
| author | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2023-11-28 20:04:21 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-11-28 20:04:21 +0100 |
| commit | a4931cd75a1780923b02e43475ba5447df3adb31 (patch) | |
| tree | df3412eb589599430990d1efa010dd999884ff68 /docs | |
| parent | 5f9e5c1b0d5680f793ba7646d52ffab9e2c3623f (diff) | |
Refs #34380 -- Added FORMS_URLFIELD_ASSUME_HTTPS transitional setting.
This allows early adoption of the new default "https".
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/internals/deprecation.txt | 2 | ||||
| -rw-r--r-- | docs/ref/forms/fields.txt | 4 | ||||
| -rw-r--r-- | docs/ref/settings.txt | 15 | ||||
| -rw-r--r-- | docs/releases/5.0.txt | 6 |
4 files changed, 25 insertions, 2 deletions
diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt index dd6712e936..edda364b73 100644 --- a/docs/internals/deprecation.txt +++ b/docs/internals/deprecation.txt @@ -53,6 +53,8 @@ details on these changes. * ``get_prefetcher()`` and ``prefetch_related_objects()`` will no longer fallback to ``get_prefetch_queryset()``. +* The ``FORMS_URLFIELD_ASSUME_HTTPS`` transitional setting will be removed. + See the :ref:`Django 5.1 release notes <deprecated-features-5.1>` for more details on these changes. diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt index 0f32df0ebb..a3e0bf1aba 100644 --- a/docs/ref/forms/fields.txt +++ b/docs/ref/forms/fields.txt @@ -1155,7 +1155,9 @@ For each field, we describe the default widget used if you don't specify .. deprecated:: 5.0 The default value for ``assume_scheme`` will change from ``"http"`` to - ``"https"`` in Django 6.0. + ``"https"`` in Django 6.0. Set :setting:`FORMS_URLFIELD_ASSUME_HTTPS` + transitional setting to ``True`` to opt into using ``"https"`` during + the Django 5.x release cycle. ``UUIDField`` ------------- diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 67f6482712..5d3e893cc7 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1675,6 +1675,20 @@ renderers are: * ``'``:class:`django.forms.renderers.Jinja2`\ ``'`` * ``'``:class:`django.forms.renderers.TemplatesSetting`\ ``'`` +.. setting:: FORMS_URLFIELD_ASSUME_HTTPS + +``FORMS_URLFIELD_ASSUME_HTTPS`` +------------------------------- + +.. versionadded:: 5.0 +.. deprecated:: 5.0 + +Default: ``False`` + +Set this transitional setting to ``True`` to opt into using ``"https"`` as the +new default value of :attr:`URLField.assume_scheme +<django.forms.URLField.assume_scheme>` during the Django 5.x release cycle. + .. setting:: FORMAT_MODULE_PATH ``FORMAT_MODULE_PATH`` @@ -3635,6 +3649,7 @@ File uploads Forms ----- * :setting:`FORM_RENDERER` +* :setting:`FORMS_URLFIELD_ASSUME_HTTPS` Globalization (``i18n``/``l10n``) --------------------------------- diff --git a/docs/releases/5.0.txt b/docs/releases/5.0.txt index b74a0f00c7..ebddec38e6 100644 --- a/docs/releases/5.0.txt +++ b/docs/releases/5.0.txt @@ -612,7 +612,11 @@ Miscellaneous * The ``ForeignObject.get_reverse_joining_columns()`` method is deprecated. * The default scheme for ``forms.URLField`` will change from ``"http"`` to - ``"https"`` in Django 6.0. + ``"https"`` in Django 6.0. Set :setting:`FORMS_URLFIELD_ASSUME_HTTPS` + transitional setting to ``True`` to opt into assuming ``"https"`` during the + Django 5.x release cycle. + +* ``FORMS_URLFIELD_ASSUME_HTTPS`` transitional setting is deprecated. * Support for calling ``format_html()`` without passing args or kwargs will be removed. |