Django組件-admin

一. admin組件的使用

　　Django 提供了基於 web 的管理工具。

　　Django 自動管理工具是 django.contrib 的一部分。你可以在項目的 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.apps.App01Config',
]

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

　　1. 激活管理工具

　　通常我們在生成項目時會在 urls.py 中自動設置好。

from django.contrib import admin
from django.urls import path

urlpatterns = [
    path('admin/', admin.site.urls),
]

　　當這一切都配置好后，Django 管理工具就可以運行了。

　　2. 使用管理工具

　　在使用admin組件之前，需要將app下的模型類，進行注冊。

　　app下 models.py 文件：

from django.db import models


class Book(models.Model):
    title = models.CharField(max_length=32)
    price = models.DecimalField(max_digits=5, decimal_places=2)
    pub_date = models.DateField()
    publish = models.ForeignKey("Publish", on_delete=models.CASCADE)
    authors = models.ManyToManyField("Author")

    def __str__(self):
        return self.title


class Publish(models.Model):
    name = models.CharField(max_length=32)
    city = models.CharField(max_length=64)
    email = models.EmailField()

    def __str__(self):
        return self.name


class Author(models.Model):
    name = models.CharField(max_length=32)
    age = models.SmallIntegerField()
    au_detail = models.OneToOneField("AuthorDetail", on_delete=models.CASCADE)

    def __str__(self):
        return self.name

class AuthorDetail(models.Model):
    gender_choices = (
        (0, "女"),
        (1, "男"),
        (2, "保密"),
    )
    gender = models.SmallIntegerField(choices=gender_choices)
    tel = models.CharField(max_length=32)
    addr = models.CharField(max_length=64)
    birthday = models.DateField()

 

　　啟動服務器，然后在瀏覽器中訪問 http://127.0.0.1:8000/admin/，得到登陸界面。

　　你可以通過命令 python manage.py createsuperuser 來創建超級用戶。然后，來進行登錄操作。

　　為了讓 admin 界面管理某個數據模型，我們需要先注冊該數據模型到 admin。

　　在admin.py中只需要將Mode中的某個類注冊，即可在Admin中實現增刪改查的功能，如：

admin.site.register(models.Book, )

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

　　3. admin的定制

　　我們可以自定制類繼承 admin.ModelAdmin 類，來擴展方法。有以下兩種方式注冊：

# 方式一：
class BookAdmin(admin.ModelAdmin):

    list_display = ('title', 'price', 'publish')

admin.site.register(models.Book, BookAdmin)


# 方式二：
@admin.register(models.Book)
class BookAdmin(admin.ModelAdmin):

    list_display = ('title', 'price', 'publish')

　　ModelAdmin中提供了大量的可定制功能，下面我們列舉一下常用的功能：

class BookAdmin(admin.ModelAdmin):

    list_display = ('title', 'price', 'publish', 'show_author')  # 定制展示的列
    list_display_links = ('price', )  # 定制跳轉的列
    list_filter = ('publish', 'authors')  # 定制過濾列
    search_fields = ('title', 'price')  # 定制模糊搜索列
    list_editable = ('title', )  # 定制可以直接編輯的列
    actions = ['patch_init']  # 定制批量處理方法
    ordering = ['-price']  # 通過該列進行排序，默認升序

    def show_author(self, obj):  # 自定制展示列
        return "|".join([i.name for i in obj.authors.all()])

    def patch_init(self, request, queryset):  # 初始化單價
        queryset.update(price=100)

    patch_init.short_description = "批量初始化"  # 設置操作名稱


admin.site.register(models.Book, BookAdmin)
admin.site.register(models.Publish, PublishAdmin)
admin.site.register(models.Author)
admin.site.register(models.AuthorDetail)