1. 程式人生 > >Django - 內建admin

Django - 內建admin

Django內建的Admin是對於model中對應的資料表進行增刪改查提供的元件,使用方式有:

Django內建的Admin是對於model中對應的資料表進行增刪改查提供的元件,使用方式有:


複製程式碼
    依賴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
複製程式碼
一. 配置路由
1 2 3 urlpatterns = [ url(r'^admin/', admin.site.urls), ] 當前配置的路由可以建立一些路由對映關係: /admin/ /admin/login/ /admin/logout/ /admin/password_change/ /admin/password_change/done/ /admin/app名稱/model名稱/ /admin/app名稱/model名稱/add/ /admin/app名稱/model名稱/ID值/history/ /admin/app名稱/model名稱/ID值/change/ /admin/app名稱/model名稱/ID值/delete/ 二. 定製Admin 在admin.py中只需要講Mode中的某個類註冊,即可在Admin中實現增刪改查的功能,如:
1 admin.site.register(models.UserInfo) 但是,這種方式比較簡單,如果想要進行更多的定製操作,需要利用ModelAdmin進行操作,如: 1 2 3 4 5 6 7 8 9 10 11 方式一: class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd',) admin.site.register(models.UserInfo, UserAdmin) # 第一個引數可以是列表 方式二: @admin.register(models.UserInfo)
# 第一個引數可以是列表 class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd',) ModelAdmin中提供了大量的可定製功能,如 1. list_display,列表時,定製顯示的列。 1 2 3 4 5 6 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd', 'xxxxx') def xxxxx(self, obj): return "xxxxx" 2. list_display_links,列表時,定製列可以點選跳轉。 1 2 3 4 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd', 'xxxxx') list_display_links = ('pwd',) 3. list_filter,列表時,定製右側快速篩選。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 from django.utils.translation import ugettext_lazy as _ @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd') class Ugg(admin.SimpleListFilter): title = _('decade born') parameter_name = 'xxxxxx' def lookups(self, request, model_admin): """ 顯示篩選選項 :param request: :param model_admin: :return: """ return models.UserGroup.objects.values_list('id', 'title') def queryset(self, request, queryset): """ 點選查詢時,進行篩選 :param request: :param queryset: :return: """ v = self.value() return queryset.filter(ug=v) list_filter = ('user',Ugg,) 4. list_select_related,列表時,連表查詢是否自動select_related 5. 分頁相關 1 2 3 4 5 6 7 8 # 分頁,每頁顯示條數 list_per_page = 100 # 分頁,顯示全部(真實資料<該值時,才會有顯示全部) list_max_show_all = 200 # 分頁外掛 paginator = Paginator 6. list_editable,列表時,可以編輯的列 1 2 3 4 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd','ug',) list_editable = ('ug',) 7. search_fields,列表時,模糊搜尋的功能 1 2 3 4 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): search_fields = ('user', 'pwd') 8. date_hierarchy,列表時,對Date和DateTime型別進行搜尋 1 2 3 4 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): date_hierarchy = 'ctime' 9. preserve_filters,詳細頁面,刪除、修改,更新後跳轉回列表後,是否保留原搜尋條件 10. save_as = False,詳細頁面,按鈕為“Sava as new” 或 “Sava and add another” 11. save_as_continue = True,點選儲存並繼續編輯 1 2 3 4 5 6 save_as_continue = True # 如果 save_as=True,save_as_continue = True, 點選Sava as new 按鈕後繼續編輯。 # 如果 save_as=True,save_as_continue = False,點選Sava as new 按鈕後返回列表。 New in Django 1.10. 12. save_on_top = False,詳細頁面,在頁面上方是否也顯示儲存刪除等按鈕 13. inlines,詳細頁面,如果有其他表和當前表做FK,那麼詳細頁面可以進行動態增加和刪除 1 2 3 4 5 6 7 8 class UserInfoInline(admin.StackedInline): # TabularInline extra = 0 model = models.UserInfo class GroupAdminMode(admin.ModelAdmin): list_display = ('id', 'title',) inlines = [UserInfoInline, ] 14. action,列表時,定製action中的操作 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): # 定製Action行為具體方法 def func(self, request, queryset): print(self, request, queryset) print(request.POST.getlist('_selected_action')) func.short_description = "中文顯示自定義Actions" actions = [func, ] # Action選項都是在頁面上方顯示 actions_on_top = True # Action選項都是在頁面下方顯示 actions_on_bottom = False # 是否顯示選擇個數 actions_selection_counter = True 15. 定製HTML模板 1 2 3 4 5 6 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 16. raw_id_fields,詳細頁面,針對FK和M2M欄位變成以Input框形式 1 2 3 4 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): raw_id_fields = ('FK欄位', 'M2M欄位',) 17. fields,詳細頁面時,顯示欄位的欄位 1 2 3 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fields = ('user',) 18. exclude,詳細頁面時,排除的欄位 1 2 3 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): exclude = ('user',) 19. readonly_fields,詳細頁面時,只讀欄位 1 2 3 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): readonly_fields = ('user',) 20. fieldsets,詳細頁面時,使用fieldsets標籤對資料進行分割顯示 1 2 3 4 5 6 7 8 9 10 11 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fieldsets = ( ('基本資料', { 'fields': ('user', 'pwd', 'ctime',) }), ('其他', { 'classes': ('collapse', 'wide', 'extrapretty'), # 'collapse','wide', 'extrapretty' 'fields': ('user', 'pwd'), }), ) 21. 詳細頁面時,M2M顯示時,資料移動選擇(方向:上下和左右) 1 2 3 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): filter_vertical = ("m2m欄位",) # 或filter_horizontal = ("m2m欄位",) 22. ordering,列表時,資料排序規則 1 2 3 4 5 6 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): ordering = ('-id',) 或 def get_ordering(self, request): return ['-id', ] 23. view_on_site,編輯時,是否在頁面上顯示view on set 1 2 3 4 view_on_site = False 或 def view_on_site(self, obj): return 'https://www.baidu.com' 24. radio_fields,詳細頁面時,使用radio顯示選項(FK預設使用select) 1 radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL 25. show_full_result_count = True,列表時,模糊搜尋後面顯示的資料個數樣式 1 2 3 4 5 @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',) 26. formfield_overrides = {},詳細頁面時,指定現實外掛 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 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}, } 27. prepopulated_fields = {},新增頁面,當在某欄位填入值後,自動會將值填充到指定欄位。 1 2 3 4 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): prepopulated_fields = {"email": ("user","pwd",)} PS: DjangoAdmin中使用js實現功能,頁面email欄位的值會在輸入:user、pwd時自動填充 28. form = ModelForm,用於定製使用者請求時候表單驗證 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 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 29. empty_value_display = "列資料為空時,顯示預設值" 1 2 3 4 5 6 7 8 9 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): empty_value_display = "列資料為空時,預設顯示" list_display = ('user','pwd','up') def up(self,obj): return obj.user up.empty_value_display = "指定列資料為空時,預設顯示"
Admin 內部依賴

 

