Djangoadminsite(一)ModelAdminOptions-파이썬 튜토리얼-php.cn

관리자 관리 인터페이스는 Django의 킬러 애플리케이션입니다. 이는 스키마의 메타데이터를 읽은 다음 웹 사이트 관리자가 웹 사이트에 콘텐츠를 즉시 추가하는 데 사용할 수 있는 강력하고 사용 가능한 인터페이스를 제공합니다.

관리자를 사용하려면 다음 단계를 따르세요.

설정의 INSTALLED_APPS 구성에 'django.contrib.admin'을 추가하세요.

INSTALLED_APPS에 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.messages' 및 'django.contrib.sessions.'가 포함되어 있는지 확인하세요. Django 관리자에게는 이 4개의 Bag이 필요합니다.

'django.contrib.messages.context_PROcessors.messages'를 TEMPLATE_CONTEXT_PROCESSORS에 추가하고 MIDDLEWARE_CLASSES에 'django.contrib.auth.middleware.AuthenticationMiddleware' 및 'django.contrib.messages.middleware.MessageMiddleware'가 포함되어 있는지 확인하세요. (기본적으로 추가됨)

관리자에게 적용해야 할 모델을 결정합니다.

관리자가 필요한 각 앱의 admin.py에 ModelAdmin을 만듭니다.

Model 및 ModelAdmin 등록

from django.contrib import admin
from myproject.myapp.models import Author

class AuthorAdmin(admin.ModelAdmin):
pass
admin.site.register(Author, AuthorAdmin)

URLconf에서 관리자 액세스 구성

from django.contrib import admin
admin.autodiscover()

# 그리고 이 URL 패턴을 포함하세요...
urlpatterns = 패턴('',
# ...
(r'^admin/', include(admin.site.urls) ),
# ...
)

python Manage.py migration을 실행하여 수퍼유저 생성을 알리면 http://127.0.0.1:8000/admin/에 액세스할 수 있습니다.

ModelAdmin 객체

1.7에 새로 추가되었습니다. Model 및 ModelAdmin은 다음과 같이 등록할 수 있습니다:

from django.contrib import admin
from .models import Author

@admin.register(Author)
class AuthorAdmin(admin. ModelAdmin) :
pass

한 번에 여러 모델을 등록할 수 있으며 사용자 정의된 AdminSite를 사용할 수 있습니다:

from django.contrib import admin
from .models import Author, Reader, Editor
from myproject.admin_site import custom_admin_site

@admin.register(Author, Reader, Editor, site=custom_admin_site)
class PersonAdmin(admin.ModelAdmin):
pass

Admin 작동 방식

'django.contrib.admin'이 INSTALLED_APPS에 추가되면 django는 자동으로 각 앱에서 admin.py 모듈을 찾아 가져옵니다.

class apps.AdminConfig
Django 1.7 new.
Django가 시작되면 관리자 기본 AppConfig 클래스가 실행됩니다.

class apps.SimpleAdminConfig
Django 1.7의 새로운 기능.
AdminConfig와 유사하며 autodiscover()를 실행하지 않습니다.

autodiscover()
각 관리자를 가져옵니다. app .py 모듈.

Django 1.7 변경 사항:
이전 버전에서는 각 앱의 admin.py를 찾으려면 urls.py에서 이 메서드를 수동으로 시작해야 했습니다. 1.7 이후에는 AdminConfig가 이 메서드를 자동으로 실행합니다.

사용자 정의된 AdminSite를 사용하는 경우 ModelAdmin의 하위 클래스를 자체 코드로 로드하고 이를 모두 사용자 정의된 AdminSite에 등록해야 합니다. 이 경우 자동 검색()을 중지해야 하며, INSTALLED_APPS의 'django.contrib.admin'을 'django.contrib.admin.apps.SimpleAdminConfig'로 대체하면 됩니다.

ModelAdmin 옵션

actions

관리자 작업 목록

actions_on_top
actions_on_bottom

작업 위치.

date_hierarchy

date_hierarchy를 모델의 DateField 또는 DateTimeField로 설정하여 관리자에서 이 모델에 날짜 계층 구조를 추가하세요.

fields

exclude

는 모델 양식에 표시되는 필드를 결정합니다. 필드에는 포함, 제외 제외가 포함됩니다.

from django.contrib import admin

class AuthorAdmin(admin.ModelAdmin):
fields = ('name', 'title')

class AuthorAdmin(admin) .ModelAdmin):
제외 = ('생년월일',)

같은 줄에 다음 URL 및 제목 필드와 같이 일부 필드를 같은 줄에 배치할 수 있습니다.

