Admin

Django Admin

1. Django Admin 개요

항목	설명
기능	데이터 관리 인터페이스 자동 생성
위치	/admin/ 경로 기본 제공
장점	DB 테이블에 대한 CRUD UI 자동 제공
전제조건	superuser 생성 필요

2. 관리자(superuser) 생성

python manage.py createsuperuser
Shell
복사

실행 후 username, email, password 입력

3. admin 사이트 접속

•

URL: http://localhost:8000/admin/

•

로그인: 위에서 생성한 superuser 계정

4. 모델 admin에 등록하기

예시 모델

# models.py
from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
Python
복사

등록 방법

# admin.py
from django.contrib import admin
from .models import Post

admin.site.register(Post)
Python
복사

등록만 하면 /admin/에서 자동으로 관리 UI 제공됩니다!

5. Admin 커스터마이징

예시: PostAdmin 클래스 정의

# admin.py
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_display = ('id', 'title', 'created_at')  # 목록에 보이는 필드
    search_fields = ('title',)                   # 검색
    list_filter = ('created_at',)                # 필터링
    ordering = ('-created_at',)                  # 정렬
Python
복사

6. 커스텀 User 모델 admin 등록 예시

# admin.py
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

@admin.register(CustomUser)
class CustomUserAdmin(UserAdmin):
    model = CustomUser
    list_display = ['username', 'email', 'nickname', 'is_staff']
    fieldsets = UserAdmin.fieldsets + (
        ('추가 정보', {'fields': ('nickname', 'phone')}),
    )
Python
복사

7. ForeignKey 관계 시 inline 사용

# models.py
class Comment(models.Model):
    post = models.ForeignKey(Post, on_delete=models.CASCADE)
    text = models.TextField()
Python
복사

# admin.py
class CommentInline(admin.TabularInline):
    model = Comment
    extra = 1

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    inlines = [CommentInline]
Python
복사

실습 과제 예시

실습명	목표
기본 Post 모델 admin 등록	등록만 해도 CRUD UI 제공됨 확인
list_display 설정	목록에 ID, 제목, 날짜 표시
search 기능 추가	제목으로 검색
필터 추가	날짜별 필터링
커스텀 User 모델 등록	nickname, phone 표시
inline 관계 구현	게시글에 댓글 inline으로 관리

요약

항목	설명
기본 등록	admin.site.register()로 간단히 관리 UI 생성
자동화	모델 구조 기반으로 CRUD 인터페이스 자동 생성
커스터마이징	ModelAdmin클래스로 검색/필터/정렬/inline 기능 추가
확장성	커스텀 User 모델 포함 모든 모델 관리 가능

Django Admin 확장 실습 자료

번호	주제	설명
1	readonly_fields	읽기 전용 필드 지정 (수정 불가 필드)
2	prepopulated_fields	제목 입력 시 slug 자동 생성
3	actions	선택 항목에 대한 일괄 작업 정의
4	formfield_overrides	관리자 페이지에서 위젯 커스터마이징
5	list_display	목록 화면에서 표시할 필드 지정
6	search_fields	검색창에서 검색할 필드 설정
7	list_filter	사이드 필터바로 목록 필터링 기능 제공
8	커스텀 User 등록	CustomUser 모델을 admin에 등록하고 필드 표시
9	Inline 관계	부모(admin)에서 자식 모델 관리

1. readonly_fields – 읽기 전용 필드 지정

개념

특정 필드는 수정 없이 보기만 가능하게 설정하고 싶을 때 사용

실습 목표

•

created_at, updated_at 필드를 읽기 전용으로 설정

실습 코드

# board/admin.py
from django.contrib import admin
from .models import Post

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    readonly_fields = ('created_at', 'updated_at')
Python
복사

2. prepopulated_fields – slug 자동 생성

개념

slug 필드를 title 입력 시 자동으로 채워줌

slug란?

영어 소문자 + 숫자 + 하이픈(-) 으로 구성된 URL-friendly 문자열

•

예시

제목 (title)	slug	URL
"장고 관리자 설정"	django-admin-settings	/post/django-admin-settings
"파이썬 웹 크롤링 입문"	python-web-crawling	/post/python-web-crawling

URL Slug 설정

모델 설정 : slug 필드 추가

관리자 설정 : 자동 슬러그 생성

post(게시글)의 경우 제목(title)을 기준으로 슬러그 자동 생성

URL 설정

urls.py 설정 파일에서 slug 로 URL 매핑 설정

View 설정

특정 데이터를 slug 필드 기준으로 조회

Tempate 작성

templates/blog/post/post_detail.html

실습 목표

제목 입력 → slug 자동 완성

실습 코드

slug 필드 추가

# board/models.py
class Post(models.Model):
    title = models.CharField(max_length=100)
    slug = models.SlugField(unique=True)
