장고:관리자페이지
장고! 웹 프레임워크! 틀:장고
개요
장고에선 기본적인 관리자 기능에 대해 구현해 두었다.
| 과정 | 설명 |
|---|---|
| 관리자등록 | python manage.py createsuperuser
이후 안내되는 메시지대로 작성한다. |
| 관리자페이지 | 도메인주소/admin에 들어가면 관리자페이지가 나온다. |
| 모델등록 | 모델등록은 앱별로 한다.
/앱이름/admin.py 안에서 모델을 불러오고, 등록한다.from django.contrib import admin#처음에 있던 거. 그냥 두자.
from .models import 모델명 #모델을 불러오고
admin.site.register(모델명) #모델을 등록한다.
이렇게 등록하고 나면 관리자페이지에서 앱별로 모델을 볼 수 있고, 데이터의 추가, 수정, 삭제가 가능하다. |
| 모델제목으로 보기 | 이렇게 등록하고 나면 모델의 제목이 아니라 이상한 텍스트로 보이는데, 모델의 제목으로 보기 위해선 모델클래스에 함수를 추가해주어야 한다.
models.py에서 편집해준다.class Question(models.Model):#세부내용은 필요에 따라..
....
def __str__(self):#관리자페이지에 나타낼 객체 이름.
return self.subject#이 객체의 subject를 관리자화면에서 이름으로 쓰겠다는 의미.
|
디자인 변경
관리자페이지의 디자인은 장고의 django\contrib\admin\templates\admin\abse_site.html 에 있다. 이를 복사하여 templates/admin/ 경로에 붙여넣으면 이를 기초 html로 인식한다.
기능
관리자 화면 커스터마이징
기본적으로 클래스를 새로이 지정해준 후 등록하는 방식을 거친다. 각 앱의 admin.py에서 수정.
from django.contrib import admin
from .models import Question #모델을 불러오고
@admin.register(Question) # 모델 등록
class QuestionAdmin(admin.ModelAdmin): # 관리자기능을 위한 클래스
필요한 내용. # 그 내용은 아래 표에서 찾자.
admin.site.register(Question,QuestionAdmin) # QuestionAdmin의 등록을 추가한다.
| 의도 | 설명 | 코드(QuestionAdmin 안에 추가한다.) |
|---|---|---|
| 나타나는 필드 순서 변경하기 | 앱이름/admin.py 파일의 클래스에서 필드 순서 변경 | fields=['필드명', '필드명2',...]#필드명의 순서에 따라 정렬
|
| 디스플레이항목조정(위와 다를 게 무엇일까;;) | 관리자화면 목록에 나오는 항목들을 조정하고 싶을 때가 있다. 다음과 같이 list_display 변수를 지정하는 것으로 가능하다. | list_display=('모델의 하위속성1', '모델의 하위속성2',...)
|
| 클릭으로 수정화면 넘어가기. | 관리자화면에서 보는 내용을 누르면 편집화면으로 들어가게 할 속성을 지정할 수 있다. | list_display_links = ['하위속성', '하위속성2'] |
| 필터 | 해당 속성에 필터를 걸면 모델의 필드에 맞춰 자동으로 필터를 생성한다.(날짜의 경우, 오늘, 최근7일 등) | list_filter=['필터를 걸 속성']
|
| 모델검색 |
|
search_fields = ['subject'] #검색할 필드를 넣어준다.
|
| 객체순서 배치하기 | 장고가 기본으로 사용하는 정렬값으로 배치할 수 있다. | ordering = ['subject', '-subject2'] #검색할 필드를 넣어준다.
#-는 거꾸로 정렬함을 의미.
|
수정화면 조정
디테일을 볼 수 있는 내용. 수정화면에서 모델의 속성을 그룹화 하여 수정화면을 편집할 수 있다.
from django.contrib import admin
from .models import Question #모델을 불러오고
class QuestionAdmin(admin.ModelAdmin):#관리자기능을 위한 클래스
fieldsets=[
('나타낼그룹명', {'fields':['해당항목']}),
(None, {'fields':['해당항목1', 해당항목2]}),
]
admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
하위객체와의 관계
| 의도 | 설명 | 코드 |
|---|---|---|
| 하위객체 한 화면에서 보기 | 연결된 하위객체를 한 화면에서 보고 조작할 수 있다면 관리가 수월해진다. | from django.contrib import admin
from .models import Question, Answer #모델을 불러오고
class AnsewerInline(admin.StackedInline):
model=Answer
extra=3#기존에 있던 외에 추가할 수 있는 칸. 몇 개를 만들 것인가?
class QuestionAdmin(admin.ModelAdmin):
inlines=[AnsewerInline]#위에서 작성한 클래스를 넣어준다.
admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
|
| 표로 간결하게 보기 | 하지만, 위처럼 쓰면 관리자페이지가 너무 길어져 불편하기도 하다. 이럴 땐 객체들을 테이블 형태로 만들어주어야 하는데, 다음과 같이 부모클래스만 바꾸어주면 된다. | class AnsewerInline(admin.TabularInline):
model=Answer
extra=3
|
문제가 발생한 경우
페이지가 이상해지는 경우
장고 버전업이 되면서 관리자페이지에 새로운 기능이 추가되곤 하는데, 이 때 CSS나 다른 것들도 바뀌곤 한다. 하여, 관리자페이지가 망가지는 경우엔 장고 버전업 후에 collectstatic 명령도 같이 해주어야 정상적으로 반영된다.