2026년 Django Admin 커스터마이징 완벽 가이드: 액션, 필터, 면접 질문

# admin.py
from django.contrib import admin
from django.utils.html import format_html
from .models import Article


class ArticleAdmin(admin.ModelAdmin):
    list_display = ["title", "author_name", "status", "publish_date", "is_recent"]
    search_fields = ["title", "author__email", "content"]
    list_per_page = 50
    list_select_related = ["author"]  # N+1 쿼리 방지

    @admin.display(description="작성자", ordering="author__last_name")
    def author_name(self, obj):
        return f"{obj.author.first_name} {obj.author.last_name}"

    @admin.display(description="최근?", boolean=True)
    def is_recent(self, obj):
        from django.utils import timezone
        return obj.publish_date >= timezone.now() - timezone.timedelta(days=7)


admin.site.register(Article, ArticleAdmin)

# admin.py
from datetime import date, timedelta
from django.contrib import admin
from django.utils.translation import gettext_lazy as _
from .models import Article


class PublishDateFilter(admin.SimpleListFilter):
    title = _("발행 기간")
    parameter_name = "published"  # URL 매개변수: ?published=this_week

    def lookups(self, request, model_admin):
        # 필터 사이드바용 (값, 레이블) 튜플 반환
        return [
            ("this_week", _("이번 주")),
            ("this_month", _("이번 달")),
            ("this_year", _("올해")),
            ("unpublished", _("미발행")),
        ]

    def queryset(self, request, queryset):
        # self.value()를 기반으로 쿼리셋 필터링
        today = date.today()
        if self.value() == "this_week":
            return queryset.filter(publish_date__gte=today - timedelta(days=7))
        if self.value() == "this_month":
            return queryset.filter(
                publish_date__year=today.year, publish_date__month=today.month
            )
        if self.value() == "this_year":
            return queryset.filter(publish_date__year=today.year)
        if self.value() == "unpublished":
            return queryset.filter(publish_date__isnull=True)
        return queryset


class ArticleAdmin(admin.ModelAdmin):
    list_filter = [
        "status",
        PublishDateFilter,
        ("author", admin.RelatedOnlyFieldListFilter),  # 기사가 있는 작성자만 표시
    ]

# admin.py
from django.contrib import admin
from django.contrib.admin import ShowFacets
from .models import Article


class ArticleAdmin(admin.ModelAdmin):
    list_display = ["title", "status", "category"]
    list_filter = ["status", "category", "author"]
    show_facets = ShowFacets.ALWAYS  # 항상 카운트 표시

    # 대체 값:
    # ShowFacets.ALLOW - URL에 ?_facets=1이 있을 때 카운트 표시
    # ShowFacets.NEVER - 카운트를 표시하지 않음 (대규모 데이터셋용)

# admin.py
from django.contrib import admin
from django.contrib import messages
from django.utils.translation import ngettext
from .models import Article


@admin.action(description="선택한 기사 발행", permissions=["change"])
def publish_articles(modeladmin, request, queryset):
    # 이미 발행된 기사 제외
    unpublished = queryset.exclude(status="published")
    updated = unpublished.update(status="published")

    modeladmin.message_user(
        request,
        ngettext(
            "%d개의 기사가 발행되었습니다.",
            "%d개의 기사가 발행되었습니다.",
            updated,
        )
        % updated,
        messages.SUCCESS,
    )


@admin.action(description="선택한 항목을 JSON으로 내보내기")
def export_as_json(modeladmin, request, queryset):
    from django.http import HttpResponse
    from django.core import serializers

    response = HttpResponse(content_type="application/json")
    response["Content-Disposition"] = 'attachment; filename="articles.json"'
    serializers.serialize("json", queryset, stream=response)
    return response  # HttpResponse 반환 시 파일 다운로드 트리거


