Django admin classes that allow for nested inlines
Permalink
Failed to load latest commit information.
docs Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
gulp Use exposify for globals Apr 10, 2016
nested_admin jQuery.fn.nearest: Use .length, not jQuery.fn.size. fixes #109 Sep 12, 2018
scripts Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
.babelrc Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
.codecov.yml fix codecov target Aug 13, 2018
.editorconfig 3.x refactor: Refactor to use gulp with babel/browserify + scss Apr 9, 2016
.eslintrc.js Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
.gitignore Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
.travis.yml Add django 2.2 to test matrix Aug 13, 2018
CHANGELOG.rst v3.1.2 [ci skip] Sep 6, 2018
LICENSE Change LICENSE year to 2015 Apr 13, 2015
MANIFEST.in v3.1.0 [ci skip] Aug 13, 2018
README.rst Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
gulpfile.babel.js Remove stray console.log in gulpfile May 26, 2016
package-lock.json Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
package.json Use webpack for bundling, add coverage, remove gulp Aug 13, 2018
requirements-rtd.txt Add requirements file for readthedocs [ci skip] Apr 14, 2016
runtests.py ensure order of formset media. fixes #71 Aug 13, 2018
setup.cfg v3.0.21 [ci skip] Nov 1, 2017
setup.py v3.1.2 [ci skip] Sep 6, 2018
tox.ini Add django 2.2 to test matrix Aug 13, 2018
webpack.config.js Use webpack for bundling, add coverage, remove gulp Aug 13, 2018

README.rst

django-nested-admin

build_badge docs_badge

django-nested-admin is a project that makes it possible to nest admin inlines (that is, to define inlines on InlineModelAdmin classes). It is compatible with Django 1.8+ and Python versions 2.7 and 3.4+ and works with or without Grappelli. When Grappelli is not installed it allows Grappelli-like drag-and-drop functionality.

Installation

The recommended way to install django-nested-admin is from PyPI:

pip install django-nested-admin

Alternatively, one can install a development copy of django-nested-admin from source:

pip install -e git+git://github.com/theatlantic/django-nested-admin.git#egg=django-nested-admin

If the source is already checked out, use setuptools to install:

python setup.py develop

Configuration

To use django-nested-admin in your project, "nested_admin" must be added to the INSTALLED_APPS in your settings and you must include nested_admin.urls in your django urlpatterns. django-grappelli is an optional dependency of django-nested-admin. If using Grappelli, make sure the appropriate version of Grappelli is installed for your version of Django.

# settings.py

INSTALLED_APPS = (
    # ...
    'nested_admin',
)

# urls.py

urlpatterns = patterns('',
    # ...
    url(r'^nested_admin/', include('nested_admin.urls')),
)

Example Usage

In order to use django-nested-admin, use the following classes in place of their django admin equivalents:

django.contrib.admin nested_admin
ModelAdmin NestedModelAdmin
InlineModelAdmin NestedInlineModelAdmin
StackedInline NestedStackedInline
TabularInline NestedTabularInline

There is also nested_admin.NestedGenericStackedInline and nested_admin.NestedGenericTabularInline which are the nesting-capable versions of GenericStackedInline and GenericTabularInline in django.contrib.contenttypes.admin.

# An example admin.py for a Table of Contents app

from django.contrib import admin
import nested_admin

from .models import TableOfContents, TocArticle, TocSection

class TocArticleInline(nested_admin.NestedStackedInline):
    model = TocArticle
    sortable_field_name = "position"

class TocSectionInline(nested_admin.NestedStackedInline):
    model = TocSection
    sortable_field_name = "position"
    inlines = [TocArticleInline]

class TableOfContentsAdmin(nested_admin.NestedModelAdmin):
    inlines = [TocSectionInline]

admin.site.register(TableOfContents, TableOfContentsAdmin)

Testing

django-nested-admin has fairly extensive test coverage. The best way to run the tests is with tox, which runs the tests against all supported Django installs. To run the tests within a virtualenv run python runtests.py from the repository directory. The tests require a selenium webdriver to be installed. By default the tests run with phantomjs, but it is also possible to run the tests with the chrome webdriver by passing --selenium=chrome to runtests.py or, if running with tox, running tox -- --selenium=chrome. See runtests.py --help for a complete list of the options available.

Contributing

This project uses webpack for building its javascript and css. To install the dependencies for the build process, run npm install from the root of the repository. You can then run npm run build to rebuild the static files.

License

The django code is licensed under the Simplified BSD License. View the LICENSE file under the root directory for complete license and copyright information.