一些简单Admin站点命令

admin的基础配置

1 管理界面本地化

在settings.py中设置语言和时区

LANGUAGE_CODE = 'zh-hans' # 使用中国语言
TIME_ZONE = 'Asia/Shanghai' # 使用中国上海时间

2 创建超级管理员

创建管理员的命令如下，按提示输入用户名、邮箱、密码。

python manage.py createsuperuser

打开浏览器，在地址栏中输入如下地址后回车。

http://127.0.0.1:8000/admin/

3 注册模型类

登录后台管理后，默认没有我们创建的应用中定义的模型类，需要在自己应用中的admin.py文件中注册，才可以在后台管理中看到，并进行增删改查操作。

打开booktest/admin.py文件，编写如下代码：(此处是自己的文件名路径，导入自己定义的模型类)

from django.contrib import admin
from booktest.models import BookInfo,HeroInfo

到浏览器中刷新页面，可以看到模型类BookInfo和HeroInfo的管理了。

4.定义与使用Admin管理类

使用管理类有两种方式：

注册参数

admin.site.register(BookInfo,BookInfoAdmin)

装饰器

@admin.register(BookInfo)
class HeroInfoAdmin(admin.ModelAdmin):
    pass

Django提供的Admin站点的展示效果可以通过自定义ModelAdmin类来进行控制。

定义管理类需要继承自admin.ModelAdmin类，如下

from django.contrib import admin

class BookInfoAdmin(admin.ModelAdmin):
    pass

@admin.register(HeroInfo)
class HeroInfoAdmin(admin.ModelAdmin):
    pass
    
admin.site.register(BookInfo,BookInfoAdmin)

1. 页大小

每页中显示多少条数据，默认为每页显示5条数据，属性如下：

list_per_page=5

2 "操作选项"的位置

顶部显示的属性，设置为True在顶部显示，设置为False不在顶部显示，默认为True。

actions_on_top=True

底部显示的属性，设置为True在底部显示，设置为False不在底部显示，默认为False。

actions_on_bottom=False

3 列表中的列

属性如下：

list_display=[模型字段1,模型字段2,...]

4 将方法作为列

列可以是模型字段，还可以是模型方法，要求方法有返回值。

通过设置short_description属性，可以设置在admin站点中显示的列名。

class BookInfo(models.Model):
	def pub_date(self):
	        return self.bpub_date.strftime('%Y年%m月%d日')
	
	    pub_date.short_description = '发布日期'

class BookInfoAdmin(admin.ModelAdmin):
 	list_display = ['id','atitle','pub_date']

5 关联对象

无法直接访问关联对象的属性或方法，可以在模型类中封装方法，访问关联对象的成员。

class HeroInfo(models.Model):
   
    def read(self):
        return self.hbook.bread

    read.short_description = '图书阅读量'

class HeroInfoAdmin(admin.ModelAdmin):
    
    list_display = ['id', 'hname', 'hbook', 'read']

6 右侧栏过滤器

属性如下，只能接收字段，会将对应字段的值列出来，用于快速过滤。一般用于有重复值的字段。

list_filter=[]

7 搜索框

属性如下，用于对指定字段的值进行搜索，支持模糊查询。列表类型，表示在这些字段上进行搜索。

search_fields=[]

调整编辑页展示

1. 显示字段

属性如下：

fields=[]

2. 分组显示

属性如下：

fieldset=(
    ('组1标题',{'fields':('字段1','字段2')}),
    ('组2标题',{'fields':('字段3','字段4')}),
)

3. 关联对象

在一对多的关系中，可以在一端的编辑页面中编辑多端的对象，嵌入多端对象的方式包括表格、块两种。

类型InlineModelAdmin：表示在模型的编辑页面嵌入关联模型的编辑。
子类TabularInline：以表格的形式嵌入。
子类StackedInline：以块的形式嵌入。

