Django后台admin的使用詳解

簡述:

Django的admin可以提供一個強大的后台管理功能，可以在web界面對數據庫進行操作,我們需要修改admin.py將要操作的數據表注冊到后台管理中.

一，新建一個 名稱為 zqxt_admin 的項目：

django-admin.py startproject zqxt_admin

二，新建一個 叫做 blog 的app：

# 進入 zqxt_admin 文件夾
cd zqxt_admin
 
# 創建 blog 這個 app
python manage.py startapp blog

三，修改 blog 文件夾中的 models.py：

# coding:utf-8
from django.db import models
 
 
class Article(models.Model):
    title = models.CharField(u'標題', max_length=256)
    content = models.TextField(u'內容')
 
    pub_date = models.DateTimeField(u'發表時間', auto_now_add=True, editable = True)
    update_time = models.DateTimeField(u'更新時間',auto_now=True, null=True)

四，把 blog 加入到settings.py中的INSTALLED_APPS中：

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
 
    'blog',
)

五，同步所有的數據表：

# 進入包含有 manage.py 的文件夾
python manage.py makemigrations
python manage.py migrate
 
注意：Django 1.6.x 及以下的版本需要用以下命令
python manage.py syncdb

可以看到：

Creating tables ...

Creating table django_admin_log

Creating table auth_permission

Creating table auth_group_permissions

Creating table auth_group

Creating table auth_user_groups

Creating table auth_user_user_permissions

Creating table auth_user

Creating table django_content_type

Creating table django_session

Creating table blog_article

 

You just installed Django's auth system, which means you don't have any superusers defined.

Would you like to create one now? (yes/no): yes

Username (leave blank to use 'tu'): tu

Email address: 

Password: 

Password (again): 

Superuser created successfully.

Installing custom SQL ...

Installing indexes ...

Installed 0 object(s) from 0 fixture(s)

如果是 Django 不主動提示創建管理員（Django 1.9不提示）用下面的命令創建一個帳號

python manage.py createsuperuser

六，修改 admin.py 

進入 blog 文件夾，修改 admin.py 文件（如果沒有新建一個），內容如下：

from django.contrib import admin
from .models import Article
 
 
admin.site.register(Article)

只需要這三行代碼，我們就可以擁有一個強大的后台！

提示：urls.py中關於 admin的已經默認開啟，

七，打開 開發服務器：

python manage.py runserver
# 如果提示 8000 端口已經被占用，可以用 python manage.py runserver 8001 以此類推

訪問 http://localhost:8000/admin/ 輸入設定的帳號和密碼, 就可以看到：

點擊 Articles，動手輸入 添加幾篇文章，就可以看到：

我們會發現所有的文章都是叫 Article object，這樣肯定不好，比如我們要修改，如何知道要修改哪個呢？

我們修改一下 blog 中的models.py

# coding:utf-8
from django.db import models
 
 
class Article(models.Model):
    title = models.CharField(u'標題', max_length=256)
    content = models.TextField(u'內容')
 
    pub_date = models.DateTimeField(u'發表時間', auto_now_add=True, editable = True)
    update_time = models.DateTimeField(u'更新時間',auto_now=True, null=True)
 
    def __unicode__(self):# 在Python3中用 __str__ 代替 __unicode__
        return self.title

　我們加了一個 __unicode__ 函數，刷新后台網頁，會看到：

所以推薦定義 Model 的時候 寫一個 __unicode__ 函數(或 __str__函數)

技能提升：如何兼容python2.x和python3.x呢？

示例如下：

# coding:utf-8
from __future__ import unicode_literals
 
from django.db import models
from django.utils.encoding import python_2_unicode_compatible
 
@python_2_unicode_compatible
class Article(models.Model):
    title = models.CharField('標題', max_length=256)
    content = models.TextField('內容')
 
    pub_date = models.DateTimeField('發表時間', auto_now_add=True, editable = True)
    update_time = models.DateTimeField('更新時間',auto_now=True, null=True)
 
    def __str__(self):
        return self.title

python_2_unicode_compatible 會自動做一些處理去適應python不同的版本，本例中的 unicode_literals 可以讓

python2.x 也像 python3 那個處理 unicode 字符，以便有更好地兼容性。

八，在列表顯示與字段相關的其它內容

后台已經基本上做出來了，可是如果我們還需要顯示一些其它的fields，如何做呢？

from django.contrib import admin
from .models import Article
 
class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','update_time',)
 
admin.site.register(Article,ArticleAdmin)

list_display 就是來配置要顯示的字段的，當然也可以顯示非字段內容，或者字段相關的內容，比如：

class Person(models.Model):
    first_name = models.CharField(max_length=50)
    last_name = models.CharField(max_length=50)
 
    def my_property(self):
        return self.first_name + ' ' + self.last_name
    my_property.short_description = "Full name of the person"
 
    full_name = property(my_property)

　　在admin.py中：

from django.contrib import admin
from .models import Article, Person
 
 
class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title', 'pub_date', 'update_time',)
 
 
class PersonAdmin(admin.ModelAdmin):
    list_display = ('full_name',)
 
admin.site.register(Article, ArticleAdmin)
admin.site.register(Person, PersonAdmin)　

到這里我們發現我們又有新的需求，比如要改 models.py 中的字段，添加一個文章的狀態（草稿，正式發布），這時候我們就需要更改表，django 1.7以前的都不會自動更改表，我們需要用第三方插件 South，參見 Django 遷移數據。

Django 1.7 及以上用以下命令來同步數據庫表的更改：

python manage.py makemigrations
python manage.py migrate

其它一些常用的功能：

搜索功能：search_fields = ('title', 'content',) 這樣就可以按照 標題或內容搜索了

https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.search_fields

 

篩選功能：list_filter = ('status',) 這樣就可以根據文章的狀態去篩選，比如找出是草稿的文章

https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_filter

 

新增或修改時的布局順序：

https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.fieldsets

 

有時候我們需要對django admin site進行修改以滿足自己的需求，那么我們可以從哪些地方入手呢？

以下舉例說明：

1.定制加載的列表, 根據不同的人顯示不同的內容列表，比如輸入員只能看見自己輸入的，審核員能看到所有的草稿，這時候就需要重寫get_queryset方法：

class MyModelAdmin(admin.ModelAdmin):
    def get_queryset(self, request):
        qs = super(MyModelAdmin, self).get_queryset(request)
        if request.user.is_superuser:
            return qs
        else:
            return qs.filter(author=request.user)

該類實現的功能是如果是超級管理員就列出所有的，如果不是，就僅列出訪問者自己相關的：

2.定制搜索功能（django 1.6及以上才有)

class PersonAdmin(admin.ModelAdmin):
    list_display = ('name', 'age')
    search_fields = ('name',)
 
    def get_search_results(self, request, queryset, search_term):
        queryset, use_distinct = super(PersonAdmin, self).get_search_results(request, queryset, search_term)
        try:
            search_term_as_int = int(search_term)
            queryset |= self.model.objects.filter(age=search_term_as_int)
        except:
            pass
        return queryset, use_distinct

queryset 是默認的結果，search_term 是在后台搜索的關鍵詞

3.修改保存時的一些操作，可以檢查用戶，保存的內容等，比如保存時加上添加人：

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj.user = request.user
        obj.save()

其中obj是修改后的對象，form是返回的表單（修改后的），當新建一個對象時 change = False, 當修改一個對象時 change = True
如果需要獲取修改前的對象的內容可以用：

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj_original = self.model.objects.get(pk=obj.pk)
        obj.user = request.user
        obj.save()

那么又有問題了，這里如果原來的obj不存在，也就是如果我們是新建的一個怎么辦呢，這時候可以用try,except的方法嘗試獲取,當然更好的方法是判斷一下這個對象是新建還是修改，是新建就沒有 obj_original，是修改就有：

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        if change:# 更改的時候
            obj_original = self.model.objects.get(pk=obj.pk)
        else:# 新增的時候
            obj_original = None
 
        obj.user = request.user
        obj.save()

4, 刪除時做一些處理,

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def delete_model(self, request, obj):
        """
        Given a model instance delete it from the database.
        """
        # handle something here
        obj.delete()