在上一節中,我們已經創建了一個Django模型Post,並使Post模型與資料庫同步。這一節中,我們將介紹Django管理站點,通過Django管理站點來管理我們創建的Post模型實例。 為你的模型創建一個控制管理站點 好了,我們已經定義了一個post模型,現在,我們將要創建一個簡單的管理站點,來管 ...
在上一節中,我們已經創建了一個Django模型Post,並使Post模型與資料庫同步。這一節中,我們將介紹Django管理站點,通過Django管理站點來管理我們創建的Post模型實例。
為你的模型創建一個控制管理站點
好了,我們已經定義了一個post模型,現在,我們將要創建一個簡單的管理站點,來管理post實例。Django自帶的管理界面是一個十分強大的內容編輯器。Django管理站點按照你模型的元數據動態建立,並且提供一個方便編輯內容的介面。同樣,你也可以在管理站點內自定義如何展現你的模塊。
需要記住的一點是django.contrib.admin已經包含在INSTALLED_APPS設置中,這就是為什麼我們不需要再手動添加它的原因。
創建管理員許可權用戶
首先,我們需要創建一個管理員許可權用戶來登錄管理站點,運行下麵命令:
python manage.py createsuperuser
你會看到以下內容,並提示你輸入用戶名、e-mail,密碼:
Username (leave blank to use 'admin'): admin
Email address: [email protected]
Password: ********
Password (again): ******** Superuser created successfully.
Django管理站點
現在,運行開發伺服器(python manage.py runserver),在瀏覽器打開http://127.0.0.1:8000/admin/,你就可以看見管理站點登錄界面。
輸入你剛剛建立的管理員用戶名和密碼,登錄管理站點,你會看見管理站點的首頁。
現在你所看見的User和Group模塊是Django的認證框架,這是在INSTALLED_APPS中的django.contrib.auth設置的。如果你打開Users,你會看見剛剛創建的管理員。blog應用中的Post模型和User模型之間有關聯關係。這段關聯被定義在Post模型中的author屬性。
將你的模型添加到管理站點
現在將我們創建的blog應用中的Post模型添加至管理站點。編輯blog應用中的admin.py文件:
from django.contrib import admin
from .models import Post
admin.site.register(Post)
現在,重新載入管理站點,你就可以看見你的Post模型已經添加至管理站點。
這很容易,對嗎?當你在Django管理站點登記一個模型,就會得到一個友好的用戶界面:允許你生成對象列表;以及非常容易的編輯、創建、刪除對象。
Django針對不同的欄位使用不同的表格插件,像DateTimeField,在管理站點中展示一個類似JavaScript日曆插件的界面。將所有內容添加完畢之後,點擊保存按鈕。站點就會跳轉到post列表頁,並且給出一個”你已成功添加post“的提示。
自定義管理站點中的模塊顯示
現在我們將看到如何自定義管理站點。編輯你的blog應用中的admin.py文件:
from django.contrib import admin
from .models import Post
class PostAdmin(admin.ModelAdmin):
list_display = ('title', 'slug', 'author', 'publish', 'status')
admin.site.register(Post, PostAdmin)
我們告訴Django管理站點,我們使用繼承自ModelAdmin的自定義類,來將我們的Post模型註冊到管理站點。在這個自定義類中,我們定義瞭如何展示Post模型。list_display屬性允許你設置你想要在管理對象列表頁面顯示的模型欄位。
現在我們為管理站點添加其他選項:
class PostAdmin(admin.ModelAdmin):
list_display = ('title', 'slug', 'author', 'publish', 'status')
list_filter = ('status', 'created', 'publish', 'author') search_fields = ('title', 'body')
prepopulated_fields = {'slug': ('title',)}
raw_id_fields = ('author',)
date_hierarchy = 'publish'
ordering = ['status', 'publish']
重新載入管理站點,可以看到:
你可以看到post對象列表頁面中顯示出你在list_display中定義展示的欄位。
列表頁包括一個右邊欄,允許你通過在list_fliter定義的過濾器欄位來篩選文章。
在頁面上出現了一個搜索欄。這是因為我們已經使用search_fields屬性定義了可搜索欄位。
搜索欄下麵一欄,由date_hierarchy屬性定義,提供一個基於日期層次的快速指向。
您還可以看到,post對象按照Status和Publish排序,你還可以使用ordering屬性定義預設的排序方式。
現在點擊Add post鏈接,進入post對象編輯界面。當你把新創建的post對象的標題輸入title欄位的時候,你會發現,slug欄位自動填充了相應的內容。這是因為我們用prepopulated_fields屬性告訴Django,slug是title的關聯欄位。另外,現在作者欄位將顯示一個查找控制項,因為當你的註冊用戶成百上千的時候,從下拉列表選擇十分的不方便。
看看,我們只用了短短幾行代碼,就在管理站點中定義了模型的管理方式。定製和擴展Django管理站點的方法還有很多,在後面的章節,我們將進一步為你揭曉。
原文鏈接:http://www.landsblog.com/blog/content/djangoexamplemanage
更多教程:http://www.landsblog.com/blog/tag/django