django3整合xadmin趟坑

django是非常丰富功能强大的python web框架，而如果只是个人或小团队，实验的使用，一般是原生admin后台管理，xadmin是一款开源的更为强大丰富的后台管理系统，可以方便我们对相关数据库model和user的管理。可以方便搭建一个企业级的后台管理系统，很多团队和企业也会基于其进行二次开发，搭建个性化的系统。
github地址：https://github.com/sshwsfc/xadmin
网站说明：http://sshwsfc.github.io/xadmin/

image.png

特点

xadmin官网都有直观详细的介绍
主要是具有比原生admin更好的界面和体验，基于Twitter Boostrap，也有专门的个性化主题
http://x.xuebingsi.com
很多人也分享新的主题

image.png

另外可以直接简便替换原生admin，只要更改setting文件和urls文件即可

丰富的插件化扩展功能支持，在包里直接增加即可，如过滤器插件，数据提取插件

image.png

接下里就是数据相关的丰富功能，可以支持日期，数字的数据过滤等；全面的增删改查功能，
支持xls 、json 等各种数据导出功能，
丰富的数据分析可视化功能等等。

image.png

比如这是个模板
再看下requirement文件可以看到需要一些依赖
前面的两个是必须的，后门的可选，
xlwt，xlsxwriter 是支持Excel表格导出的包，可以选择。

废话不说了，开始体验吧

下载安装xadmin

和其他python包类似可以pip下载 ： pip install xadmin
推荐使用下载源码安装
pip install https://github.com/sshwsfc/xadmin/tarball/master

image.png

安装成功后，将下载的xadmin包复制到项目目录下：
项目主配置目录refs下 setting文件加上三个应用

image.png

增加路由
refs/urls.py增加

from django.conf.urls import url,include
from xadmin.plugins import xversion
import xadmin

xversion.register_models()
xadmin.autodiscover()

urlpatterns = [
    #path("admin/", admin.site.urls),
    path("xadmin"),xadmin.site.urls),

根据model的更改生成migrations文件，也就是数据迁移的动作文件
python manage.py makemigrations

问题1：
File "E:\workspace\SmartScientificResearchAssistant\xadmin\models.py", line 8, in
from django.core.urlresolvers import NoReverseMatch, reverse
ModuleNotFoundError: No module named 'django.core.urlresolvers'

这里要使用django.urls，django.core.urlresolvers包其实没有了，在xadmin里很多地方有这个地方
对model.py 文件里
from django.core.urlresolvers import NoReverseMatch, reverse
替换成
from django.urls import NoReverseMatch, reverse
还有很多其他文件也用到了 这个包，所以可以批量搜索替换含有 django.core.urlresolvers 的地方。

问题2
File "E:\workspace\SmartScientificResearchAssistant\xadmin\models.py", line 11, in
from django.utils.encoding import python_2_unicode_compatible, smart_text
ImportError: cannot import name 'python_2_unicode_compatible' from 'django.utils.encoding' (D:\ProgramData\Anaconda3\envs\myproject\lib\site-packages\django\utils\encoding.py)

使用
from six import python_2_unicode_compatible
替代
from django.utils.encoding import python_2_unicode_compatible, smart_text

问题3:
File "E:\workspace\SmartScientificResearchAssistant\xadmin\models.py", line 19, in
from xadmin.util import quote
File "E:\workspace\SmartScientificResearchAssistant\xadmin\util.py", line 24, in
from django.contrib.staticfiles.templatetags.staticfiles import static
ModuleNotFoundError: No module named 'django.contrib.staticfiles.templatetags'

将from django.contrib.staticfiles.templatetags.staticfiles import static
替换成
from django.templatetags.static import static

image.png

问题4：
File "E:\workspace\SmartScientificResearchAssistant\xadmin\models.py", line 46, in
class Bookmark(models.Model):
File "E:\workspace\SmartScientificResearchAssistant\xadmin\models.py", line 48, in Bookmark
user = models.ForeignKey(AUTH_USER_MODEL, verbose_name=_(u"user"), blank=True, null=True)
TypeError: init() missing 1 required positional argument: 'on_delete'

这是model的数据定义不符合数据库级联方式，外键记录要随着主键表的记录删除而删除。
凡是出现关联关系字段的 地方要加上，也就是ForeignKey地方加上on_delete=models.CASCADE

