summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/contrib/admin/index.txt14
1 files changed, 9 insertions, 5 deletions
diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt
index f684452e23..4c06a7575e 100644
--- a/docs/ref/contrib/admin/index.txt
+++ b/docs/ref/contrib/admin/index.txt
@@ -1488,16 +1488,20 @@ templates used by the :class:`ModelAdmin` views:
Returns a :class:`~django.forms.ModelForm` class for use in the admin add
and change views, see :meth:`add_view` and :meth:`change_view`.
- If you wanted to hide a field from non-superusers, for example, you could
- override ``get_form`` as follows::
+ The base implementation uses :func:`~django.forms.models.modelform_factory`
+ to subclass :attr:`~form`, modified by attributes such as :attr:`~fields`
+ and :attr:`~exclude`. So, for example, if you wanted to offer additional
+ fields to superusers, you could swap in a different base form like so::
class MyModelAdmin(admin.ModelAdmin):
def get_form(self, request, obj=None, **kwargs):
- self.exclude = []
- if not request.user.is_superuser:
- self.exclude.append('field_to_hide')
+ if request.user.is_superuser:
+ kwargs['form'] = MySuperuserForm
return super(MyModelAdmin, self).get_form(request, obj, **kwargs)
+ You may also simply return a custom :class:`~django.forms.ModelForm` class
+ directly.
+
.. method:: ModelAdmin.get_formsets(request, obj=None)
.. deprecated:: 1.7