django-admin2 0.6.1

An introspective interface for Django's ORM.

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.

Full Documentation at: http://django-admin2.rtfd.org/

Features

  • Rewrite of the Django Admin backend
  • Drop-in themes
  • Built-in RESTful API

Requirements

Installation

Use pip to install from PyPI:

pip install django-admin2

Add djadmin2 and rest_framework to your settings file:

INSTALLED_APPS = (
    ...
    'djadmin2',
    'rest_framework', # for the browsable API templates
    'floppyforms', # For HTML5 form fields
    'crispy_forms', # Required for the default theme's layout
    ...
)

Add the default theme in your settings file:

# In settings.py
INSTALLED_APPS += ('djadmin2.themes.djadmin2theme_default',)
ADMIN2_THEME_DIRECTORY = "djadmin2theme_default/"

Add djadmin2 urls to your URLconf:

# urls.py
from django.conf.urls import patterns, include

import djadmin2

djadmin2.default.autodiscover()


urlpatterns = patterns(
   ...
   url(r'^admin2/', include(djadmin2.default.urls)),
)

How to write django-admin2 modules

# 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

import djadmin2


class UserAdmin2(djadmin2.ModelAdmin2):
    # Replicates the traditional admin for django.contrib.auth.models.User
    create_form_class = UserCreationForm
    update_form_class = UserChangeForm


#  Register each model with the admin
djadmin2.default.register(Post)
djadmin2.default.register(Comment)
djadmin2.default.register(User, UserAdmin2)

Migrating from 0.5.x

Themes are now defined explicitly, including the default theme. Therefore, your settings need to include this:

# In settings.py
INSTALLED_APPS += ('djadmin2.themes.djadmin2theme_default',)
ADMIN2_THEME_DIRECTORY = "djadmin2theme_default/"

Drop-In Themes

The default theme is whatever bootstrap is most current. Specifically:

# In settings.py
INSTALLED_APPS += ('djadmin2.themes.djadmin2theme_default',)
ADMIN2_THEME_DIRECTORY = "djadmin2theme_default/"

If you create a new theme, you define it thus:

# In settings.py
# Mythical theme! This does not exit... YET!
INSTALLED_APPS += ('djadmin2theme_foundation',)
ADMIN2_THEME_DIRECTORY = "djadmin2theme_foundation/"

Support this project!

You can hire the lead maintainer to perform dedicated work on this package. Please email pydanny@cartwheelweb.com.

History

0.6.1 (2014-02-26)

  • Fix empty form display
  • Added more explicit installation instructions
  • Added migration instructions
  • Added view descriptions for "registry" and "app_verbose_names"
  • Show a nice message and margin if there are no visible fields
  • Updated widget controls for Django 1.6 changes.
  • Better error messages for admin views that fail to instantiate
  • Added png glyphicons to MANIFEST

0.6.0 (2013-09-12)

  • Implemented LogHistory to track recent history
  • New system for adding new views to ModelAdmin2 object
  • Fixed missing enctype="multipart/form-data" functionality
  • Implemented "app verbose name"
  • Apps can have customized names
  • List Actions can be set so they don't require selecting a model
  • Implemented ModelAdmin2.ordering
  • To maintain API consistency, renamed views.AdminView's "url" argument to "regex"
  • Implemented ModelAdmin2.date_hierarchy
  • Changed theming system to make default theme follow the same rules as third-party themes.
  • Inlines now separated into stacked and tabular formats
  • Code coverage now displaying in README
  • User list page now showing all default columns and filters
  • Vast documentation improvements
  • Converted to django.utils.encoding.force_str instead unicode in order to type edge cases
  • setup.py fix

0.5.1 (2013-07-14)

  • No longer pinning dependencies on specific versions
  • Documentation on built-in views shows context variables.
  • Added django-filter to dependency list
  • Problem with related_name resolved
  • Fixed the height of the change_form
  • Example app actually shows added content
  • Pull requests going forward are internationalized
  • FAQ begun

