추가 설정(Advanced Configuration)
Django에서 제공해주는 admin 애플리케이션은
사용자가 인터페이스를 수정할 수 있다.
- 목록 뷰(List Views) :
・각 레코드에 표시되는 추가적인 필드 및 정보를 추가
・레코드들이 보여질지 선택하는 필터 추가
・목록 뷰(List Views) 안의 동작 메뉴에 추가적인 옵션을 추가하고
이 메뉴가 어디에 보여져야 할 지를 선택
- 세부 뷰(Detail Views) :
・표시할(혹은 제외할) 필드, 따를 순서, 그루핑, 편집 가능 여부,
위젯, 방향(orentation) 등을 선택
・인라인 편집(inline editing) 기능을 넣기 위해
관련된 필드들을 레코드에 추가
이번에는 LocalLibrary의 인터페이스를 향상 시키려고 한다.
Book과 Author Model 목록에 더 많은 정보를 추가하고,
편집 뷰(Edit Views)의 레이아웃을 향상시키는 것을 포함한다.
이외의 관리자 사이트 커스터마이징에 대한 것은
아래 링크의 공식 도큐먼트를 참고하기 바란다.
① ModelAdmin Class 등록하기
관리자 인터페이스를 커스터마이징하고 싶다면
ModelAdmin Class를 정의한 후 등록해야한다.
일단 적용할 Model은
Author, Author, BookInstance Model이다.
우선 위와 같이
catalog 디렉토리의 admin.py에 들어가
Author, Author, BookInstance Model의
레지스터 코드를 주석 처리한다.
| class AuthorAdmin(admin.ModelAdmin): pass # Register the admin class with the associated model admin.site.register(Author, AuthorAdmin) # Register the Admin classes for Book using the decorator @admin.register(Book) class BookAdmin(admin.ModelAdmin): pass # Register the Admin classes for BookInstance using the decorator @admin.register(BookInstance) class BookInstanceAdmin(admin.ModelAdmin): pass | cs |
그리고 위와 같은 코드를 추가 한다.
여기서 @admin.register(Book)은
admin.site.register(Book, BookAdmin)과 동일하다.
② 목록 뷰(List View) 설정
현재 LocalLibrary는 __str__() 메소드에서 생성되는
객체 이름을 사용하여 모든 저자들의 목록을 보여준다.
만약 수 많은 저자가 있을 경우에는
똑같은 이름의 다른 저자가 있을 수도 있을 것이다.
이것을 구분하거나, 저자마다 다른 데이터를 보여주고 싶다면
| class AuthorAdmin(admin.ModelAdmin): list_display = ('last_name', 'first_name', 'date_of_birth', 'date_of_death') | cs |
그 다음 다시 관리자 애플리케이션의 Author 사이트로 들어가보자.
AuthorAdmin Class에 프로그래밍 한대로
화면에 표시되는 것을 볼 수 있다.
추가로 Book Model도 커스터마이징 해보자.
커스터마이징 할 필드는 title, author, genre이다
다만, author는 ForeignKey 필드(일 대 다)이기 때문에
관련 레코드 __str__()에 의해 리턴되지만,
genre 필드는 ManyToManyField이기 때문에
list_display를 이용해 리턴할 수는 없다.
대신에 문자열로 받기 위해
disply_genre 함수를 정의할 것 이다.
사실 genre를 가져오는 것은 좋은 생각은 아니다.
왜냐하면 DB의 효율이 떨어지기 때문이다.
어쨋든 먼저 Book Model안에 아래의 코드를 추가한다.
| def display_genre(self): """Create a string for the Genre. This is required to display genre in Admin.""" return ', '.join(genre.name for genre in self.genre.all()[:3]) display_genre.short_description = 'Genre' | cs |
그 다음 admin.py에 아래와 같이 추가하자
| class BookAdmin(admin.ModelAdmin): list_display = ('title', 'author', 'display_genre') | cs |
그리고 book 관라자 앱에서 확인해보면
위와같이 프로그래밍 한 대로
title, author, display_genre이
화면에 표시되는 것을 확인할 수 있다.
③ 목록 필터(List Filter) 추가하기
목록 안에 항목들이 많다면
List View 보다는 List Filter를 추가하는 것이 좋다.
| class BookInstanceAdmin(admin.ModelAdmin): list_filter = ('status', 'due_back') | cs |
작성 후 관리자 애플리케이션의
Book Instances 페이지에 들어가면
위의 화면과 같이 List Filter가
화면에 출력되는 것을 확인할 수 있다.
④상세 뷰(Detail View) 레이아웃 커스터마이징
Model들을 눌렀을 때 나오는
상세 뷰(Detail View)의 레이아웃도 커스터마이징할 수도 있다.
Detail View는은 모든 필드들을 Model에 정의한대로
표시할 수 있다.
1) 필드 배치 및 제어
| class AuthorAdmin(admin.ModelAdmin): list_display = ('last_name', 'first_name', 'date_of_birth', 'date_of_death') fields = ['first_name', 'last_name', ('date_of_birth', 'date_of_death')] | cs |
위와 같이 admin.py 파일의 AuthorAdmin Class안에
fields라는 변수를 선언하고 데이터를 입력 하자.
필드들은 기본적으로 수직적으로 표시되지만,
date_of_birth와 date_of_death 처럼 묶는다면
수평적으로 표시된다.
추가했다면 Author의 세부 뷰화면으로 가보자.
들어가보면 프로그래밍 한대로
first_name과 last_name은 수직적으로,
묶었던 date_of_birth와 date_of_death는
수평적으로 표시되어있는 것을 확인할 수 있다.
2) 세부 뷰 구역 나누기(Sectioning the detail view)
연관된 모델 정보를 그룹화하는 sections를 추가할 수 있다.
| @admin.register(BookInstance) class BookInstanceAdmin(admin.ModelAdmin): list_filter = ('status', 'due_back') fieldsets = ( (None, { 'fields': ('book', 'imprint', 'id') }), ('Availability', { 'fields': ('status', 'due_back') }), ) | cs |
위와 같이 BookInstanceAdmin Class에
fieldsets 변수와 데이터를 추가해보자.
길게 말하는 것 보다 실행 결과를 보는 것이
이해하기 더 쉬울 것이다.
바로 Book Instance의 Detail View로 가보자.
프로그래밍한대로 초록색 박스는
타이틀이 달려있지 않은 3개의 필드가 표시되고
빨간색 박스는 타이틀이 달려있는 2개의 필드가 화면에 표시된다.
3) 연관 레코드들의 인라인 편집(Inline editing of
associated records)
연관된 레코드들을 동시에 추가하는 것이 가능할 때도 있다.
책 정보와 특정한 복사본에 대한 정보 둘다 가질 수 도 있다.
선택할 수 있다.
| class BooksInstanceInline(admin.TabularInline): model = BookInstance @admin.register(Book) class BookAdmin(admin.ModelAdmin): list_display = ('title', 'author', 'display_genre') inlines = [BooksInstanceInline] | cs |
위와 같이 admin.py 파일에
BooksInstanceInline Class를 정의하고
BookAdmin Class에 inlines 변수와 데이터를 추가하자.
저장하고 Book Model 관리자 페이지의
상세 뷰(Detail View)로 들어가보자.
상세 뷰의 맨 아래쪽으로 가보면
Book Instances라는 타이틀로
사본에 대한 인라인이 추가되어있는 것을 확인할 수 있다.
