Django开发博客系统(11-使用xadmin)

明瞳

2020-04-11

关注关注

这段时间进行了前端页面的美化,实现了搜索功能与评论功能,以及配置了rss和sitemap,不过这些东西后期可能还会进行大改,所以暂时不准备讲,可能完成之后会一起说一下...吧.

另外这里贴上我的源码,不过还没有完成,有兴趣可以去看看.

今天将后台的admin替换为了xadmin,xadmin是国人创建的一个开源项目,作者github,这个项目简单来说可以完全无痛地替换admin,同时增加很多有用的功能,界面也是基于Bootstrap,相较自带的更美观.

先来看看最终完成的效果图吧

Django开发博客系统(11-使用xadmin)

接下来就进行xadmin的配置.

安装

pip install https://codeload.github.com/sshwsfc/xadmin/zip/django2

在base.py中配置INSTALLED_APPS

INSTALLED_APPS = [
    ...
    ‘xadmin‘,
    ‘crispy_forms‘,
    ‘reversion‘,
    ...
]

接下来尝试创建迁移,会报一连串的错误,接下来一个个解决.

我的开发环境是:python3.8.0 + django3.0.4

1.ImportError: cannot import name ‘six‘ from ‘django.utils‘

Django开发博客系统(11-使用xadmin)

找到six.py所在的位置并复制这个文件

Django开发博客系统(11-使用xadmin)

把six.py复制到‘django.utils‘所在的路径

2.cannot import name ‘python_2_unicode_compatible‘ from ‘django.utils.encoding‘

Django开发博客系统(11-使用xadmin)

找到路径中的models.py,把第十一行的

from django.utils.encoding import python_2_unicode_compatible, smart_text

替换为

1 from django.utils.encoding import smart_text
2 from six import python_2_unicode_compatible

3.ModuleNotFoundError: No module named ‘django.contrib.staticfiles.templatetags‘

找到util.py

Django开发博客系统(11-使用xadmin)

找到这一行,将其替换为

from django.templatetags.static import static

执行迁移..

开始配置xadmin

1.在各个App中新建adminx.py文件,并把对应的admin.py中的内容复制过去

Django开发博客系统(11-使用xadmin)

2.将我们定义的ModelAdmin的继承对象改为object或者去掉继承,这里我选择新建一个base_xadmin.py文件,内容与base_admin.py相同,只是把

class BaseOwnerAdmin(admin.ModelAdmin):
# 改为
class BaseOwnerAdmin:

有几个类是直接继承admin.ModelAdmin的,也需要去掉继承.

3.修改类中的内容

把fieldsets修改为Fieldsets

用PostAdmin来举例

fieldsets = (
    (‘基础配置‘, {
        ‘description‘: ‘基础配置描述‘,
        ‘fields‘: (
            (‘title‘, ‘category‘),
            ‘status‘,
        ),
    }),
    (‘内容‘, {
        ‘description‘: ‘摘要默认选取内容中的前140个字‘,
        ‘fields‘: (
            ‘desc‘,
            ‘content‘,
        ),
    }),
    (‘额外信息‘, {
        ‘classes‘: (‘wide‘, ),
        ‘fields‘: (‘tag‘, ),
    }),
)

原

改为

form_layout = (
    Fieldset(
        ‘基础信息‘,
        Row(‘title‘, ‘category‘),
        ‘status‘,
        ‘tag‘,
    ),
    Fieldset(
        ‘内容信息‘,
        ‘desc‘,
        ‘content‘,
    )
)

改

自定义过滤器修改

之前我们在post中自定义了一个按照分类过滤的过滤器

class CategoryOwnerFilter(admin.SimpleListFilter):
    """自定义过滤器只展示当前用户分类"""

    title = ‘分类过滤器‘  # 标题
    parameter_name = ‘owner_category‘  # 查询时URL参数的名字

    def lookups(self, request, model_admin):  # 返回要展示的内容和查询用的id
        return Category.objects.filter(owner=request.user).values_list(‘id‘, ‘name‘)

    def queryset(self, request, queryset):
        category_id = self.value()
        if category_id:
            return queryset.filter(category_id=self.value())
        return queryset

xadmin:

class CategoryOwnerFilter(RelatedFieldListFilter):
    """自定义过滤器只展示当前用户分类"""

    @classmethod
    def test(cls, field, request, params, model, admin_view, field_path):
        return field.name == ‘category‘

    def __init__(self, field, request, params, model, model_admin, field_path):
        super(CategoryOwnerFilter, self).__init__(field, request, params, model, model_admin, field_path)
        # 重新获取lookup_choices, 根据owner过滤
        self.lookup_choices = Category.objects.filter(owner=request.user).values_list(‘id‘, ‘name‘)

同时PostAdmin中也需要修改:

list_filter = [CategoryOwnerFilter]  # 页面过滤器

# 改为

list_filter = [‘category‘]  # 页面过滤器

其中,test方法的作用是确认字段是否需要被当前的过滤器过滤.

在__init__方法中,我们执行完父类的__init__后,重新定义了lookup_choices的值,这个值默认是查询所有数据.

操作配置

def operator(self, obj):
    return format_html(
        ‘<a href="{}">编辑</a>‘,
        reverse(‘cus_admin:blogApp_post_change‘, args=(obj.id,))
    )
operator.short_description = ‘操作‘

改为

def operator(self, obj):
    return format_html(
        ‘<a href="{}">编辑</a>‘,
        self.model_admin_url(‘change‘, obj.id)
    )
operator.short_description = ‘操作‘

装饰器

@admin.register(Post, site=custom_site)

改为

@xadmin.sites.register(Post)

其他修改与Post类似

添加路由

path(‘xadmin/‘, xadmin.site.urls, name=‘xadmin‘),

这时使用的时候发现又能看到其他用户的文章了,这是因为接口存在差异,BaseOwnerAdmin中的

def get_queryset(self, request):
    qs = super(BaseOwnerAdmin, self).get_queryset(request)
    return qs.filter(owner=request.user)

def save_model(self, request, obj, form, change):
    obj.owner = request.user
    return super(BaseOwnerAdmin, self).save_model(request, obj, form, change)

需要改为

def get_list_queryset(self):
    request = self.request
    qs = super().get_list_queryset()
    return qs.filter(owner=request.user)

def save_models(self):
    self.new_obj.owner = self.request.user
    return super().save_model()

另外在在xadmin中,我们可以在settings中来自定义系统名称和footer需要展示的内容.

settings/base.py

1 XADMIN_TITLE = ‘Blog管理后台‘
2 XADMIN_FOOTER_TITLE = ‘power by ylnx2000.cn‘

xadmin也自带了log功能,所以我们可以删掉LogEntryAdmin.

xadmin还有很多功能,想要熟悉的话最好还是通过手册与阅读源码来了解

另外我在使用xadmin时,

# @property
    # def media(self):
    #     media = super().media
    #     media.add_js([‘https://cdn.bootcss.com/twitter-bootstrap/4.4.0/js/bootstrap.bundle.js‘])
    #     media.add_css({
    #         ‘all‘: (‘https://cdn.bootcss.com/twitter-bootstrap/4.3.1/css/bootstrap.min.css‘,),
    #     })
    #     return media

在PostAdmin中使用静态资源会出现

Django开发博客系统(11-使用xadmin)