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)