# Django 6.0.7 문서

# 첫 번째 장고 앱 작성하기, part 7

이 튜토리얼은 튜토리얼 6장 에 이어서 시작합니다. 우리는 웹 설문조사 어플리케이션을 계속 다루고 있으며, Tutorial 2 에서 봤었던 자동으로 생성된 관리자 사이트를 커스터마이징하는 데 초점을 맞출 것입니다.

도움을 받을 수 있는 방법

이 튜토리얼을 수행하는 데 문제가 있는 경우 FAQ 섹션인 :doc:`Getting Help </faq/help>`으로 이동하십시오.

## 관리자 폼 커스터마이징

`Question` 모델을 `admin.site.register(Question)`에 등록함으로써, Django는 디폴트 폼 표현을 구성 할 수 있었습니다. 관리 폼이 보이고 작동하는 방법을 커스터마이징하려는 경우가 있습니다. 객체를 등록 할 때 Django에 원하는 옵션을 알려주면 커스터마이징 할 수 있습니다.

수정 폼의 필드를 재정렬하여 이것이 작동하는 법을 보겠습니다. `admin.site.register(Question)` 줄을 다음과 같이 바꾸세요:

`polls/admin.py`

    from django.contrib import admin

    from .models import Question

    class QuestionAdmin(admin.ModelAdmin):
        fields = ["pub_date", "question_text"]

    admin.site.register(Question, QuestionAdmin)

모델의 관리자 옵션을 변경해야 할 때마다 이 패턴 – 모델 어드민 클래스를 만든 다음, `admin.site.register()`에 두 번째 인수로 전달합니다 – 을 따라하면 됩니다.

여기서 특별한 변경 사항은 “발행일”이 “설문” 필드 앞에 오게 만듭니다.

단지 2개의 필드만으로는 인상적이지는 않지만, 수십 개의 필드가 있는 관리 폼의 경우에는 직관적인 순서을 선택하는 것이 사용 편리성의 중요한 부분입니다.

수십 개의 필드가 있는 폼에 관해서는 폼을 fieldset으로 분할하는 것이 좋습니다.

`polls/admin.py`

    from django.contrib import admin

    from .models import Question

    class QuestionAdmin(admin.ModelAdmin):
        fieldsets = [
            (None, {"fields": ["question_text"]}),
            ("Date information", {"fields": ["pub_date"]}),
        ]

    admin.site.register(Question, QuestionAdmin)

`fieldsets`의 각 튜플의 첫 번째 요소는 fieldset의 제목입니다. 우리의 폼이 다음과 같이 변했네요.

## 관련된 객체 추가

OK, 우리는 Question 관리자 페이지를 가지고 있습니다. 그러나, `Question`은 여러 개의 `Choice`들을 가지고 있음에도, admin 페이지는 선택 사항을 표시하지 않습니다.

아직까진 말이죠.

이 문제를 해결하는 방법은 두 가지가 있습니다. 첫 번째는 `Question`:과 마찬가지로 ``Choice``를 관리자에 등록하는 것입니다.

`polls/admin.py`

    from django.contrib import admin

    from .models import Choice, Question

    # ...
    admin.site.register(Choice)

이제 “Choices”는 Django 관리자가 사용할 수 있는 옵션입니다. “Add choice” 폼은 다음과 같습니다.

이 양식에서 “Question” 필드는 데이터베이스의 모든 질문을 포함하는 select box입니다. Django는 `ForeignKey`가 admin에서 `<select>`로 표현되어야 함을 알고 있습니다. 우리의 경우, 지금은 단 하나의 질문만이 존재합니다.

Also note the “Add another question” button (displayed as a plus sign) to the right of the “Question” field. Every `ForeignKey` relationship gets this button for free. When you click this button, you’ll get a popup window with the “Add question” form. If you add a question in that window and click “Save”, Django will save the question to the database and dynamically add it as the selected choice on the “Add choice” form you’re looking at.

그러나 실제로 이것은 `Choice` 객체를 시스템에 추가하는 비효율적인 방법입니다. `Question` 객체를 생성할 때 여러 개의 Choices를 직접 추가할 수 있다면 더 좋을 것입니다. 그것을 만들어 봅시다.

`Choice` 모델에 대한 `register()` 호출을 제거하십시오. 그런 다음 `Question` 등록 코드를 다음과 같이 편집하십시오:

