# Simple UI

Simpleui

让Django Admin简单而友好

Simple and friendly. Django admin theme the simpleui


中文 | English


demo

# 介绍

🚀simpleui 是django admin的一个主题 是一个基于element-ui+vue开发,重写和优化90%以上的页面。 与suit是同类产品。我们是一个更符合国人审美和使用习惯的一个主题。

# 特点


👍 内置28款流行的主题

⚡️ pip闪电安装100%兼容原生admin无需修改代码

✨ 多标签页面,各个模块更加清晰明了

🎯 配置简单,极速上手,在settings.py中加入simpleui后启动立即生效,效率提升 100%!让后端开发得心应手。

☕️ Element-UI + Vue 加持,让古老的django admin 焕然一新。

# 文档&教程

文档详细的描述了安装使用方法,以及各种配置项的说明,请点击以下链接查阅。

  • 重要的事情说3遍:

👇👇👇👇👇👇👇👇👇👇👇

👉 1.simpleui文档教程使用说明 👈

👉 2.simpleui文档教程使用说明👈

👉 3.simpleui文档教程使用说明👈

👆👆👆👆👆👆👆👆👆👆👆

# 开发初衷

Django Admin默认界面设计语言存在着的一些不足,比如色彩单一,大量线条的使用,分割化明显。将这些不足归类一下就是界面单调、雷同性明显、缺少惊喜。我们认为新的平台类视觉风格可以打破这些束缚,尝试一些新的探索,启发传统的设计认知,因此结合当下设计趋势,构思了Element+Django Admin的Simpleui。让Django Admin和Element产生完美的交互。配以最流行的后台设计风格,让Django Admin更加强大。

# QQ群

  • QQ群号:873469913

# 本地Demo

如果你没有任何python django基础,可以下载一个可以直接运行的demo进行体验。 😝DEMO源码 (opens new window)

# 在线Demo

权限受限,只能查看模块的相关数据,不能操作。如果要体验全部功能,请在自己的系统安装simpleui查看效果。

# 开始使用

详细步骤请浏览 使用文档。 也可以参考Demo

# 安装

pip install django-simpleui
1

用pip或者源码方式安装simpleui后,在自己项目的settings.py文件中INSTALLED_APPS的第一行加入simpleui

举个例子🌰:

  # Application definition

  INSTALLED_APPS = [
      'simpleui',
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
      ...
  ]
1
2
3
4
5
6
7
8
9
10
11
12

如果不知道怎么配置或者如何使用,请下载本地demo进行学习。或者加入QQ群:873469913 咨询。

# 升级simpleui

pip install django-simpleui --upgrade
1

# 克隆源码本地安装

git clone https://github.com/newpanjing/simpleui
cd simpleui
python setup.py sdist install
1
2
3

# 常见问题

  1. 如果关闭debug模式后,请执行以下命令将simpleui静态文件静态文件克隆到根目录

    python3 manage.py collectstatic
    
    1
  2. 克隆静态文件出错 请在settings.py文件中加入:

    STATIC_ROOT = os.path.join(BASE_DIR, "static")
    
    1
  3. 静态文件丢失的问题请参考:管理静态文件 (opens new window)

  4. 其他问题请参考django官方文档 (opens new window)django-admin配置 (opens new window)

  5. i18n 国际化 采用js国际化,默认为英文和中文两种语言,随系统切换。具体请看国际化配置

其他问题请查看快速上手指南

# 支持django和python版本

# 支持的Python版本

版本 说明
Python2.7.x 不支持
Python3.x 支持
Python3.7.x 支持
Python3.8.x 支持
Python3.9.x 支持

不支持是指未经官方测试,可能某些模块会报错。

3.9由于未发布,PyCharm不支持,可以用命令行创建Python39虚拟环境

python39 -m venv venv39
1

# 支持的Django版本

版本 说明
Django1.x 不支持
Django2.x 支持
Django3.x 支持

不支持是指未经官方测试,可能某些模块会报错。

# 浏览器兼容性

Chrome Firefox Edge IE Safari Opera UC
11+ ✔

# README 徽章

如果你的项目正在使用Simpleui,可以将Simpleui徽章 ice (opens new window) 添加到你的 README 中:

[![simpleui](https://img.shields.io/badge/developing%20with-Simpleui-2077ff.svg)](https://github.com/newpanjing/simpleui)
1

# 赞助💰

如果你觉得simpleui对你有帮助,你可以赞助我们一杯咖啡,鼓励我们继续开发维护下去。 扫码赞助

# 预览图

# 登录页

# 主页

# 列表页

# 切换主题

# 密码修改

# 编辑页

# 设置字体大小

# 优质贡献者

simpleui的发展离不开以下优秀贡献者的支持。如果您想为simpleui贡献代码,请fork到自己仓库,然后发起合并请求,合并至dev分支。

Github 贡献范围
@zhangzhibo1014 (opens new window) 英文文档翻译
@liaogx (opens new window) bug修复
@shouyong (opens new window) bug修复
@Roddy1219 (opens new window) bug修复
@WalkerWang731 (opens new window) 优质代码贡献

# 致谢

开发工具由Jetbrains (opens new window)赞助的Pycharm