class FlatPageAdmin(admin.ModelAdmin):
fields = (('url', 'title'), 'content')

fieldsets

fieldsets는 이중 튜플(이름, field_options), 필드는 블록으로 나눌 수 있습니다:

from django.contrib import admin

class FlatPageAdmin(admin.ModelAdmin):
fieldsets = (
(없음) , {
' 접기',),
'필드': ('enable_comments', 'registration_required', 'template_name')
}),
)

name은 블록의 제목이고 field_options는 사전입니다.

field_options의 키는 다음과 같습니다:

fields

fieldset

{
'fields'에 표시되는 필드 이름 튜플 : (('first_name', 'last_name'), 'address', 'city', 'state'),
}

클래스

필드셋 목록에 추가 제공 CSS 클래스 중.

설명

필드셋 상단에 표시할 수 있는 추가 텍스트입니다.

filter_horizontal
filter_vertical

모델에 ManyToManyField 필드가 있는 경우 filter_horizontal을 사용하며 기존 옵션에서 filter_vertical을 선택할 수 있습니다. 하나는 가로, 하나는 세로입니다.

양식

사용된 양식입니다.

django 가져오기 양식
from django.contrib import admin
from myapp.models import Person

class PersonForm(forms.ModelForm):

class Meta :
모델 = 사람
제외 = ['이름']

class PersonAdmin(admin.ModelAdmin):
제외 = ['나이']
form = PersonForm

충돌이 발생하면 ModelAdmin이 우선적으로 적용됩니다. 위의 예에서는 나이는 제외되지만 이름은 페이지에 표시됩니다.

formfield_overrides

모델 양식 인터페이스에서 일부 필드의 옵션을 재정의하고 일부 특정 유형의 필드에 대해 사용자 정의된 구성 요소를 추가할 수 있습니다.

예를 들어 다음을 수행할 수 있습니다. 자신만의 모델의 TextField 필드 추가 서식 있는 텍스트 편집기 사용:

from django.db import models
from django.contrib import admin

# 사용자 정의 위젯과 모델을 해당 위치에서 가져옵니다. 정의되었습니다
from myapp.widgets import RichTextEditorWidget
from myapp.models import MyModel

class MyModelAdmin(admin.ModelAdmin):
formfield_overrides = {
models.TextField: {' widget': RichTextEditorWidget},
}

list_display

모델의 변경 목록 페이지에 표시할 수 있는 필드 list_display가 설정되지 않은 경우 관리 인터페이스가 자동으로 표시됩니다. 모델의 __unicode__() 결과.

list_display에는 4개의 값이 있습니다:

모델 필드

list_display = ('first_name', 'last_name')

모델을 매개변수로 사용하는 호출 가능한 함수

def upper_case_name(obj):
return ("%s %s" % (obj.first_name, obj.last_name)).upper()
upper_case_name .short_description = '이름'

class PersonAdmin(admin.ModelAdmin):
list_display = (upper_case_name,)　

ModelAdmin의 속성, 호출 가능한 함수와 유사

class PersonAdmin(admin.ModelAdmin):
list_display = ('upper_case_name',)

def upper_case_name(self, obj):
return ("%s %s" % ( obj.first_name, obj.last_name)).upper()
upper_case_name.short_description = 'Name'

django의 호출 가능 함수

와 유사한 Model의 속성 .db import models
from django.contrib import admin

class Person(models.Model):
name = models.CharField(max_length=50)
birthday = models.DateField( )

defdede_born_in(self):
return self.birthday.strftime('%Y')[:3] + "0's"
decade_born_in.short_description = '탄생 10년'

class PersonAdmin(admin.ModelAdmin):
list_display = ('name', 'decade_born_in')

참고:

필드가 ForeignKey인 경우 표시되는 키의 __unicode__입니다.

ManyToManyField는 지원하지 않습니다

BooleanField인 경우 on/off가 표시됩니다.

제공된 문자열이 Model 또는 ModelAdmin의 메서드이거나 호출 가능한 함수인 경우 Django는 출력을 자동으로 HTML 이스케이프합니다. 이스케이프를 원하지 않으면 메서드의 허용_태그를 True로 설정할 수 있습니다. XSS 사이트 간 공격을 방지하려면 format_html을 사용하여 사용자 입력을 이스케이프 처리해야 합니다.

django.db에서 모델 가져오기
django.contrib에서 관리자 가져오기
django.utils.html에서 import format_html

class Person(models.Model):
first_name = models. CharField(max_length=50)
last_name = models.CharField(max_length=50)
color_code = models.CharField(max_length=6)

