Djangoadminsite(一)ModelAdminOptions

2019-11-14 17:31:34

字體：大中小

來源：轉載

供稿：網友

Admin管理界面是django的殺手級應用。它讀取你模式中的元數據，然后提供給你一個強大而且可以使用的界面，網站管理者可以用它立即向網站中添加內容。

要使用admin，可以按照下面的步驟：

將'django.contrib.admin'加入setting的INSTALLED_APPS配置中。
保證INSTALLED_APPS中包含'django.contrib.auth'，'django.contrib.contenttypes'，'django.contrib.messages'和'django.contrib.sessions.'，Django的admin需要這4個包。
將'django.contrib.messages.context_
確定哪些Model需要應用到admin中。
為每個需要admin的app中的admin.py中創建一個ModelAdmin。

from django.contrib import adminfrom myproject.myapp.models import Authorclass AuthorAdmin(admin.ModelAdmin):    passadmin.site.register(Author, AuthorAdmin)

將admin訪問配置在URLconf中

from django.contrib import adminadmin.autodiscover()# And include this URLpattern...urlpatterns = patterns('',    # ...    (r'^admin/', include(admin.site.urls)),    # ...)

運行python manage.py migrate提醒創建superuser后就可以訪問http://127.0.0.1:8000/admin/了。

ModelAdmin對象

register裝飾器

1.7中新添加。Model和ModelAdmin可以這樣注冊：

from django.contrib import adminfrom .models import Author@admin.register(Author)class AuthorAdmin(admin.ModelAdmin):    pass

可以一次注冊多個Model，并且可以使用自己定制的AdminSite：

from django.contrib import adminfrom .models import Author, Reader, Editorfrom 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會自動查找每個app中的admin.py模塊并且import載入。

class apps.AdminConfig
Django 1.7新增.
admin默認的AppConfig類.當django啟動時會執行autodiscover()。

class apps.SimpleAdminConfig
Django 1.7新增.
類似于AdminConfig,不會執行autodiscover().

autodiscover()
import每個app的admin.py模塊。

Django 1.7改變:
在以前的版本中需要在urls.py中手動啟動此方法去尋找每個app的admin.py，1.7后AdminConfig會自動執行此方法。

如果正在使用定制的AdminSite，需要將ModelAdmin的子類載入到自己的代碼中并全部注冊到定制的AdminSite中。這種情況下需要停止自動discovery()，可以將'django.contrib.admin.apps.SimpleAdminConfig'代替INSTALLED_APPS中的'django.contrib.admin'。

ModelAdmin選項

actions

admin actions的列表

actions_on_top
actions_on_bottom

action的位置。

date_hierarchy

將date_hierarchy設成Model的DateField或者DateTimeField，就可以為admin中的此Model添加日期層次。

fields

exclude

決定Model的form中展現哪些字段。fields是包括，exclude是排除。

from django.contrib import adminclass AuthorAdmin(admin.ModelAdmin):    fields = ('name', 'title')class AuthorAdmin(admin.ModelAdmin):    exclude = ('birth_date',)

可以將一些字段放在同一行，如下url和title字段放在同一行：

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

fieldsets

fieldsets是雙元元組(name, field_options)的列表，可以將字段分塊：

from django.contrib import adminclass FlatPageAdmin(admin.ModelAdmin):    fieldsets = (        (None, {            'fields': ('url', 'title', 'content', 'sites')        }),        ('Advanced options', {            'classes': ('collapse',),            'fields': ('enable_comments', 'registration_required', 'template_name')        }),    )

name是塊的標題，field_options是一個字典。

field_options的key有下面幾種：

fields

字段名稱的元組，在fieldset中展示

{'fields': (('first_name', 'last_name'), 'address', 'city', 'state'),}

classes

提供給fieldset的額外 CSS類的列表。

description

可以在fieldset頂部額外展示的文本。

filter_horizontal
filter_vertical

Model有ManyToManyField字段時，使用filter_horizontal，filter_vertical可以從現有的選項中多選。一個為橫排，一個為豎排。

form

使用的表單。

from django import formsfrom django.contrib import adminfrom myapp.models import Personclass PersonForm(forms.ModelForm):    class Meta:        model = Person        exclude = ['name']class PersonAdmin(admin.ModelAdmin):    exclude = ['age']    form = PersonForm

發生沖突時，ModelAdmin優先。上面的例子中age會被排除，但name會在頁面中展示。

formfield_overrides

可以覆蓋Model表單界面的一些字段的選項，為一些特定類型的字段添加自己定制的部件

比如，想為自己Model的TextField字段使用富文本編輯器：

