Shabda Raaj - Django Admin Cookbook: How to do Things with Django Admin

This is a book about doing things with Django admin. It takes the form of about forty questions and common tasks with Django admin we answer.

The chapters are based on a common set of models, which you can read in detail here (). In short, we have two apps, events and entities . The models are

• Events: Epic , Event , EventHero , EventVillian

• Entities: Category , Origin , Hero , Villain

Django Admin Cookbook is a book about doing things with Django admin. It is targeted towards intermediate Django developers,who have some experience with Django admin, but are looking to expand their knowledge of Django admin and achieve mastery of Django admin.

It takes the form of question and answers about common tasks you might do with Django admin. All the chapters are based on a common set of models, which you can read in detail here (). In short, we have two apps, events and entities . The models are

• Events: Epic , Event , EventHero , EventVillain

• Entities: Category , Origin , Hero , Villain

You can read this book either from start to end, or search for the things you need to do and only read those chapters. Each chapter focusses on a single, specific task.

In either case, you should read the entities/models.py and events/models.py first.

1.1. Login, Listview and Changeview Page

By default it looks like this and is set to Django administration

site_header can be set to change this.

1.2. Listview Page

BY default it looks like this and is set to Site administration

index_title can be set to change this.

1.3. HTML title tag

By default it looks like this and is set to Django site admin

site_title can be set to change this.

We can make the three changes in urls.py:

admin . site . site_header = "UMSRA Admin" admin . site . site_title = "UMSRA Admin Portal" admin . site . index_title = "Welcome to UMSRA Researcher Portal"

2. How to set the plural text for a model?

By default admin will show the name of your model appended with an s, aka the plural form of your model. It looks like this

You have been asked to set the correct plural spellings: Categories and Heroes

You can do this by setting the verbose_name_plural in your models. Change that in your models.py.:

class Category ( models . Model ): ... class Meta : verbose_name_plural = "Categories" class Hero ( Entity ): ... class Meta : verbose_name_plural = "Heroes"

With the changes your Admin will look like this.

3. How to create two independent admin sites?

The usual way to create admin pages is to put all models in a single admin. However it is possible to have multiple admin sites in a single Django app.

Right now our entity and event models are in same place. UMSRA has two distinct group researching Events and Entities, and so wants to split the admins.

We will keep the default admin for entities and create a new subclass of AdminSite for events.

In our events/admin.py we do:

from django.contrib.admin import AdminSite class EventAdminSite ( AdminSite ): site_header = "UMSRA Events Admin" site_title = "UMSRA Events Admin Portal" index_title = "Welcome to UMSRA Researcher Events Portal" event_admin_site = EventAdminSite ( name = 'event_admin' ) event_admin_site . register ( Epic ) event_admin_site . register ( Event ) event_admin_site . register ( EventHero ) event_admin_site . register ( EventVillain )

And change the urls.py to

from events.admin import event_admin_site urlpatterns = [ path ( 'entity-admin/' , admin . site . urls ), path ( 'event-admin/' , event_admin_site . urls ), ]

This separates the admin. Both admins are available at their respective urls, /entity-admin/ and event-admin/ .

4. How to remove default apps from Django admin?

Django will include django.contrib.auth in INSTALLED_APPS ,which means User and Groups models are included in admin automatically.

If you want to remove it, you will have to unregister them.

from django.contrib.auth.models import User , Group admin . site . unregister ( User ) admin . site . unregister ( Group )

After making these changes, your admin should look like this.

5. How to add a logo to Django admin?

Your higher ups at UMSRA love the admin you have created till now, but marketing wants to put the UMSRA logo on all admin pages.

You need to override the default templates provided by Django. In your django settings, you code::TEMPLATES setting looks like this.

TEMPLATES = [ { 'BACKEND' : 'django.template.backends.django.DjangoTemplates' , 'DIRS' : [], 'APP_DIRS' : True , 'OPTIONS' : { 'context_processors' : [ 'django.template.context_processors.debug' , 'django.template.context_processors.request' , 'django.contrib.auth.context_processors.auth' , 'django.contrib.messages.context_processors.messages' , ], }, }, ]

This means that Django will look for templates in a directory called templates inside each app, but you can override that by setting a value for