Changes between Version 60 and Version 61 of S3/S3REST/s3_rest_controller

Timestamp:

04/17/11 21:53:19 (14 years ago)

Author:

Dominic König

Comment:

--

S3/S3REST/s3_rest_controller

@@ -84 +84 @@
   - in standard views, the add-form in list views is hidden and can be activated by clicking the respective "Add Record" button. If {{{listadd=False}}}, then the "Add Record" button will redirect to the create-form view instead.
   - these settings do not effect non-interactive representations
+
+=== List-Fields ===
+
+To control which fields appear in list views (and to prescribe the order of the columns), use the {{{list_fields}}}-setting. This setting takes a list of field names of the fields to be displayed:
+
+{{{
+s3xrc.model.configure(table,
+                      list_fields=["id", "name", "location_id"])
+}}}
+
+  NOTE: If your view uses dataTables (which all default view templates do), then you '''must''' include {{{"id"}}} at the first place to have it working properly.
+
+For virtual fields, you should provide a tuple of {{{(T("FieldLabel"), "fieldname")}}}, because virtual fields do not have a {{{.label}}} setting (as they are functions and not {{{Field}}} instances):
+
+{{{
+s3xrc.model.configure(table,
+                      list_fields=[
+                          "id",
+                          "name",
+                          "location_id",
+                          (T("Total costs"), "total_costs")
+                      ]
+}}}
 
 === List-add ===