from django.db import modelsfrom django.contrib import admin# Import our custom widget and our model from where they're definedfrom myapp.widgets import RichTextEditorWidgetfrom myapp.models import MyModelclass MyModelAdmin(admin.ModelAdmin):    formfield_overrides = {        models.TextField: {'widget': RichTextEditorWidget},    }

list_display

Model的change list頁面可以展示的字段，如果不設置list_display，admin界面會自動展示Model的__unicode__()結果。

list_display中有4種值：

model的一個字段

list_display = ('first_name', 'last_name')

一個可調用的以model為參數的函數

def upper_case_name(obj):    return ("%s %s" % (obj.first_name, obj.last_name)).upper()upper_case_name.short_description = 'Name'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'

Model的一個屬性，類似于可調用函數

from django.db import modelsfrom django.contrib import adminclass Person(models.Model):    name = models.CharField(max_length=50)    birthday = models.DateField()    def decade_born_in(self):        return self.birthday.strftime('%Y')[:3] + "0's"    decade_born_in.short_description = 'Birth decade'class PersonAdmin(admin.ModelAdmin):    list_display = ('name', 'decade_born_in')

Note：

如果字段是ForeignKey，會顯示外鍵的__unicode__。
不支持ManyToManyField
如果是BooleanField，會顯示on或者off。

如果提供的字符串是Model或者ModelAdmin的方法或者一個可調用函數，django會自動的HTML-escape輸出，如果不想轉義，可以將方法的allow_tags設為True。為了避免XSS跨站攻擊，需要使用format_html轉義用戶的輸入：

from django.db import modelsfrom django.contrib import adminfrom django.utils.html import format_htmlclass 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 colored_name(self):        return format_html('<span style="color: #{0};">{1} {2}</span>',                           self.color_code,                           self.first_name,                           self.last_name)    colored_name.allow_tags = Trueclass PersonAdmin(admin.ModelAdmin):    list_display = ('first_name', 'last_name', 'colored_name')

如果提供的字符串是Model或者ModelAdmin的方法或者一個可調用函數，并且返回True或者False，可以將方法的boolean屬性設為True。這樣頁面上會展示on或者off圖標。

from django.db import modelsfrom django.contrib import adminclass 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 = Trueclass 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 import modelsfrom django.contrib import adminfrom django.utils.html import format_htmlclass Person(models.Model):    first_name = models.CharField(max_length=50)    color_code = models.CharField(max_length=6)    def colored_first_name(self):        return format_html('<span style="color: #{0};">{1}</span>',                           self.color_code,                           self.first_name)    colored_first_name.allow_tags = True    colored_first_name.admin_order_field = 'first_name'class PersonAdmin(admin.ModelAdmin):    list_display = ('first_name', 'colored_first_name')

這樣試圖以colored_first_name排序時，django會以first_name排序。可以反向排序：

colored_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 of the person"    full_name = property(my_property)class PersonAdmin(admin.ModelAdmin):    list_display = ('full_name',)

list_display_link

其中的字段會被鏈接到mode的change頁面

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

list_editable

其中的字段在change list頁面是可以被更改的。在其中的字段也必須在list_display中。

list_filter

其中的字段可以作為過濾器過濾model 。可以是相關域。

class PersonAdmin(admin.UserAdmin):    list_filter = ('company__name',)

list_max_show_all

show all頁面上的model數目，缺省200。

list_per_page

每個change list頁面的model數目，缺省100。

list_select_related

與select_related()有關。

ordering

排序。

paginator

使用的分頁。缺省django.core.paginator.Paginator 。

prepopulated_fields

預置字段。

radio_fields

使用radio-button代替select-box( ForeignKey或者有choices選項時)。

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

raw_id_fields

會展示其中字段的id，用于ForeignKey或者ManyToManyField。

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

readonly_fields

只可讀不可編輯的字段。也可以是方法：

from django.contrib import adminfrom django.utils.html import format_html_joinfrom django.utils.safestring import mark_safeclass PersonAdmin(admin.ModelAdmin):    readonly_fields = ('address_report',)    def address_report(self, instance):        # assuming get_full_address() returns a list of strings        # for each line of the address and you want to separate each        # line by a linebreak        return format_html_join(            mark_safe('<br/>'),            '{0}',            ((line,) for line in instance.get_full_address()),        ) or "<span class='errors'>I can't determine this address.</span>"    # short_description functions like a model field's verbose_name    address_report.short_description = "Address"    # in this example, we have used HTML tags in the output    address_report.allow_tags = True

save_as

設為Ture時，change頁面的 "Save and add another"按鈕會被"Save as"代替。

save_on_top

設為Ture時，change頁面的頂端也會有save按鈕。

search_fields

可搜索字段。

view_on_site

是否顯示View on site鏈接。