0.5.0 (2013-07-08)

  • Implemented customizable value renderers
  • Implemented list filters using django-filters. Greatly supersedes what Django provides.
  • Implemented ModelAdmin2.save_on_top and ModelAdmin2.save_on_bottom
  • Implemented BooleanField icons for List and Detail views
  • Implemented default django.contrib.auth and django.contrib.sites registrations
  • Implemented the displayed of verbose field/method names in list view
  • Implemented client-side ordering of model list fields in default theme
  • Implemented improved internal naming conventions
  • Improved example project home page
  • Improved internal test coverage
  • Documentation for Context Variables in Themes
  • Corrected early nomenclature decisions
  • Much improved Internationalization
  • Added django-admin2 to Transifex
  • Translations for French, Polish, Slovak, Chinese, German, Catalan, Italian, and Spanish.

0.4.0 (2013-06-30)

  • Implemented both Function- and Class-based Action views
  • Implemented ModelAdmin2.list_display
  • Implemented ModelAdmin2.fieldsets
  • Dropdown widget now displays the selected choice
  • Added support for callables in ModelAdmin2.list_display
  • Added screenshots to README
  • Added second example project
  • Fixed breadcrumbs
  • Default theme: Proper closing of template and media blocks
  • Default theme: Standardized indentation in default theme templates
  • Default theme: Pointed to CDN for JQuery
  • Default theme: Added basic style for login form
  • Default theme: Internationalized all text strings

0.3.0 (2013-05-31)

  • HTML5 forms via floppyforms.
  • Many API improvements.
  • Added Breadcrumbs.
  • Added Login, Logout, ChangePassword views.
  • Added Actions.
  • Added support for inlines.
  • Added view based permission controls
  • Implement delete confirmations for child models.
  • Testrunner now can run on a specific test set or module.
  • Internal code refactoring to follow standards.
  • Moved to git-flow for accepting pull requests.
  • Model create/update pages now have save options.
  • Added i18n to all templates, much of internal code.
  • All print statements replaced with proper logging.
  • Design goals specified in the documentation.

0.2.0 (2013-05-19)

  • Birth! (Working Prototype)
  • Easy-to-extend API that follows similar patterns to django.contrib.admin.
  • Built-in RESTFUL API powered by django-rest-framework.
  • Default theme built on Twitter Bootstrap.
  • Easy to implement theme system.
  • Basic permission controls.
  • Testrunner
  • Documentation

0.1.1 (2013-05-17)

  • Code adoption from django-mongonaut.
  • Preperation for Django Circus sprints.

0.1 (2013-05-13)

  • Discussion with Russell Keith-Magee.
  • Inception.
MIT

Author

Daniel Greenfeld & Contributors

Pip

django-admin2==0.6.1

Classifiers

  • Environment :: Web Environment
  • Framework :: Django
  • Operating System :: OS Independent
  • Programming Language :: Python :: 2.7
  • Programming Language :: Python :: 3.3
  • Development Status :: 3 - Alpha
  • License :: OSI Approved :: BSD License
  • Topic :: Software Development :: Libraries :: Python Modules
  • Topic :: Internet :: WWW/HTTP
  • Topic :: Internet :: WWW/HTTP :: Dynamic Content
  • Programming Language :: JavaScript
File Type Python Version Uploaded On Downloads
django-admin2-0.6.1.tar.gz Source Feb. 26, 2014 3,073
Version Release Date
0.6.1 Feb. 26, 2014
0.6.0rc1 Sept. 12, 2013
0.5.2 July 14, 2013
0.5.1 July 14, 2013
0.5.0 July 9, 2013
Date Package Version Action
Aug. 24, 2015, 10:57 p.m. django-admin2 0.5.2 Release Created
Aug. 24, 2015, 10:57 p.m. django-admin2 0.5.1 Release Created
Aug. 24, 2015, 10:57 p.m. django-admin2 0.5.0 Release Created
Aug. 24, 2015, 10:57 p.m. django-admin2 0.6.1 Release Created
Aug. 24, 2015, 10:57 p.m. django-admin2 0.6.0rc1 Release Created
Aug. 24, 2015, 10:57 p.m. django-admin2 Package Created