django 强大的一个地方就是在于它集成了一个非常方便的admin后台，我们只需要做简单的配置就可以实现一些强大的功能。所以接下来我们介绍下admin后台的使用
model
简单model
先准备models.py文件 如下
from django.db import models
# Create your models here.
class User(models.Model):
GENDER = ((0, "未知"), (1, "男"), (2, "女"))
name = models.CharField('名字', max_length=256)
gender = models.IntegerField("性别", choices=GENDER, default=0)
def __str__(self):
return self.name
class Meta:
verbose_name = '用户'
db_table = 'user'然后，我们可以根据model 准备admin.py的代码了，简单示例如下
from django.contrib import admin
from .models import *
@admin.register(User)
class UserAdmin(admin.ModelAdmin):
pass- 创建管理员账户
python manage.py createsuperuser - 访问
/admin/用创建的用户名密码登录，可以看到我们注册的model
带外键的model
还是先看model文件
from django.db import models
# Create your models here.
class Tag(models.Model):
name = models.CharField(max_length=20)
class Meta:
verbose_name = "标签"
class User(models.Model):
GENDER = ((0, "未知"), (1, "男"), (2, "女"))
name = models.CharField('名字', max_length=256)
phone = models.CharField('手机', max_length=40, null=True)
gender = models.IntegerField("性别", choices=GENDER, default=0)
tag = models.ForeignKey(Tag, verbose_name="标签", on_delete=models.CASCADE)
def __str__(self):
return self.name
class Meta:
verbose_name = '用户'
db_table = 'user'
class Property(models.Model):
user = models.ForeignKey(User, verbose_name="用户", on_delete=models.CASCADE)
context = models.CharField('内容', max_length=200)
def __str__(self):
return self.context
class Meta:
verbose_name = "用户属性"然后我们查看 admin页面，发现多了 标签选项
现在对admin.py做一下添加
@admin.register(Tag)
class TagAdmin(admin.ModelAdmin):
pass也就是仅仅将Tag model 注册到admin页面，在去观察admin页面，可以发现多了添加和修改按钮。
接下来，我们添加Property model,按找Tag的方式注册完，发现并没有在User界面显示Property 相关的添加和查看，只能在Property中添加相应的用户，于是，我们引入inline，代码如下
class PropertyInline(admin.StackedInline):
model = Property
@admin.register(User)
class UserAdmin(admin.ModelAdmin):
inlines = [PropertyInline, ]
pass效果如下
fileds
列表页
默认的列表页显示的是model的__str__值,我们可以自己定义，并添加多列的值来显示，也可以自己定义显示的内容等，具体内容看下面代码
from django.utils.safestring import mark_safe
@admin.register(User)
class UserAdmin(admin.ModelAdmin):
# 列表页显示自定义字段
def url_test(self, obj):
# return '自定义的文字'
# 如果需要加上样式，或显示图片等，需要将字段标记成安全的，如下：
return mark_safe('url')
url_test.short_description = "链接测试"
list_per_page = 20 # 每页显示数量
list_display = ('id', 'name', 'phone''gender', 'url_test') # 列表页显示哪些列的数据，第一个字段会自动生成链接，指像该对象的详情页
list_editable = ('gender', ) # 在列表页可以编辑的字段效果如下
详情页
默认是显示所有的字段，我们也可以按照自己的需求添加和修改，代码如下
@admin.register(User)
class UserAdmin(admin.ModelAdmin):
# 自定义显示字段的方式和列表页相同
# 只读字段，注意自定义显示的字段必须标记为readonly
readonly_fields = ('id', 'name', 'url_test')
# 要显示的字段顺序，可以分组显示
fields = (('id', 'name'), 'phone', 'gender', 'url_test' )- 自定义表单
有时，我们需要自己定义表单提交的内容，比如说，我们需要将图片传到云上，将返回的url保存到对应的字段，因为该字段为CharField，所以我们需要一个上传文件的地方，于是引入了form
class ImageForm(ModelForm):
pic = FileField(required=False, label="图片")
class Meta:
model = Image
fields = "__all__"
@admin.register(User)
class UserAdmin(admin.ModelAdmin):
list_per_page = 20
form = ImageForm
def save_model(self, request, obj, form, change):
request.files = request.FILES
pic = image_upload(request, "pic") # 上传图片至云，返回url
obj.pic = pic[0] if pic else obj.pic
return super().save_model(request, obj, form, change)filter
当需要对列表页做筛选的时候，我们可以通过添加list_filter的字段实现，也可以自己定义相关的操作，代码如下
class CategoryFilter(admin.SimpleListFilter):
title = _('分类') # 显示的名字
parameter_name = 'category' # url中的字段
def lookups(self, request, model_admin):
# url查找的值，和其对应的显示出来的值
return (
('80s', _('in the eighties')),
('90s', _('in the nineties')),
)
def queryset(self, request, queryset):
# 我们自己处理的传过来的值的过程
if self.value():
id_ = int(self.value())
if id_:
return queryset.filter(category=id_)
@admin.register(User)
class UserAdmin(admin.ModelAdmin):
list_filter = ('gender', CategoryFilter)
# 搜索字段的添加
search_fields = ("name", "phone")其他操作
action
在界面上的这个位置，用来对列表页进行批量操作，默认了一个删除的action。
- 编写自己的action
def send_note_msg(self, request, queryset):
error = ''
resoult = ''
for obj in queryset:
phone = obj.tel
txt = "短信内容 "
if sendMsg(phone, txt):
resoult += u'发送{}成功！'.format(obj.id)
obj.is_send_msg = True
obj.save()
else:
error += u'发送{}失败,相关信息不完整，mast need phone, event_name, delivery_num'.format(obj.id)
# 通知哪些发送成功，哪些发送失败
self.message_user(request, resoult, level=messages.SUCCESS)
self.message_user(request, error, level=messages.ERROR)
# action显示的名称
send_note_msg.short_description = '发送短信提示'
# 添加action
actions=[send_note_msg]- 根据权限控制action的显示
def get_actions(self, request):
actions = super(GuestTmpAdmin, self).get_actions(request)
if 'guest.delete_guest' not in request.user.get_group_permissions():
del actions["send_note_msg"]
return actions