Django xadmin安装教程与问题解决方案

一、安装教程

1. xadmin下载

   源码包下载地址：

   https://github.com/sshwsfc/xadmin/tree/django2

2. 安装xadmin

   （1）安装方法一：pip install 第一步压缩包下载地址

   （2）安装方法二：直接复制压缩包里的xadmin文件夹到项目app的同级目录下（方便修改源码，本教程使用此方法）
   
   

3. settings.py配置

   （1）注册app
   

    ```django
    INSTALLED_APPS = [
     'django.contrib.admin',
     'django.contrib.auth',
     'django.contrib.contenttypes',
     'django.contrib.sessions',
     'django.contrib.messages',
     'django.contrib.staticfiles',
     'APT_app',
     'xadmin', # 添加
     'crispy_forms', # 添加
     'reversion', # 添加(可选)
    ]
    ```
   

   （2）修改语言
   

   LANGUAGE_CODE = 'zh-hans'
   TIME_ZONE = 'Asia/Shanghai'
   

4. urls.py配置，xadmin替换admin
   

   from django.urls import path,include
   import xadmin
   xadmin.autodiscover()
   
   from xadmin.plugins import xversion
   xversion.register_models()
   
   urlpatterns = [
       path('xadmin/',xadmin.site.urls),#添加新路由
   ]
   

5. 安装依赖包

   （1）复制第一步下载的压缩包里的requirements.txt到项目xadmin文件夹同级目录下
   
   

   （2）执行以下代码

      pip install -r requirements.txt
   

6. 数据同步

   python manage.py makemigrations
   
   python manage.py migrate
   

7. 启动项目，并在浏览器访问127.0.0.1:8000/xadmin/

   python manage.py runserver
   

   

8. 创建超级用户

   输入python manage.py createsuperuser并根据提示完成超级用户的创建
   

9. 根据自身需求，在App下的models.py文件中创建表结构并同步到数据库
   

10. 在app中添加一个adminx.py的文件用于在后台注册表

    （1）全局配置
    

    （2）注册表
    

11. 再次访问127.0.0.1:8000/xadmin/
    

二、问题说明

1. 点击添加小组件出错：render() got an unexpected keyword argument ‘renderer’

   解决办法:

   • 打开xadmin/views/dashboard.py

   • 把第36行代码修改成以下内容

     def render(self, name, value, attrs=None, renderer=None):
     

2. 修改app显示的名称

   解决办法:

   （1）进入对应app下的apps.py文件，修改代码如下（根据自认情况修改app名）

   from django.apps import AppConfig
   class AptAppConfig(AppConfig):
       name = 'APT_app'
       verbose_name = u'APT组织信息展示'  # 配置中文别名，还需在__init__中配置
   

   （2）进入__init__.py文件下，添加代码如下（根据自认情况修改app名）

   default_app_config = 'APT_app.apps.AptAppConfig'
   

3. 修改登录后的首页路径

   解决办法：

   • 进入xadmin下的文件路径：xadmin/views/website.py

   • 修改56、57行（根据需求修改）

     

4. 修改xadmin首页左上角标题路由；
   

   解决办法：

   进入xadmin/templates/xadmin/base_site.html修改以下代码；
   

5. 如何使用xadmin注销功能；

   直接使用{% url 'xadmin:logout' %}