Xadmin是django admin的替换方案,对admin做了一些扩展,支持添加插件,界面基于bootstrap开发,更加漂亮。
一、用pycharm创建一个my_xadmin项目
二、安装必须的依赖组件
1、打开pycharm终端安装1.x版本django
pip install django
2.安装xadmin
由于用的是django2的版本,所以这里用django2的分支
pip install git+git://github.com/sshwsfc/xadmin.git@django2
直接clone下载比较久,也可以直接下载包后本地安装 https://github.com/sshwsfc/xadmin/tree/django2
pip install --cache-dir . C:\Users\eirc\Downloads\xadmin-django2.zip
三、配置运行xadmin
1、修改settings.py
# 引入下面三个app
INSTALLED_APPS = [
....
'xadmin',
'crispy_forms',
'reversion',
]
......
## 修改使用中文界面
LANGUAGE_CODE = 'zh-Hans'
......
## 添加下面static目录定义
STATICFILES_DIRS = (
os.path.join( BASE_DIR, "static" ),
)
STATIC_ROOT = os.path.join(BASE_DIR, 'collect_static')
需要再项目根目录下创建static,collect_static两个目录
2、配置xadmin路由,修改urls.py
import xadmin
from django.urls import path
xadmin.autodiscover()
# model自动注册
from xadmin.plugins import xversion
xversion.register_models()
urlpatterns = [
path( r'xadmin/', xadmin.site.urls ),
]
3、创建数据库并创建超级用户
python manage.py migrate python manage.py createsuperuser
4、拉取静态文件到本地
python manage.py collectstatic
5、运行并访问后台
python manage.py runserver # 使用创建的超级用户登录
四、添加一个App,实现model的curd功能
1、添加一个IDC机房管理app,并在settings.py中加入IdcManager
python manager.py startapp IdcManager
2、添加一个model
class IDC(models.Model): name = models.CharField('名称',unique=True,max_length=50) addr = models.CharField('地址',max_length=128) tel = models.CharField('电话',max_length=50) note = models.TextField(null=True,blank=True) expire = models.DateTimeField('到期') create_datetime = models.DateTimeField('创建时间',auto_now=True) def __str__(self): return self.name class Meta: verbose_name = 'IDC机房' verbose_name_plural = verbose_name
3、打开IdcManager的__init__.py文件添加:
default_app_config = 'IdcManager.apps.IdcmanagerConfig'
4、修改apps.py文件
from django.apps import AppConfig class IdcmanagerConfig(AppConfig): name = 'IdcManager' verbose_name = 'IDC管理'
5、修改admin.py
import xadmin from .models import IDC @xadmin.sites.register(IDC) class IDCAdmin(object): list_display = ("name", "addr", "tel", "expire", "create_datetime","note") # 带链接字段,点击进入编辑 list_display_links = ("name",)
6、创建表并启动测试
python manage.py makemigrations python manage.py migrate python manage.py runserver
五、外键关联以及用户关联
1、model添加一个server,关联用户以及idc机房
class Server(models.Model): # 关联当前登录用户 user = models.ForeignKey(User,on_delete=models.CASCADE,editable=False,verbose_name='最后编辑人') # 关联idc机房 idc = models.ForeignKey(IDC,on_delete=models.CASCADE,verbose_name='IDC') ip = models.GenericIPAddressField('IP') cabin = models.CharField('机架位',max_length=128) active = models.BooleanField('有效',default=True) create_time = models.DateTimeField(auto_now=True) def __str__(self): return self.ip class Meta: verbose_name = '服务器' verbose_name_plural = verbose_name
2、admin.py 添加注入模板,注意save_models这里通过修改原先的方法来实现自定义修改字段
@xadmin.sites.register(Server) class ServerAdmin(object): list_display = ("ip", "idc", "cabin", "user", "active" ,'create_time') list_display_links = ("ip",) def save_models(self): self.new_obj.user = self.request.user super().save_models()
3、启动并测试
python manage.py makemigrations python manage.py migrate python manage.py runserver
4、根据登录用户过滤显示选项
修改 admin.py 中server的定义方式如下,同时去掉自动注入方式,因为如果使用自定义的queryset方法,不支持自动注入
class ServerAdmin(object): list_display = ("ip", "idc", "cabin", "user", "active" ,'create_time') list_display_links = ("ip",) def save_models(self): self.new_obj.user = self.request.user super().save_models() def queryset(self): qs = super( ServerAdmin, self ).queryset() if self.request.user.is_superuser: return qs else: return qs.filter( create_user=self.request.user ) xadmin.sites.site.register( Server, ServerAdmin )
这样修改完后重启项目,就可以看到根据登录的用户,看到的选项不一样
六、总结
xadmin确实比django admin漂亮很多,也对扩展的支持很好,用起来很舒服。但官方的文档实在是渣渣,痛苦,故记录在这里,方便以后可以查阅