image.png

image.png

问题5：
model = ModelChoiceField(label=_(u'Target Model'), widget=exwidgets.AdminSelectWidget)
File "E:\workspace\SmartScientificResearchAssistant\xadmin\views\dashboard.py", line 284, in init
forms.Field.init(self, required, widget, label, initial, help_text,
TypeError: init() takes 1 positional argument but 6 were given

看到这里因为新的forms表单初始化只有一个参数，这里改为一个即可

image.png

问题6：
File "E:\workspace\SmartScientificResearchAssistant\xadmin\views\website.py", line 5, in
from django.contrib.auth.views import login
ImportError: cannot import name 'login' from 'django.contrib.auth.views' (D:\ProgramData\Anaconda3\envs\myproject\lib\site-packages\django\contrib\auth\views.py)

将website.py中的
from django.contrib.auth.views import login
from django.contrib.auth.views import logout
替换为
from django.contrib.auth import authenticate,login,logout

问题7：
File "E:\workspace\SmartScientificResearchAssistant\xadmin\plugins\filters.py", line 10, in
from django.db.models.sql.query import LOOKUP_SEP, QUERY_TERMS
ImportError: cannot import name 'QUERY_TERMS' from 'django.db.models.sql.query' (D:\ProgramData\Anaconda3\envs\myproject\lib\site-packages\django\db\models\sql\query.py)

将plugins 里的filters
中from django.db.models.sql.query import LOOKUP_SEP, QUERY_TERMS
替换为
from django.db.models.sql.query import LOOKUP_SEP,Query

问题8：
File "E:\workspace\SmartScientificResearchAssistant\xadmin\plugins\passwords.py", line 4, in
from django.contrib.auth.views import password_reset_confirm
ImportError: cannot import name 'password_reset_confirm' from 'django.contrib.auth.views' (D:\ProgramData\Anaconda3\envs\myproject\lib\site-packages\django\contrib\auth\views.py)

xadmin\plugins\password.py 中的

from django.contrib.auth.views import password_reset_confirm
替换成
from django.contrib.auth.views import PasswordResetConfirmView

问题9：
File "D:\ProgramData\Anaconda3\envs\myproject\lib\site-packages\django\conf_init_.py", line 77, in getattr
val = getattr(self._wrapped, name)
AttributeError: 'Settings' object has no attribute 'MIDDLEWARE_CLASSES

将xadmin\plugins\language.py 中的
if settings.LANGUAGES and 'django.middleware.locale.LocaleMiddleware' in settings.MIDDLEWARE_CLASSES:
替换成
if settings.LANGUAGES and 'django.middleware.locale.LocaleMiddleware' in settings.MIDDLEWARE:

修改后，进行数据库迁移，python make migrate
也就是实际开始操作数据库和模型一致。

image.png

启动服务
python manage.py runserver 0.0.0.0:9090
登录问题：

image.png

修改views\website.py文件


问题11

image.png

解决方案：
将xadmin\util.py 中的86行 def vendor(*tags):方法体改为：

css = {'screen': []}
js = []
for tag in tags:
    file_type = tag.split('.')[-1]
    files = xstatic(tag)
    if file_type == 'js':
        js.extend(files)
    elif file_type == 'css':
        css['screen'] += files
return Media(css=css, js=js)

可以登录了
先要创建是超级管理员 ：python .\manage.py createsuperuser

image.png

左边已经有基础结构模型，接着就可增加自己设计的model了，然后可以进行界面管理

image.png

对使用的django包的forms下的boundfield.py进行注释

image.png

问题

image.png

对类似的field.rel 改为field.remote_field
有几个地方，可以批量替换
'ManyToManyField' object has no attribute 'rel'
同样改成remote_field

image.png

改为model

image.png

同样改成
remote_field

image.png

国际化问题
File "E:\workspace\SmartScientificResearchAssistant\xadmin\sites.py", line 349, in i18n_javascript
from django.views.i18n import javascript_catalog
ImportError: cannot import name 'javascript_catalog' from 'django.views.i18n' (D:\ProgramData\Anaconda3\envs\myproject\lib\site-packages\django\views\i18n.py)
新的django中 javascript_catalog 方法不存在导致，页面js代码执行错误
xadmin里的sites.py可以改为

image.png

并且在setting里加上应用

image.png

这下各个部分都可以了。

image.png