Changeset 7684

Timestamp:

06/17/08 17:45:59 (5 months ago)

Author:

brosner

Message:

newforms-admin: Brought docs/admin.txt up to speed on missing options from ModelAdmin?.

Files:

• django/branches/newforms-admin/docs/admin.txt (modified) (3 diffs)
• django/branches/newforms-admin/docs/model-api.txt (modified) (1 diff)

django/branches/newforms-admin/docs/admin.txt

@@ -147 +147 @@
-    and you must escape any special HTML characters (such as ampersands) yourself.
-
+``filter_horizontal``
+~~~~~~~~~~~~~~~~~~~~~
+
+Use a nifty unobtrusive Javascript "filter" interface instead of the
+usability-challenged ``<select multiple>`` in the admin form. The value is a
+list of fields that should be displayed as a horizontal filter interface. See
+``filter_vertical`` to use a vertical interface.
+
+``filter_vertical``
+~~~~~~~~~~~~~~~~~~~
+
+Same as ``filter_horizontal``, but is a vertical display of the filter
+interface.
+
-``list_display``
-~~~~~~~~~~~~~~~~
@@ -342 +356 @@
-If this isn't provided, the Django admin will use the model's default ordering.
-
+``prepopulated_fields``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Set ``prepopulated_fields`` to a dictionary mapping field names to the fields
+it should prepopulate from::
+
+    class ArticleAdmin(admin.ModelAdmin):
+        prepopulated_fields = {"slug": ("title",)}
+
+When set the given fields will use a bit of Javascript to populate from the
+fields assigned.
+
+``prepopulated_fields`` doesn't accept DateTimeFields, ForeignKeys nor
+ManyToManyFields.
+
-``radio_fields``
-~~~~~~~~~~~~~~~~
@@ -358 +387 @@
-Don't include a field in ``radio_fields`` unless it's a ``ForeignKey`` or has
-``choices`` set.
+
+``raw_id_fields``
+~~~~~~~~~~~~~~~~~
+
+By default, Django's admin uses a select-box interface (<select>) for
+fields that are ``ForeignKey``. Sometimes you don't want to incur the
+overhead of having to select all the related instances to display in the
+drop-down.
+
+``raw_id_fields`` is a list of fields you would like to change
+into a ``Input`` widget for the primary key.
-
-``save_as``

django/branches/newforms-admin/docs/model-api.txt

@@ -423 +423 @@
-
-Implies ``db_index=True``.
-
-Accepts an extra option, ``prepopulate_from``, which is a list of fields
-from which to auto-populate the slug, via JavaScript, in the object's admin
-form::
-
-    models.SlugField(prepopulate_from=("pre_name", "name"))
-
-``prepopulate_from`` doesn't accept DateTimeFields, ForeignKeys nor
-ManyToManyFields.
-
-The admin represents ``SlugField`` as an ``<input type="text">`` (a
-single-line input).
-
-``SmallIntegerField``