Changes between Version 33 and Version 34 of S3/FilterForms

Timestamp:

03/27/13 21:40:52 (13 years ago)

Author:

Dominic König

Comment:

--

S3/FilterForms

@@ -137 +137 @@
 === Configuration of Filter Forms in S3CRUD ===
 
-S3CRUD has filter forms integrated in the standard list view (=multi-record request w/o URL method) - as well as the /datatable_f and /datalist_f views.
-
-For these pages, the filter widgets are configured per resource as a list of filter widget instances in the "filter_widgets"-setting like:
+==== Standard List Views ====
+
+S3CRUD has filter forms integrated in the standard list view (=multi-record request w/o URL method). The filter form can be suppressed by a keyword argument to {{{s3_rest_controller()}}:
+
+{{{
+output = s3_rest_controller(prefix, resourcename,
+                            hide_filter=True        # hide filter form in list views
+                           )
+}}}
+
+To render only the datatable or datalist without the filter form, choose the /datatable or /datalist method instead.
+
+To choose a particular list type from the URL yet render the filter form, choose the /datatable_f resp. the /datalist_f method (overrides hide_filter).
+
+==== Configuration ====
+
+For pages with filter forms, the filter widgets are configured per resource as a list of filter widget instances in the "filter_widgets"-setting like:
 
 {{{
@@ -160 +174 @@
 The widgets appear in the form in list order.
 
+==== Controller Arguments ====
+
 Additionally, there are a number of controller options for the s3_rest_controller call: