你應(yīng)該使用Django admin的9個理由
我現(xiàn)在要澄清這個誤解。Django 的 admin 絕對是軟件中的亮點，可以有效的加速你的開發(fā)。
這里有一些我能想到的很有用的 Django 的 admin 模塊的竅門。
(對于 Django admin 不太熟悉的人，先簡單解釋幾個名詞)
- Changeform 是可以編輯對象的頁面。
- Changelist 頁面可以列出指定類型的對象。你可以指定過濾對象的條件及對對象的操作。點擊 changelist 里的對象一般會跳轉(zhuǎn)到對象的 changeform 頁面。
為了讓這些敲門更具可操作性，我們使用了與真實問題幾乎一致的場景。假設(shè)我們有一個簡單的網(wǎng)站，訪客可以上傳可愛的動物圖片并進行評論。這是不是很流行呢?
Tip 1：Django admin 后臺不限于用 Django 開發(fā)的網(wǎng)站
雖然 Django admin 管理界面可以非常友好的用在 Django 項目的其它部分，它同樣可以很容易用于其它像傳統(tǒng)的數(shù)據(jù)庫或具有一個可怕的的管理界面的網(wǎng)站。而且這也是評估 Django 是否會滿足您的需求的***途徑。
你需要做的僅是：
- 在你的 Django 項目中建立一個新的應(yīng)用，并確保你已經(jīng)連接好傳統(tǒng)數(shù)據(jù)庫 ,通過 settings.py 文件中的 DATABASES 的設(shè)置。
- 將你的數(shù)據(jù)表定義為 Django 的模型。正如它的名字所表述的，manage.py inspectdb 是一個非常有用的命令：檢測現(xiàn)有的數(shù)據(jù)庫，并打印出自動生成的 Django 模型。
- 創(chuàng)建 admin.py 文件，并放在那里，唉，管理相關(guān)的。稍后將詳細說明這個。
說到我們的動物“的網(wǎng)站，是由進屎的腦袋寫出來的，所以管理界面看起來像……你知道的，不是很好。為了解決這個問題，我們通過幾個 Django 模型重構(gòu)了數(shù)據(jù)庫結(jié)構(gòu)，實現(xiàn)一個簡單的管理界面：
- # models.py
- class Picture(models.Model):
- DOG = 1
- CAT = 2
- ANIMAL_KIND_CHOICES = (
- (DOG, 'dog'),
- (CAT, 'cat'),
- )
- title = models.CharField(max_length=200)
- author = models.ForeignKey(Author, related_name='pictures')
- animal_kind = models.IntegerField(choices=ANIMAL_KIND_CHOICES)
- photo = models.ImageField(upload_to='animals')
- is_promoted = models.BooleanField(default=False)
- class Author(models.Model):
- name = models.CharField(max_length=100)
- email = models.EmailField()
- class Comment(models.Model):
- author = models.ForeignKey(Author, related_name='comments')
- picture = models.ForeignKey(Picture, related_name='comments')
- comment = models.TextField()
- editors_note = models.TextField()
- # admin.py
- class PictureAdmin(admin.ModelAdmin):
- list_display_fields = ('photo', 'animal_kind', 'author', 'is_promoted', )
- class AuthorAdmin(admin.ModelAdmin):
- list_display_fields = ('name', 'email', )
- class CommentAdmin(admin.ModelAdmin):
- list_display_fields = ('picture', 'author', )
Tip #2: 按你喜歡的方式篩選你的數(shù)據(jù)
很多人使用 Django admin 后臺對指定字段進行篩選。要知道，把一個字段名放到 list_filter 列表里就可以了。同時它也非常容易地創(chuàng)建一個自定義過濾器!
假如最終你決定要推廣所有有 100+ 的帖子的作者。但是，我們?nèi)绾螀^(qū)分它們?讓我們創(chuàng)建一個過濾器，并把它添加到我們的變更列表。
- class ProductiveAuthorsFilter(admin.SimpleListFilter):
- parameter_name = 'is_productive'
- title = 'Productive author'
- YES, NO = 1, 0
- # Number of comments for an author to be considered a productive one
- THRESHOLD = 100
- def lookups(self, request, model_admin):
- return (
- (self.YES, 'yes'),
- (self.NO, 'no'),
- )
- def queryset(self, request, queryset):
- qs = queryset.annotate(Count('comments'))
- # Note the syntax. This way we avoid touching the queryset if our
- # filter is not used at all.
- if self.value() == self.YES:
- return qs.filter(comments__count__gte=self.THRESHOLD)
- if self.value() == self.NO:
- return qs.filter(comments__count__lt=self.THRESHOLD)
- return queryset
- class PictureAdmin(admin.ModelAdmin):
- list_filters = [..., ProductiveAuthorsFilter]
現(xiàn)在，我們可以很容易地選出我們的核心作者。那么我們?nèi)绾伍_始向他們推廣呢?讓我們進入下一部分。
Tip #3：添加動作(操作函數(shù))到 ‘actions’
這可是內(nèi)容管理者的天賜之物。還記得在每個模型的列表頂部的“動作”工具欄不?我們是不是非常方便的先選擇一些圖片，然后只需單擊一下就“推廣”給作者了?現(xiàn)在讓我們來實現(xiàn)它：
- class PictureAdmin(admin.ModelAdmin):
- actions = ['promote', ]
- def promote(self, request, queryset):
- queryset.update(is_promoted=True)
- self.message_user(request, 'The posts are promoted')
- promote.short_description = 'Promote the pictures'
就是這樣!不用再一個挨一個的打開每個表單!另外，它很容易進一步增加我們的動作，例如，添加一個過渡表單。關(guān)于這點，Django 文檔 有段非常棒的講解(https://docs.djangoproject.com/en/1.8/ref/contrib/admin/actions/#actions-that-provide-intermediate-pages)。
Tip #4: 搜索你需要的所有字段
好吧，過濾器是很酷，但讓我們關(guān)注了一下就搜索工具。在幾乎所有的安裝我見過的搜索框是用來在一個模型中的字段搜索。但是，當(dāng)你意識到它可以處理關(guān)系的 Django 搜索真正的亮點。因此，假設(shè)我們希望它在圖片“的標(biāo)題，作者姓名和注釋”文本進行搜索。我們?nèi)绾巫龅竭@一點?
- class PictureAdmin(admin.ModelAdmin):
- search_fields = ('title', 'author__name', 'comments__text', )
如果你的數(shù)據(jù)庫是夠大，不要忘記添加一些全文索引來增加搜索速度。
Tip #5: “在站點查看”的簡單實現(xiàn)
在站點查看一個對象的界面是非常普及的需求，默認(rèn)情況下，你必須打開該對象的表單，然后點擊按鈕“在站點查看”。以下代碼展示如何使此過程更容易一些：
- class PictureAdmin(admin.ModelAdmin):
- list_fields = [..., 'object_link']
- def object_link(self, item):
- url = item.get_absolute_url()
- return u'<a href={url}>open</a>'.format(url=url)
- object_link.short_description = 'View on site'
- object_link.allow_tags = True
這段代碼給列表中每個對象都添加了“在站點查看”的鏈接。在此，我們假定你的模型(Model)已經(jīng)實現(xiàn)了get_absolute_url()方法。如果還沒有 – 那現(xiàn)在就去實現(xiàn) ，這將為你節(jié)省很多時間。你也可能會想將這個片段轉(zhuǎn)移到一個 mixin，或公用的 admin 基類。
Tip #6: 在列表頁就地編輯字段
假設(shè)我們需要給評論加一個編輯的備注。很自然，我們希望不需要對每條評論都去打開評論的changeform。要做到這點，我們可以稍微修改一下ModelAdmin：
- class CommentAdmin(admin.ModelAdmin):
- list_display_fields = ('picture', 'author', 'editors_note', )
- list_editable = ('editors_note', )
這樣就搞定了，現(xiàn)在打開評論列表，可以按照需要進行過濾，還可以在評論上即時添加備注。
Tip #7: 根據(jù)需要自定義 total 字段
每個 changelist 最下方都有一行列出總數(shù)(total)。假設(shè)我們需要把貓和狗的圖片數(shù)量區(qū)分開來。這個功能需要的代碼稍微多一些：我們需要重載 changelist 和 html 模板(更多內(nèi)容參考模板重載)。
- from django.contrib.admin.views.main import ChangeList
- class PicturesChangeList(admin.ChangeList):
- def get_results(self, request):
- super(PicturesChangeList, self).get_results(request)
- totals = self.result_list.aggregate(
- dogs_count=Sum(Case(When(animal_kind=Picture.DOG, then=1),
- output_field=IntegerField())),
- cats_count=Sum(Case(When(animal_kind=Picture.CAT, then=1),
- output_field=IntegerField())))
- self.totals = totals
- class PictureAdmin(admin.ModelAdmin):
- def get_changelist(self, request):
- return PicturesChangeList
模板的內(nèi)容：
- {% extends 'admin/change_list.html' %}
- {% block result_list %}
- {{ block.super }}
- <p>
- There are
- <strong>
- {{ cl.totals.dogs_count|default:'none' }} dogs and
- {{ cl.totals.cats_count|default:'none' }} cats
- </strong>
- on this page.
- </p>
- {% endblock %}
Tip #8: 對某些用戶只讀的 admin 界面
啥意思?假設(shè)你的祖母打算瞅一眼這些可愛的圖片，她站在你背后，覺得 Django 的 admin 界面挺有意思。不過你能肯定，她要是使用 admin 界面，恐怕一個按鈕的點擊就能毀掉整個網(wǎng)站。那么，我們加上 grandma-proof™，這樣就支持只讀的 admin 界面(就是某人說的“數(shù)據(jù)瀏覽”)：
- class GrandmaProofAdmin(admin.ModelAdmin):
- def get_readonly_fields(self, request, obj=None):
- if request.user.username == 'granny':
- return [f.name for f in self.model._meta.fields]
- else:
- return super(GrandmaProofAdmin, self).get_readonly_fields(request, obj)
- class PictureAdmin(GrandmaProofAdmin):
- ...
現(xiàn)在你可以安全的把修改圖片的權(quán)限放開給你的祖母，這樣她就能瀏覽圖片列表。要注意這個方案肯定不能適用于所有使用場景，你還需要處理更多的情況。
Tip #9: 為每個對象自定義 action
有時候你需要在單個對象上執(zhí)行特定的 action。‘actions’工具當(dāng)然可以完成這個任務(wù)，不過過程會顯得很麻煩：點擊對象、選擇 action、再點擊一個按鈕……肯定有更便捷的方式，對吧?讓我們想辦法只點擊一次就全部搞定。
這次我們要實現(xiàn)老祖母的另一個宏達的想法。她希望能給某些編輯發(fā) email，告訴他們她喜歡的所有圖片。
- class PictureAdmin(admin.ModelAdmin):
- list_fields = (..., 'mail_link', )
- def mail_link(self, obj):
- dest = reverse('admin:myapp_pictures_mail_author',
- kwargs={'pk': obj.pk})
- return '<a href="{url}">{title}</a>'.format(url=dest, title='send mail')
- mail_link.short_description = 'Show some love'
- mail_link.allow_tags = True
- def get_urls(self):
- urls = [
- url('^(?P<pk>\d+)/sendaletter/?$',
- self.admin_site.admin_view(self.mail_view),
- name='myapp_pictures_mail_author'),
- ]
- return urls + super(PictureAdmin, self).get_urls()
- def mail_view(self, request, *args, **kwargs):
- obj = get_object_or_404(Picture, pk=kwargs['pk'])
- send_mail('Feel the granny\'s love', 'Hey, she loves your pet!',
- 'granny@yoursite.com', [obj.author.email])
- self.message_user(request, 'The letter is on its way')
- return redirect(reverse('admin:myapp_picture_changelist'))
但愿她現(xiàn)在能夠滿意?，F(xiàn)在每個對象字段加上了一個鏈接，讓她點一下就可以發(fā)送郵件。
Bonus Tip: 只需為 admin 添加一行代碼來減少查詢量
Django admin (Django 也是如此) 最常用也是最有用的技巧是 select_related。呃，你已經(jīng)都知道了?不就是把對象的名字傳給 ModelAdmin 的 list_select_related 屬性來實現(xiàn)相關(guān)對象的預(yù)加載嘛。但是，你知道你并沒有描述全部的相關(guān)對象嗎?只需要設(shè)置成 True，Django 就可以自動預(yù)加載外部對象：
- class PictureAdmin(admin.ModelAdmin):
- list_select_related = True
本文到此就差不多結(jié)束了，希望你能覺得有意思。別忘了在評論里分享你的看法，告訴我們對你有幫助的技巧。
