README.en_US.md

DjangoAsyncAdmin

DjangoAsyncAdmin is a new dynamic admin interface for Django, featuring asynchronous requests, asynchronous page updates and loading, and a more attractive UI. It is based on vue2+ElementUI2.X and is a simple and efficient solution for high-performance backend management.

This project is based on SimplePro:6.5.2 and is open-source, with no licensing or activation required.

Inspiration

• thinkPHP
• simpleUI
• simplePro

Demo

• Digital World
• AI Lab

Features

Feature	Sub-Feature	Sub-Sub-Feature	Status
Optimized List Pages	Separated Front-End and Back-End Loading of Data	·········	✅
Visualized Homepage Design	·········	·········	✅
Multiple Customizable Theme Skins	·········	·········	✅
Rich Component Library	Integration of Almost All Element-UI Components	·········	✅
	Diverse Kinds of Editors	Rich Text Editor	✅
		Markdown Editor	✅
		Json Editor	✅
	Media Components	Image Upload Component	✅
		Video Playback Component	✅
	Advanced Components	Map Component	✅
		Password Input Component	✅
Supports Customization	Custom Buttons	·········	✅
	Custom Menus	·········	✅
	Custom Permissions	·········	✅
	Custom Dialog Boxes	·········	✅
·········	·········	·········	✅
Optimized Permissions	·········	·········	✅

Usage

Basics

• Component Documentation DjangoAsyncAdmin Components Docs
• Packaging and Deployment Documentation Package And Deploy
• Installation and Configuration Temporary Reference

Advanced Configuration

• Global Configuration Temporary Reference
• Admin Configuration Temporary Reference
• Theme Configuration Temporary Reference
• JS-SDK Temporary Reference
• Custom Permissions Temporary Reference
• Visualization Icons Temporary Reference
• Rich Text Plugins Temporary Reference

Frequently Asked Questions

• Static files temporary reference
• Installation problems temporary reference
• Installation problems temporary reference

Installation

pip installation

pip install DjangoAsyncAdmin

If your installation is slow, you can use the mirror provided by the University of Science and Technology of China to speed up

pip install DjangoAsyncAdmin -i https://pypi.mirrors.ustc.edu.cn/simple/

Source code installation

1. Clone the project to local

git clone https://github.com/Haoke98/DjangoAsyncAdmin.git

2. Generate installation package

Enter the project root directory

python setup.py sdist bdist_wheel

3. Install

pip install /path/to/your_project/dist/DjangoAsyncAdmin-6.5.4.tar.gz

Note: ⚠️ Replace /path/to/your_project with your project path (relative path/absolute path)

Directory structure description

Directory	Remarks
bawa
components	Components, store model fields and form fields
editor	Editor, MD editor, UE rich text editor, JSON editor, etc.
group
locale	Multiple language package directory, plaintext and binary files do not need to be processed
management
monitor
static	Static resource directory, no need to process
templates	Template directory, no need to process
templatetags
__init__.py
action.py
apps.py
apps.py
conf.py
conf.py
core.so	Converted and saved to core.py
decorators.py
dialog.py
filters.py
forms.py
hanlers.py	Removed the part that loads the core.so file and added from core.py import *
middlewares.py
models.py	Basic model file
urls.py
utils.py

New feature log

Version	Description
6.7.3	Fixed rendering abnormalities on the password component (PasswordInputField).
6.7.2	Implemented the Json editor (JsonTextField) and password generator Input (PasswordInputField) and other components. At the same time, the component directory structure was preliminarily adjusted to improve the readability of the code.
6.7.1	Added the PasswordFormField form fields with copy and automatic password generation.
6.7.0	Added basic classes BaseModel and BaseModelWithShowRate to reduce the repetitive design of some basic fields and attributes during the development process, and improve the efficiency of designing models.
6.6.0	Removed the authorization and activation state validation mechanism to make it fully authorized, activated, and free to use for academic research. You can also apply for a free commercial use license. For licensing, cooperation, and other issues, please contact <[email protected]>.
6.5.4	Upgraded and optimized the display of the title and LOGO on the login page of the background management.
6.5.3	Implemented the effect that the table header and the total column at the bottom of the table list page are fixed and the table bodyscroll.

Open source license

The code in this repository is open source under the Apache-2.0 license. This project is completely open to academic research and can also apply for a free commercial use license. For licensing, cooperation, and other issues, please contact [email protected].

Acknowledgments & References

Thanks to newpanjing for simpleui

Thanks to newpanjing for simplepro