장고:관리자페이지 편집하기

{{장고}}

==개요==
장고에선 기본적인 관리자 기능에 대해 구현해 두었다.
{| class="wikitable"
|+
!과정
!설명
|-
|관리자등록
|python manage.py createsuperuser
이후 안내되는 메시지대로 작성한다.
|-
|관리자페이지
|도메인주소/admin에 들어가면 관리자페이지가 나온다.
|-
|모델등록
|모델등록은 앱별로 한다.
/앱이름/admin.py 안에서 모델을 불러오고, 등록한다.<syntaxhighlight lang="python">
from django.contrib import admin#처음에 있던 거. 그냥 두자.

from .models import 모델명 #모델을 불러오고
admin.site.register(모델명) #모델을 등록한다.
</syntaxhighlight>DB를 안만들었다면 python manage.py makemigrations 과 python manage.py migrate를 실행하자.
이렇게 등록하고 나면 관리자페이지에서 앱별로 모델을 볼 수 있고, 데이터의 추가, 수정, 삭제가 가능하다.
|-
|모델제목으로 보기
|이렇게 등록하고 나면 모델의 제목이 아니라 이상한 텍스트로 보이는데, 모델의 제목으로 보기 위해선 모델클래스에 함수를 추가해주어야 한다.
models.py에서 편집해준다.<syntaxhighlight lang="python">
class Question(models.Model):#세부내용은 필요에 따라..
    ....
    def __str__(self):#관리자페이지에 나타낼 객체 이름.
        return self.subject#이 객체의 subject를 관리자화면에서 이름으로 쓰겠다는 의미.
</syntaxhighlight>
|}

===디자인 변경===
관리자페이지의 디자인은 장고의 <code>django\contrib\admin\templates\admin\abse_site.html</code> 에 있다. 이를 복사하여 <code>templates/admin/</code> 경로에 붙여넣으면 이를 기초 html로 인식한다.

=기능=

==관리자 화면 커스터마이징==
기본적으로 클래스를 새로이 지정해준 후 등록하는 방식을 거친다.<syntaxhighlight lang="python">
from django.contrib import admin
from .models import Question #모델을 불러오고

class QuestionAdmin(admin.ModelAdmin):#관리자기능을 위한 클래스
    필요한 내용.
    
admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
</syntaxhighlight>

===객체 배치===
{| class="wikitable"
|+
!의도
!설명
!코드(QuestionAdmin 안에 추가한다.)
|-
|나타나는 필드 순서 변경하기
|앱이름/admin.py 파일의 클래스에서 필드 순서 변경
|<syntaxhighlight lang="python">
fields=['필드명', '필드명2',...]#필드명의 순서에 따라 정렬

</syntaxhighlight>
|-
|디스플레이항목조정(필드 순서와 다를 게 무엇일까;;)
|관리자화면 목록에 나오는 항목들을 조정하고 싶을 때가 있다. 다음과 같이 list_display 변수를 지정하는 것으로 가능하다.
|<syntaxhighlight lang="python">
list_display=('모델의 하위속성1', '모델의 하위속성2',...)
</syntaxhighlight>
|-
|필터
|해당 속성에 필터를 걸면 모델의 필드에 맞춰 자동으로 필터를 생성한다.(날짜의 경우, 오늘, 최근7일 등)
|<syntaxhighlight lang="python">
list_filter=['필터를 걸 속성']
</syntaxhighlight>
|-
|모델검색
|여러 필드를 기입해 검색의 범위를 지정할 수 있다.
|<syntaxhighlight lang="python">
search_fields = ['subject'] #검색할 필드를 넣어준다.
</syntaxhighlight>
|-
|객체순서 배치하기
|장고가 기본으로 사용하는 정렬값으로 배치할 수 있다.
|<syntaxhighlight lang="python">
ordering = ['subject', '-subject2'] #검색할 필드를 넣어준다.
#-는 거꾸로 정렬함을 의미.
</syntaxhighlight>
|}
===수정화면 조정===
디테일을 볼 수 있는 내용. 수정화면에서 모델의 속성을 그룹화 하여 수정화면을 편집할 수 있다.<syntaxhighlight lang="python">
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의 등록을 추가한다.
</syntaxhighlight>

===하위객체와의 관계===
{| class="wikitable"
!의도
!설명
!코드
|-
|하위객체 한 화면에서 보기
|연결된 하위객체를 한 화면에서 보고 조작할 수 있다면 관리가 수월해진다.
|<syntaxhighlight lang="python">
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의 등록을 추가한다.
</syntaxhighlight>
|-
|표로 간결하게 보기
|하지만, 위처럼 쓰면 관리자페이지가 너무 길어져 불편하기도 하다. 이럴 땐 객체들을 테이블 형태로 만들어주어야 하는데, 다음과 같이 부모클래스만 바꾸어주면 된다.
|<syntaxhighlight lang="python">
class AnsewerInline(admin.TabularInline):
    model=Answer
    extra=3
</syntaxhighlight>
|}<br />

== 문제가 발생한 경우 ==

=== 페이지가 이상해지는 경우 ===
장고 버전업이 되면서 관리자페이지에 새로운 기능이 추가되곤 하는데, 이 때 CSS나 다른 것들도 바뀌곤 한다. 하여, 관리자페이지가 망가지는 경우엔 장고 버전업 후에 collectstatic 명령도 같이 해주어야 정상적으로 반영된다.