2020년 11월 8일 (일) 21:41 판

장고! 웹 프레임워크! 틀:장고

개요

장고에선 기본적인 관리자 기능에 대해 구현해 두었다.


과정	설명
관리자등록	python manage.py createsuperuser 이후 안내되는 메시지대로 작성한다.
관리자페이지	도메인주소/admin에 들어가면 관리자페이지가 나온다.
모델등록	모델등록은 앱별로 한다. /앱이름/admin.py 안에서 모델을 불러오고, 등록한다. from django.contrib import admin#처음에 있던 거. 그냥 두자. from .models import 모델명 #모델을 불러오고 admin.site.register(모델명) #모델을 등록한다. DB를 안만들었다면 python manage.py makemigrations 과 python manage.py migrate를 실행하자. 이렇게 등록하고 나면 관리자페이지에서 앱별로 모델을 볼 수 있고, 데이터의 추가, 수정, 삭제가 가능하다.
모델제목으로 보기	이렇게 등록하고 나면 모델의 제목이 아니라 이상한 텍스트로 보이는데, 모델의 제목으로 보기 위해선 모델클래스에 함수를 추가해주어야 한다. models.py에서 편집해준다. class Question(models.Model):#세부내용은 필요에 따라.. .... def __str__(self):#관리자페이지에 나타낼 객체 이름. return self.subject#이 객체의 subject를 관리자화면에서 이름으로 쓰겠다는 의미.

디자인 변경

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

기능

관리자 화면 커스터마이징

기본적으로 클래스를 새로이 지정해준 후 등록하는 방식을 거친다.

from django.contrib import admin
from .models import Question #모델을 불러오고

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

객체 배치


의도	설명	코드(QuestionAdmin 안에 추가한다.)
나타나는 필드 순서 변경하기	앱이름/admin.py 파일의 클래스에서 필드 순서 변경	fields=['필드명', '필드명2',...]#필드명의 순서에 따라 정렬
디스플레이항목조정(필드 순서와 다를 게 무엇일까;;)	관리자화면 목록에 나오는 항목들을 조정하고 싶을 때가 있다. 다음과 같이 list_display 변수를 지정하는 것으로 가능하다.	list_display=('모델의 하위속성1', '모델의 하위속성2',...)
필터	해당 속성에 필터를 걸면 모델의 필드에 맞춰 자동으로 필터를 생성한다.(날짜의 경우, 오늘, 최근7일 등)	list_filter=['필터를 걸 속성']
모델검색	여러 필드를 기입해 검색의 범위를 지정할 수 있다.	search_fields = ['subject'] #검색할 필드를 넣어준다.

수정화면 조정

디테일을 볼 수 있는 내용. 수정화면에서 모델의 속성을 그룹화 하여 수정화면을 편집할 수 있다.

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

@@ 31번째 줄: / 31번째 줄: @@
      ....
      def __str__(self):#관리자페이지에 나타낼 객체 이름.
-         return self.subject#이 객체의 subject를 이름으로 쓰겠다는 의미.
+         return self.subject#이 객체의 subject를 관리자화면에서 이름으로 쓰겠다는 의미.
 </syntaxhighlight>
 |}
 ===디자인 변경===
-관리자페이지의 디자인은...html 점차 채워넣자.
+관리자페이지의 디자인은 장고의 <code>django\contrib\admin\templates\admin\abse_site.html</code> 에 있다. 이를 복사하여 <code>templates/admin/</code> 경로에 붙여넣으면 이를 기초 html로 인식한다.
 =기능=
 ==관리자 화면 커스터마이징==
+기본적으로 클래스를 새로이 지정해준 후 등록하는 방식을 거친다.<syntaxhighlight lang="python">
-===나타나는 필드 순서 변경하기===
-앱이름/admin.py 파일의 클래스에서 필드 순서 변경<syntaxhighlight lang="python">
 from django.contrib import admin
 from .models import Question #모델을 불러오고
 class QuestionAdmin(admin.ModelAdmin):#관리자기능을 위한 클래스
-     fields=['필드명', '필드명2',...]#필드명의 순서에 따라 정렬
+     필요한 내용.
 admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
 </syntaxhighlight>