一. 配置路由

1 2 3 urlpatterns  =  [          url(r '^admin/' , admin.site.urls),      ]

當前配置的路由可以建立一些路由對映關係:

/admin/
/admin/login/
/admin/logout/
/admin/password_change/
/admin/password_change/done/

/admin/app名稱/model名稱/
/admin/app名稱/model名稱/add/
/admin/app名稱/model名稱/ID值/history/
/admin/app名稱/model名稱/ID值/change/
/admin/app名稱/model名稱/ID值/delete/

二. 定製Admin

在admin.py中只需要講Mode中的某個類註冊,即可在Admin中實現增刪改查的功能,如:

1 admin.site.register(models.UserInfo)

但是,這種方式比較簡單,如果想要進行更多的定製操作,需要利用ModelAdmin進行操作,如:

1 2 3 4 5 6 7 8 9 10 11 方式一:      class  UserAdmin(admin.ModelAdmin):          list_display  =  ( 'user' 'pwd' ,)        admin.site.register(models.UserInfo, UserAdmin)  # 第一個引數可以是列表         方式二:      @admin .register(models.UserInfo)                 # 第一個引數可以是列表      class  UserAdmin(admin.ModelAdmin):          list_display  =  ( 'user' 'pwd' ,)

ModelAdmin中提供了大量的可定製功能,如

