Model例項,myapp/models.py：

from django.db import models

class Blog(models.Model):
	name = models.CharField(max_length=100)
	tagline = models.TextField()
 
	# On Python 3: def __str__(self):
	def __unicode__(self):
		return self.name
 
class Author(models.Model):
	name = models.CharField(max_length=50)
	email = models.EmailField()
 
	# On Python 3: def __str__(self):
 

	def __unicode__(self):
		return self.name
 
class Entry(models.Model):
	blog = models.ForeignKey(Blog)
	headline = models.CharField(max_length=255)
	body_text = models.TextField()
	pub_date = models.DateField()
	mod_date = models.DateField()
	authors = models.ManyToManyField(Author)
	n_comments = models.IntegerField()
	n_pingbacks = models.IntegerField()
	rating = models.IntegerField()
 
	# On Python 3: def __str__(self):
 

	def __unicode__(self):
		return self.headline

類級別許可權

預設情況下，superuser可以訪問admin介面的所有Model，但有時候只想讓一些使用者只能訪問一些特定的Model。

可以定製自己的User物件的has_perm()方法：

class MyUser(AbstractBaseUser):
	...
	def has_perm(self, perm, obj=None):
		if self.is_superuser:
			return True
		elif self.can_edit:
			if perm=='myapp.add_entry'
 
:
				return True
			else:
				return False
		else:
			return False

這樣superuser具有全部許可權。普通user的can_edit屬性為True時，就具有了建立Entry例項的許可權，其餘使用者無許可權。

也可以定製ModelAdmin的has_add_permission(),has_change_permission(),has_delete_permission()方法：

def has_add_permission(self, request):
	"""
	Returns True if the given request has permission to add an object.
	Can be overridden by the user in subclasses.
	"""
	opts = self.opts
	codename = get_permission_codename('add', opts)
	if request.user.can_edit:
	    return True
	else:
	    return request.user.has_perm("%s.%s" % (opts.app_label, codename))

欄位級別的許可權

不同許可權的可以編輯不同的內容，可以通過get_readonly_fileds()來新增欄位只讀許可權。

class EntryAdmin(admin.ModelAdmin):
	list_display=(...)
	search_fields=(...)
	def get_readonly_fields(self,request,obj=None):
		if not request.user.is_superuser and not request.user.can_edit:
			return [f.name for f in self.model._meta.fields]
		return self.readonly_fields

重寫Model的save行為

可以直接重寫model的save()方法：

from django.db import models

class Blog(models.Model):
	name = models.CharField(max_length=100)
	tagline = models.TextField()

	def save(self, *args, **kwargs):
		do_something()
		super(Blog, self).save(*args, **kwargs) # Call the "real" save() method.
		do_something_else()

阻止save()：

from django.db import models

class Blog(models.Model):
	name = models.CharField(max_length=100)
	tagline = models.TextField()

	def save(self, *args, **kwargs):
		if self.name == "Yoko Ono's blog":
			return # Yoko shall never have her own blog!
		else:
			super(Blog, self).save(*args, **kwargs) # Call the "real" save() method.

也可以重寫ModelAdmin的save_model()方法，根據不同的使用者定製不同的save行為：

from django.contrib import admin

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

其中obj是修改後的物件，當新建一個物件時 change = False, 當修改一個物件時 change = True，可以獲得修改前的物件：

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

不同的使用者顯示不同的資料行，重寫列表頁面返回的查詢集

ModelAdmin 提供了一個鉤子程式 —— 它有一個名為 queryset() 的方法，該方法可以確定任何列表頁面返回的預設查詢集。

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

定製過濾器list_filter

從django.contrib.admin.SimpleListFilter繼承一個子類，提供title和parameter_name屬性，並重寫 lookups和queryset方法。

from datetime import date

from django.contrib import admin
from django.utils.translation import ugettext_lazy as _

class DecadeBornListFilter(admin.SimpleListFilter):
	# Human-readable title which will be displayed in the
	# right admin sidebar just above the filter options.
	title = _('decade born')

	# Parameter for the filter that will be used in the URL query.
	parameter_name = 'decade'

	def lookups(self, request, model_admin):
		"""
		Returns a list of tuples. The first element in each
		tuple is the coded value for the option that will
		appear in the URL query. The second element is the
		human-readable name for the option that will appear
		in the right sidebar.
		"""
		return (
			('80s', _('in the eighties')),
			('90s', _('in the nineties')),
		)

	def queryset(self, request, queryset):
		"""
		Returns the filtered queryset based on the value
		provided in the query string and retrievable via
		`self.value()`.
		"""
		# Compare the requested value (either '80s' or '90s')
		# to decide how to filter the queryset.
		if self.value() == '80s':
			return queryset.filter(birthday__gte=date(1980, 1, 1),
									birthday__lte=date(1989, 12, 31))
		if self.value() == '90s':
			return queryset.filter(birthday__gte=date(1990, 1, 1),
									birthday__lte=date(1999, 12, 31))

class PersonAdmin(admin.ModelAdmin):
	list_filter = (DecadeBornListFilter,)

parameter_name和title是必須的。look_up方法返回出現在列表頁右側過濾器中的選項和描述。parameter_name為附加在url後面get請求的引數名，self.value()返回該引數對應的值。

根據不同的使用者定製：

class AuthDecadeBornListFilter(DecadeBornListFilter):

	def lookups(self, request, model_admin):
		if request.user.is_superuser:
			return super(AuthDecadeBornListFilter,
				self).lookups(request, model_admin)

	def queryset(self, request, queryset):
		if request.user.is_superuser:
			return super(AuthDecadeBornListFilter,
				self).queryset(request, queryset)

model_admin為ModelAdmin例項：

class AdvancedDecadeBornListFilter(DecadeBornListFilter):

	def lookups(self, request, model_admin):
		"""
		Only show the lookups if there actually is
		anyone born in the corresponding decades.
		"""
		qs = model_admin.get_queryset(request)
		if qs.filter(birthday__gte=date(1980, 1, 1),
					  birthday__lte=date(1989, 12, 31)).exists():
			yield ('80s', _('in the eighties'))
		if qs.filter(birthday__gte=date(1990, 1, 1),
					  birthday__lte=date(1999, 12, 31)).exists():
			yield ('90s', _('in the nineties'))

定製搜尋功能

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)
		except ValueError:
			pass
		else:
			queryset |= self.model.objects.filter(age=search_term_as_int)
		return queryset, use_distinct

queryset是查詢集，search_term是搜尋詞。

外來鍵欄位過濾

在新增物件時顯示外來鍵選項時，太多的選項不太友好，這時候需要過濾出符合要求的物件供選擇。

class MyModelAdmin(admin.ModelAdmin):
    def formfield_for_foreignkey(self, db_field, request, **kwargs):
        if db_field.name == "car":
            kwargs["queryset"] = Car.objects.filter(owner=request.user)
        return super(MyModelAdmin, self).formfield_for_foreignkey(db_field, req