def Coloured_name(self):
return format_html( '{1} {2}',
이 🎜>
class PersonAdmin(admin.ModelAdmin):
list_display = ('first_name', 'last_name', 'color_name')　

제공된 문자열이 Model 또는 ModelAdmin 또는 호출 가능한 함수를 호출하고 True 또는 False를 반환하는 경우 메서드의 부울 속성을 True로 설정할 수 있습니다. 이런 식으로 켜기 또는 끄기 아이콘이 페이지에 표시됩니다.

django.db에서 모델 가져오기
django.contrib에서 가져오기 관리자

class Person(models.Model):

first_name = models.CharField(max_length=50)

birthday = models.DateField()

def Born_in_fifties(self):
return self.birthday.strftime('%Y')[:3] == '195'
Born_in_fifties.boolean = True

class PersonAdmin(admin.ModelAdmin):
list_display = ('name', 'born_in_fifties')　

Model의 __str__ 또는 __unicode__ 메서드도

list_display = ('__str__', 'some_other_field')

list_display의 항목이 데이터베이스의 실제 필드가 아닌 경우 이 항목을 기준으로 정렬할 수 없습니다. 그렇지 않으면 이 항목으로 주문할 수 있으며 admin_order_field 속성을 설정하여 이 사실을 지적할 수 있습니다.

from django.db 모델 가져오기
from django.contrib 가져오기 관리자

from django.utils.html import format_html

class Person(models.Model):

first_name = models.CharField(max_length=50)
color_code = models.CharField(max_length=6)

def Coloured_first_name(self):
return format_html('{1}',
_tags = 참
color_first_name.admin_order_field = 'first_name'

class PersonAdmin(admin.ModelAdmin):
list_display = ('first_name', 'color_first_name')

colored_first_name으로 정렬하려고 하면 django는 first_name으로 정렬합니다. 역순으로 정렬 가능:

color_first_name.admin_order_field = '-first_name'

list_display의 항목은 속성일 수도 있습니다:

class Person(object):

first_name = models.CharField(max_length=50)

last_name = models.CharField(max_length=50)

def my_property(self):

return self.first_name + ' ' + self. last_name

my_property.short_description = "본인의 성명"

full_name = property(my_property)

class PersonAdmin(admin.ModelAdmin):
list_display = ('full_name' ,)　

list_display_link

해당 필드는 모드 변경 페이지로 연결됩니다

class PersonAdmin(admin.ModelAdmin):
list_display = (' first_name ', 'last_name', 'birthday')
list_display_links = ('first_name', 'last_name')

list_editable

변경된 변경 목록 페이지에서 해당 필드를 사용할 수 있습니다. . 그 안의 필드도 list_display에 있어야 합니다.

list_filter

여기에 포함된 필드는 모델을 필터링하는 필터로 사용될 수 있습니다. 관련 도메인일 수 있습니다.

class PersonAdmin(admin.UserAdmin):

list_filter = ('company__name',)

list_max_show_all

모두 표시 페이지의 모델 수 , 저장 200이 누락되었습니다.

list_per_page

각 변경 목록 페이지의 모델 수, 기본값은 100입니다.

list_select_관련

select_관련()과 관련됩니다.

주문

주문.

페이지네이터

에서 사용하는 페이지네이터입니다. 기본 django.core.paginator.Paginator.

prepopulated_fields

미리 채워진 필드입니다.

radio_fields

선택 상자 대신 라디오 버튼을 사용하세요(ForeignKey 또는 선택 옵션이 있는 경우).

class PersonAdmin(admin.ModelAdmin):
radio_fields = {"group": admin.VERTICAL}

raw_id_fields

는 fields , ForeignKey 또는 ManyToManyField에 사용됩니다.

class ArticleAdmin(admin.ModelAdmin):
raw_id_fields = ("newspaper",)

readonly_fields

읽을 수 있고 편집할 수 없는 필드만. 메소드일 수도 있습니다:

from django.contrib import admin
from django.utils.html import format_html_join
from django.utils.safestring import mark_safe

class PersonAdmin( admin.ModelAdmin):
readonly_fields = ('address_report',)

def address_report(self, instance):
# get_full_address()가 문자열 목록을 반환한다고 가정
# 각 줄 주소의 각
# 줄을 줄바꿈으로 구분합니다
return format_html_join(
mark_safe('
'),
((( line,) 라인 입력의 경우 instance.get_full_address()),
) 또는 "이 주소를 확인할 수 없습니다."

# short_description 함수는 모델 필드와 같습니다. verbose_name
address_report.short_description = "Address"
# 이 예에서는 출력에 HTML 태그를 사용했습니다.
address_report.allow_tags = True