Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
140 lines (118 sloc) 4.472 kb
from django import forms
from django.conf import settings
from django.conf.urls.defaults import patterns, url
except ImportError:
from django.conf.urls import patterns, url
from django.contrib.admin import helpers
from django.core.exceptions import PermissionDenied
from django.core.urlresolvers import reverse
from django.utils.decorators import method_decorator
from django.views.decorators.csrf import csrf_protect
csrf_protect_m = method_decorator(csrf_protect)
class ObjectTool(object):
Base class from which all other tools should inherit.
Provides setup and utility method for easily rendering a form in admin.
def __init__(self, model):
Set model and modeladmin on which tool is acting
for easy access in other methods.
from django.contrib.admin import site
self.model = model
self.modeladmin = site._registry.get(model)
if self.modeladmin:
self.modeladmin_changelist_view = self.modeladmin.changelist_view
self.modeladmin.changelist_view = self.changelist_view
def changelist_view(self, request, extra_context=None):
Simple wrapper to pass request to admin/change_list.html
return self.modeladmin_changelist_view(
request, extra_context={'request': request}
def construct_form(self, request):
Constructs form from POST method using self.form_class.
if not hasattr(self, 'form_class'):
return None
if request.method == 'POST':
form = self.form_class(self.model, request.POST, request.FILES)
form = self.form_class(self.model)
return form
def get_permission(self):
return u'%s_%s' % (, self.model._meta.object_name.lower())
def has_permission(self, user):
Returns True if the given request has permission to use the tool.
Can be overriden by the user in subclasses.
return user.has_perm(
self.model._meta.app_label + '.' + self.get_permission()
def media(self, form):
Collects admin and form media.
js = ['admin/js/core.js', 'admin/js/admin/RelatedObjectLookups.js',
'admin/js/jquery.min.js', 'admin/js/jquery.init.js']
media = forms.Media(
js=['%s%s' % (settings.STATIC_URL, u) for u in js],
if form:
for name, field in form.fields.iteritems():
media = media +
return media
def reverse(self):
info = self.model._meta.app_label, self.model._meta.module_name, \
return reverse('object-tools:%s_%s_%s' % info)
def _urls(self):
URL patterns for tool linked to _view method.
info = self.model._meta.app_label, self.model._meta.module_name, \
urlpatterns = patterns(
'', url(r'^%s/$' %, self._view, name='%s_%s_%s' % info),
return urlpatterns
urls = property(_urls)
def construct_context(self, request):
Builds context with various required variables.
opts = self.model._meta
app_label = opts.app_label
object_name = opts.object_name.lower()
form = self.construct_form(request)
media =
context = {
'user': request.user,
'title': '%s %s' % (self.label, opts.verbose_name_plural.lower()),
'tool': self,
'opts': opts,
'app_label': app_label,
'media': media,
'form': form,
'changelist_url': reverse('admin:%s_%s_changelist' % (
app_label, object_name
# Pass along fieldset if sepcififed.
if hasattr(form, 'fieldsets'):
admin_form = helpers.AdminForm(form, form.fieldsets, {})
context['adminform'] = admin_form
return context
def _view(self, request, extra_context=None):
View wrapper taking care of houskeeping for painless form rendering.
if not self.has_permission(request.user):
raise PermissionDenied
return self.view(request, self.construct_context(request))
Jump to Line
Something went wrong with that request. Please try again.