xadmin 基本使用

Posted on |
使用 xadmin 搭建后台

下载

最近的项目用django2,这里就用支持django2的版本

1
2
3
4
# 指定 django2 分支
git clone -b django2 https://github.com/sshwsfc/xadmin.git
# or
pip install git+git://github.com/sshwsfc/xadmin.git@django2

下载完成以后把xadmin这个目录拷贝到项目的根目录中。

配置

  • settings.py
1
INSTALLED_APPS = [
    ...
    'xadmin',
    'crispy_forms',
    ...
]
  • urls.py
1
2
3
import xadmin

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

注册 Model

和Django Admin 一样的

1
2
3
4
5
6
7
import xadmin
from app.model import example

class ExamplexAdmin():
    pass

xadmin.site.register(example, ExampleXAdmin)

站点配置

1
2
3
4
5
from xadmin import view

# 创建xadmin的最基本管理器配置，并与view绑定
class BaseSetting(object):
    # 开启主题功能
    enable_themes = True
    use_bootswatch = True


# 全局修改，固定写法
class GlobalSettings(object):
    # 修改title
    site_title = 'XX管理平台'
    # 修改footer
    site_footer = 'XX有限公司'
    # 收起菜单
    menu_style = 'accordion'

# 将基本配置管理与view绑定
xadmin.site.register(views.BaseAdminView,BaseSetting)
# 将title和footer信息进行注册
xadmin.site.register(views.CommAdminView,GlobalSettings)

菜单配置

也就是App名称配置，和菜单组名称配置

  • app > apps.py
1
from django.apps import AppConfig


class MyAppConfig(AppConfig):
    name = 'myapp'
    verbose_name = 'App 名称'
  • 菜单组名称__init__.py
1
default_app_config = 'myapp.apps.MyappConfig'