Welcome to django-admin2’s documentation!¶
Warning: This project is currently in an alpha state and currently not meant for real projects.
One of the most useful parts of django.contrib.admin is the ability to configure various views that touch and alter data. django-admin2 is a complete rewrite of that library using modern Class-Based Views and enjoying a design focused on extendibility and adaptability. By starting over, we can avoid the legacy code and make it easier to write extensions and themes.
django-admin2 aims to replace django’s built-in admin that lives in
django.contrib.admin. Come and help us, read the Design and
Contributing pages, and visit the GitHub project.
This project is intentionally backwards-incompatible with django.contrib.admin.
Features¶
- Rewrite of the Django Admin backend
- Drop-in themes
- Built-in RESTful API
Basic API¶
If you’ve worked with Django, this implementation should look familiar:
# myapp/admin2.py
# Import your custom models
from django.contrib.auth.forms import UserCreationForm, UserChangeForm
from django.contrib.auth.models import User
from .models import Post, Comment
from djadmin2.site import djadmin2_site
from djadmin2.types import ModelAdmin2
class UserAdmin2(ModelAdmin2):
create_form_class = UserCreationForm
update_form_class = UserChangeForm
# Register each model with the admin
djadmin2_site.register(Post)
djadmin2_site.register(Comment)
djadmin2_site.register(User, UserAdmin2)