-필드분리, 필드접기는 156~157 참고하자;; 길다;
+=== 객체 배치 ===
+{| class="wikitable"
+|+
+!의도
+!설명
+!코드(QuestionAdmin 안에 추가한다.)
+|-
+|나타나는 필드 순서 변경하기
+|앱이름/admin.py 파일의 클래스에서 필드 순서 변경
+|<syntaxhighlight lang="python">
+fields=['필드명', '필드명2',...]#필드명의 순서에 따라 정렬
-===디스플레이항목조정===
-관리자화면 목록에 나오는 항목들을 조정하고 싶을 때가 있다. 다음과 같이 list_display 변수를 지정하는 것으로 가능하다.<syntaxhighlight lang="python">
-from django.contrib import admin
-from .models import Question #모델을 불러오고
-class QuestionAdmin(admin.ModelAdmin):#관리자기능을 위한 클래스
-    list_display=('모델의 하위속성1', '모델의 하위속성2',...)
-admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
 </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">
@@ 75번째 줄: / 97번째 줄: @@
          (None, {'fields':['해당항목1', 해당항목2]}),
          ]
-admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
-</syntaxhighlight>
-===모델검색===
-앱의 admin.py를 다음과 같이 수정한다.<syntaxhighlight lang="python">
-from django.contrib import admin
-from .models import Question #모델을 불러오고
-class QuestionAdmin(admin.ModelAdmin):#관리자기능을 위한 클래스
-    search_fields = ['subject'] #검색할 필드를 넣어준다.
 admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
 </syntaxhighlight>
-<br />
+===하위객체와의 관계===
+{| class="wikitable"
-===하위객체 한 화면에서 보기===
+!의도
-연결된 하위객체를 한 화면에서 보고 조작할 수 있다면 관리가 수월해진다.<syntaxhighlight lang="python">
+!설명
+!코드
+|-
+|하위객체 한 화면에서 보기
+|연결된 하위객체를 한 화면에서 보고 조작할 수 있다면 관리가 수월해진다.
+|<syntaxhighlight lang="python">
 from django.contrib import admin
 from .models import Question, Answer #모델을 불러오고
@@ 96번째 줄: / 114번째 줄: @@
 class AnsewerInline(admin.StackedInline):
      model=Answer
-     extra=3#나타나는 갯수. 이게 없으면 어떻게 될까?
+     extra=3#기존에 있던 외에 추가할 수 있는 칸. 몇 개를 만들 것인가?
 class QuestionAdmin(admin.ModelAdmin):
      inlines=[AnsewerInline]#위에서 작성한 클래스를 넣어준다.
 admin.site.register(Question,QuestionAdmin) #QuestionAdmin의 등록을 추가한다.
-</syntaxhighlight>하지만, 위처럼 쓰면 관리자페이지가 너무 길어져 불편하기도 하다. 이럴 땐 객체들을 테이블 형태로 만들어주어야 하는데, 다음과 같이 부모클래스만 바꾸어주면 된다.<syntaxhighlight lang="python">
+</syntaxhighlight>
+|-
+|표로 간결하게 보기
+|하지만, 위처럼 쓰면 관리자페이지가 너무 길어져 불편하기도 하다. 이럴 땐 객체들을 테이블 형태로 만들어주어야 하는데, 다음과 같이 부모클래스만 바꾸어주면 된다.
+|<syntaxhighlight lang="python">
 class AnsewerInline(admin.TabularInline):
      model=Answer
-     extra=3#나타나는 갯수. 이게 없으면 어떻게 될까?
+     extra=3
 </syntaxhighlight>
+|}
-===외래키를 쓰는 객체 한 화면에서 보기===
-앱/admin.py에서... 159 참조.
-데이터가 너무 많아질 경우엔 테이블 형식으로 보는 게 편하다. 160쪽.
-레코드의 이름은 models.py에서 정의한 __srt__()의 리턴값이 사용된다.
-이외 기능은 필요할 때 찾아보자; 기본적인 편의기능은 다 있다고 보면 된다.
 <br />

장고:관리자페이지: 두 판 사이의 차이