mirror of
https://github.com/pacnpal/django-anymail.git
synced 2025-12-21 12:21:06 -05:00
@@ -18,19 +18,28 @@ that will change. (Warnings appear in the console when running Django
|
||||
in debug mode.)
|
||||
|
||||
|
||||
**Djrill Admin site**
|
||||
Breaking Changes in Djrill 2.0
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Djrill 2.0 will remove the custom Djrill admin site. It duplicates
|
||||
information from Mandrill's dashboard, most Djrill users are unaware
|
||||
it exists, and it has caused problems tracking Django admin changes.
|
||||
Removed DjrillAdminSite
|
||||
Earlier versions of Djrill included a custom Django admin site.
|
||||
The equivalent functionality is available in Mandrill's dashboard.
|
||||
|
||||
Drill 1.4 will report a DeprecationWarning when you try to load
|
||||
the `DjrillAdminSite`. You should remove it from your code.
|
||||
You should remove any references to DjrillAdminSite from your
|
||||
:file:`urls.py`. E.g.::
|
||||
|
||||
Also, if you changed Django's :setting:`INSTALLED_APPS` setting to use
|
||||
`'django.contrib.admin.apps.SimpleAdminConfig'`, you may be able to
|
||||
switch that back to `'django.contrib.admin'` and let Django
|
||||
handle the admin.autodiscover() for you.
|
||||
.. code-block:: python
|
||||
|
||||
# Remove these:
|
||||
from djrill import DjrillAdminSite
|
||||
admin.site = DjrillAdminSite()
|
||||
|
||||
Also, on Django 1.7 or later if you had switched your :setting:`INSTALLED_APPS`
|
||||
(in :file:`settings.py`) to use ``'django.contrib.admin.apps.SimpleAdminConfig'``
|
||||
you *may* want to switch back to the default ``'django.contrib.admin'``
|
||||
and remove the call to ``admin.autodiscover()`` in your :file:`urls.py`.
|
||||
(Do this only if you changed to SimpleAdminConfig for Djrill, and aren't
|
||||
creating custom admin sites for any other Django apps you use.)
|
||||
|
||||
|
||||
**Dates in merge data and other attributes**
|
||||
|
||||
@@ -36,9 +36,7 @@ Thanks
|
||||
------
|
||||
|
||||
Thanks to the MailChimp team for asking us to build this nifty little app, and to all of Djrill's
|
||||
:doc:`contributors <contributing>`. Also thanks to James Socol on Github for his django-adminplus_
|
||||
library that got us off on the right foot for the custom admin views.
|
||||
:doc:`contributors <contributing>`.
|
||||
Oh, and, of course, Kenneth Reitz for the awesome requests_ library.
|
||||
|
||||
.. _requests: http://docs.python-requests.org
|
||||
.. _django-adminplus: https://github.com/jsocol/django-adminplus
|
||||
|
||||
@@ -65,47 +65,3 @@ with :ref:`Mandrill-specific sending options <mandrill-send-support>`.)
|
||||
|
||||
|
||||
.. _subaccounts: http://help.mandrill.com/entries/25523278-What-are-subaccounts-
|
||||
|
||||
|
||||
Admin (Optional)
|
||||
----------------
|
||||
|
||||
Djrill includes an optional Django admin interface, which allows you to:
|
||||
|
||||
* Check the status of your Mandrill API connection
|
||||
* See stats on email senders, tags and urls
|
||||
|
||||
If you want to enable the Djrill admin interface, edit your base :file:`urls.py`:
|
||||
|
||||
.. code-block:: python
|
||||
:emphasize-lines: 4,6
|
||||
|
||||
...
|
||||
from django.contrib import admin
|
||||
|
||||
from djrill import DjrillAdminSite
|
||||
|
||||
admin.site = DjrillAdminSite()
|
||||
admin.autodiscover()
|
||||
...
|
||||
|
||||
urlpatterns = [
|
||||
...
|
||||
url(r'^admin/', include(admin.site.urls)),
|
||||
]
|
||||
|
||||
If you are on **Django 1.7 or later,** you will also need to change the config used
|
||||
by the django.contrib.admin app in your :file:`settings.py`:
|
||||
|
||||
.. code-block:: python
|
||||
:emphasize-lines: 4
|
||||
|
||||
...
|
||||
INSTALLED_APPS = (
|
||||
# For Django 1.7+, use SimpleAdminConfig because we'll call autodiscover...
|
||||
'django.contrib.admin.apps.SimpleAdminConfig', # instead of 'django.contrib.admin'
|
||||
...
|
||||
'djrill',
|
||||
...
|
||||
)
|
||||
...
|
||||
|
||||
Reference in New Issue
Block a user