Changes between Version 4 and Version 5 of DeveloperGuidelines/DataTables

Timestamp:

06/10/11 05:16:46 (14 years ago)

Author:

graeme

Comment:

--

DeveloperGuidelines/DataTables

@@ -61 +61 @@
 }}}
 This is sufficient to generate a vanilla dataTable as follows:
+[[BR]]
 [[Image(DataTable_Plain.png)]]
+[[BR]]
 === Adding Buttons ===
+With the default settings two buttons are provided, Open and Delete. Additional buttons can be added by using the actions, or more fully, response.s3.actions. The following code will add an "Import" button
+{{{
+#!div style="font-size: 80%"
+Add this to the postp() function of the controller:
+  {{{#!python
+    def postp(r, output):
+        response.s3.actions = [
+                                dict(label=str(UPDATE), _class="action-btn",
+                                     url=str(URL(r=request,
+                                                 c=module,
+                                                 f=resourcename,
+                                                 args=["[id]", "update"]))),
+                                dict(label=str(DELETE), _class="action-btn",
+                                     url=str(URL(r=request,
+                                                 c=module,
+                                                 f=resourcename,
+                                                 args=["[id]", "delete"]))),
+                                dict(label=str(T("Import")), _class="action-btn",
+                                     url=str(URL(r=request,
+                                                 c=module,
+                                                 f=resourcename,
+                                                 args=["[id]", "import"]))),
+                              ]
+        return output
+}}}
+Notice that before the Open and Delete buttons were provided, now they need to be explicitly added.
+[[BR]]
+[[Image(DataTable_Plus_Import_Btn.png)]]
+[[BR]]
 === Adding Buttons conditionally ===
+Maybe you don't want the ability to import every file. Such as files that are older than a certain date.
+{{{
+#!div style="font-size: 80%"
+Add this to the postp() function of the controller:
+  {{{#!python
+    def postp(r, output):
+        from datetime import tzinfo, timedelta, datetime
+        cutoffDate = datetime.now() - timedelta(days=30)
+        query = (r.table.created_on > cutoffDate)
+        rows = db(query).select(r.table.id)
+        restrict = [str(row.id) for row in rows]
+        response.s3.actions = [
+                                dict(label=str(UPDATE), _class="action-btn",
+                                     url=str(URL(r=request,
+                                                 c=module,
+                                                 f=resourcename,
+                                                 args=["[id]", "update"]))),
+                                dict(label=str(DELETE), _class="action-btn",
+                                     url=str(URL(r=request,
+                                                 c=module,
+                                                 f=resourcename,
+                                                 args=["[id]", "delete"]))),
+                                dict(label=str(T("Import")), _class="action-btn",
+                                     url=str(URL(r=request,
+                                                 c=module,
+                                                 f=resourcename,
+                                                 args=["[id]", "import"])),
+                                     restrict = restrict
+                                     ),
+                              ]
+        return output
+}}}
+The key is the restrict argument that is passed to the Import button. This is set up as a list of record ids that will display the button.
+[[BR]]
+[[Image(DataTable_Plus_Cond_Import_Btn.png)]]
+[[BR]]
+
 === Changing the displayed text ===
 === Sorting by a selected column ===