Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Fixed #8299 -- Clarified the ModelAdmin.form option. Also added an in…

…ner Meta class to the ModelForm example in adding custom validation to the admin. Thanks jarrow for the report and initial patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@8395 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 8edb4f97c749bc21846f058d2bf4137893bce481 1 parent 6a71c76
@brosner brosner authored
Showing with 11 additions and 3 deletions.
  1. +11 −3 docs/admin.txt
View
14 docs/admin.txt
@@ -72,9 +72,14 @@ Example::
``form``
~~~~~~~~
-The default ``forms.ModelForm`` class used to generate the form on the
-add/change pages for models. You can easily change this to your own
-``ModelForm`` to override the default form behavior of the add/change pages.
+By default a ``ModelForm`` is dynamically created for your model. It is used
+to create the form presented on both the add/change pages. You can easily
+provide your own ``ModelForm`` to override any default form behavior on the
+add/change pages.
+
+For an example see the section `Adding custom validation to the admin`_.
+
+.. _Adding custom validation to the admin: #adding-custom-validation-to-the-admin
``fieldsets``
~~~~~~~~~~~~~
@@ -617,6 +622,9 @@ needed. Now within your form you can add your own custom validation for
any field::
class MyArticleAdminForm(forms.ModelForm):
+ class Meta:
+ model = Article
+
def clean_name(self):
# do something that validates your data
return self.cleaned_data["name"]
Please sign in to comment.
Something went wrong with that request. Please try again.