Django + Xadmin
Xadmin 是一个基于 Django 编写的 admin 的替代管理系统
安装
安装 Xadmin 的时候，需要注意 Django 的版本，Xadmin 在 Github 上的仓库 master 分支是支持 Django 1.9 版本的，假如是 Django 2.0 版本的，则需要从 Django2 分支安装
# 从 PyPI 安装 支持 django 1.9
$ pip install xadmin
# 支持 django 1.4
$ pip install django-xadmin
# 从源码安装 支持django 2.0
$ pip install git+git://github.com/sshwsfc/xadmin.git@django2
以上安装方法会同时安装好需要的第三方库，而如果是直接在 Github 上下载 zip 源码包或是使用 git clone 命令，则需要自己安装，可以使用一下命令
# 在工程项目根目录中执行一下命令
$ pip install -r requirements.txt
配置
在 settings.py 中注册相应库
# 添加以下代码
# Application definition
INSTALLED_APPS = [
...
'xadmin',
'crispy_forms',
'reversion',
]
添加 url 规则
from django.urls import path
import xadmin
xadmin.autodiscover()
# version模块自动注册需要版本控制的 Model
from xadmin.plugins import xversion
xversion.register_models()
urlpatterns = [
# 将原先的 admin.site.urls 替换为以下
path('admin/', xadmin.site.urls),
]
登陆
$ python manage.py runserver
image
创建一个超级用户登陆
$ python manage.py createsuperuser
image
简单定制
- 中文显示
# settings.py
...
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Sahnghai'
...
- 注册 models
# 数据模型
# users/models.py
from django.db import models
# Create your models here.
class User(models.Model):
nickname = models.CharField(max_length=50, blank=True)
email = models.EmailField(('email address'), blank=True, unique=True)
def __str__(self):
return self.nickname
# users/admin.py
import xadmin
from .models import User
# Register your models here.
class UserAdmin(object):
# 在列表中显示 nickname email 两个字段
list_display = ['nickname', 'email']
xadmin.site.register(User, UserAdmin)
image
- 修改左侧菜单栏中栏目
# users/apps.py
from django.apps import AppConfig
class UsersConfig(AppConfig):
name = 'users'
# verbose_name 为菜单栏目名字
verbose_name = '用户'
# users/__init__.py
default_app_config='users.apps.UsersConfig'
image
- 修改页面 title footer header
# users/admin.py
import xadmin
from .models import User
from xadmin import views
# Register your models here.
class UserAdmin(object):
list_display = ['nickname', 'email']
class GlobalSetting(object):
site_title = 'Fbckf'
site_header = 'Fbckf'
site_footer = 'Fbckf'
xadmin.site.register(User, UserAdmin)
xadmin.site.register(views.CommAdminView, GlobalSetting)
image
- 添加搜索、过滤器
# users/admin.py
...
class UserAdmin(object):
list_display = ['nickname', 'email']
# 根据 nickname 字段 搜索
search_fields = ['nickname']
list_filter = ['nickname']
...
image
