Fixed #19695 -- Retitle "Form Media" to "Form Assets".

You've got several options. If you want to piggyback on top of an add/change

form that Django automatically generates, you can attach arbitrary JavaScript

modules to the page via the model's class Admin :ref:`js parameter

<modeladmin-media-definitions>`. That parameter is a list of URLs, as strings,

<modeladmin-asset-definitions>`. That parameter is a list of URLs, as strings,

pointing to JavaScript modules that will be included within the admin form via

a ``<script>`` tag.

rendering. For more details, see the :doc:`TemplateResponse documentation

</ref/template-response>`.

.. _modeladmin-media-definitions:

.. _modeladmin-asset-definitions:

``ModelAdmin`` media definitions

``ModelAdmin`` asset definitions

--------------------------------

There are times where you would like add a bit of CSS and/or JavaScript to

the add/change views. This can be accomplished by using a Media inner class

the add/change views. This can be accomplished by using a ``Media`` inner class

on your ``ModelAdmin``::

    class ArticleAdmin(admin.ModelAdmin):

The :doc:`staticfiles app </ref/contrib/staticfiles>` prepends

:setting:`STATIC_URL` (or :setting:`MEDIA_URL` if :setting:`STATIC_URL` is

``None``) to any media paths. The same rules apply as :ref:`regular media

definitions on forms <form-media-paths>`.

``None``) to any asset paths. The same rules apply as :ref:`regular asset

definitions on forms <form-asset-paths>`.

jQuery

~~~~~~

Styling widget classes

^^^^^^^^^^^^^^^^^^^^^^

With widgets, it is possible to add media (``css`` and ``javascript``)

With widgets, it is possible to add assets (``css`` and ``javascript``)

and more deeply customize their appearance and behavior.

In a nutshell, you will need to subclass the widget and either

:ref:`define a class "Media" <media-as-a-static-definition>` as a member of the

subclass, or :ref:`create a property "media" <dynamic-property>`, returning an

instance of that class.

:ref:`define a "Media" inner class  <assets-as-a-static-definition>` or

:ref:`create a "media" property <dynamic-property>`.

These methods involve somewhat advanced Python programming and are described in

detail in the :doc:`Form Media </topics/forms/media>` topic guide.

detail in the :doc:`Form Assets </topics/forms/media>` topic guide.

.. _base-widget-classes:

Example: ``"/static/"`` or ``"http://static.example.com/"``

If not ``None``, this will be used as the base path for

:ref:`media definitions<form-media-paths>` and the

:ref:`asset definitions<form-asset-paths>` (the ``Media`` class) and the

:doc:`staticfiles app</ref/contrib/staticfiles>`.

It must end in a slash if set to a non-empty value.

  (``django.core.context_processors.static``) and renamed to

  :func:`~django.core.context_processors.static`.

* :ref:`form-media-paths` now uses :setting:`STATIC_URL` as the prefix

* :ref:`form-asset-paths` now uses :setting:`STATIC_URL` as the prefix

  **if the value is not None**, and falls back to the previously used

  :setting:`MEDIA_URL` setting otherwise.