1. list_display,列表時,定製顯示的列。

1 2 3 4 5 6 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):      list_display  =  ( 'user' 'pwd' 'xxxxx' )        def  xxxxx( self , obj):          return  "xxxxx"

2. list_display_links,列表時,定製列可以點選跳轉。

1 2 3 4 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):      list_display  =  ( 'user' 'pwd' 'xxxxx' )      list_display_links  =  ( 'pwd' ,)

3. list_filter,列表時,定製右側快速篩選。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 from  django.utils.translation  import  ugettext_lazy as _   @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):      list_display  =  ( 'user' 'pwd' )        class  Ugg(admin.SimpleListFilter):          title  =  _( 'decade born' )          parameter_name  =  'xxxxxx'            def  lookups( self , request, model_admin):              """              顯示篩選選項              :param request:              :param model_admin:              :return:              """              return  models.UserGroup.objects.values_list( 'id' 'title' )            def  queryset( self , request, queryset):              """              點選查詢時,進行篩選              :param request:              :param queryset:              :return:              """              =  self .value()              return  queryset. filter (ug = v)        list_filter  =  ( 'user' ,Ugg,)

4. list_select_related,列表時,連表查詢是否自動select_related

5. 分頁相關

1 2 3 4 5 6 7 8 # 分頁,每頁顯示條數      list_per_page  =  100   # 分頁,顯示全部(真實資料<該值時,才會有顯示全部)      list_max_show_all  =  200   # 分頁外掛      paginator  =  Paginator

6. list_editable,列表時,可以編輯的列

1 2 3 4 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):      list_display  =  ( 'user' 'pwd' , 'ug' ,)      list_editable  =  ( 'ug' ,)

7. search_fields,列表時,模糊搜尋的功能

1 2 3 4 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):            search_fields  =  ( 'user' 'pwd' )

8. date_hierarchy,列表時,對Date和DateTime型別進行搜尋

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

9. preserve_filters,詳細頁面,刪除、修改,更新後跳轉回列表後,是否保留原搜尋條件

10. save_as = False,詳細頁面,按鈕為“Sava as new” 或 “Sava and add another”

11. save_as_continue = True,點選儲存並繼續編輯

1 2 3 4 5 6 save_as_continue  =  True   # 如果 save_as=True,save_as_continue = True, 點選Sava as new 按鈕後繼續編輯。 # 如果 save_as=True,save_as_continue = False,點選Sava as new 按鈕後返回列表。   New  in  Django  1.10 .

12. save_on_top = False,詳細頁面,在頁面上方是否也顯示儲存刪除等按鈕

13. inlines,詳細頁面,如果有其他表和當前表做FK,那麼詳細頁面可以進行動態增加和刪除

1 2 3 4 5 6 7 8 class  UserInfoInline(admin.StackedInline):  # TabularInline      extra  =  0      model  =  models.UserInfo     class  GroupAdminMode(admin.ModelAdmin):      list_display  =  ( 'id' 'title' ,)      inlines  =  [UserInfoInline, ]

14. action,列表時,定製action中的操作

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):        # 定製Action行為具體方法      def  func( self , request, queryset):          print ( self , request, queryset)          print (request.POST.getlist( '_selected_action' ))        func.short_description  =  "中文顯示自定義Actions"      actions  =  [func, ]        # Action選項都是在頁面上方顯示      actions_on_top  =  True      # Action選項都是在頁面下方顯示      actions_on_bottom  =  False        # 是否顯示選擇個數      actions_selection_counter  =  True

15. 定製HTML模板

1 2 3 4 5 6 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

16. raw_id_fields,詳細頁面,針對FK和M2M欄位變成以Input框形式

1 2 3 4 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):        raw_id_fields  =  ( 'FK欄位' 'M2M欄位' ,)

17. fields,詳細頁面時,顯示欄位的欄位

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

18. exclude,詳細頁面時,排除的欄位

1 2 3 @admin .register(models.UserInfo) class  UserAdmin(admin.ModelAdmin):      exclude