Django admin是Django 提供的基于 web 的管理工具扼鞋。Django 自動(dòng)管理工具是 django.contrib 的一部分蘑志。你可以在項(xiàng)目的 settings.py 中的 INSTALLED_APPS 看到它穗泵。django.contrib是一套龐大的功能集瓮孙，它是Django基本代碼的組成部分坊秸。

Django內(nèi)置的Admin是對(duì)于model中對(duì)應(yīng)的數(shù)據(jù)表進(jìn)行增刪改查提供的組件麸祷。

admin的內(nèi)部依賴(lài)：
    依賴(lài)APP：
        django.contrib.auth
        django.contrib.contenttypes
        django.contrib.messages
        django.contrib.sessions

    模板的context_processors：
        django.contrib.auth.context_processors.auth
        django.contrib.messages.context_processors.messages

    中間件：
        django.contrib.auth.middleware.AuthenticationMiddleware 
        django.contrib.messages.middleware.MessageMiddleware

一、定制admin

• 在admin.py中只需要將Mode中的某個(gè)類(lèi)注冊(cè)一下褒搔，即可在Admin中實(shí)現(xiàn)增刪改查的功能阶牍，注冊(cè)規(guī)則如下：

from django.contrib import admin
from app import models
admin.site.register(models.UserInfo)

• 以上這種方式比較簡(jiǎn)單喷面，如果想要進(jìn)行更多的定制操作，需要利用ModelAdmin進(jìn)行操作走孽，如下：

方式一：
    class UserAdmin(admin.ModelAdmin):#必須繼承admin.ModelAdmin
        pass 
    admin.site.register(models.UserInfo, UserAdmin)  # 第一個(gè)參數(shù)可以是列表
      
方式二：
    @admin.register(models.UserInfo) # 第一個(gè)參數(shù)可以是列表
    class UserAdmin(admin.ModelAdmin):
        list_display = ('user', 'pwd',)

二惧辈、 ModelAdmin中提供的可定制功能簡(jiǎn)單示例

• list_display，列表或元組內(nèi)的元素是Model中的字符串類(lèi)型的字段磕瓷，定制顯示的列盒齿。

class UserInfo(admin.ModelAdmin):
   list_display = ("username","phone","email")

admin.site.register(models.UserInfo,UserInfo)

• list_display_links，列表或元組內(nèi)的元素是Model中的字符串類(lèi)型的字段困食，定制列可以點(diǎn)擊跳轉(zhuǎn)边翁。

class UserInfo(admin.ModelAdmin):
    list_display = ("username","phone","email")
    list_display_links = ['username','phone','email']
admin.site.register(models.UserInfo,UserInfo)

• list_filter，定制右側(cè)快速篩選硕盹。

class UserInfo(admin.ModelAdmin):
    list_display = ("username","phone","email")
    list_display_links = ['username','phone','email']
    list_filter = ['username','phone']#一般列表里面存放的字段都是一對(duì)多的字段符匾，要不然就沒(méi)什么意義了

admin.site.register(models.UserInfo,UserInfo)

• search_fields，模糊搜索的功能

class UserInfo(admin.ModelAdmin):
    list_display = ("username","phone","email")
    list_display_links = ['username','phone','email']
    list_filter = ['username','phone']#一般列表里面存放的字段都是一對(duì)多的字段瘩例，要不然就沒(méi)什么意義了
    search_fields = ["username",'phone']

admin.site.register(models.UserInfo,UserInfo)

• action啊胶，定制action中的操作

class ArticleAction(admin.ModelAdmin):

    def func(self, request, queryset):
        queryset.delete()

    func.short_description = "快捷刪除選中項(xiàng)"
    actions = [func, ]
    # Action選項(xiàng)都是在頁(yè)面上方顯示
    actions_on_top = True
    # Action選項(xiàng)都是在頁(yè)面下方顯示
    actions_on_bottom = False
    # 是否顯示選擇個(gè)數(shù)
    actions_selection_counter = True

admin.site.register(models.Article,ArticleAction)

• list_select_related，連表查詢(xún)是否自動(dòng)select_related,對(duì)應(yīng)的值是Ture或False
• 分頁(yè)相關(guān)

# 分頁(yè)垛贤，每頁(yè)顯示條數(shù)
    list_per_page = 100
 
# 分頁(yè)焰坪，顯示全部（真實(shí)數(shù)據(jù)<該值時(shí)，才會(huì)有顯示全部）
    list_max_show_all = 200
 
# 分頁(yè)插件
    paginator = Paginator

• date_hierarchy聘惦，對(duì)Date和DateTime類(lèi)型進(jìn)行搜索

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    date_hierarchy = 'ctime'

• preserve_filters某饰，詳細(xì)頁(yè)面，刪除部凑、修改露乏，更新后跳轉(zhuǎn)回列表后，是否保留原搜索條件
• save_as = False涂邀，詳細(xì)頁(yè)面瘟仿，按鈕為“Sava as new” 或 “Sava and add another”
• save_as_continue = True，點(diǎn)擊保存并繼續(xù)編輯

save_as_continue = True
 
# 如果 save_as=True比勉，save_as_continue = True劳较， 點(diǎn)擊Sava as new 按鈕后繼續(xù)編輯。
# 如果 save_as=True浩聋，save_as_continue = False观蜗，點(diǎn)擊Sava as new 按鈕后返回列表。
 
