Django 관리자 복수 형태 수정

2024-07-27

문제점

Django 관리자는 기본적으로 모델의 단수 형태를 기반으로 관리 패널에 데이터를 표시합니다. 하지만 일부 경우에는 모델의 복수 형태를 사용하는 것이 더 적절할 수 있습니다. 예를 들어, "Book" 모델의 경우 관리 패널에 "책"이라고 표시되는 것이 더 자연스러울 수 있습니다.

해결 방법

Django는 모델의 verbose_name_plural 속성을 사용하여 관리 패널에 표시되는 복수 형태를 지정할 수 있도록 합니다. 다음은 verbose_name_plural 속성을 사용하여 "Book" 모델의 복수 형태를 "책"으로 설정하는 방법입니다.

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=255)
    author = models.ForeignKey('Author', on_delete=models.CASCADE)
    publication_date = models.DateField()

    class Meta:
        verbose_name = '책'
        verbose_name_plural = '책'

django-admin 사용

django-admin 명령줄 도구를 사용하여 모델의 복수 형태를 설정할 수도 있습니다. 다음은 django-admin을 사용하여 "Book" 모델의 복수 형태를 "책"으로 설정하는 방법입니다.

python manage.py makemigrations
python manage.py migrate
python manage.py shell
from django.db import models
Book._meta.verbose_name_plural = '책'
Book._meta.save_m2m()

추가 고려 사항

모델의 복수 형태는 관리 패널뿐만 아니라 다른 곳에서도 사용될 수 있습니다. 예를 들어, 모델의 관리자 URL은 복수 형태를 기반으로 생성됩니다.
모델의 복수 형태를 설정할 때는 모델의 이름과 일관성이 유지되는지 확인하십시오.
모델의 복수 형태를 변경하면 기존 데이터에 영향을 미치지 않도록 주의해야 합니다.

예제 코드

verbose_name_plural 속성 사용

다음은 verbose_name_plural 속성을 사용하여 모델의 복수 형태를 설정하는 방법의 예시입니다.

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=255)
    author = models.ForeignKey('Author', on_delete=models.CASCADE)
    publication_date = models.DateField()

    class Meta:
        verbose_name = '책'
        verbose_name_plural = '책'

이 코드는 "Book" 모델의 복수 형태를 "책"으로 설정합니다. 즉, 관리 패널에 표시될 때 "책"이라는 레이블이 사용됩니다.

다음은 django-admin 명령줄 도구를 사용하여 모델의 복수 형태를 설정하는 방법의 예시입니다.

python manage.py makemigrations
python manage.py migrate
python manage.py shell
from django.db import models
Book._meta.verbose_name_plural = '책'
Book._meta.save_m2m()

이 코드는 다음과 같은 단계를 수행합니다.

makemigrations 명령을 사용하여 변경 사항을 위한 마이그레이션을 생성합니다.
migrate 명령을 사용하여 마이그레이션을 적용합니다.
shell 명령을 사용하여 Django 쉘을 시작합니다.
Book 모델의 _meta 속성에 액세스합니다.
verbose_name_plural 속성을 "책"으로 설정합니다.
save_m2m() 메서드를 사용하여 변경 사항을 저장합니다.

이 코드는 위의 예제와 동일한 결과를 얻습니다. 즉, "Book" 모델의 복수 형태를 "책"으로 설정합니다.

추가 예제

다음은 모델의 복수 형태를 설정하는 다른 방법의 몇 가지 예시입니다.

모델의 verbose_name_plural 속성을 함수로 설정할 수 있습니다. 이 함수는 모델 인스턴스의 특성을 기반으로 복수 형태를 반환할 수 있습니다.
admin.site.register() 함수의 verbose_name_plural 매개변수를 사용하여 관리 패널에 표시되는 복수 형태를 설정할 수 있습니다.
django-modeltranslation 패키지를 사용하여 모델의 복수 형태를 여러 언어로 설정할 수 있습니다.

대체 방법

Django 관리자 복수 형태를 수정하는 방법에는 여러 가지가 있습니다.

이는 가장 일반적인 방법이며, 앞서 예시 코드에서도 설명했습니다. 모델 클래스의 Meta 내부 클래스에서 verbose_name_plural 속성을 직접 설정하는 방식입니다.

class Book(models.Model):
    # ...

    class Meta:
        verbose_name = '책'
        verbose_name_plural = '책'

admin.site.register() 함수 사용

from django.contrib import admin
from .models import Book

admin.site.register(Book, verbose_name_plural='책')

함수 사용

verbose_name_plural 속성에 함수를 할당하여 모델 인스턴스의 특성을 기반으로 동적으로 복수 형태를 결정할 수 있습니다.

from django.db import models

def get_book_plural(self):
    # ... (모델 인스턴스의 특성을 기반으로 복수 형태를 계산하는 로직)

class Book(models.Model):
    # ...

    class Meta:
        verbose_name = '책'
        verbose_name_plural = get_book_plural

django-modeltranslation 패키지 사용

다국어 지원이 필요한 경우 django-modeltranslation 패키지를 사용하여 각 언어마다 복수 형태를 별도로 설정할 수 있습니다.

설치: pip install django-modeltranslation
설정: settings.py 파일에 MODELTRANSLATION_LANGUAGES 설정 추가

MODELTRANSLATION_LANGUAGES = (
    ('ko', 'Korean'),
    ('en', 'English'),
)

모델 번역: admin.py 파일에 TranslationOptions 클래스 사용

from django.contrib import admin
from .models import Book
from django_modeltranslation.admin import TranslationOptions

class BookAdmin(admin.ModelAdmin):
    model = Book
    fields = ['title', 'author', 'publication_date']
    list_display = ['title', 'author', 'publication_date']

class BookTranslationOptions(TranslationOptions):
    fields = ['verbose_name_plural']

admin.site.register(Book, BookAdmin, TranslationOptions=BookTranslationOptions)