1
0
mirror of https://github.com/django/django.git synced 2025-07-04 01:39:20 +00:00

newforms-admin: Added more to docs/admin.txt

git-svn-id: http://code.djangoproject.com/svn/django/branches/newforms-admin@6328 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2007-09-15 20:28:26 +00:00
parent e51a819595
commit 0b1febe248

View File

@ -12,5 +12,58 @@ Django's admin interface.
The admin site has been refactored significantly since Django 0.96. This
document describes the newest version of the admin site, which allows for
much richer customization. If you've kept up with Django development, you
may have heard this described as "newforms-admin."
much richer customization. If you follow the development of Django itself,
you may have heard this described as "newforms-admin."
Overview
========
There are four steps in activating the Django admin site:
1. Determine which of your application's models should be editable in the
admin interface.
2. For each of those models, optionally create a ``ModelAdmin`` class that
encapsulates the customized admin functionality and options for that
particular model.
3. Instantiate an ``AdminSite`` and tell it about each of your models and
``ModelAdmin`` classes.
4. Hook the ``AdminSite`` instance into your URLconf.
``ModelAdmin`` objects
======================
``AdminSite`` objects
=====================
Hooking ``AdminSite`` instances into your URLconf
=================================================
The last step in setting up the Django admin is to hook your ``AdminSite``
instance into your URLconf. Do this by pointing a given URL at the
``AdminSite.root`` method.
In this example, we register the ``AdminSite`` instance
``myproject.admin.admin_site`` at the URL ``/admin/`` ::
from django.conf.urls.defaults import *
from myproject.admin import admin_site
urlpatterns = patterns('',
('^admin/(.*)', admin_site.root),
)
In this example, we register the default ``AdminSite`` instance
``django.contrib.admin.site`` at the URL ``/myadmin/`` ::
from django.conf.urls.defaults import *
from django.contrib import admin
urlpatterns = patterns('',
('^myadmin/(.*)', admin.site.root),
)
Note that the regular expression in the URLpattern *must* group everything in
the URL that comes after the URL root -- hence the ``(.*)`` in these examples.