Django Admin Interface

Django provided a buildin admin interface that can be used to manage the data in the database.

21.1 Creating a superuser

To access the admin interface, we need to create a superuser. We can create a superuser using the createsuperuser command.

python manage.py createsuperuser

21.2 Registering models with the admin interface

To make the model available in the admin interface we need to register the model with the admin interface.

from django.contrib import admin
from myapp.models import Person
admin.site.register(Person)

21.3 Customizing the admin interface

We can change the site header, title, and index title of the admin interface by overriding the admin.site.site_header, admin.site.site_title, and admin.site.index_title respectively.

admin.site.site_header = 'My Site Admin'
admin.site.site_title = 'My Site Admin'

21.4 Customizing the model admin

We can customize the model admin by creating a class that inherits from admin.ModelAdmin and then registering it with the model.

• Customizing Admin List Display By default, the admin list view only displays the __str__() method of the model. You can customize it using the list_display attribute.This makes it easier to view important information at a glance.

class StudentAdmin(admin.ModelAdmin):
    list_display = ('id', 'name', 'age', 'grade')  # Fields to display in the list view

• Adding Search Functionality Purpose: Enable a search bar to search through specific fields in the model. Use the search_fields attribute to specify which fields should be searchable

class StudentAdmin(admin.ModelAdmin):
    search_fields = ('name', 'grade')  # Enable search for name and grade fields

• Ordering the List Purpose: Sort the list view by a specific field. Use the ordering attribute to specify the default ordering of the list view.

class StudentAdmin(admin.ModelAdmin):
    ordering = ('name',)  # Order the list view by name

• Fieldsets Purpose: Group related fields together in the admin interface. Use the fieldsets attribute to group fields together.

class StudentAdmin(admin.ModelAdmin):
    fieldsets = (
        ('Personal Information', {
            'fields': ('name', 'age')
        }),
        ('Academic Information', {
            'fields': ('grade', 'subject')
        }),
    )

21.5 Combining all customizations

admin.py

from django.contrib import admin
from myapp.models import Student
class StudentAdmin(admin.ModelAdmin):
    list_display = ('id', 'name', 'age', 'grade')
    search_fields = ('name', 'grade')
    ordering = ('name',)
    fieldsets = (
        ('Personal Information', {
            'fields': ('name', 'age')
        }),
        ('Academic Information', {
            'fields': ('grade', 'subject')
        }),
    )

admin.site.register(Student, StudentAdmin)