+ return encode_options($str, $states_assoc, $use_keys = true);
+}
+
+
+define('PULLDOWN_ARRAY', 0); define('PULLDOWN_HASH', 1); define('PULLDOWN_2D', 2);
+
+function pulldown_options_to_hash($options, $keys_from) {
+ # convert other types of input to value=>display hash
+ switch($keys_from) {
+ case PULLDOWN_HASH:
+ return $options;
+ case PULLDOWN_ARRAY:
+ $new_options = array();
+ foreach($options as $opt) {
+ $new_options[$opt] = $opt;
+ }
+ return $new_options;
+ break;
+ case PULLDOWN_2D:
+ $new_options = array();
+ foreach($options as $opt) {
+ $new_options[$opt[0]] = $opt[1];
+ }
+ return $new_options;
+ break;
+ default:
+ die('unknown value: "' . print_r($keys_from) . '" passed in $keys_from parameter');
+ }
+}
+
+
+# call this function before you run() the template so enc_options() knows what
+# to do
+#
+# Parameters:
+#
+# name: the name of the html control
+#
+# options: an array of options to display in the pulldown/selectbox
+#
+# keys_from: Set to one of:
+# PULLDOWN_ARRAY: (default) values of $options are displayd and posted
+# PULLDOWN_HASH: values of $options are display, keys are posted
+# PULLDOWN_2D: $options is a 2 dimensional array.
+# $options[0][1] is displayed, $options[0][0] is posted.
+# $options[1][1] is displayed, $options[1][0] is posted.
+#
+# multiple: UNTESTED set to true for multiple-select boxes.
+
+function pulldown($name, $options, $keys_from = PULLDOWN_ARRAY, $multiple = false) {
+ $options = pulldown_options_to_hash($options, $keys_from);
+ $GLOBALS[$name . '_options'] = array();
+ $GLOBALS[$name . '_options']['options'] = $options;
+ $GLOBALS[$name . '_options']['multiple'] = $multiple;
+}
+
+# output a bunch of <option> tags
+function enc_options($values, $name) {
+ if(!isset($GLOBALS[$name . '_options'])) {
+ die('pulldown() must be called before this template can be run. See code/wfpl/encode.php');
+ }
+ if($GLOBALS[$name . '_options']['multiple']) { # FIXME test this
+ $values = explode(', ', $values);
+ }
+ return encode_options($values, $GLOBALS[$name . '_options']['options'], PULLDOWN_HASH);
+}
+
+# use this function along with a special template to generate the html for pulldowns and multiple select boxes.
+#
+# Parameters:
+#
+# selected: can be a string or (for multiple-selects) an array
+#
+# options, keys_from: see documentation for pulldown() above
+function encode_options($selected, $options, $keys_from) {
+ if(!is_array($selected)) {
+ $selected = array($selected);
+ }
+
+ $options = pulldown_options_to_hash($options, $keys_from);
+
+ $out = '';
+ foreach($options as $value => $display) {
+ $out .= '<option';
+
+ if(in_array($value, $selected, $strict = true)) {
+ $out .= ' selected="selected"';
+ }
+
+ if($value !== $display) {
+ $out .= ' value="';
+ $out .= enc_attr($value);
+ $out .= '"';