[1.5.x] Fixed #19291 -- Completed deprecation of ADMIN_MEDIA_PREFIX.

Backport of 9b755a2 from master.
This commit is contained in:
Aymeric Augustin 2012-11-17 22:38:19 +01:00
parent 9fa6aa9534
commit a586f2a7e5
5 changed files with 10 additions and 32 deletions

View File

@ -110,9 +110,6 @@ class BaseSettings(object):
def __setattr__(self, name, value): def __setattr__(self, name, value):
if name in ("MEDIA_URL", "STATIC_URL") and value and not value.endswith('/'): if name in ("MEDIA_URL", "STATIC_URL") and value and not value.endswith('/'):
raise ImproperlyConfigured("If set, %s must end with a slash" % name) raise ImproperlyConfigured("If set, %s must end with a slash" % name)
elif name == "ADMIN_MEDIA_PREFIX":
warnings.warn("The ADMIN_MEDIA_PREFIX setting has been removed; "
"use STATIC_URL instead.", DeprecationWarning)
elif name == "ALLOWED_INCLUDE_ROOTS" and isinstance(value, six.string_types): elif name == "ALLOWED_INCLUDE_ROOTS" and isinstance(value, six.string_types):
raise ValueError("The ALLOWED_INCLUDE_ROOTS setting must be set " raise ValueError("The ALLOWED_INCLUDE_ROOTS setting must be set "
"to a tuple, not a string.") "to a tuple, not a string.")

View File

@ -1,15 +0,0 @@
import warnings
from django.template import Library
from django.templatetags.static import PrefixNode
register = Library()
@register.simple_tag
def admin_media_prefix():
"""
Returns the string contained in the setting ADMIN_MEDIA_PREFIX.
"""
warnings.warn(
"The admin_media_prefix template tag is deprecated. "
"Use the static template tag instead.", DeprecationWarning)
return PrefixNode.handle_simple("ADMIN_MEDIA_PREFIX")

View File

@ -140,6 +140,11 @@ these changes.
removed. In its place use removed. In its place use
:class:`~django.contrib.staticfiles.handlers.StaticFilesHandler`. :class:`~django.contrib.staticfiles.handlers.StaticFilesHandler`.
* The template tags library ``adminmedia`` and the template tag ``{%
admin_media_prefix %}`` will be removed in favor of the generic static files
handling. (This is faster than the usual deprecation path; see the
:doc:`Django 1.4 release notes</releases/1.4>`.)
* The :ttag:`url` and :ttag:`ssi` template tags will be * The :ttag:`url` and :ttag:`ssi` template tags will be
modified so that the first argument to each tag is a template variable, not modified so that the first argument to each tag is a template variable, not
an implied string. In 1.4, this behavior is provided by a version of the tag an implied string. In 1.4, this behavior is provided by a version of the tag
@ -232,10 +237,6 @@ these changes.
:setting:`LOGGING` setting should include this filter explicitly if :setting:`LOGGING` setting should include this filter explicitly if
it is desired. it is desired.
* The template tag
:func:`django.contrib.admin.templatetags.adminmedia.admin_media_prefix`
will be removed in favor of the generic static files handling.
* The builtin truncation functions :func:`django.utils.text.truncate_words` * The builtin truncation functions :func:`django.utils.text.truncate_words`
and :func:`django.utils.text.truncate_html_words` will be removed in and :func:`django.utils.text.truncate_html_words` will be removed in
favor of the ``django.utils.text.Truncator`` class. favor of the ``django.utils.text.Truncator`` class.

View File

@ -2210,16 +2210,6 @@ The default value for the X-Frame-Options header used by
Deprecated settings Deprecated settings
=================== ===================
.. setting:: ADMIN_MEDIA_PREFIX
ADMIN_MEDIA_PREFIX
------------------
.. deprecated:: 1.4
This setting has been obsoleted by the ``django.contrib.staticfiles`` app
integration. See the :doc:`Django 1.4 release notes</releases/1.4>` for
more information.
.. setting:: AUTH_PROFILE_MODULE .. setting:: AUTH_PROFILE_MODULE
AUTH_PROFILE_MODULE AUTH_PROFILE_MODULE

View File

@ -574,6 +574,11 @@ Miscellaneous
HTML validation against pre-HTML5 Strict DTDs, you should add a div around it HTML validation against pre-HTML5 Strict DTDs, you should add a div around it
in your pages. in your pages.
* The template tags library ``adminmedia``, which only contained the
deprecated template tag ``{% admin_media_prefix %}``, was removed.
Attempting to load it with ``{% load adminmedia %}`` will fail. If your
templates still contain that line you must remove it.
Features deprecated in 1.5 Features deprecated in 1.5
========================== ==========================