A Bootstrap theme for Django Admin
Project description
A Django admin theme using Bootstrap. It doesn’t need any kind of modification on your side, just add it to the installed apps.
Requirements
Django >=1.6
Installation
Since 2.0 we are targeting Bootstrap 3 and recent Django versions. The old 1.x series works with Django >=1.4 and <1.7.
Download it from PyPi with pip install django-admin-bootstrapped
Add into the INSTALLED_APPS before 'django.contrib.admin':
'django_admin_bootstrapped',
Have fun!
Configuration
For a full bootstrap3 experience you may want to use a custom renderer for the fields. There’s one available in tree that requires the django-bootstrap3 application installed. You have to add to your project settings file:
DAB_FIELD_RENDERER = 'django_admin_bootstrapped.renderers.BootstrapFieldRenderer'
Messages will have alert-info tag by default, so you may want to add Bootstrap 3 tags for different message levels to make them styled appropriately. Add to your project settings file:
from django.contrib import messages
MESSAGE_TAGS = {
messages.SUCCESS: 'alert-success success',
messages.WARNING: 'alert-warning warning',
messages.ERROR: 'alert-danger error'
}
Now, adding messages like this:
messages.success(request, "My success message") messages.warning(request, "My warning message") messages.error(request, "My error message")
will result into this:
Goodies
Translate/change an application name with a template
With a version of django < 1.7 you can’t change the application name, but django-admin-bootstrapped let you do it in a really easy way. Create a file named admin_app_name.html into the application’s template folder. Eg: myapp/templates/admin_app_name.html or project/templates/myapp/admin_app_name.html. Please be warned that since this is already possible using plain django the feature will be removed in favour of the upstream solution.
You can also change the default Django Administration title, just add a admin_title.html file into your project/templates/admin/ folder.
Add custom html to the change form of any model with a template
You can inject custom html on top of any change form creating a template named admin_model_MODELNAME_change_form.html into the application’s template folder. Eg: myapp/templates/myapp/admin_model_mymodelname_change_form.html or project/templates/myapp/admin_model_mymodelname_change_form.html.
Inline sortable
You can add drag&drop sorting capability to any inline with a couple of changes to your code.
First, add a position field in your model (and sort your model accordingly), for example:
class TestSortable(models.Model):
that = models.ForeignKey(TestMe)
position = models.PositiveSmallIntegerField("Position")
test_char = models.CharField(max_length=5)
class Meta:
ordering = ('position', )
Then in your admin.py create a class to handle the inline using the django_admin_bootstrapped.admin.models.SortableInline mixin, like this:
from django_admin_bootstrapped.admin.models import SortableInline
from models import TestSortable
class TestSortable(admin.StackedInline, SortableInline):
model = TestSortable
extra = 0
You can now use the inline as usual. The result will look like this:
This feature was brought to you by Kyle Bock. Thank you Kyle!
XHTML Compatible
Compatible with both html and xhtml. To enable xhtml for your django app add the following to your settings.py: DEFAULT_CONTENT_TYPE = ‘application/xhtml+xml’
Generic lookups in admin
All that needs to be done is change the admin widget with either formfield_overrides like this:
from django_admin_bootstrapped.widgets import GenericContentTypeSelect
class SomeModelAdmin(admin.ModelAdmin):
formfield_overrides = {
models.ForeignKey: {'widget': GenericContentTypeSelect},
}
Or if you want to be more specific:
from django_admin_bootstrapped.widgets import GenericContentTypeSelect
class SomeModelAdmin(admin.ModelAdmin):
def formfield_for_dbfield(self, db_field, **kwargs):
if db_field.name == 'content_type':
kwargs['widget'] = GenericContentTypeSelect
return super(SomeModelAdmin, self).formfield_for_dbfield(db_field, **kwargs)
If you decide on using formfield_overrides you should be aware of its limitations with relation fields.
This feature (and many more) was brought to you by Jacob Magnusson. Thank you Jacob!
Contributing
Every code, documentation and UX contribution is welcome.
Found an issue? Report it in the bugtracker!
Have some free time? Help fixing an already filed issue, just remember to work on a separate branch please.
Screenshots
Homepage
List view with filters in dropdown
Change form view
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-admin-bootstrapped-2.3.5.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6e797753a27ffb35c3c58a261d47b9f0371dd17545729b28817be3c778a67d07 |
|
| MD5 | 9ab98a57cc885e3e8cd4ad7eba6215fe |
|
| BLAKE2b-256 | b40a6335889bcc2b5a60fbddf444653f58d104864b997ff6a836a2ab58c826d5 |
