基础用法

  1. model_icon = "fa fa-folder"  # 图标
  2. list_display = ('title', 'type', 'operations')  # 列表显示字段
  3. list_display_links = ('title',)  # 链接字段
  4. # search_fields = ()  # 搜索字段
  5. # list_filter = ()  # 过滤字段
  6. readonly_fields = ('path',)  # 只读字段
  7. ordering = ('-id',)  # 列表排序
  8. # exclude = ()  # 隐藏字段
  9. # relfield_style = 'fk-ajax  # 外键使用时，不一次性加载所有数据，已搜索+ajax方式获取
  10. # list_editable = ()  # 可在连表页编辑的字段
  11. form = CategoryForm  # 设置form
  12. use_related_menu = False  # 禁用relate插件
  13. hidden_menu = True  # 不在菜单中显示
  16. Admin:  # 可重写view中方法
  18. self.form  # form 类
  19. self.form_obj # form对象
  22. List_display_links = None  #禁用编辑链接
  24.     def has_add_permission(self, request):
  25.         # 禁用添加按钮
  26.         return False
  28.     def has_delete_permission(self, request, obj=None):
  29.         # 禁用删除按钮
  30.         return False
  32.     def get_actions(self, request):
  33.         # 在actions中去掉‘删除’操作
  34.         actions = super(GradesManagementAdmin, self).get_actions(request)
  35.         if request.user.username[0].upper() != 'J':
  36.             if 'delete_selected' in actions:
  37.                 del actions['delete_selected']
  38.         return actions

form_layout 使用

  1. # 导入相关
  2. from xadmin.layout import Main, Fieldset, Row, Side
  4. # xxxxAdmin中定义
  5. form_layout = (
  6.     Main(  # 里面的内容在中间显示，主显示区域
  7.         # 里面可写Fieldset 
  8.         Fieldset('标题', '字段1', '字段2',..., '字段n'),
  9.         # 可有多个fieldset  每个fieldset为单独的一个 panel 
  10.         Fieldset(
  11.             '标题2', 
  12.             Row('字段1', '字段2')  #  字段1 字段2 将
  13.         )
  14.     ),
  15.     Side(  # 里面的内容在右边显示
  17.     )
  18. )

自定义页面

1. 创建view

  1. # views.py
  2. from xadmin.views import CommAdminView
  4. class TestView(CommAdminView):
  5.     """
  6.     可根据情况基础xadmin其他view类，如表单FormAdminView等
  7.     重新请求方法
  8.     """
  9.     def get(self, request):
  10.         """
  11.         get 请求
  12.         """
  13.         # 获取xadmin默认的context数据
  14.         context = super().get_context()  
  15.         title = "测试页面"
  16.         context["breadcrumbs"].append({'url': '', 'title': title})  # 设置面包屑
  17.         context["title"] = title  # 设置标题
  19.         // ...
  21.         return render(request, 'test.html', context)

2. 创建模板

  1. <!-- test.html -->
  3. {% extends 'xadmin/base_site.html' %}
  4. {% load i18n %}
  5. {% load crispy_forms_tags %}
  6. {% load xadmin_tags %}
  8. {% block extrastyle %}
  9.   <!-- 加载自定义css样式 或编写 css样式， 其它标签可查看base_site.html文件进行修改 -->
  10.   {% vendor 'xadmin.form.css' %}
  11. {% endblock %}
  14. {% block content-nav %}
  16. {% endblock %}
  19. {% block content %}
  20. 这是test页面内容
  21. {% endblock %}
  24. {% block extrabody %}
  25.   {% vendor 'xadmin.plugin.portal.js' 'xadmin.page.form.js' %}
  26. {% endblock %}

3. 修改菜单 和 将TestView url注册到xadmin中

  1. # adminx.py
  3. import xadmin
  4. from xadmin import views
  6. from . import models
  7. from .views.admin import WebsiteOptions
  10. @xadmin.sites.register(views.CommAdminView)
  11. class GlobalSetting:
  12.     def get_site_menu(self):
  13.         """
  14.         从写该方法，返回自定义菜单数据
  15.         xadmin get_nav_menu()方法自动生成菜单前会调用该方法
  16.         return list
  17.         perm 调用了 get_model_perm()方法 返回的是 : '%s.%s_%s' % (model._meta.app_label, name, model._meta.model_name)
  18.         [{'title': 'apps.py中第一的名称', 'menus': [{'title': '菜单1', 'url': 'url', 'icon': None, 'perm': '', 'order': 7}, ...],'first_url': '第一个菜单url'}, ...]
  19.         """
  20.         // ... 具体格式
  21.         return menu_list
  23.     def change_site_menu(self, site_menu):
  24.         """
  25.         该方法为自己添加的在 get_nav_menu()方法 返回菜单前执行
  26.         用户修改现有菜单数据
  27.         """
  28.         # 在websiteAPP下添加新菜单
  29.         site_menu[0]['menus'].append({
  30.             'title': '测试页面',
  31.             'url': '/admin/website/test/',
  32.             'icon': None,
  33.             'order': 0})
  34.         return site_menu
  37. # 将 TestView url注册到xadmin中
  38. xadmin.site.register_view('website/test/', TestView, name='test')