django2 xadmin 安装和使用

末蓝、 2022-01-16 23:25 241阅读 0赞

官方文档：[https://xadmin.readthedocs.io/en/docs-chinese/][https_xadmin.readthedocs.io_en_docs-chinese]

## 源码安装部署 ##

下载源码：[https://github.com/sshwsfc/xadmin/tree/django2][https_github.com_sshwsfc_xadmin_tree_django2]  
**初步配置**  
1.在建好的Django目录下新建一个extra\_apps文件夹  
2.解压下载好的源码文件，将其中的xadmin文件夹放到extra\_apps中  
3.右键选中extra\_apps，选择Make Directory as 中的Sources Root  
4.在settings.py中添加配置如下  
import sys  
sys.path.insert(0, os.path.join(BASE\_DIR,“extra\_apps”))

5.在urls.py中修改配置如下，注释掉之前admin的配置

#from django.contrib import admin
    import xadmin
    urlpatterns = [
        #path('admin/', admin.site.urls),
        path('xadmin/', xadmin.site.urls),
    ]

6.迁移数据库

python manage.py makemigrations
    python manage.py migrate

7.安装过程中可能会遇到的问题  
报错一、

ModuleNotFoundError: No module named 'future'

缺少future包，命令行安装

pip install future
    pip install six
    pip install django_import_export

报错二、

ModuleNotFoundError: No module named 'crispy_forms'

命令行安装

pip install django-crispy-forms

报错三、

ModuleNotFoundError: No module named 'reversion'

命令行安装

pip install django-reversion

报错四、

ModuleNotFoundError: No module named 'django.contrib.formtools'

安装升级

pip install django-formtools==2.1

报错五、

ModuleNotFoundError: No module named 'httplib2'

安装

pip install httplib2

报错六

django.db.utils.InternalError: (1071, 'Specified key was too long; max key length is 1000 bytes')

原因是数据库保存索引字段做大限制， 本例是因为已经创建多个数据表，总和超过了1000导致报错，解决办法是分别将每个应用的模型做数据迁移，避免一次性超过限制大小而报错。  
8.数据库配好之后，运行项目，出现如下结果，则表示配置成功。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70]  
9.创建超级用户,设置用户名密码

python manage.py createsuperuser

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 1]后台进行登录之后报如下错误  
![在这里插入图片描述][20190614092215577.png]  
报错原因在settings.py中

MIDDLEWARE = [
        'django.middleware.security.SecurityMiddleware',
        'django.contrib.sessions.middleware.SessionMiddleware',
        'django.middleware.common.CommonMiddleware',
        'django.middleware.csrf.CsrfViewMiddleware',
        'django.contrib.auth.middleware.AuthenticationMiddleware',
        'django.contrib.messages.middleware.MessageMiddleware',
        'django.middleware.clickjacking.XFrameOptionsMiddleware',
    ]
    INSTALLED_APPS = [
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.sessions',
        'django.contrib.messages',
        'django.contrib.staticfiles',
        'apps.users.apps.UsersConfig',
        'apps.operations.apps.OperationsConfig',
        'apps.courses.apps.CoursesConfig',
        'apps.orgs.apps.OrgsConfig',
        'xadmin',
        'crispy_forms',
        'reversion',
    ]

‘django.contrib.sessions.middleware.SessionMiddleware’,  
‘django.contrib.sessions’,  
默认配置中使用session作为后台数据存储 ,故django\_session数据表也是必须的，否则报错。  
在setting.py同目录下的\_\_init\_\_.py中添加如下命令，然后重新执行上面的迁移表命令：

import pymysql
    pymysql.install_as_MySQLdb()

## 发现无法解决上面的问题，修改迁移数据步骤 ##

1.注释掉之前关于xadmin在settings.py和urls.py中的配置  
![在这里插入图片描述][20190614105031243.png]  
![\-][-]  
2.删除掉之前的表和migrations中除\_\_init\_\_.py之外的其他文件，使用上面的迁移命令，用admin进行迁移数据。此时是官方配置，故无兼容性问题，你会看到生成的表中有django\_session。  
![在这里插入图片描述][2019061410542794.png]  
3.创建超级用户登录  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 2]4.去掉之前对xadmin相关配置的注释 ， 此时浏览器访问 localhost:8000/xadmin/ 无法登录后台， 提示相关表不存在，需要进行数据迁移操作生成数据表。  
**注意：**  
不可删除之前生成的数据表，否则将出现无法创建django\_session表的情况 ， 并且如果之后需要添加数据表，尽量不要批量进行数据迁移操作， 而是分开单个应用进行数据迁移操作。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 3]5.打开Tools–>Run [manage.py][] task执行下面的命令

