Django-admin管理工具使用

admin組件使用

Django 提供了基于 web 的管理工具.
Django 自動(dòng)管理工具是 django.contrib 的一部分.你可以在項(xiàng)目的settings.py 中的 INSTALLED_APPS 看到它:

# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    "app01"
]

django.contrib 是一套龐大的功能集,它是 Django 基本代碼的組成部分.

激活管理工具

通常我們?cè)谏身?xiàng)目時(shí)會(huì)在 urls.py 中自動(dòng)設(shè)置好，

from django.conf.urls import url
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),

]

當(dāng)這一切都配置好后,Django 管理工具就可以運(yùn)行了.

使用管理工具

啟動(dòng)開發(fā)服務(wù)器，然后在瀏覽器中訪問 http://127.0.0.1:8000/admin/，得到登陸界面，你可以通過(guò)命令 python manage.py createsuperuser 來(lái)創(chuàng)建超級(jí)用戶。

為了讓 admin 界面管理某個(gè)數(shù)據(jù)模型，我們需要先注冊(cè)該數(shù)據(jù)模型到 admin
eg:
models.py

from django.db import models

# Create your models here.
class Author(models.Model):
    nid = models.AutoField(primary_key=True)
    name=models.CharField( max_length=32)
    age=models.IntegerField()

    # 與AuthorDetail建立一對(duì)一的關(guān)系
    authorDetail=models.OneToOneField(to="AuthorDetail",on_delete=models.CASCADE)
    def __str__(self):
        return self.name

class AuthorDetail(models.Model):

    nid = models.AutoField(primary_key=True)
    birthday=models.DateField()
    telephone=models.BigIntegerField()
    addr=models.CharField( max_length=64)
    def __str__(self):
        return str(self.telephone)

class Publish(models.Model):
    nid = models.AutoField(primary_key=True)
    name=models.CharField( max_length=32)
    city=models.CharField( max_length=32)
    email=models.EmailField()

    def __str__(self):
        return self.name


class Book(models.Model):

    nid = models.AutoField(primary_key=True)
    title = models.CharField( max_length=32)
    publishDate=models.DateField()
    price=models.DecimalField(max_digits=5,decimal_places=2)

    # 與Publish建立一對(duì)多的關(guān)系,外鍵字段建立在多的一方
    publish=models.ForeignKey(to="Publish",to_field="nid",on_delete=models.CASCADE)
    # 與Author表建立多對(duì)多的關(guān)系,ManyToManyField可以建在兩個(gè)模型中的任意一個(gè)，自動(dòng)創(chuàng)建第三張表
    authors=models.ManyToManyField(to='Author',)
    def __str__(self):
        return self.title

admin.py

from app01.models import Book
from app01.models import Publish
from app01.models import Author
from app01.models import AuthorDetail

admin.site.register(Book)
admin.site.register(Publish)
admin.site.register(Author)
admin.site.register(AuthorDetail)

admin定制

在 admin.py 中只需要將 Mode 中的某個(gè)類注冊(cè),即可在Admin中實(shí)現(xiàn)增刪改查的功能,如:
admin.site.register(Book)
但是,這種方式比較簡(jiǎn)單,如果想要進(jìn)行更多的定制操作,需要利用ModelAdmin進(jìn)行操作,如:

# 方式一:
class BookConfig(admin.ModelAdmin):
    list_display = ["title","price","publishDate"]
admin.site.register(Book,BookConfig)  # 第一個(gè)參數(shù)可以是元祖

# 方式二:
@admin.register(Book,BookConfig)   # 第一個(gè)參數(shù)可以是元祖
class BookConfig(admin.ModelAdmin):
    list_display = ["title","price","publishDate"]

我們?yōu)槭裁匆^承admin.ModelAdmin呢?這就得看admin源碼了.
首先我們看admin.site.register的register到底干了什么

image.png

ModelAdmin就是默認(rèn)的定制類
image.png

