# django-xadmin

**Repository Path**: markhoo/django-xadmin

## Basic Information

- **Project Name**: django-xadmin
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-10-21
- **Last Updated**: 2024-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xadmin 使用方法

## 安装xadmin

### 注意：切勿pip install 方式安装！不然同步数据库会因缺失log表引发错误

1. 下载对应Django版本的xadmin，解压并将其中的xadmin文件夹全部复制到自己的项目下（app同级目录），然后在 settings.py文件的INSTALLED_APPS内添加以下代码：
```
INSTALLED_APPS = [
    'xadmin',
    'crispy_forms',
]
```

2. 在根urls.py内修改为如下代码：

```
import xadmin

urlpatterns = [
    url(r'^xadmin/', xadmin.site.urls),
```

3. 使用pip install安装以下依赖库：
```
six
future
httplib2
django-reversion
django-formtools
django-crispy-forms
django-import-export
requests
```

如果还提示缺少某个模块，安装即可。

4. 生成并同步表

> python manage.py makemigrations

> python manage.py migrate

启动项目，打开 ```127.0.0.1:8000/xadmin``` 进入后台登录页面，输入用户名和密码进入后台


## 配置xadmin

### 配置后台主题

首先需要在创建好的app中新建一个adminx.py的文件，然后添加代码
```
# _*_ coding: utf-8 _*_
import xadmin
from xadmin import views

# 配置后台主题
class BaseSetting(object):
    enable_themes = True    # 启动主题功能
    use_bootswatch = True   # 启用更多主题


xadmin.site.register(views.BaseAdminView, BaseSetting)
```

### 配置后台系统名称和页脚版权、菜单样式

```
# _*_ coding: utf-8 _*_
import xadmin
from xadmin import views

class GlobalSetting(object):
    site_title = 'xx后台管理系统'     # 后台系统名称
    site_footer = 'XXXX xxxx.com'    # 页脚版权信息
    menu_style = 'accordion'         # 设置后台菜单为收缩样式


xadmin.site.register(views.CommAdminView, GlobalSetting)
```

### 设置app的中文名称

更改apps.py文件
```
# _*_ coding: utf-8 _*_
from django.apps import AppConfig

class UsersConfig(AppConfig):
    name = 'users'
    verbose_name = "中文名称"
    verbose_name = u"中文名称"  # Python2

```
更改 \_\_init\_\_.py 文件
```
default_app_config = "users.apps.UsersConfig"  # users为当前app名称
```

### 定制后台用户信息页面。
- UserProfile, UserProfileAdmin相关联并注册，同时卸载后台中默认显示的‘用户信息’一栏
- 用户信息的定制是在xadmin中plugins中的auth.py中修改

```
from xadmin.layout import Fieldset, Main, Side, Row
from xadmin.plugins.auth import UserAdmin
from .models import UserProfile


from django.contrib.auth.models import User
xadmin.site.unregister(User)
xadmin.site.register(UserProfile, UserProfileAdmin)
```

### 更换后台icon图标

```
model_icon = 'fa fa-lock'  
```
将此代码拷贝到adminx.py中修改即可，其中前面的fa不能修改！只改变fa-lock即可。

### 设置后台某些字段为只读
在自己创建的adminx.py中加入如下代码：
```
readonly_fields = ['','','']
```
列表中填入想设置为只读的字段即可

### 在adminx.py中设置此字段增加后台自动刷新，时间可以自定义
```
refresh_times = [5, 10]   # 设置了两个可选择的时间，分别是5秒和10秒
```

### 新增支持安装 ```DjangoUeditor``` 富文本编辑器后可直接使用。建议源码安装。关闭HTML文本自动转义：
```
{% autoescape off %}

{% endautoescape %}
```
用以上模板标签包裹显示的内容，取消默认的html代码转义

### 新增Excel导入功能，无需设置即可使用

更多详细： https://xadmin.readthedocs.io/en/latest/index.html