8.10 Django admin組件使用
介紹
admin 組件實現了更方便的WEB後臺數據管理方式
settings.py 中第一個組件就是 :
INSTALLED_APPS = [ ‘django.contrib.admin‘, ‘django.contrib.auth‘, ‘django.contrib.contenttypes‘, ‘django.contrib.sessions‘, ‘django.contrib.messages‘, ‘django.contrib.staticfiles‘, "app01" ]
啟用
通常 在pycharm 中創建 Django 項目的時候就自動在url 中生成了一條admin 相關的路由了
from django.conf.urls import url from django.contrib import admin urlpatterns = [ url(r‘^admin/‘, admin.site.urls), ]
使用
路由接口
路有前綴為 admin ,進入後需要超級用戶權限才可以操作
http://127.0.0.1:8000/admin/
超級用戶創建
python manage.py createsuperuser
admin 註冊
想要在admin 界面管理某個數據模型(model),我們需要先將該數據模型(model)註冊到 admin。
註冊後才可以在 web進行表單數據行的操作
admin.site.register(models.Publisher) admin.site.register(models.Book) admin.site.register(models.Author)
定制
倘若需要定制,register 可以接收兩個參數,第二個參數接受一個自定義類,自定制類必須繼承 admin.ModelAdmin
或者通過 裝飾器方式,直接將自定義類加裝 admin.register(模型)裝飾器
# 註冊方式1 class PublisherAdmin(admin.ModelAdmin): list_display = ("name", "address") admin.site.register(models.Publisher, PublisherAdmin) # 註冊方式2 @admin.register(models.Book) class BookAdmin(admin.ModelAdmin): list_display = ("title", "price", "publish_date", "publisher")
ModelAdmin支持的定制項
ModelAdmin中提供了大量的可定制功能,如
1. list_display,列表時,定制顯示的列。
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = (‘user‘, ‘pwd‘, ‘xxxxx‘) def xxxxx(self, obj): return "xxxxx"
2. list_display_links,列表時,定制列可以點擊跳轉。
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = (‘user‘, ‘pwd‘, ‘xxxxx‘) list_display_links = (‘pwd‘,)
3. list_filter,列表時,定制右側快速篩選。
4. list_select_related,列表時,連表查詢是否自動select_related
5. list_editable,列表時,可以編輯的列
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = (‘user‘, ‘pwd‘,‘ug‘,) list_editable = (‘ug‘,)
6. search_fields,列表時,模糊搜索的功能
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): search_fields = (‘user‘, ‘pwd‘)
7. date_hierarchy,列表時,對Date和DateTime類型進行搜索
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): date_hierarchy = ‘ctime‘
8 inlines,詳細頁面,如果有其他表和當前表做FK,那麽詳細頁面可以進行動態增加和刪除
class UserInfoInline(admin.StackedInline): # TabularInline extra = 0 model = models.UserInfo class GroupAdminMode(admin.ModelAdmin): list_display = (‘id‘, ‘title‘,) inlines = [UserInfoInline, ]
9 action,列表時,定制action中的操作
@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
安分的分割線
10 定制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
11 raw_id_fields,詳細頁面,針對FK和M2M字段變成以Input框形式
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): raw_id_fields = (‘FK字段‘, ‘M2M字段‘,)
12 fields,詳細頁面時,顯示字段的字段
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fields = (‘user‘,)
13 exclude,詳細頁面時,排除的字段
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): exclude = (‘user‘,)
14 readonly_fields,詳細頁面時,只讀字段
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): readonly_fields = (‘user‘,)
15 fieldsets,詳細頁面時,使用fieldsets標簽對數據進行分割顯示
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fieldsets = ( (‘基本數據‘, { ‘fields‘: (‘user‘, ‘pwd‘, ‘ctime‘,) }), (‘其他‘, { ‘classes‘: (‘collapse‘, ‘wide‘, ‘extrapretty‘), # ‘collapse‘,‘wide‘, ‘extrapretty‘ ‘fields‘: (‘user‘, ‘pwd‘), }), )
16 filter_vertical 詳細頁面時,M2M顯示時,數據移動選擇(方向:上下和左右)
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): filter_vertical = ("m2m字段",) # 或filter_horizontal = ("m2m字段",)
17 ordering,列表時,數據排序規則
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): ordering = (‘-id‘,) 或 def get_ordering(self, request): return [‘-id‘, ]
18. radio_fields,詳細頁面時,使用radio顯示選項(FK默認使用select)
radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL
19 form = ModelForm,用於定制用戶請求時候表單驗證
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
20 empty_value_display = "列數據為空時,顯示默認值"
@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 = "指定列數據為空時,默認顯示"示例代碼
8.10 Django admin組件使用