ModelAdmin中提供了大量的可定制功能，如
1.list_display,列表時(shí),定制顯示的列

class BookConfig(admin.ModelAdmin):
    list_display = ["title","price","publishDate"]
image.png
  1. list_display_links，列表時(shí)，定制列可以點(diǎn)擊跳轉(zhuǎn)。
class BookConfig(admin.ModelAdmin):
    list_display = ["title","price","publishDate"]
    list_display_links = ["title","price","nid"]
image.png

(media/15319841381000/15320774163440.jpg)

  1. list_filter，列表時(shí)，定制右側(cè)快速篩選。
    list_filter = ["publish","authors"]

    image.png

  2. list_select_related，列表時(shí)，連表查詢是否自動(dòng)select_related

  3. list_editable，列表時(shí)，可以編輯的列

# 注意事項(xiàng) list_editable 里邊的字段必須包含在 list_display 不包含在 list_display_links
# <class 'app01.admin.BookConfig'>: (admin.E122) The value of 'list_editable[0]' refers to 'authors', which is not contained in 'list_display'.
# <class 'app01.admin.BookConfig'>: (admin.E123) The value of 'title' cannot be in both 'list_editable' and 'list_display_links'.

list_editable = ['publishDate',]
image.png
  1. search_fields，列表時(shí)，模糊搜索的功能
# 搜索框內(nèi)輸入關(guān)鍵字過(guò)濾的字段
    search_fields = ['price', 'title']
image.png

(media/15319841381000/15322648400241.jpg)

  1. date_hierarchy，列表時(shí)，對(duì)Date和DateTime類型進(jìn)行搜索
    date_hierarchy = 'ctime'
    image.png

    image.png

8 inlines，詳細(xì)頁(yè)面，如果有其他表和當(dāng)前表做FK，那么詳細(xì)頁(yè)面可以進(jìn)行動(dòng)態(tài)增加和刪除

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

9 action，列表時(shí)，定制action中的批量操作


    def patch_init(self,request,queryset):
        queryset.update(price=100)

    patch_init.short_description = '價(jià)格初始化"100"'

    actions = [patch_init]  # 你可以定義多個(gè)函數(shù),寫到列表里
    
    # Action選項(xiàng)都是在頁(yè)面上方顯示
    actions_on_top = True
    # Action選項(xiàng)都是在頁(yè)面下方顯示
    actions_on_bottom = False
    # 是否顯示選擇個(gè)數(shù)
    actions_selection_counter = True
image.png

image.png

10 定制HTML模板

# 僅供參考 eg:
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，詳細(xì)頁(yè)面，針對(duì)FK和M2M字段變成以Input框形式

# 僅供參考 eg:
    raw_id_fields = ('FK字段', 'M2M字段',)

12 fields，詳細(xì)頁(yè)面時(shí)，顯示字段的字段

# 僅供參考 eg:
        fields = ('user',)

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

# 僅供參考 eg:
    exclude = ('user',)

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

# 僅供參考 eg:
    readonly_fields = ('user',)

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

# 僅供參考 eg:
    fieldsets = (
        ('基本數(shù)據(jù)', {
            'fields': ('user', 'pwd', 'ctime',)
        }),
        ('其他', {
            'classes': ('collapse', 'wide', 'extrapretty'),  # 'collapse','wide', 'extrapretty'
            'fields': ('user', 'pwd'),
        }),
    )

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

# 僅供參考 eg:
    filter_vertical = ("m2m字段",) # 或filter_horizontal = ("m2m字段",)

17 ordering，列表時(shí)，數(shù)據(jù)排序規(guī)則

# 僅供參考 eg:
    ordering = ('-id',)
    或
    def get_ordering(self, request):
        return ['-id',
  1. radio_fields，詳細(xì)頁(yè)面時(shí)，使用radio顯示選項(xiàng)（FK默認(rèn)使用select）
# 僅供參考 eg:
radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL

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

# 僅供參考 eg:
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 = "列數(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)顯示"
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容