`polls/admin.py`

    from django.contrib import admin

    from .models import Choice, Question

    class ChoiceInline(admin.StackedInline):
        model = Choice
        extra = 3

    class QuestionAdmin(admin.ModelAdmin):
        fieldsets = [
            (None, {"fields": ["question_text"]}),
            ("Date information", {"fields": ["pub_date"], "classes": ["collapse"]}),
        ]
        inlines = [ChoiceInline]

    admin.site.register(Question, QuestionAdmin)

위 소소는 Django에게 “`Choice` 객체는 `Question` 관리자 페이지에서 편집된다. 기본으로 3가지 선택 항목을 제공함.” 이라고 알려줍니다.

모양을 보려면 “Add question” 페이지를 로드하십시오.

이 화면은 다음과 같이 작동합니다. 관련된 선택 사항을 위한 슬롯이 세 개 있으며– `extra`로 지정됨 – 이미 생성된 객체의 “Change” 페이지의 경우에도 빈 세 개의 슬롯이 생깁니다.

현재 세 개의 슬롯 끝에 “Add another Choice” 링크가 있습니다. 이 링크를 클릭하면 새로운 슬롯이 추가됩니다. 추가된 슬롯을 제거하려면 해당 슬롯의 오른쪽 상단에 있는 X를 클릭하면 됩니다. 아래 이미지는 추가된 슬롯이 표시됩니다.

작은 문제가 하나 있습니다. 관련 `Choice` 객체를 입력하기 위한 모든 필드를 표시하는 데는 많은 화면 공간이 필요합니다. 이러한 이유로 Django는 인라인 관련 객체를 표시하는 표 형식의 방법을 제공합니다. 이를 사용하려면 `ChoiceInline` 선언을 다음과 같이 변경하면 됩니다.

`polls/admin.py`

    class ChoiceInline(admin.TabularInline): ...

`StackedInline` 대신에 `TabularInline`을 사용하면, 관련된 객체는 좀 더 조밀하고 테이블 기반 형식으로 표시됩니다:

추가적인 “Delete?” 열은 “Add another Choice”버튼을 사용하여 추가된 행과 이미 저장된 행을 삭제할 수 있으므로 유의하세요.

## 관리자 변경 목록(change list) 커스터마이징

이제 질문 관리 페이지가 괜찮아 보이므로, 시스템의 모든 질문을 표시하는 “변경 목록” 페이지를 약간 조정하십시오.

다음은 이 시점의 모습입니다.

기본적으로 Django는 각 객체의 `str()` 값을 표시합니다. 그러나 경우에 따라 개별 필드를 표시하는 것이 더 유용할 수 있습니다. 이를 위해 attr:~django.contrib.admin.ModelAdmin.list_display admin 옵션을 사용합니다. 이 옵션은 객체의 변경 목록 페이지에서 열로 표시할 필드 이름의 목록입니다.

`polls/admin.py`

    class QuestionAdmin(admin.ModelAdmin):
        # ...
        list_display = ["question_text", "pub_date"]

좋은 측정을 위해 Tutorial 2:의 `was_published_recently()` 메소드를 추가해봅시다.

`polls/admin.py`

    class QuestionAdmin(admin.ModelAdmin):
        # ...
        list_display = ["question_text", "pub_date", "was_published_recently"]

이제 질문 변경 목록 페이지는 다음과 같습니다.

`was_published_recently` 헤더의 경우를 제외하고 그 값으로 정렬하기 위해 열 머리글을 클릭 할 수 있습니다. 왜냐하면 임의의 메서드의 출력에 의한 정렬은 지원되지 않기 때문입니다. 또한 `was_published_recently`에 대한 열 머리글은 기본적으로 메서드 이름 (밑줄을 공백으로 대체)이며 각 줄에는 출력의 문자열 표현이 포함되어 있습니다.

`display()` 데코레이터를 해당 메서드에 적용하면 다음과 같이 개선할 수 있습니다(Tutorial 2 </intro/tutorial02>`에서 생성한 :file:`polls/models.py 파일을 확장).

`polls/models.py`

    from django.contrib import admin

    class Question(models.Model):
        # ...
        @admin.display(
            boolean=True,
            ordering="pub_date",
            description="Published recently?",
        )
        def was_published_recently(self):
            now = timezone.now()
            return now - datetime.timedelta(days=1) <= self.pub_date <= now