makemigrations xadmin
    migrate xadmin

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 4]  
创建成功， 在数据库中可查看到xadmin\_前缀的数据表。  
![在这里插入图片描述][20190614111745122.png]  
6.重启项目，浏览器登录后台localhost:8000/xadmin即可  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 5]

## 后台显示数据表 ##

1.在各个app下创建adminx.py文件代替原来的admin.py文件  
2.确保各app下模型已经创建，然后编写adminx文件

import xadmin
    from .models import CourseInfo,LessonInfo,VideoInfo,SourceInfo
    from xadmin import views
    #主题配置
    class BaseXadminSetting(object):
        enable_themes = True
        use_bootswatch = True
    #头部尾部配置
    class CommXadminSetting(object):
        site_title = '星海教育后台管理系统'
        site_footer = '星海公司'
        #菜单栏配置
    	menu_style = 'accordion'
    	
    # Create your models here.
    class CourseInfoXadmin(object):
        list_display = ['image','name','study_time','study_num','level','love_num','click_num','desc','detail','category','course_notice','course_need','teacher_tell','add_time']
        #图标配置
        model_icon = 'fa fa-tasks'
    
    class LessonInfoXadmin(object):
        list_display = ['name', 'courseinfo', 'add_time']
        model_icon = 'fa fa-ticket'
    
    class VideoInfoXadmin(object):
        list_display = ['name', 'study_time', 'url','lessoninfo','add_time']
        #搜索框
        search_fields = ['name']
        #过滤器
    	list_filter = ['name']
    	model_icon = 'fa fa-video-camera'
    
    class SourceInfoXadmin(object):
        list_display = ['name', 'down_load', 'courseinfo', 'add_time']
        model_icon = 'fa fa-folder-open-o'
    
    xadmin.site.register(CourseInfo,CourseInfoXadmin)
    xadmin.site.register(LessonInfo,LessonInfoXadmin)
    xadmin.site.register(VideoInfo,VideoInfoXadmin)
    xadmin.site.register(SourceInfo,SourceInfoXadmin)
    #注册xadmin的主题
    xadmin.site.register(views.BaseAdminView,BaseXadminSetting)
    #注册xadmin的标题和底部公司名称
    xadmin.site.register(views.CommAdminView,CommXadminSetting)

3.重启服务，刷新后台页面，就可以看到相关表创建好了  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 6]

[https_xadmin.readthedocs.io_en_docs-chinese]: https://xadmin.readthedocs.io/en/docs-chinese/
[https_github.com_sshwsfc_xadmin_tree_django2]: https://github.com/sshwsfc/xadmin/tree/django2
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70]: /images/20220117/acd5a9fdbd2d491f941c733f491543dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 1]: /images/20220117/c2782b1993c14da3a311c4ee7fc341c4.png
[20190614092215577.png]: /images/20220117/64be69622ddf47658d414d603c263c72.png
[20190614105031243.png]: /images/20220117/6093fc9a0782493b936da4d141ea462d.png
[-]: /images/20220117/a4373c8a4a094e44a12bec8e14d8b4db.png
[2019061410542794.png]: /images/20220117/8a263d60b01843ac80c6bd6a267c7ca6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 2]: /images/20220117/ed6120f1036d4b2cbd6fdc87b5102992.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20190614110906479.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw==,size_16,color_FFFFFF,t_70
[manage.py]: http://manage.py
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 4]: /images/20220117/ee3a9b7cb9c94e7ebbf6f454a59686d4.png
[20190614111745122.png]: /images/20220117/a2a7a6c186384ba899c3146b918afd83.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 5]: /images/20220117/97552036b580482dbbc253adb6e07739.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70 6]: /images/20220117/655b9632f9eb47c680853ecda0948caa.png