Ticket #7973: 7973.exclude.diff

django/django/contrib/admin/options.py

@@ -116 +116 @@
     raw_id_fields = ()
     fields = None
     fieldsets = None
+    exclude = None
     form = forms.ModelForm
     filter_vertical = ()
     filter_horizontal = ()
@@ -319 +320 @@
             fields = flatten_fieldsets(self.declared_fieldsets)
         else:
             fields = None
-        return modelform_factory(self.model, form=self.form, fields=fields, formfield_callback=self.formfield_for_dbfield)
+        return modelform_factory(self.model, form=self.form, fields=fields, formfield_callback=self.formfield_for_dbfield, exclude=self.exclude)
 
     def get_formsets(self, request, obj=None):
         for inline in self.inline_instances:
@@ -726 +727 @@
         return inlineformset_factory(self.parent_model, self.model,
             form=self.form, formset=self.formset, fk_name=self.fk_name,
             fields=fields, formfield_callback=self.formfield_for_dbfield,
-            extra=self.extra, max_num=self.max_num)
+            extra=self.extra, max_num=self.max_num, exclude=self.exclude)
 
     def get_fieldsets(self, request, obj=None):
         if self.declared_fieldsets:

django/tests/regressiontests/modeladmin/models.py

@@ -162 +162 @@
 
 >>> band2.delete()
 
+
+Using 'exclude'.
+>>> class BandAdmin(ModelAdmin):
+...     exclude = ['bio']
+>>> ma = BandAdmin(Band, site)
+>>> ma.get_form(request).base_fields.keys()
+['name', 'sign_date']
+
+Using 'fields' *and* 'exclude'.
+>>> class BandAdmin(ModelAdmin):
+...     fields = ['name', 'bio']
+...     exclude = ['bio']
+>>> ma = BandAdmin(Band, site)
+>>> ma.get_form(request).base_fields.keys()
+['name']
+
+
 # radio_fields behavior ################################################
 
 First, without any radio_fields specified, the widgets for ForeignKey

django/docs/admin.txt

@@ -147 +147 @@
     ``django.utils.html.escape()`` to escape any HTML special
     characters.
 
+``exclude``
+~~~~~~~~~~~
+
+This attribute, if given, should be a list of field names to exclude from the form.
+
+For example, let's consider the following model::
+
+    class Author(models.Model):
+        name = models.CharField(max_length=100)
+        title = models.CharField(max_length=3)
+        birth_date = models.DateField(blank=True, null=True)
+        
+If you want a form for the ``Author`` model that includes only the ``name`` and ``title``
+fields, you would specify ``fields`` or ``exclude`` like this::
+
+    class AuthorAdmin(admin.ModelAdmin):
+        fields = ('name', 'title')
+
+    class AuthorAdmin(admin.ModelAdmin):
+        exclude = ('birth_date',)
+
+Since the Author model only has 3 fields, 'name', 'title', and 'birth_date', the forms
+resulting from the above declarations will contain exactly the same fields.
+
 ``filter_horizontal``
 ~~~~~~~~~~~~~~~~~~~~~