class HeroInfoStackInline(admin.StackedInline):
    model = HeroInfo  # 要编辑的对象
    extra = 1  # 附加编辑的数量

class BookInfoAdmin(admin.ModelAdmin):
    inlines = [HeroInfoStackInline]

调整站点信息

Admin站点的名称信息也是可以自定义的。

admin.site.site_header 设置网站页头
admin.site.site_title 设置页面标题
admin.site.index_title 设置首页标语

上传图片

Django有提供文件系统支持，在Admin站点中可以轻松上传图片。

使用Admin站点保存图片，需要安装Python的图片操作包

pip install Pillow

我们可以将上传的文件保存在静态文件目录中，如我们之前设置的static_files目录中在settings.py 文件中添加如下上传保存目录信息

MEDIA_ROOT=os.path.join(BASE_DIR,"自己文件的路径")

案例代码：

admin.py

from django.contrib import admin

# Register your models here.
# from django.contrib import admin
from .models import BookInfo,HeroInfo


admin.site.site_header="书店"#
admin.site.site_title="小书店"
admin.site.index_title="欢迎来到小书店"


class HeroInfoTabularInline(admin.StackedInline):

    model = HeroInfo
    extra = 1

class BookInfoAdmin(admin.ModelAdmin):
    list_display = ['id', 'btitle', 'pub_date']
    # fields=['btitle','bpub_date']
    fieldsets = (
        ('基本', {'fields': ['btitle', 'bpub_date']}),
        ('高级', {
            'fields': ['bread', 'bcomment','image',],
            'classes': ('collapse',)  # 是否折叠显示
        })
    )
    inlines=[HeroInfoTabularInline]


@admin.register(HeroInfo)
class HeroInfoAdmin(admin.ModelAdmin):

    list_per_page = 5  #分页
    actions_on_top = True
    actions_on_bottom = True
    list_display = ['id', 'hname','hbook','read']
    list_filter=['hbook','hgender']
    search_fields = ['hname']

admin.site.register(BookInfo,BookInfoAdmin)

models.py

from django.db import models
from django.contrib import admin
# Create your models here.
class BookInfo(models.Model):
    btitle = models.CharField(max_length=20, verbose_name='名称')
    bpub_date = models.DateField(verbose_name='发布日期')
    bread = models.IntegerField(default=0, verbose_name='阅读量')
    bcomment = models.IntegerField(default=0, verbose_name='评论量')
    is_delete = models.BooleanField(default=False, verbose_name='逻辑删除')
    image = models.ImageField(upload_to='booktest', verbose_name='图片', null=True)
    class Meta:
        db_table = 'tb_books'  # 指明数据库表名
        verbose_name = '图书'  # 在admin站点中显示的名称
        verbose_name_plural = verbose_name  # 显示的复数名称

    def __str__(self):
        """定义每个数据对象的显示信息"""
        return self.btitle

    def pub_date(self):
        return self.bpub_date.strftime('%Y年%m月%d日')

    pub_date.short_description = '发布日期'
    pub_date.admin_order_field = 'bpub_date'

class HeroInfo(models.Model):
    GENDER_CHOICES = (
        (0, 'male'),
        (1, 'female')
    )
    hname = models.CharField(max_length=20, verbose_name='名称')
    hgender = models.SmallIntegerField(choices=GENDER_CHOICES, default=0, verbose_name='性别')
    hcomment = models.CharField(max_length=200, null=True, verbose_name='描述信息')
    hbook = models.ForeignKey(BookInfo, on_delete=models.CASCADE, verbose_name='图书')  # 外键
    is_delete = models.BooleanField(default=False, verbose_name='逻辑删除')
    # image = models.ImageField(upload_to='booktest', verbose_name='图片', null=True)
    class Meta:
        db_table = 'tb_heros'
        verbose_name = '英雄'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.hname
    def read (self):
        return self.hbook.bread
    read.short_description='图书阅读量'