## 模板
### 修改模板
在simpleui的基础上修改模板需要对django有一定了解
1. 先把simpleui克隆到静态目录下,参考[克隆静态文件到根目录](#克隆静态文件到根目录)
2. 找到静态目录下的admin目录,里面就是simpleui的模板,直接修改相关html页面即可生效。
### 重写页面
例如重写首页,在templates目录中新建admin
## 图标
### 说明
simpleui中显示的图标 可以参考[fontawesome](https://fontawesome.com/icons?d=gallery)的图标,只需要将完整的class名填入即可。
### 默认图标
simpleui对所有菜单提供了一个默认的file图标,是为了统一风格。也许你并不喜欢,你可以选择关闭默认图标
>SIMPLEUI_DEF
## 主题
### 默认主题
默认主题在settings.py中进行配置
```python
# 指定simpleui默认的主题,指定一个文件名,相对路径就从simpleui的theme目录读取
SIMPLEUI_DEFAULT_THEME = 'admin.lte.css'
```
### 切换主题
目前simpleui 内置28个流行样式风格的主题。后续随着
### 克隆静态文件
熟悉django的同学会了解,django有个神奇的模式叫做debug模式,默认是开启的,在settings.py中
```python
# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True
```
关闭后可以有两种办法解决静态资源无法访问的情况
1. 在
# 快速上手指南
-----
有很多同学会误解simpleui,认为下载、安装simpleui后,启动就可以直接使用。但是simpleui是在django的基础上进行优化的,所以请先自行用命令行、IDE[创建一个django项目](#创建一个django项目),然后[修改默认后台模板为simpleui](#修改默认后台模板为simpleui)
在开始入门之前,请花1分钟了解下[setti
# 表格和Admin
simplepro table基于elementui table,设置主要来自ModelAdmin,写法与原生admin一致,但是在原生的基础上增加了和减少了部分字段。注意目前table仅支持下列这些字段,但是在编辑和添加页还有用到其他字段,请参考原生admin与simpleui,simplepro是完全基于simpleui的。
## 自定义按钮
admin
# simplepro 自定义权限
+ 在simpleui中没有提供自定义权限的支持。
+ 在原生django admin中没有提供自定义菜单权限的支持,自定义按钮权限支持。
# 权限基础知识
simplepro的权限 也是在django admin的权限中进行扩展的。但是未更改django 权限相关的任何字段。
## 表结构
|表名|名字|作用|
|---|--
# JS-SDK
为了提供更好的前端扩展,simplepro提供了jssdk,在不用重写页面的同时,进行页面最高程度的扩展。但是前提你必须了解Vue,因为JS sdk仅仅提供了vue对象的暴露,需要操作vue对象实现功能的变化。
## 步骤
### 引入JS
首先通过Admin中的Media引入自定义的js文件
例子:
```python
@admin.reg
# 首页配置
simplepro首页默认了较多的模块,也许某些你无法用上。所以该文档提供了如何定制。
simpleui采用框架结构,simplepro也是基于simpleui,simpleui的首页文件`home.html`
只要重写该页面即可。
重写有两种方式,第一种全覆盖,第二种block方式
## 模板重写
### 全覆盖方式
在你的项目的templates目录
# 导入导出
simplepro导入导出是依赖 `django-import-export`插件,配置请参考该插件的文档。
## 插件主页
[https://github.com/django-import-export/django-import-export](https://github.com/django-import-export/django-import-export