Permalink
Browse files

Added documentation for cms.forms.field.PageSelectFormField and cms.m…

…odels.fields.PageField, fixes #904
  • Loading branch information...
1 parent 73c3665 commit 334ac064e728ce0d9211c03470ea12874fb60bd7 Jonas Obrist committed Aug 4, 2011
Showing with 33 additions and 0 deletions.
  1. +32 −0 docs/extending_cms/fields.rst
  2. +1 −0 docs/index.rst
@@ -0,0 +1,32 @@
+#####################
+Form and model fields
+#####################
+
+
+************
+Model fields
+************
+
+
+.. py:class:: cms.models.fields.PageField
+
+ This is a foreign key field to the :class:`cms.models.pagemodel.Page` model
+ that defaults to use the :class:`cms.forms.fields.PageSelectFormField` form
+ field when rendered in forms. It has the same API as the
+ :class:`django.db.models.fields.related.ForeignKey` but does not require
+ the ``othermodel`` argument.
+
+
+***********
+Form fields
+***********
+
+
+.. py:class:: cms.forms.fields.PageSelectFormField
+
+ Behaves like a :class:`django.forms.models.ModelChoiceField` field for the
+ :class:`cms.models.pagemodel.Page` model, but displays itself as a splitted
+ field with a select dropdown for the site and one for the page. It also
+ indents the page names based on what level they're on, so that the page
+ select dropdown is easier to use. Takes the same arguments as
+ :class:`django.forms.models.ModelChoiceField`.
View
@@ -54,6 +54,7 @@ Extending the CMS
extending_cms/api_references
extending_cms/placeholders
extending_cms/searchdocs
+ extending_cms/fields
***********************

0 comments on commit 334ac06

Please sign in to comment.