Decorator를 통해 구성할 수 있는 속성에 대한 자세한 내용은 :attr:`~django.contrib.admin.ModelAdmin.list_display`을 참조하십시오.

`polls/admin.py` 파일을 다시 편집하고 Question 변경 목록 페이지에 개선점을 추가하십시오: `list_filter`를 사용하는 필터. `QuestionAdmin`에 다음 줄을 추가하십시오:

    list_filter = ["pub_date"]

`pub_date` 필드에 의해 사람들이 변경 목록을 필터링 할 수 있게 해주는 “Filter” 사이드 바가 추가되었습니다:

표시되는 필터의 유형은 필터링중인 필드의 유형에 따라 다릅니다. `pub_date`는 `DateTimeField`이므로, Django는 “Any date”, “Today”, “Past 7 days”, “This month”, “This year” 등의 적절한 필터 옵션을 제공합니다.

잘 만들어지고 있습니다. 이제 검색 기능을 추가해 보겠습니다:

    search_fields = ["question_text"]

그러면 변경 목록 맨 위에 검색 창이 추가됩니다. 누군가가 검색어를 입력하면, 장고는 `question_text` 필드를 검색합니다. 당신이 원하는 만큼의 필드를 사용할 수 있습니다 – 그것은 내부적으로 `LIKE` 쿼리를 사용하기 때문에 검색 필드의 수를 적당한 수로 제한하면 데이터베이스가 검색을 더 쉽게 할 수 있습니다.

Now’s also a good time to note that change lists give you free pagination. The default is to display 100 items per page.

더 보기

The following `ModelAdmin` options allow further customization of change lists: `list_per_page`, `search_fields`, `date_hierarchy`, and `list_display`.

## 관리자 룩앤필 커스터마이징

명백히, 모든 관리자 페이지 상단에 “Django administration”이 있다는 것은 우스꽝스럽습니다. 이건 그저 자리를 채워넣기 위한 문자열입니다.

그러나 Django의 템플릿 시스템을 사용하여 변경할 수 있습니다. Django 관리자는 Django 자체에 의해 구동되며, 인터페이스는 Django 자신의 템플릿 시스템을 사용합니다.

### 프로젝트의 템플릿 커스터마이징

`djangotutorial` 디렉토리에 `templates` 디렉토리를 생성하세요. 템플릿은 Django가 접근할 수 있는 파일 시스템 어디에나 둘 수 있습니다. (Django는 서버를 실행하는 사용자 권한으로 실행됩니다.) 그러나 템플릿은 프로젝트 내부에 두는 것이 일반적으로 권장됩니다.

설정 파일 (`mysite/settings.py`를 기억하세요)을 열고 `DIRS` 옵션을 `TEMPLATES` 설정에 추가하십시오:

`mysite/settings.py`

    TEMPLATES = [
        {
            "BACKEND": "django.template.backends.django.DjangoTemplates",
            "DIRS": [BASE_DIR / "templates"],
            "APP_DIRS": True,
            "OPTIONS": {
                "context_processors": [
                    "django.template.context_processors.request",
                    "django.contrib.auth.context_processors.auth",
                    "django.contrib.messages.context_processors.messages",
                ],
            },
        },
    ]

`DIRS`는 Django 템플릿을 로드 할 때 검사 할 파일 시스템 디렉토리 목록입니다. 바로 검색 경로입니다.

템플릿 구성

정적 파일과 마찬가지로, 하나의 커다란 템플릿 디렉토리에 모든 템플릿을 함께 넣을 수 있습니다. 그렇게 해도 완벽하게 잘 작동할 것입니다. 그러나, 특정 애플리케이션에 속한 템플릿은 프로젝트(`templates`) 가 아닌 해당 애플리케이션의 템플릿 디렉토리(예: `polls/templates`)에 있어야 합니다. 우리는 왜 우리가 이렇게 해야하는 지에 대한 더 자세한 내용을 reusable apps tutorial 에서 논의할 것입니다.

이제 `admin` inside `templates``라는 디렉토리를 만들고 Django 자체 소스 코드(:source:`django/contrib/admin/templates`) 에 있는 기본 Django 관리자 템플릿 디렉토리 내에 ``admin/base_site.html` 템플릿을 해당 디렉토리로 복사합니다.