Python
복사

관리자 설정 : 자동 슬러그 생성

# board/admin.py
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    prepopulated_fields = {"slug": ("title",)}
Python
복사

URL 설정

from django.urls import path
from . import views

urlpatterns = [
    path('post/<slug:slug>', views.post_detail, name='post_detail'),
]
Python
복사

View 설정

from django.shortcuts import render
from django.shortcuts import get_object_or_404

from .models import Post

# Create your views here.
def post_detail(request, slug):
  post = get_object_or_404(Post, slug=slug)
  return render(request, 'blog/post_detail.html', {'post': post})
Python
복사

Template 작성

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>게시글 조회 - {{post.title}}</title>
</head>
<body>
  <h1>{{ post.title }}</h1>
  <hr>
  <table border="1">
    <tr>
      <th>작성자</th>
      <td>{{ post.user.nickname }}</td>
    </tr>
    <tr>
      <th>작성일</th>
      <td>{{ post.created_at|date:"Y-m-d H:i:s" }}</td>
    </tr>
    <tr>
      <td colspan="2">
        <div class="post-content">
          {{ post.content|safe }}
        </div>
      </td>
    </tr>
  </table>
</body>
</html>
Python
복사

한글명 제목으로 Slug 자동 생성하기

python-slugify 라이브러리 설치

slugify 의 slugify() 함수 사용

python-slugify 라이브러리 설치

pip install python-slugify
Python
복사

slugify 의 slugify() 함수 사용

모델의 save() 함수를 오버라이딩하여, slugify() 적용

 # 모델의 save() 함수를 오버라이딩하여, slugify() 적용
  def save(self, *args, **kwargs):
    if not self.slug:
      self.slug = slugify(self.title)   # 한글명의 제목을 slug로 변환합니다.
    # slugify() 함수는 문자열을 URL-friendly한 형식으로 변환합니다.
    super().save(*args, **kwargs)
Python
복사

3. actions – 커스텀 관리자 일괄 작업

개념

선택된 객체에 대해 일괄 처리 함수 실행

실습 목표

•

게시글을 한 번에 공개 상태로 변경하는 액션 구현

실습 코드

# board/models.py
class Post(models.Model):
    title = models.CharField(max_length=100)
    is_public = models.BooleanField(default=False)
Python
복사

# board/admin.py
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    actions = ['make_public']

    @admin.action(description="선택한 글을 공개처리")
    def make_public(self, request, queryset):
        queryset.update(is_public=True)
Python
복사

4. formfield_overrides – 위젯 커스터마이징

개념

모델 필드에 연결된 폼 위젯을 커스터마이징

실습 목표

•

TextField를 Textarea로 줄 수 설정

실습 코드

from django.db import models
from django.forms import Textarea

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    formfield_overrides = {
        models.TextField: {'widget': Textarea(attrs={'rows': 3, 'cols': 60})},
    }
Python
복사

5. list_display – 목록 필드 설정

개념

관리자 목록 페이지에서 보여줄 필드 지정

실습 목표

•

ID, 제목, 작성일 출력

실습 코드

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_display = ('id', 'title', 'created_at')
Python
복사

6. search_fields – 검색 기능 추가

개념

검색창을 통해 특정 필드 검색 가능

실습 목표

•

제목 기준으로 검색 가능하게 설정

실습 코드

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    search_fields = ('title',)
Python
복사

7. list_filter – 필터 기능 추가

개념

사이드 필터바로 빠른 필터링 제공

실습 목표

•

작성일 기준으로 필터 가능

실습 코드

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_filter = ('created_at',)
Python
복사

8. 커스텀 User 모델 등록

실습 목표

•

CustomUser 모델을 Admin에 등록

•

목록에 username, nickname, phone 표시

실습 코드

# accounts/models.py
from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    nickname = models.CharField(max_length=30)
    phone = models.CharField(max_length=20)
Python
복사

# accounts/admin.py
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

@admin.register(CustomUser)
class CustomUserAdmin(UserAdmin):
    fieldsets = UserAdmin.fieldsets + (
        ('추가 정보', {'fields': ('nickname', 'phone')}),
    )
    list_display = ('username', 'nickname', 'phone', 'is_staff')
Python
복사

9. Inline 관계 실습 – 댓글 관리

개념

부모 모델 페이지에서 자식 모델을 Inline으로 함께 관리

실습 목표

•

게시글(Post) 페이지에서 댓글(Comment) 관리

실습 코드

# board/models.py
from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)

class Comment(models.Model):
    post = models.ForeignKey(Post, on_delete=models.CASCADE)
    content = models.TextField()
Python
복사

# board/admin.py
class CommentInline(admin.TabularInline):
    model = Comment
    extra = 1

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    inlines = [CommentInline]
Python
복사