工欲善其事，必先利其器，xadmin是一个优秀的开源后台管理插件，漂亮的界面以及丰富的功能，好了废话不多说，我们直接开始名片管理系统的制作吧。（本次分享制作环境为win10操作平台,Django2.2.5+xadmin2）

一、安装Django+xadmin

1、安装Django

    pip install Djano
   或者参考菜鸟教程的步骤安装：https://www.runoob.com/django/django-install.html](https://www.runoob.com/django/django-install.html

2、安装xadmin

  下载好xadmin压缩包，然后pip install xadmin压缩包
  xadmin压缩包下载地址：https://github.com/sshwsfc/xadmin/tree/django2](https://github.com/sshwsfc/xadmin/tree/django2

image.png

pip install xadmin-django2.zip 等待安装完成

二、开始创建项目

1、创建项目

django-admin startproject BCMS

2、创建app

进到BCMS目录执行:python manage.py startapp user

创建完成后，目录结构如下：

image.png

3、注册，配置自己的应用以及配置xadmin

1、在BCMS目录下创建一个跟user目录同级的extra_apps目录，并将第一步下载好的xadmin-django2.zip解压后的xadmin文件放置到该目录下，如下所示

image.png

2、在BCMS/setting.py 文件中加入如下内容

import sys
sys.path.insert(0,os.path.join(BASE_DIR,'extra_apps'))
INSTALLED_APPS 中加入如下三个
'xadmin',
'crispy_forms',
'user',

image.png

3、修改BCMS/urls.py文件

import xadmin
urlpatterns = [
    path('', xadmin.site.urls),
]

4、创建用户模型类user/models/py

from django.db import models

# Create your models here.

class Signup(models.Model):
    username = models.CharField('用户名', max_length=255)
    phone = models.CharField('手机号', max_length=255)
    email = models.EmailField('邮箱', max_length=255)
    company = models.CharField('公司名称', max_length=255)
    create_time = models.DateTimeField('创建时间', null=True, blank=True)
    address = models.CharField('地址', max_length=255)

    # admin管理界面中显示中文model名称
    class Meta:
        verbose_name = '注册用户'
        verbose_name_plural = '注册用户'

    # 添加删除是不再显示Signup onject，而是显示__str__返回的内容
    def __str__(self):
        return self.username

5、将自已的应用模型类注册到xadmin中并设置显示方式

    将user目录下的admin.py文件更改文件名为adminx.py
user/adminx.py

import xadmin
from xadmin import views
from .models import Signup


# Register your models here.


class GlobalSettings(object):
    site_title = '名片管理系统'
    site_footer = '名片管理系统'
    menu_style = 'accordion'  # 左边导航栏 收缩 手风琴

class BaseSetting(object):
    enable_themes = True
    use_bootswatch = True  # 调出主题菜单

xadmin.site.register(views.BaseAdminView, BaseSetting)
xadmin.site.register(views.CommAdminView, GlobalSettings)




# 定义Admin管理类
class SignupAdmin(object):

    # options选项：
    # 1. 注册用户列表页都显示哪些字段
    list_display = ('username', 'company', 'create_time', 'email','address')

    # 2. 列表页过滤器
    list_filter = ('company', 'create_time')

    # 3. 列表页每页显示几个
    list_per_page = 5

    # 4. 注意search_fields里不能出现以时间定义的字段，如Date，DateTime等
    search_fields = ['username', 'email', 'company', 'phone']

    # 5. 这些字段可以点击显示详细信息
    show_detail_fields = ['username']

    # 6. 这些字段可以在列表页即时数据编辑，不用进change页面去编辑，ajax无刷新
    list_editable = ['address','email', 'company', 'phone']

    # 7. change页只能读取不能更改的数据
    #readonly_fields = ['username']

xadmin.site.register(Signup, SignupAdmin)

user/apps.py

from django.apps import AppConfig


class UserConfig(AppConfig):
    name = 'user'
    verbose_name = '用户管理'

user/__init__.py

default_app_config = 'user.apps.UserConfig'

BCMS/setting.py
将：LANGUAGE_CODE = 'en-us'
修改为：LANGUAGE_CODE = 'zh-hans'

6、生成数据库迁移模型，并迁移数据

生成数据库迁移模型
在BCMS目录CMD窗口执行
python manage.py makemigrations

迁移数据
python manage.py migrate

7、创建xadmin后台管理超级用户，等会登录会用到

  在BCMS目录CMD窗口执行,按照提示输入即可
  python manage.py createsuperuser

image.png

本次创建的用户为admin,密码为123456
8、启动项目，登录体验自己的系统

在BCMS目录CMD窗口执行
python manage.py runserver 127.0.0.1:1101

image.png
image.png
image.png
image.png
image.png
image.png

项目源码：
链接：https://pan.baidu.com/s/15RC250MfoC50e62V4grYKg
提取码：xmlk