Registering models in admin in Django - Mini Project: Build & Apply

Registering models in admin

📖 Scenario: You are building a simple Django app to manage a library. You have created a model called Book to store book information.Now, you want to make the Book model manageable through the Django admin site so that librarians can add, edit, and delete books easily.

🎯 Goal: Register the Book model in the Django admin site so it appears in the admin interface.

📋 What You'll Learn

Create a Book model with fields title and author

Import the Book model into admin.py

Register the Book model with the Django admin site

💡 Why This Matters

🌍 Real World

Registering models in the Django admin site is a common task to allow non-technical users to manage data easily through a web interface.

💼 Career

Understanding how to register and customize models in the Django admin is essential for backend developers working with Django to build maintainable and user-friendly admin panels.

1

Create the Book model

Create a Django model called Book in models.py with two fields: title as a CharField with max length 100, and author as a CharField with max length 50.

Django

# Your code here to define the Book model

Hint

Remember to import models from django.db before defining the model.

2

Import the Book model in admin.py

In admin.py, import the Book model from the current app's models module using from .models import Book.

Django

# Your code here to import Book model

Hint

Use a relative import to bring the Book model into admin.py.

3

Register the Book model with admin site

Register the Book model with the Django admin site by calling admin.site.register(Book) in admin.py.

Django

from django.contrib import admin
from .models import Book

# Your code here to register Book model

Hint

Use admin.site.register() function to make the model manageable in the admin interface.

4

Verify admin registration

Ensure the admin.py file contains the import of Book and the registration line admin.site.register(Book) so the model appears in the admin site.

Django

from django.contrib import admin
from .models import Book

admin.site.register(Book)  # Confirm this line is present

Hint

Double-check that both the import and registration lines are present in admin.py.

Practice

1. What is the main purpose of registering a model in Django admin using admin.site.register(ModelName)?

easy

A. To make the model manageable through the Django admin web interface

B. To create a new database table for the model

C. To automatically generate API endpoints for the model

D. To enable model validation during form submission

Solution

1. Step 1: Understand the role of Django admin

   Django admin provides a web interface to manage database models easily without coding forms manually.

2. Step 2: Identify what registering a model does

   Registering a model with admin.site.register(ModelName) makes it appear in the admin interface for management.

3. Final Answer:

   To make the model manageable through the Django admin web interface -> Option A

4. Quick Check:

   Registering model = Manage in admin [OK]

Hint: Registering means showing model in admin panel [OK]

Common Mistakes:

• Confusing registration with database table creation
• Thinking registration creates API endpoints
• Assuming registration validates forms automatically

2. Which of the following is the correct syntax to register a model named Book in Django admin inside admin.py?

easy

A. admin.site.register(Book)

B. site.admin.register(Book)

C. register.admin(Book)

D. admin.register(Book)

Solution

1. Step 1: Recall the Django admin registration syntax

   The correct syntax uses admin.site.register(ModelName) to register models.

2. Step 2: Match the syntax with options

   Only admin.site.register(Book) matches the correct pattern exactly.

3. Final Answer:

   admin.site.register(Book) -> Option A

4. Quick Check:

   Correct syntax = admin.site.register(Model) [OK]

Hint: Remember: admin.site.register(Model) is correct [OK]

Common Mistakes:

• Using admin.register instead of admin.site.register
• Swapping order of site and admin
• Using incorrect module names

3. Given this admin.py code:

from django.contrib import admin
from .models import Author

admin.site.register(Author)

What will happen when you access the Django admin site?

medium

A. The Author model will not appear in admin because it is not imported

B. You will see an interface to add, edit, and delete Author records

C. You will get a syntax error because of missing parentheses

D. The admin site will crash due to missing admin class

Solution

1. Step 1: Check the import and registration

   The Author model is imported and registered correctly with admin.site.register(Author).

2. Step 2: Understand admin behavior

   Registering the model shows it in admin with default interface to add, edit, delete records.

3. Final Answer:

   You will see an interface to add, edit, and delete Author records -> Option B

4. Quick Check:

   Registered model = visible in admin [OK]

Hint: Registered model appears in admin with default UI [OK]

Common Mistakes:

• Assuming missing admin class causes crash
• Thinking import is missing when it is present
• Confusing syntax error with correct code

4. Identify the error in this admin.py snippet:

from django.contrib import admin
from .models import Publisher

admin.site.register(Publisher())

medium

A. Using admin.register instead of admin.site.register

B. Missing import statement for admin

C. Calling Publisher as a function instead of passing the class

D. No error, code is correct

Solution

1. Step 1: Analyze the registration argument

   The code calls Publisher() which creates an instance, but registration needs the class itself.

2. Step 2: Understand correct usage

   Correct usage is admin.site.register(Publisher) without parentheses.

3. Final Answer:

   Calling Publisher as a function instead of passing the class -> Option C

4. Quick Check:

   Register model class, not instance [OK]

Hint: Register model class, not instance (no parentheses) [OK]

Common Mistakes:

• Adding parentheses after model name
• Forgetting to import admin
• Confusing admin.site.register with admin.register

5. You want to customize the admin interface for a model Article to display the title and published_date columns in the list view. Which is the correct way to register this model with customization?

hard

A. admin.site.register(Article)
admin.list_display = ['title', 'published_date']

B. admin.site.register(Article, list_display=['title', 'published_date'])

C. admin.site.register(Article)
Article.list_display = ['title', 'published_date']

D. class ArticleAdmin(admin.ModelAdmin):
list_display = ('title', 'published_date')
admin.site.register(Article, ArticleAdmin)

Solution

1. Step 1: Understand how to customize admin list display

   Customization requires defining a ModelAdmin subclass with list_display attribute.

2. Step 2: Register model with the custom admin class

   Pass the ModelAdmin subclass as the second argument to admin.site.register().

3. Final Answer:

   Define ArticleAdmin with list_display and register it with Article -> Option D

4. Quick Check:

   Custom admin = ModelAdmin subclass + register [OK]

Hint: Use ModelAdmin subclass with list_display, then register [OK]

Common Mistakes:

• Trying to pass list_display directly to register
• Setting list_display on model instance or admin module
• Not defining a ModelAdmin subclass for customization