allow preselection of values in templating menu()s (patch [SF#1396085])

Author: Richard Jones

CHANGES.txt

@@ -14,6 +14,7 @@ Feature:
 - Roundup installation document includes configuration example
   for Exim Internet Mailer (sf bug 1393860)
 - enable registration confirmation by web only (sf bug 1381675)
+- allow preselection of values in templating menu()s (sf patch 1396085)
 
 Fixed:
 - MySQL now creates String columns using the TEXT column type

doc/customizing.txt

@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.187 $
+:Version: $Revision: 1.188 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -2035,6 +2035,8 @@ menu        only on Link and Multilink properties - render a form select
                 (direction, property) where direction is '+' or '-'. A
                 single string with the direction prepended may be used.
                 For example: ('-', 'order'), '+name'.
+            value
+                gives a default value to preselect in the menu
 
             The remaining keyword arguments are used as conditions for
             filtering the items in the list - they're passed as the

roundup/cgi/templating.py

@@ -1669,13 +1669,14 @@ def field(self, showid=0, size=None):
         return '<input name="%s" value="%s" size="%s">'%(self._formname,
             value, size)
 
-    def menu(self, size=None, height=None, showid=0, additional=[],
+    def menu(self, size=None, height=None, showid=0, additional=[], value=None,
             sort_on=None, **conditions):
         ''' Render a form select list for this property
 
             "size" is used to limit the length of the list labels
             "height" is used to set the <select> tag's "size" attribute
             "showid" includes the item ids in the list labels
+            "value" specifies which item is pre-selected
             "additional" lists properties which should be included in the
                 label
             "sort_on" indicates the property to sort the list on as
@@ -1692,7 +1693,8 @@ def menu(self, size=None, height=None, showid=0, additional=[],
         if not self.is_edit_ok():
             return self.plain()
 
-        value = self._value
+        if value is None:
+            value = self._value
 
         linkcl = self._db.getclass(self._prop.classname)
         l = ['<select name="%s">'%self._formname]
@@ -1857,14 +1859,15 @@ def field(self, size=30, showid=0):
         return self.input(name=self._formname,size=size,value=value)
 
     def menu(self, size=None, height=None, showid=0, additional=[],
-            sort_on=None, **conditions):
+             value=None, sort_on=None, **conditions):
         ''' Render a form <select> list for this property.
 
             "size" is used to limit the length of the list labels
             "height" is used to set the <select> tag's "size" attribute
             "showid" includes the item ids in the list labels
             "additional" lists properties which should be included in the
                 label
+            "value" specifies which item is pre-selected
             "sort_on" indicates the property to sort the list on as
                 (direction, property) where direction is '+' or '-'. A
                 single string with the direction prepended may be used.
@@ -1879,7 +1882,8 @@ def menu(self, size=None, height=None, showid=0, additional=[],
         if not self.is_edit_ok():
             return self.plain()
 
-        value = self._value
+        if value is None:
+            value = self._value
 
         linkcl = self._db.getclass(self._prop.classname)