class ArticleAdmin(admin.ModelAdmin):
    actions = [publish_articles, export_as_json]

    def get_actions(self, request):
        # 사용자 권한에 따라 조건부로 액션 제거
        actions = super().get_actions(request)
        if not request.user.has_perm("articles.delete_article"):
            del actions["delete_selected"]
        return actions

# admin.py
from django.contrib import admin
from .models import Article, ArticleImage, ArticleComment


class ArticleImageInline(admin.TabularInline):
    model = ArticleImage
    extra = 1  # 표시할 빈 폼 수
    max_num = 5  # 기사당 최대 이미지 수
    fields = ["image", "caption", "order"]


class ArticleCommentInline(admin.StackedInline):
    model = ArticleComment
    extra = 0
    readonly_fields = ["created_at", "author"]
    can_delete = True


class ArticleAdmin(admin.ModelAdmin):
    fieldsets = [
        (
            None,
            {
                "fields": ["title", "slug", "author"],
            },
        ),
        (
            "콘텐츠",
            {
                "fields": ["content", "excerpt"],
                "classes": ["wide"],  # 전체 너비 필드
            },
        ),
        (
            "발행 설정",
            {
                "fields": ["status", "publish_date", "category", "tags"],
                "classes": ["collapse"],  # 기본적으로 접힘
            },
        ),
        (
            "SEO",
            {
                "fields": ["meta_title", "meta_description"],
                "classes": ["collapse"],
                "description": "검색 엔진 최적화 필드",
            },
        ),
    ]
    inlines = [ArticleImageInline, ArticleCommentInline]
    prepopulated_fields = {"slug": ["title"]}  # 제목에서 슬러그 자동 생성
    autocomplete_fields = ["author", "category"]  # AJAX 기반 선택
    filter_horizontal = ["tags"]  # M2M 선택용 위젯


admin.site.register(Article, ArticleAdmin)

# admin.py
from django.contrib import admin
from django.contrib.admin import AdminSite
from .models import Article, Category


class ContentAdminSite(AdminSite):
    site_header = "콘텐츠 관리"
    site_title = "CMS"
    index_title = "대시보드"

    def has_permission(self, request):
        # 'editors' 그룹의 스태프로 제한
        return (
            request.user.is_active
            and request.user.is_staff
            and request.user.groups.filter(name="editors").exists()
        )


content_admin = ContentAdminSite(name="content_admin")
content_admin.register(Article, ArticleAdmin)
content_admin.register(Category)

# urls.py에서:
# path('content-admin/', content_admin.urls),

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


class OrderAdmin(admin.ModelAdmin):
    # 실수: list_select_related 없이 관련 필드에 접근
    # 이는 N+1 쿼리를 유발하며 목록 뷰의 각 행마다 하나씩 발생
    list_display = ["id", "customer_email", "total"]

    # 수정: 관련 객체 프리페치
    list_select_related = ["customer"]

    def customer_email(self, obj):
        return obj.customer.email

    # 실수: 인덱스되지 않은 대용량 텍스트 컬럼에서 search_fields
    # search_fields = ["notes"]  # 대용량 테이블에서 느림

    # 수정: 인덱스된 필드로 검색 제한
    search_fields = ["id", "customer__email"]

    # 실수: list_display에서 비용이 많이 드는 계산
    # def order_total(self, obj):
    #     return sum(item.price * item.qty for item in obj.items.all())  # N+1

    # 수정: get_queryset에서 어노테이션 사용
    def get_queryset(self, request):
        from django.db.models import Sum, F

        qs = super().get_queryset(request)
        return qs.annotate(computed_total=Sum(F("items__price") * F("items__qty")))

    @admin.display(description="합계", ordering="computed_total")
    def total(self, obj):
        return obj.computed_total

# settings.py
INSTALLED_APPS = [
    "unfold",  # django.contrib.admin 전에 위치해야 함
    "unfold.contrib.filters",  # 고급 필터 위젯
    "unfold.contrib.forms",  # 향상된 폼 위젯
    "django.contrib.admin",
    # ...
]