New in Django 1.10.

• save_on_top = False衣洁，詳細(xì)頁(yè)面墓捻，在頁(yè)面上方是否也顯示保存刪除等按鈕
• inlines，詳細(xì)頁(yè)面坊夫，如果有其他表和當(dāng)前表做FK砖第，那么詳細(xì)頁(yè)面可以進(jìn)行動(dòng)態(tài)增加和刪除

class UserInfoInline(admin.StackedInline): # TabularInline
    extra = 0
    model = models.UserInfo
 
class GroupAdminMode(admin.ModelAdmin):
    list_display = ('id', 'title',)
    inlines = [UserInfoInline, ]

• 定制HTML模板

add_form_template = None
change_form_template = None
change_list_template = None
delete_confirmation_template = None
delete_selected_confirmation_template = None
object_history_template = None

• raw_id_fields撤卢，詳細(xì)頁(yè)面，針對(duì)FK和M2M字段變成以Input框形式

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
 
    raw_id_fields = ('FK字段', 'M2M字段',)

• fields梧兼，詳細(xì)頁(yè)面時(shí)放吩，顯示字段的字段

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    fields = ('user',)

• exclude，詳細(xì)頁(yè)面時(shí)羽杰，排除的字段

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    exclude = ('user',)

• readonly_fields渡紫，詳細(xì)頁(yè)面時(shí)，只讀字段

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    readonly_fields = ('user',)

• fieldsets考赛，詳細(xì)頁(yè)面時(shí)惕澎，使用fieldsets標(biāo)簽對(duì)數(shù)據(jù)進(jìn)行分割顯示

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    fieldsets = (
        ('基本數(shù)據(jù)', {
            'fields': ('user', 'pwd', 'ctime',)
        }),
        ('其他', {
            'classes': ('collapse', 'wide', 'extrapretty'),  # 'collapse','wide', 'extrapretty'
            'fields': ('user', 'pwd'),
        }),
    )

• 詳細(xì)頁(yè)面時(shí)，M2M顯示時(shí)欲虚，數(shù)據(jù)移動(dòng)選擇（方向：上下和左右）

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    filter_vertical = ("m2m字段",) # 或filter_horizontal = ("m2m字段",)

• ordering集灌，列表時(shí)悔雹，數(shù)據(jù)排序規(guī)則

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
   ordering = ('-id',)
   或
   def get_ordering(self, request):
       return ['-id', ]

• view_on_site复哆，編輯時(shí)，是否在頁(yè)面上顯示view on set

view_on_site = False
或
def view_on_site(self, obj):
    return 'https://www.baidu.com'

• radio_fields腌零，詳細(xì)頁(yè)面時(shí)梯找，使用radio顯示選項(xiàng)（FK默認(rèn)使用select）

radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL

• show_full_result_count = True，列表時(shí)益涧，模糊搜索后面顯示的數(shù)據(jù)個(gè)數(shù)樣式

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    # show_full_result_count = True # 1 result (12 total)
    # show_full_result_count = False  # 1 result (Show all)
    search_fields = ('user',)

• formfield_overrides = {}锈锤，詳細(xì)頁(yè)面時(shí)，指定現(xiàn)實(shí)插件

from django.forms import widgets
from django.utils.html import format_html
 
class MyTextarea(widgets.Widget):
    def __init__(self, attrs=None):
        # Use slightly better defaults than HTML's 20x2 box
        default_attrs = {'cols': '40', 'rows': '10'}
        if attrs:
            default_attrs.update(attrs)
        super(MyTextarea, self).__init__(default_attrs)
 
    def render(self, name, value, attrs=None):
        if value is None:
            value = ''
        final_attrs = self.build_attrs(attrs, name=name)
        return format_html('<textarea {}>\r\n{}</textarea>',final_attrs, value)
  
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
 
    formfield_overrides = {
        models.models.CharField: {'widget': MyTextarea},
    }

• prepopulated_fields = {}闲询，添加頁(yè)面久免，當(dāng)在某字段填入值后，自動(dòng)會(huì)將值填充到指定字段扭弧。

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
 
    prepopulated_fields = {"email": ("user","pwd",)}

PS: DjangoAdmin中使用js實(shí)現(xiàn)功能阎姥，頁(yè)面email字段的值會(huì)在輸入：user、pwd時(shí)自動(dòng)填充

• form = ModelForm鸽捻，用于定制用戶請(qǐng)求時(shí)候表單驗(yàn)證

from app01 import models
from django.forms import ModelForm
from django.forms import fields
 
class MyForm(ModelForm):
    others = fields.CharField()
 
    class Meta:
        model = models = models.UserInfo
        fields = "__all__"
 
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
 
    form = MyForm

• empty_value_display = "列數(shù)據(jù)為空時(shí)呼巴，顯示默認(rèn)值"

@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
    empty_value_display = "列數(shù)據(jù)為空時(shí)，默認(rèn)顯示"
 
    list_display = ('user','pwd','up')
 
    def up(self,obj):
        return obj.user
    up.empty_value_display = "指定列數(shù)據(jù)為空時(shí)御蒲，默認(rèn)顯示"