Django 소스 파일은 어디에 있습니까?

Django 소스 파일이 시스템에있는 위치를 찾는 데 어려움이있는 경우 다음 명령을 실행하십시오.

/ 

    $ python -c "import django; print(django.__path__)"

    ...\> py -c "import django; print(django.__path__)"

그런 다음 파일을 편집하고 `{{ site_header|default:_('Django administration') }}` (중괄호 포함)을 적합한 사이트 이름으로 바꿉니다. 코드 섹션은 다음과 같습니다.

    {% block branding %}
    <div id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></div>
    {% if user.is_anonymous %}
      {% include "admin/color_theme_toggle.html" %}
    {% endif %}
    {% endblock %}

이 방법을 사용하여 템플릿을 재정의하는 방법을 학습합니다. 실제 프로젝트에서는 아마 `django.contrib.admin.AdminSite.site_header` 속성을 사용하여 이 개별 커스터마이징을 보다 쉽게 만들 수 있습니다.

이 템플릿 파일에는 `{% block branding %}`및 `{{title}}`과 같은 텍스트가 많이 포함되어 있습니다. `{%`와 `{{`태그들은 장고의 템플릿 언어의 일부입니다. Django가 `admin/base_site.html`을 렌더링 할 때, 이 템플릿 언어는 튜토리얼 3장에서 보았 듯이 최종 HTML 페이지를 생성하기 위해 평가 될 것입니다.

Django의 기본 관리 템플릿은 재정의할 수 있습니다. 템플릿을 재정의하려면 ``base_site.html``에서 수행한 작업을 동일하게 수행하십시오. 즉, 기본 디렉토리에서 사용자 지정 디렉토리로 복사한 후 변경하십시오.

### 어플리케이션의 템플릿 사용자 정의

그러나 `DIRS`가 기본설정으로 비어 있다면, 장고는 기본 관리자 템플릿을 어떻게 찾을까요? 그 해답은 `APP_DIRS` 설정이 `True`로 설정되어 있기 때문에 Django는 각 어플리케이션 패키지 내에서 `templates/` 서브 디렉토리를 자동으로 찾아서 대체하게 됩니다. (`django.contrib.admin`이 어플리케이션 임을 잊지 마십시오.)

투표 어플리케이션은 복잡하지 않으며 사용자 정의 admin 템플릿이 필요하지 않습니다. 그러나 Django의 표준 admin 템플릿을 좀더 정교하게 필요에 맞게 수정 할 경우 프로젝트 템플릿 대신 어플리케이션의 템플릿을 수정하는 것이 더 현명합니다. 그렇게 하면 다른 새 프로젝트에 투표 애플리케이션을 포함시킬 수 있고, 필요할때는 커스텀 템플릿을 찾을수 있습니다.

Django가 템플릿을 찾는 방법에 대한 자세한 정보는 템플릿 로딩 문서를 보십시오.

## admin 인덱스 페이지 수정하기

제목과 같이, Django admin 인덱스 페이지의 모양과 느낌을 수정하고 싶을 수도 있습니다.

기본적으로 admin 어플리케이션과 함께 등록된 `INSTALLED_APPS`의 모든 어플리케이션을 사전순으로 표시합니다. 어쩌면 레이아웃을 크게 변경하고자 할 수 있습니다. 설사 그렇게 하더라도 인덱스는 admin의 가장 중요한 페이지이고, 사용하기 쉬워야 합니다.

커스터마이징할 템플릿은 ``admin/index.html``입니다. (이전 섹션에서 ``admin/base_site.html``을 복사한 것과 동일하게, 기본 디렉토리에서 커스텀 템플릿 디렉토리로 파일을 복사하세요.) 파일을 편집해 보면 ``app_list``라는 템플릿 변수를 사용하는 것을 확인할 수 있습니다. 이 변수에는 설치된 모든 Django 앱이 포함되어 있습니다. 이를 사용하는 대신, 필요에 따라 개별 객체별 admin 페이지로 연결되는 링크를 원하는 방식으로 하드코딩할 수 있습니다.

admin에 익숙해졌으면, 서드파티 패키지 사용 방법에 대해 배울 수 있는 :doc:`part 8 of this tutorial </intro/tutorial08>`을 보세요.