什么是Admin管理工具呢,管理工具就是給一項技術提供一個可管理的頁面,比如說 Elasticsearch 就提供了管理工具 head-master ,我們可以通過管理工具去管理此軟件
那么Django 提供了基于 web 的管理工具,Django 自動管理工具是 django.contrib 的一部分,下面就來介紹 Django 的管理工具

1. 配置Admin

目錄結構說明

1.1 添加配置文件內容

修改 myFirstDjango/settings.py 找到 INSTALLED_APPS配置內容,看是否有如下配置,如沒有就添加上

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

1.2 配置路由

修改 myFirstDjango/urls.py ,添加正確路由指向admin, 默認創建項目應該就有, 解開注釋就好了

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

urlpatterns = [
	# 指向正確的路由
    url(r'^admin/', admin.site.urls)
]

1.3 啟動項目

啟動項目后訪問 http://localhost:8080/admin,可以看到出現注冊頁面

1.4 注冊Admin賬號密碼

在項目根目錄下啟動 cmd 窗口

命令行輸入創建超級用戶

python manage.py createsuperuser

命令行操作截圖

1.4 登錄

輸入用戶名密碼,即可看見登錄成功后的頁面,如下所示

2. 注冊模型到admin

為了讓 admin 界面管理某個數據模型，我們需要先注冊該數據模型到 admin
數據模型就是數據庫中的表,現在我們把此前注冊過得Book模型注冊到admin

修改 models/admin.py ,添加如下內容

from django.contrib import admin
from models.models import Book

# Register your models here.
admin.site.register(Book)

"""
注冊多個模型方式:

admin.site.register([Test, Contact, Tag])
"""

2.2 驗證注冊

添加后重啟項目,刷新admin頁面,即可看到Book已經被注冊

3. admin-add表單自定義

我們可以自定義管理頁面，來取代默認的頁面,比如 add 添加頁面,我們只需要填寫 名稱,作者,價格就好,剩下的時間由系統默認添加,那么我們可以修改表單顯示

3.1 自定義添加字段

修改 models/admin.py,添加如下內容

from django.contrib import admin
from models.models import Book


class BookAdmin(admin.ModelAdmin):
    """
    字段只顯示: 名稱 作者 價格
    class BookAdmin 函數名稱可以隨便起
    但是一定要繼承 admin.ModelAdmin
    """
    fields = ('name', 'author', 'price')


# 注冊Book模型,把我們自定義的配置也注冊
admin.site.register(Book, BookAdmin)
"""
注冊多個模型方式:
admin.site.register([Test, Contact, Tag])
"""

重啟服務,刷新頁面,點擊 Book 旁邊的add查看是否修改成功,可以看到,只有我們自定義的三個字段,證明自定義修改成功

3.2 自定義字段分類

我們可以把添加表單字段分類或做一些樣式問題

修改 models/admin.py如下內容

class BookAdmin(admin.ModelAdmin):
    """
    1. one two 為分類名稱,這里可以隨便起名
    2. one 區域顯示 名稱和作者字段 
    3. two 區域隱藏,可以點擊css樣式 show 顯示 價格添加項
    """
    fieldsets = (
        ['one', {
            'fields': ('name', 'author'),
        }],
        ['two', {
            'classes': ('collapse',),  # CSS
            'fields': ('price',),
        }]
    )

重啟服務 ,刷新頁面

可以看到 two旁邊有一個按鈕,可以點擊 show 展示, hide隱藏

4. 配置模型數據顯示頁面

admin默認的展示頁面不是以字段展示的,這樣跟我們平時看到的不太一樣

必須要點進去才可以看到詳細內容,點進去也相當于修改了

所以,下面是修改方式

---

4.1 修改模型數據顯示

在 models/admin.py 添加 list_display

from django.contrib import admin
from models.models import Book


class BookAdmin(admin.ModelAdmin):
    """
    1. one two 為分類名稱,這里可以隨便起名
    2. one 區域顯示 名稱和作者字段
    3. two 區域隱藏,可以點擊css樣式 show 顯示 價格添加項
    """
    # 想顯示那個字段就寫那些字段的名稱即可
    list_display = ('name', 'author', 'price', 'pub_time')  # list
    fieldsets = (
        ['one', {
            'fields': ('name', 'author'),
        }],
        ['two', {
            'classes': ('collapse',),  # CSS
            'fields': ('price',),
        }]
    )

# 注冊Book模型,把我們自定義的配置也注冊
admin.site.register(Book, BookAdmin)

重啟刷新,即可看到已更改成功

4.1 添加搜索欄

在展示頁面可以看到搜索框不是我們常見的搜索框,那么我們可以添加一個搜索框

在 models/admin.py 添加 search_fields

from django.contrib import admin
from models.models import Book


class BookAdmin(admin.ModelAdmin):
    """
    1. one two 為分類名稱,這里可以隨便起名
    2. one 區域顯示 名稱和作者字段
    3. two 區域隱藏,可以點擊css樣式 show 顯示 價格添加項
    """
    # 想顯示那個字段就寫那些字段的名稱即可
    list_display = ('name', 'author', 'price', 'pub_time')  # list
    search_fields = ('name',)
    fieldsets = (
        ['one', {
            'fields': ('name', 'author'),
        }],
        ['two', {
            'classes': ('collapse',),  # CSS
            'fields': ('price',),
        }]
    )

# 注冊Book模型,把我們自定義的配置也注冊
admin.site.register(Book, BookAdmin)

重啟刷新,即可看到有搜索框了

https://www.runoob.com/django/django-admin-manage-tool.html