Source for file options.php

Documentation is available at options.php

  1. <?php
  2.  
  3. /**
  4.  * options.php
  5.  *
  6.  * Functions needed to display the options pages.
  7.  *
  8.  * @copyright 1999-2017 The SquirrelMail Project Team
  9.  * @license http://opensource.org/licenses/gpl-license.php GNU Public License
  10.  * @version $Id: options.php 14715 2017-08-17 02:34:54Z pdontthink $
  11.  * @package squirrelmail
  12.  * @subpackage prefs
  13.  */
  14.  
  15. /**
  16.  * SquirrelOption: An option for SquirrelMail.
  17.  *
  18.  * @package squirrelmail
  19.  * @subpackage prefs
  20.  */
  21. class SquirrelOption {
  22.     /**
  23.      * The original option configuration array
  24.      * @var array 
  25.      */
  26.     var $raw_option_array;
  27.     /**
  28.      * The name of this setting
  29.      * @var string 
  30.      */
  31.     var $name;
  32.     /**
  33.      * The text that prefaces setting on the preferences page
  34.      * @var string 
  35.      */
  36.     var $caption;
  37.     /**
  38.      * Whether or not the caption text is allowed to wrap
  39.      * @var boolean 
  40.      */
  41.     var $caption_wrap;
  42.     /**
  43.      * The type of INPUT element
  44.      *
  45.      * See SMOPT_TYPE_* defines
  46.      * @var integer 
  47.      */
  48.     var $type;
  49.     /**
  50.      * Indicates if a link should be shown to refresh part
  51.      * or all of the window
  52.      *
  53.      * See SMOPT_REFRESH_* defines
  54.      * @var integer 
  55.      */
  56.     var $refresh_level;
  57.     /**
  58.      * Specifies the size of certain input items
  59.      *
  60.      * See SMOPT_SIZE_* defines
  61.      * @var integer 
  62.      */
  63.     var $size;
  64.     /**
  65.      * Text that follows a text input or
  66.      * select list input on the preferences page
  67.      *
  68.      * useful for indicating units, meanings of special values, etc.
  69.      * @var string 
  70.      */
  71.     var $trailing_text;
  72.     /**
  73.      * Indicates that the widget's "trailing text"
  74.      * should be displayed in a smaller sized font
  75.      *
  76.      * @var boolean 
  77.      */
  78.     var $trailing_text_small;
  79.     /**
  80.      * Indicates that the widget's "trailing text"
  81.      * contains HTML and should not thus be
  82.      * sanitized (encoded)
  83.      *
  84.      * @var boolean 
  85.      */
  86.     /**
  87.      * Text that overrides the "Yes" label for boolean
  88.      * radio option widgets
  89.      *
  90.      * @var string 
  91.      */
  92.     var $yes_text;
  93.     /**
  94.      * Text that overrides the "No" label for boolean
  95.      * radio option widgets
  96.      *
  97.      * @var string 
  98.      */
  99.     var $no_text;
  100.     /**
  101.      * Some widgets support more than one layout type
  102.      *
  103.      * @var int 
  104.      */
  105.     var $layout_type;
  106.     /**
  107.      * Indicates if the Add widget should be included
  108.      * with edit lists.
  109.      *
  110.      * @var boolean 
  111.      */
  112.     var $use_add_widget;
  113.     /**
  114.      * Indicates if the Delete widget should be included
  115.      * with edit lists.
  116.      *
  117.      * @var boolean 
  118.      */
  119.     var $use_delete_widget;
  120.     /**
  121.      * associative array, treated the same as $possible_values
  122.      * (see its documentation below), but usually expected to
  123.      * have its first value contain a list of IMAP folders, an
  124.      * array itself in the format as passed back by
  125.      * sqimap_mailbox_list(). Used to display folder selector
  126.      * for possible values of an associative edit list option
  127.      * widget
  128.      *
  129.      * @since 1.5.2
  130.      * @var array 
  131.      */
  132.     var $poss_value_folders;
  133.     /**
  134.      * text displayed to the user
  135.      *
  136.      * Used with SMOPT_TYPE_COMMENT options
  137.      * @var string 
  138.      */
  139.     var $comment;
  140.     /**
  141.      * additional javascript or other widget attributes added to the
  142.      * user input; must be an array where keys are attribute names
  143.      * ("onclick", etc) and values are the attribute values.
  144.      * @var array 
  145.      */
  146.     var $aExtraAttribs;
  147.     /**
  148.      * script (usually Javascript) that will be placed after (outside of)
  149.      * the INPUT tag
  150.      * @var string 
  151.      */
  152.     var $post_script;
  153.  
  154.     /**
  155.      * The name of the Save Function for this option.
  156.      * @var string 
  157.      */
  158.     var $save_function;
  159.  
  160.     /* The various 'values' for this options. */
  161.     /**
  162.      * default/preselected value for this option
  163.      * @var mixed 
  164.      */
  165.     var $value;
  166.     /**
  167.      * new option value
  168.      * @var mixed 
  169.      */
  170.     var $new_value;
  171.     /**
  172.      * associative array, where each key is an actual input value
  173.      * and the corresponding value is what is displayed to the user
  174.      * for that list item in the drop-down list
  175.      * @var array 
  176.      */
  177.     var $possible_values;
  178.     /**
  179.      * disables html sanitizing.
  180.      *
  181.      * WARNING - don't use it, if user input is possible in option
  182.      * or use own sanitizing functions. Currently only works for SMOPT_TYPE_STRLIST.
  183.      * @var bool 
  184.      */
  185.     var $htmlencoded=false;
  186.     /**
  187.      * Controls folder list limits in SMOPT_TYPE_FLDRLIST and
  188.      * SMOPT_TYPE_FLDRLIST_MULTI widgets as well as the optional
  189.      * embedded folder lists provided for inputting values for
  190.      * the SMOPT_TYPE_EDIT_LIST and SMOPT_TYPE_EDIT_LIST_ASSOCIATIVE
  191.      * :idgets.
  192.      * See $flag argument in sqimap_mailbox_option_list() function.
  193.      * @var string 
  194.      * @since 1.5.1
  195.      */
  196.     var $folder_filter='noselect';
  197.  
  198.     /**
  199.      * Constructor (PHP5 style, required in some future version of PHP)
  200.      * @param array $raw_option_array 
  201.      * @param string $name 
  202.      * @param string $caption 
  203.      * @param integer $type 
  204.      * @param integer $refresh_level 
  205.      * @param mixed $initial_value 
  206.      * @param array $possible_values 
  207.      * @param bool $htmlencoded 
  208.      */
  209.     function __construct
  210.     ($raw_option_array$name$caption$type$refresh_level$initial_value ''$possible_values ''$htmlencoded false{
  211.         /* Set the basic stuff. */
  212.         $this->raw_option_array = $raw_option_array;
  213.         $this->name = $name;
  214.         $this->caption = $caption;
  215.         $this->caption_wrap = TRUE;
  216.         $this->type = $type;
  217.         $this->refresh_level = $refresh_level;
  218.         $this->possible_values = $possible_values;
  219.         $this->htmlencoded = $htmlencoded;
  220.         $this->size = SMOPT_SIZE_NORMAL;
  221.         $this->trailing_text = '';
  222.         $this->trailing_text_small = FALSE;
  223.         $this->trailing_text_is_html = FALSE;
  224.         $this->yes_text = '';
  225.         $this->no_text = '';
  226.         $this->comment = '';
  227.         $this->layout_type = 0;
  228.         $this->use_add_widget = TRUE;
  229.         $this->use_delete_widget = TRUE;
  230.         $this->poss_value_folders = '';
  231.         $this->aExtraAttribs = array();
  232.         $this->post_script = '';
  233.  
  234.         //Check for a current value.  
  235.         if (isset($GLOBALS[$name])) {
  236.             $this->value = $GLOBALS[$name];
  237.         else if (!empty($initial_value)) {
  238.             $this->value = $initial_value;
  239.         else {
  240.             $this->value = '';
  241.         }
  242.  
  243.         /* Check for a new value. */
  244.         if !sqgetGlobalVar("new_$name"$this->new_valueSQ_POST ) ) {
  245.             $this->new_value = NULL;
  246.         }
  247.  
  248.         /* Set the default save function. */
  249.         if ($type != SMOPT_TYPE_HIDDEN
  250.          && $type != SMOPT_TYPE_INFO
  251.          && $type != SMOPT_TYPE_COMMENT{
  252.             $this->save_function = SMOPT_SAVE_DEFAULT;
  253.         else {
  254.             $this->save_function = SMOPT_SAVE_NOOP;
  255.         }
  256.     }
  257.  
  258.     /**
  259.      * Constructor (PHP4 style, kept for compatibility reasons)
  260.      * @param array $raw_option_array 
  261.      * @param string $name 
  262.      * @param string $caption 
  263.      * @param integer $type 
  264.      * @param integer $refresh_level 
  265.      * @param mixed $initial_value 
  266.      * @param array $possible_values 
  267.      * @param bool $htmlencoded 
  268.      */
  269.     function SquirrelOption
  270.     ($raw_option_array$name$caption$type$refresh_level$initial_value ''$possible_values ''$htmlencoded false{
  271.         self::__construct($raw_option_array$name$caption$type$refresh_level$initial_value$possible_values$htmlencoded);
  272.     }
  273.  
  274.     /** Convenience function that identifies which types of
  275.         widgets are stored as (serialized) array values. */
  276.     function is_multiple_valued({
  277.         return ($this->type == SMOPT_TYPE_FLDRLIST_MULTI
  278.              || $this->type == SMOPT_TYPE_STRLIST_MULTI
  279.              || $this->type == SMOPT_TYPE_EDIT_LIST
  280.              || $this->type == SMOPT_TYPE_EDIT_LIST_ASSOCIATIVE);
  281.     }
  282.  
  283.     /**
  284.      * Set the value for this option.
  285.      * @param mixed $value 
  286.      */
  287.     function setValue($value{
  288.         $this->value = $value;
  289.     }
  290.  
  291.     /**
  292.      * Set the new value for this option.
  293.      * @param mixed $new_value 
  294.      */
  295.     function setNewValue($new_value{
  296.         $this->new_value = $new_value;
  297.     }
  298.  
  299.     /**
  300.      * Set whether the caption is allowed to wrap for this option.
  301.      * @param boolean $caption_wrap 
  302.      */
  303.     function setCaptionWrap($caption_wrap{
  304.         $this->caption_wrap = $caption_wrap;
  305.     }
  306.  
  307.     /**
  308.      * Set the size for this option.
  309.      * @param integer $size 
  310.      */
  311.     function setSize($size{
  312.         $this->size = $size;
  313.     }
  314.  
  315.     /**
  316.      * Set the trailing_text for this option.
  317.      * @param string $trailing_text 
  318.      */
  319.     function setTrailingText($trailing_text{
  320.         $this->trailing_text = $trailing_text;
  321.     }
  322.  
  323.     /**
  324.      * Set the trailing_text_small for this option.
  325.      * @param boolean $trailing_text_small 
  326.      */
  327.     function setTrailingTextSmall($trailing_text_small{
  328.         $this->trailing_text_small = $trailing_text_small;
  329.     }
  330.  
  331.     /**
  332.      * Set the trailing_text_is_html for this option.
  333.      * @param boolean $trailing_text_is_html 
  334.      */
  335.     function setTrailingTextIsHtml($trailing_text_is_html{
  336.         $this->trailing_text_is_html = $trailing_text_is_html;
  337.     }
  338.  
  339.     /**
  340.      * Set the yes_text for this option.
  341.      * @param string $yes_text 
  342.      */
  343.     function setYesText($yes_text{
  344.         $this->yes_text = $yes_text;
  345.     }
  346.  
  347.     /**
  348.      * Set the no_text for this option.
  349.      * @param string $no_text 
  350.      */
  351.     function setNoText($no_text{
  352.         $this->no_text = $no_text;
  353.     }
  354.  
  355.     /* Set the "use add widget" value for this option. */
  356.     function setUseAddWidget($use_add_widget{
  357.         $this->use_add_widget = $use_add_widget;
  358.     }
  359.  
  360.     /* Set the "use delete widget" value for this option. */
  361.     function setUseDeleteWidget($use_delete_widget{
  362.         $this->use_delete_widget = $use_delete_widget;
  363.     }
  364.  
  365.     /* Set the "poss value folders" value for this option.
  366.        See the associative edit list widget, which uses this
  367.        to offer folder list selection for the values */
  368.     function setPossValueFolders($poss_value_folders{
  369.         $this->poss_value_folders = $poss_value_folders;
  370.     }
  371.  
  372.     /**
  373.      * Set the layout type for this option.
  374.      * @param int $layout_type 
  375.      */
  376.     function setLayoutType($layout_type{
  377.         $this->layout_type = $layout_type;
  378.     }
  379.  
  380.     /**
  381.      * Set the comment for this option.
  382.      * @param string $comment 
  383.      */
  384.     function setComment($comment{
  385.         $this->comment = $comment;
  386.     }
  387.  
  388.     /**
  389.      * Set the extra attributes for this option.
  390.      * @param array $aExtraAttribs 
  391.      */
  392.     function setExtraAttributes($aExtraAttribs{
  393.         $this->aExtraAttribs = $aExtraAttribs;
  394.     }
  395.  
  396.     /**
  397.      * Set the "post script" for this option.
  398.      * @param string $post_script 
  399.      */
  400.     function setPostScript($post_script{
  401.         $this->post_script = $post_script;
  402.     }
  403.  
  404.     /**
  405.      * Set the save function for this option.
  406.      * @param string $save_function 
  407.      */
  408.     function setSaveFunction($save_function{
  409.         $this->save_function = $save_function;
  410.     }
  411.  
  412.     /**
  413.      * Set the folder_filter for this option.
  414.      * @param string $folder_filter 
  415.      * @since 1.5.1
  416.      */
  417.     function setFolderFilter($folder_filter{
  418.         $this->folder_filter = $folder_filter;
  419.     }
  420.  
  421.     /**
  422.      * Creates fields on option pages according to option type
  423.      *
  424.      * This is the function that calls all other createWidget* functions.
  425.      *
  426.      * @return string The formated option field
  427.      *
  428.      */
  429.     function createWidget({
  430.         global $color;
  431.  
  432.         // Use new value if available
  433.         if (!is_null($this->new_value)) {
  434.             $tempValue $this->value;
  435.             $this->value = $this->new_value;
  436.         }
  437.  
  438.         /* Get the widget for this option type. */
  439.         switch ($this->type{
  440.             case SMOPT_TYPE_PASSWORD:
  441.                 $result $this->createWidget_String(TRUE);
  442.                 break;
  443.             case SMOPT_TYPE_STRING:
  444.                 $result $this->createWidget_String();
  445.                 break;
  446.             case SMOPT_TYPE_STRLIST:
  447.                 $result $this->createWidget_StrList();
  448.                 break;
  449.             case SMOPT_TYPE_TEXTAREA:
  450.                 $result $this->createWidget_TextArea();
  451.                 break;
  452.             case SMOPT_TYPE_INTEGER:
  453.                 $result $this->createWidget_Integer();
  454.                 break;
  455.             case SMOPT_TYPE_FLOAT:
  456.                 $result $this->createWidget_Float();
  457.                 break;
  458.             case SMOPT_TYPE_BOOLEAN:
  459.                 $result $this->createWidget_Boolean();
  460.                 break;
  461.             case SMOPT_TYPE_BOOLEAN_CHECKBOX:
  462.                 $result $this->createWidget_Boolean(TRUE);
  463.                 break;
  464.             case SMOPT_TYPE_BOOLEAN_RADIO:
  465.                 $result $this->createWidget_Boolean(FALSE);
  466.                 break;
  467.             case SMOPT_TYPE_HIDDEN:
  468.                 $result $this->createWidget_Hidden();
  469.                 break;
  470.             case SMOPT_TYPE_COMMENT:
  471.                 $result $this->createWidget_Comment();
  472.                 break;
  473.             case SMOPT_TYPE_FLDRLIST:
  474.                 $result $this->createWidget_FolderList();
  475.                 break;
  476.             case SMOPT_TYPE_FLDRLIST_MULTI:
  477.                 $result $this->createWidget_FolderList(TRUE);
  478.                 break;
  479.             case SMOPT_TYPE_EDIT_LIST:
  480.                 $result $this->createWidget_EditList();
  481.                 break;
  482.             case SMOPT_TYPE_EDIT_LIST_ASSOCIATIVE:
  483.                 $result $this->createWidget_EditListAssociative();
  484.                 break;
  485.             case SMOPT_TYPE_STRLIST_MULTI:
  486.                 $result $this->createWidget_StrList(TRUE);
  487.                 break;
  488.             case SMOPT_TYPE_STRLIST_RADIO:
  489.                 $result $this->createWidget_StrList(FALSETRUE);
  490.                 break;
  491.             case SMOPT_TYPE_SUBMIT:
  492.                 $result $this->createWidget_Submit();
  493.                 break;
  494.             case SMOPT_TYPE_INFO:
  495.                 $result $this->createWidget_Info();
  496.                 break;
  497.             default:
  498.                 error_box 
  499.                     sprintf(_("Option Type '%s' Not Found")$this->type)
  500.                     );
  501.         }
  502.  
  503.         /* Add the "post script" for this option. */
  504.         $result .= $this->post_script;
  505.  
  506.         // put correct value back if need be
  507.         if (!is_null($this->new_value)) {
  508.             $this->value = $tempValue;
  509.         }
  510.  
  511.         /* Now, return the created widget. */
  512.         return $result;
  513.     }
  514.  
  515.     /**
  516.      * Creates info block
  517.      * @return string html formated output
  518.      */
  519.     function createWidget_Info({
  520.         // return sq_htmlspecialchars($this->value);
  521.         // like COMMENT, allow HTML here
  522.         return $this->value;
  523.     }
  524.  
  525.     /**
  526.      * Create string field
  527.      *
  528.      * @param boolean $password When TRUE, the text in the input
  529.      *                           widget will be obscured (OPTIONAL;
  530.      *                           default = FALSE).
  531.      *
  532.      * @return string html formated option field
  533.      *
  534.      */
  535.     function createWidget_String($password=FALSE{
  536.         switch ($this->size{
  537.             case SMOPT_SIZE_TINY:
  538.                 $width 5;
  539.                 break;
  540.             case SMOPT_SIZE_SMALL:
  541.                 $width 12;
  542.                 break;
  543.             case SMOPT_SIZE_LARGE:
  544.                 $width 38;
  545.                 break;
  546.             case SMOPT_SIZE_HUGE:
  547.                 $width 50;
  548.                 break;
  549.             case SMOPT_SIZE_NORMAL:
  550.             default:
  551.                 $width 25;
  552.         }
  553.  
  554. //TODO: might be better to have a separate template file for all widgets, because then the layout of the widget and the "trailing text" can be customized - they are still hard coded here (also, we have <small> tags here; don't want HTML here!)
  555.         if ($password)
  556.             return addPwField('new_' $this->name$this->value$width0$this->aExtraAttribs' ' ($this->trailing_text_small ? '<small>' ''($this->trailing_text_is_html ? $this->trailing_text : sm_encode_html_special_chars($this->trailing_text)) ($this->trailing_text_small ? '</small>' '');
  557.         else
  558.             return addInput('new_' $this->name$this->value$width0$this->aExtraAttribs' ' ($this->trailing_text_small ? '<small>' ''($this->trailing_text_is_html ? $this->trailing_text : sm_encode_html_special_chars($this->trailing_text)) ($this->trailing_text_small ? '</small>' '');
  559.     }
  560.  
  561.     /**
  562.      * Create selection box or radio button group
  563.      *
  564.      * When $this->htmlencoded is TRUE, the keys and values in
  565.      * $this->possible_values are assumed to be display-safe.
  566.      * Use with care!
  567.      *
  568.      * Note that when building radio buttons instead of a select
  569.      * widget, if the "size" attribute is SMOPT_SIZE_TINY, the
  570.      * radio buttons will be output one after another without
  571.      * linebreaks between them.  Otherwise, each radio button
  572.      * goes on a line of its own.
  573.      *
  574.      * @param boolean $multiple_select When TRUE, the select widget
  575.      *                                  will allow multiple selections
  576.      *                                  (OPTIONAL; default is FALSE
  577.      *                                  (single select list))
  578.      * @param boolean $radio_buttons   When TRUE, the widget will
  579.      *                                  instead be built as a group
  580.      *                                  of radio buttons (and
  581.      *                                  $multiple_select will be
  582.      *                                  forced to FALSE) (OPTIONAL;
  583.      *                                  default is FALSE (select widget))
  584.      *
  585.      * @return string html formated selection box or radio buttons
  586.      *
  587.      */
  588.     function createWidget_StrList($multiple_select=FALSE$radio_buttons=FALSE{
  589. //FIXME: Currently, $this->htmlencoded is ignored here -- was removed when changing to template-based output; a fix is available as part of proposed centralized sanitizing patch
  590.  
  591.         // radio buttons instead of select widget?
  592.         //
  593.         if ($radio_buttons{
  594.  
  595.             global $br$nbsp;
  596.             $result '';
  597.             foreach ($this->possible_values as $real_value => $disp_value{
  598.                 $result .= addRadioBox('new_' $this->name($this->value == $real_value)$real_valuearray_merge(array('id' => 'new_' $this->name . '_' $real_value)$this->aExtraAttribs)) $nbsp create_label($disp_value'new_' $this->name . '_' $real_value);
  599.                 if ($this->size != SMOPT_SIZE_TINY)
  600.                     $result .= $br;
  601.             }
  602.  
  603.             return $result;
  604.         }
  605.  
  606.  
  607.         // everything below applies to select widgets
  608.         //
  609.         switch ($this->size{
  610. //FIXME: not sure about these sizes... seems like we could add another on the "large" side...
  611.             case SMOPT_SIZE_TINY:
  612.                 $height 3;
  613.                 break;
  614.             case SMOPT_SIZE_SMALL:
  615.                 $height 8;
  616.                 break;
  617.             case SMOPT_SIZE_LARGE:
  618.                 $height 15;
  619.                 break;
  620.             case SMOPT_SIZE_HUGE:
  621.                 $height 25;
  622.                 break;
  623.             case SMOPT_SIZE_NORMAL:
  624.             default:
  625.                 $height 5;
  626.         }
  627.  
  628.         return addSelect('new_' $this->name$this->possible_values$this->valueTRUE$this->aExtraAttribs$multiple_select$height!$this->htmlencoded($this->trailing_text_small ? '<small>' ''($this->trailing_text_is_html ? $this->trailing_text : sm_encode_html_special_chars($this->trailing_text)) ($this->trailing_text_small ? '</small>' '');
  629.  
  630.     }
  631.  
  632.     /**
  633.      * Create folder selection box
  634.      *
  635.      * @param boolean $multiple_select When TRUE, the select widget
  636.      *                                  will allow multiple selections
  637.      *                                  (OPTIONAL; default is FALSE
  638.      *                                  (single select list))
  639.      *
  640.      * @return string html formated selection box
  641.      *
  642.      */
  643.     function createWidget_FolderList($multiple_select=FALSE{
  644.  
  645.         switch ($this->size{
  646. //FIXME: not sure about these sizes... seems like we could add another on the "large" side...
  647.             case SMOPT_SIZE_TINY:
  648.                 $height 3;
  649.                 break;
  650.             case SMOPT_SIZE_SMALL:
  651.                 $height 8;
  652.                 break;
  653.             case SMOPT_SIZE_LARGE:
  654.                 $height 15;
  655.                 break;
  656.             case SMOPT_SIZE_HUGE:
  657.                 $height 25;
  658.                 break;
  659.             case SMOPT_SIZE_NORMAL:
  660.             default:
  661.                 $height 5;
  662.         }
  663.  
  664.         // possible values might include a nested array of 
  665.         // possible values (list of folders)
  666.         //
  667.         $option_list array();
  668.         foreach ($this->possible_values as $value => $text{
  669.  
  670.             // list of folders (boxes array)
  671.             //
  672.             if (is_array($text)) {
  673.               $option_list array_merge($option_listsqimap_mailbox_option_array(00$text$this->folder_filter));
  674.  
  675.             // just one option here
  676.             //
  677.             else {
  678.               $option_list array_merge($option_listarray($value => $text));
  679.             }
  680.  
  681.         }
  682.         if (empty($option_list))
  683.             $option_list array('ignore' => _("unavailable"));
  684.  
  685.  
  686.         return addSelect('new_' $this->name$option_list$this->valueTRUE$this->aExtraAttribs$multiple_select$height($this->trailing_text_small ? '<small>' ''($this->trailing_text_is_html ? $this->trailing_text : sm_encode_html_special_chars($this->trailing_text)) ($this->trailing_text_small ? '</small>' '');
  687.  
  688.     }
  689.  
  690.     /**
  691.      * Creates textarea
  692.      * @return string html formated textarea field
  693.      */
  694.     function createWidget_TextArea({
  695.         switch ($this->size{
  696.             case SMOPT_SIZE_TINY:  $rows 3$cols =  10break;
  697.             case SMOPT_SIZE_SMALL$rows 4$cols =  30break;
  698.             case SMOPT_SIZE_LARGE$rows 10$cols =  60break;
  699.             case SMOPT_SIZE_HUGE:  $rows 20$cols =  80break;
  700.             case SMOPT_SIZE_NORMAL:
  701.             default$rows 5$cols =  50;
  702.         }
  703.         return addTextArea('new_' $this->name$this->value$cols$rows$this->aExtraAttribs);
  704.     }
  705.  
  706.     /**
  707.      * Creates field for integer
  708.      *
  709.      * Difference from createWidget_String is visible only when javascript is enabled
  710.      * @return string html formated option field
  711.      */
  712.     function createWidget_Integer({
  713.  
  714.         // add onChange javascript handler to a regular string widget
  715.         // which will strip out all non-numeric chars
  716.         if (checkForJavascript())
  717.            $this->aExtraAttribs['onchange''origVal=this.value; newVal=\'\'; '
  718.                     . 'for (i=0;i<origVal.length;i++) { if (origVal.charAt(i)>=\'0\' '
  719.                     . '&& origVal.charAt(i)<=\'9\') newVal += origVal.charAt(i); } '
  720.                     . 'this.value=newVal;';
  721.  
  722.         return $this->createWidget_String();
  723.     }
  724.  
  725.     /**
  726.      * Creates field for floating number
  727.      * Difference from createWidget_String is visible only when javascript is enabled
  728.      * @return string html formated option field
  729.      */
  730.     function createWidget_Float({
  731.  
  732.         // add onChange javascript handler to a regular string widget
  733.         // which will strip out all non-numeric (period also OK) chars
  734.         if (checkForJavascript())
  735.            $this->aExtraAttribs['onchange''origVal=this.value; newVal=\'\'; '
  736.                     . 'for (i=0;i<origVal.length;i++) { if ((origVal.charAt(i)>=\'0\' '
  737.                     . '&& origVal.charAt(i)<=\'9\') || origVal.charAt(i)==\'.\') '
  738.                     . 'newVal += origVal.charAt(i); } this.value=newVal;';
  739.  
  740.         return $this->createWidget_String();
  741.     }
  742.  
  743.     /**
  744.      * Create boolean widget
  745.      *
  746.      * When creating Yes/No radio buttons, the "yes_text"
  747.      * and "no_text" option attributes are used to override
  748.      * the typical "Yes" and "No" text.
  749.      *
  750.      * @param boolean $checkbox When TRUE, the widget will be
  751.      *                           constructed as a checkbox,
  752.      *                           otherwise it will be a set of
  753.      *                           Yes/No radio buttons (OPTIONAL;
  754.      *                           default is TRUE (checkbox)).
  755.      *
  756.      * @return string html formated boolean widget
  757.      *
  758.      */
  759.     function createWidget_Boolean($checkbox=TRUE{
  760.  
  761.         global $oTemplate$nbsp;
  762.  
  763.  
  764.         // checkbox...
  765.         //
  766.         if ($checkbox{
  767. //TODO: Why isn't trailing_text being sanitized with sm_encode_special_chars()???  If this is a bug, add that, then add the option to display unsanitized if $this->trailing_text_is_html is enabled
  768.             $result addCheckbox('new_' $this->name($this->value != SMPREF_NO)SMPREF_YESarray_merge(array('id' => 'new_' $this->name)$this->aExtraAttribs)) $nbsp create_label(($this->trailing_text_small ? '<small>' ''$this->trailing_text . ($this->trailing_text_small ? '</small>' '')'new_' $this->name);
  769.         }
  770.  
  771.         // radio buttons...
  772.         //
  773.         else {
  774.  
  775.             /* Build the yes choice. */
  776.             $yes_option addRadioBox('new_' $this->name($this->value != SMPREF_NO)SMPREF_YESarray_merge(array('id' => 'new_' $this->name . '_yes')$this->aExtraAttribs)) $nbsp create_label((!empty($this->yes_text$this->yes_text : _("Yes"))'new_' $this->name . '_yes');
  777.  
  778.             /* Build the no choice. */
  779.             $no_option addRadioBox('new_' $this->name($this->value == SMPREF_NO)SMPREF_NOarray_merge(array('id' => 'new_' $this->name . '_no')$this->aExtraAttribs)) $nbsp create_label((!empty($this->no_text$this->no_text : _("No"))'new_' $this->name . '_no');
  780.  
  781.             /* Build the combined "boolean widget". */
  782.             $result "$yes_option$nbsp$nbsp$nbsp$nbsp$no_option ($this->trailing_text_small ? '<small>' ''($this->trailing_text_is_html ? $this->trailing_text : sm_encode_html_special_chars($this->trailing_text)) ($this->trailing_text_small ? '</small>' '');
  783.  
  784.         }
  785.  
  786.         return ($result);
  787.     }
  788.  
  789.     /**
  790.      * Creates hidden field
  791.      * @return string html formated hidden input field
  792.      */
  793.     function createWidget_Hidden({
  794.         return addHidden('new_' $this->name$this->value$this->aExtraAttribs);
  795.     }
  796.  
  797.     /**
  798.      * Creates comment
  799.      * @return string comment
  800.      */
  801.     function createWidget_Comment({
  802.         $result $this->comment;
  803.         return ($result);
  804.     }
  805.  
  806.     /**
  807.      * Creates a (non-associative) edit list
  808.      *
  809.      * Note that multiple layout types are supported for this widget.
  810.      * $this->layout_type must be one of the SMOPT_EDIT_LIST_LAYOUT_*
  811.      * constants.
  812.      *
  813.      * @return string html formated list of edit fields and
  814.      *                 their associated controls
  815.      */
  816.     function createWidget_EditList({
  817.  
  818.         global $oTemplate;
  819.  
  820.         switch ($this->size{
  821.             case SMOPT_SIZE_TINY:
  822.                 $height 3;
  823.                 break;
  824.             case SMOPT_SIZE_SMALL:
  825.                 $height 8;
  826.                 break;
  827.             case SMOPT_SIZE_MEDIUM:
  828.                 $height 15;
  829.                 break;
  830.             case SMOPT_SIZE_LARGE:
  831.                 $height 25;
  832.                 break;
  833.             case SMOPT_SIZE_HUGE:
  834.                 $height 40;
  835.                 break;
  836.             case SMOPT_SIZE_NORMAL:
  837.             default:
  838.                 $height 5;
  839.         }
  840.  
  841.         if (empty($this->possible_values)) $this->possible_values = array();
  842.         if (!is_array($this->possible_values)) $this->possible_values = array($this->possible_values);
  843.  
  844. //FIXME: $this->aExtraAttribs probably should only be used in one place
  845.         $oTemplate->assign('input_widget'addInput('add_' $this->name''380$this->aExtraAttribs));
  846.         $oTemplate->assign('use_input_widget'$this->use_add_widget);
  847.         $oTemplate->assign('use_delete_widget'$this->use_delete_widget);
  848.  
  849.         $oTemplate->assign('trailing_text'$this->trailing_text);
  850.         $oTemplate->assign('trailing_text_small'$this->trailing_text_small);
  851.         $oTemplate->assign('trailing_text_is_html'$this->trailing_text_is_html);
  852.         $oTemplate->assign('possible_values'$this->possible_values);
  853.         $oTemplate->assign('current_value'$this->value);
  854.         $oTemplate->assign('select_widget'addSelect('new_' $this->name$this->possible_values$this->valueFALSE!checkForJavascript($this->aExtraAttribs : array_merge(array('onchange' => 'if (typeof(window.addinput_' $this->name . ') == \'undefined\') { var f = document.forms.length; var i = 0; var pos = -1; while( pos == -1 && i < f ) { var e = document.forms[i].elements.length; var j = 0; while( pos == -1 && j < e ) { if ( document.forms[i].elements[j].type == \'text\' && document.forms[i].elements[j].name == \'add_' $this->name . '\' ) { pos = j; i=f-1; j=e-1; } j++; } i++; } if( pos >= 0 ) { window.addinput_' $this->name . ' = document.forms[i-1].elements[pos]; } } for (x = 0; x < this.length; x++) { if (this.options[x].selected) { window.addinput_' $this->name . '.value = this.options[x].text; break; } }')$this->aExtraAttribs)TRUE$height));
  855. // NOTE: i=f-1; j=e-1 is in lieu of break 2
  856.         $oTemplate->assign('checkbox_widget'addCheckBox('delete_' $this->nameFALSESMPREF_YESarray_merge(array('id' => 'delete_' $this->name)$this->aExtraAttribs)));
  857.         $oTemplate->assign('name'$this->name);
  858.  
  859.         switch ($this->layout_type{
  860.             case SMOPT_EDIT_LIST_LAYOUT_SELECT:
  861.                 return $oTemplate->fetch('edit_list_widget.tpl');
  862.             case SMOPT_EDIT_LIST_LAYOUT_LIST:
  863.                 return $oTemplate->fetch('edit_list_widget_list_style.tpl');
  864.             default:
  865.                 error_box(sprintf(_("Edit List Layout Type '%s' Not Found")$this->layout_type));
  866.         }
  867.  
  868.     }
  869.  
  870.     /**
  871.      * Creates an associative edit list
  872.      *
  873.      * Note that multiple layout types are supported for this widget.
  874.      * $this->layout_type must be one of the SMOPT_EDIT_LIST_LAYOUT_*
  875.      * constants.
  876.      *
  877.      * @return string html formated list of edit fields and
  878.      *                 their associated controls
  879.      */
  880.     function createWidget_EditListAssociative({
  881.  
  882.         global $oTemplate;
  883.  
  884.         switch ($this->size{
  885.             case SMOPT_SIZE_TINY:
  886.                 $height 3;
  887.                 break;
  888.             case SMOPT_SIZE_SMALL:
  889.                 $height 8;
  890.                 break;
  891.             case SMOPT_SIZE_MEDIUM:
  892.                 $height 15;
  893.                 break;
  894.             case SMOPT_SIZE_LARGE:
  895.                 $height 25;
  896.                 break;
  897.             case SMOPT_SIZE_HUGE:
  898.                 $height 40;
  899.                 break;
  900.             case SMOPT_SIZE_NORMAL:
  901.             default:
  902.                 $height 5;
  903.         }
  904.  
  905.  
  906.         // ensure correct format of current value(s)
  907.         //
  908.         if (empty($this->possible_values)) $this->possible_values = array();
  909.         if (!is_array($this->possible_values)) $this->possible_values = array($this->possible_values);
  910.  
  911.  
  912.         $oTemplate->assign('name'$this->name);
  913.         $oTemplate->assign('current_value'$this->value);
  914.         $oTemplate->assign('possible_values'$this->possible_values);
  915.         $oTemplate->assign('poss_value_folders'$this->poss_value_folders);
  916.         $oTemplate->assign('folder_filter'$this->folder_filter);
  917.  
  918.         $oTemplate->assign('use_input_widget'$this->use_add_widget);
  919.         $oTemplate->assign('use_delete_widget'$this->use_delete_widget);
  920.  
  921.         $oTemplate->assign('checkbox_widget'addCheckBox('delete_' $this->nameFALSESMPREF_YESarray_merge(array('id' => 'delete_' $this->name)$this->aExtraAttribs)));
  922.  
  923. //FIXME: $this->aExtraAttribs probably should only be used in one place
  924.         $oTemplate->assign('input_key_widget'addInput('add_' $this->name . '_key'''220$this->aExtraAttribs));
  925.         $oTemplate->assign('input_value_widget'addInput('add_' $this->name . '_value'''120$this->aExtraAttribs));
  926.  
  927.         $oTemplate->assign('select_height'$height);
  928.  
  929.         $oTemplate->assign('aAttribs'$this->aExtraAttribs);
  930.  
  931.         $oTemplate->assign('trailing_text'$this->trailing_text);
  932.         $oTemplate->assign('trailing_text_small'$this->trailing_text_small);
  933.         $oTemplate->assign('trailing_text_is_html'$this->trailing_text_is_html);
  934.  
  935.         switch ($this->layout_type{
  936.             case SMOPT_EDIT_LIST_LAYOUT_SELECT:
  937.                 return $oTemplate->fetch('edit_list_associative_widget.tpl');
  938.             case SMOPT_EDIT_LIST_LAYOUT_LIST:
  939.                 return $oTemplate->fetch('edit_list_associative_widget_list_style.tpl');
  940.             default:
  941.                 error_box(sprintf(_("Associative Edit List Layout Type '%s' Not Found")$this->layout_type));
  942.         }
  943.  
  944.     }
  945.  
  946.     /**
  947.      * Creates a submit button
  948.      *
  949.      * @return string html formated submit button widget
  950.      *
  951.      */
  952.     function createWidget_Submit({
  953.  
  954.         return addSubmit($this->comment$this->name$this->aExtraAttribs($this->trailing_text_small ? '<small>' ''($this->trailing_text_is_html ? $this->trailing_text : sm_encode_html_special_chars($this->trailing_text)) ($this->trailing_text_small ? '</small>' '');
  955.  
  956.     }
  957.  
  958.     /**
  959.      *
  960.      */
  961.     function save({
  962.         $function $this->save_function;
  963.         $function($this);
  964.     }
  965.  
  966.     /**
  967.      *
  968.      */
  969.     function changed({
  970.  
  971.         // edit lists have a lot going on, so we'll always process them
  972.         //
  973.         if ($this->type == SMOPT_TYPE_EDIT_LIST
  974.          || $this->type == SMOPT_TYPE_EDIT_LIST_ASSOCIATIVE)
  975.             return TRUE;
  976.  
  977.         return ($this->value != $this->new_value);
  978.     }
  979. /* End of SquirrelOption class*/
  980.  
  981. /**
  982.  * Saves the option value (this is the default save function
  983.  * unless overridden by the user)
  984.  *
  985.  * @param object $option object that holds option name and new_value
  986.  */
  987. function save_option($option{
  988.  
  989.     // Can't save the pref if we don't have the username
  990.     //
  991.     if !sqgetGlobalVar('username'$usernameSQ_SESSION ) ) {
  992.         return;
  993.     }
  994.  
  995.     // if the widget is a selection list, make sure the new
  996.     // value is actually in the selection list and is not an
  997.     // injection attack
  998.     //
  999.     if ($option->type == SMOPT_TYPE_STRLIST
  1000.      && !array_key_exists($option->new_value$option->possible_values))
  1001.         return;
  1002.  
  1003.  
  1004.     // all other widgets except TEXTAREAs should never be allowed to have newlines
  1005.     //
  1006.     else if ($option->type != SMOPT_TYPE_TEXTAREA)
  1007.         $option->new_value str_replace(array("\r""\n")''$option->new_value);
  1008.  
  1009.  
  1010.     global $data_dir;
  1011.  
  1012.     // edit lists: first add new elements to list, then
  1013.     // remove any selected ones (note that we must add
  1014.     // before deleting because the javascript that populates
  1015.     // the "add" textbox when selecting items in the list
  1016.     // (for deletion))
  1017.     //
  1018.     if ($option->type == SMOPT_TYPE_EDIT_LIST{
  1019.  
  1020.         if (empty($option->possible_values)) $option->possible_values array();
  1021.         if (!is_array($option->possible_values)) $option->possible_values array($option->possible_values);
  1022.  
  1023.         // add element if given
  1024.         //
  1025.         if ((isset($option->use_add_widget&& $option->use_add_widget)
  1026.          && sqGetGlobalVar('add_' $option->name$new_elementSQ_POST)) {
  1027.             $new_element trim($new_element);
  1028.             if (!empty($new_element)
  1029.              && !in_array($new_element$option->possible_values))
  1030.                 $option->possible_values[$new_element;
  1031.         }
  1032.         
  1033.         // delete selected elements if needed
  1034.         //
  1035.         if ((isset($option->use_delete_widget&& $option->use_delete_widget)
  1036.          && is_array($option->new_value)
  1037.          && sqGetGlobalVar('delete_' $option->name$ignoreSQ_POST))
  1038.             $option->possible_values array_diff($option->possible_values$option->new_value);
  1039.  
  1040.         // save full list (stored in "possible_values")
  1041.         //
  1042.         setPref($data_dir$username$option->nameserialize($option->possible_values));
  1043.  
  1044.     // associative edit lists are handled similar to
  1045.     // non-associative ones
  1046.     //
  1047.     else if ($option->type == SMOPT_TYPE_EDIT_LIST_ASSOCIATIVE{
  1048.  
  1049.         if (empty($option->possible_values)) $option->possible_values array();
  1050.         if (!is_array($option->possible_values)) $option->possible_values array($option->possible_values);
  1051.  
  1052.         // add element if given
  1053.         //
  1054.         $new_element_key '';
  1055.         $new_element_value '';
  1056.         $retrieve_key sqGetGlobalVar('add_' $option->name '_key'$new_element_keySQ_POST);
  1057.         $retrieve_value sqGetGlobalVar('add_' $option->name '_value'$new_element_valueSQ_POST);
  1058.  
  1059.         if ((isset($option->use_add_widget&& $option->use_add_widget)
  1060.          && ($retrieve_key || $retrieve_value)) {
  1061.             $new_element_key trim($new_element_key);
  1062.             $new_element_value trim($new_element_value);
  1063.             if ($option->poss_value_folders && empty($new_element_key))
  1064.                 $new_element_value '';
  1065.             if (!empty($new_element_key|| !empty($new_element_value)) {
  1066.                 if (empty($new_element_key)) $new_element_key '0';
  1067.                 $option->possible_values[$new_element_key$new_element_value;
  1068.             }
  1069.         }
  1070.  
  1071.         // delete selected elements if needed
  1072.         //
  1073.         if ((isset($option->use_delete_widget&& $option->use_delete_widget)
  1074.          && is_array($option->new_value)
  1075.          && sqGetGlobalVar('delete_' $option->name$ignoreSQ_POST)) {
  1076.  
  1077.             if ($option->layout_type == SMOPT_EDIT_LIST_LAYOUT_SELECT{
  1078.                 foreach ($option->new_value as $key)
  1079.                     unset($option->possible_values[urldecode($key)]);
  1080.             }
  1081.             else
  1082.                 $option->possible_values array_diff($option->possible_values$option->new_value);
  1083.         }
  1084.  
  1085.         // save full list (stored in "possible_values")
  1086.         //
  1087.         setPref($data_dir$username$option->nameserialize($option->possible_values));
  1088.  
  1089.     // Certain option types need to be serialized because
  1090.     // they are not scalar
  1091.     //
  1092.     else if ($option->is_multiple_valued())
  1093.         setPref($data_dir$username$option->nameserialize($option->new_value));
  1094.  
  1095.     // Checkboxes, when unchecked, don't submit anything in
  1096.     // the POST, so set to SMPREF_OFF if not found
  1097.     //
  1098.     else if (($option->type == SMOPT_TYPE_BOOLEAN
  1099.            || $option->type == SMOPT_TYPE_BOOLEAN_CHECKBOX)
  1100.           && empty($option->new_value)) 
  1101.         setPref($data_dir$username$option->nameSMPREF_OFF);
  1102.  
  1103.     // For integer fields, make sure we only have digits...
  1104.     // We'll be nice and instead of just converting to an integer,
  1105.     // we'll physically remove each non-digit in the string.
  1106.     //
  1107.     else if ($option->type == SMOPT_TYPE_INTEGER{
  1108.         $option->new_value preg_replace('/[^0-9]/'''$option->new_value);
  1109.         setPref($data_dir$username$option->name$option->new_value);
  1110.     }
  1111.  
  1112.     else
  1113.         setPref($data_dir$username$option->name$option->new_value);
  1114.  
  1115.  
  1116.     // if a checkbox or multi select is zeroed/cleared out, it
  1117.     // needs to have an empty value pushed into its "new_value" slot
  1118.     //
  1119.     if (($option->type == SMOPT_TYPE_STRLIST_MULTI
  1120.       || $option->type == SMOPT_TYPE_BOOLEAN_CHECKBOX)
  1121.      && is_null($option->new_value))
  1122.         $option->new_value '';
  1123.  
  1124. }
  1125.  
  1126. /**
  1127.  * save function that does not save
  1128.  * @param object $option 
  1129.  */
  1130. function save_option_noop($option{
  1131.     /* Do nothing here... */
  1132. }
  1133.  
  1134. /**
  1135.  * Create hidden 'optpage' input field with value set by argument
  1136.  * @param string $optpage identification of option page
  1137.  * @return string html formated hidden input field
  1138.  */
  1139. function create_optpage_element($optpage{
  1140.     return addHidden('optpage'$optpage);
  1141. }
  1142.  
  1143. /**
  1144.  * Create hidden 'optmode' input field with value set by argument
  1145.  * @param string $optmode 
  1146.  * @return string html formated hidden input field
  1147.  */
  1148. function create_optmode_element($optmode{
  1149.     return addHidden('optmode'$optmode);
  1150. }
  1151.  
  1152. /**
  1153.  * @param array $optgrps 
  1154.  * @param array $optvals 
  1155.  * @return array 
  1156.  */
  1157. function create_option_groups($optgrps$optvals{
  1158.     /* Build a simple array with which to start. */
  1159.     $result array();
  1160.  
  1161.     /* Create option group for each option group name. */
  1162.     foreach ($optgrps as $grpkey => $grpname{
  1163.         $result[$grpkeyarray();
  1164.         $result[$grpkey]['name'$grpname;
  1165.         $result[$grpkey]['options'array();
  1166.     }
  1167.  
  1168.      /* Create a new SquirrelOption for each set of option values. */
  1169.     foreach ($optvals as $grpkey => $grpopts{
  1170.         foreach ($grpopts as $optset{
  1171.             /* Create a new option with all values given. */
  1172.             $next_option new SquirrelOption(
  1173.                     $optset,
  1174.                     $optset['name'],
  1175.                     $optset['caption'],
  1176.                     $optset['type'],
  1177.                     (isset($optset['refresh']$optset['refresh'SMOPT_REFRESH_NONE),
  1178.                     (isset($optset['initial_value']$optset['initial_value'''),
  1179.                     (isset($optset['posvals']$optset['posvals'''),
  1180.                     (isset($optset['htmlencoded']$optset['htmlencoded'false)
  1181.                     );
  1182.  
  1183.             /* If provided, set if the caption is allowed to wrap for this option. */
  1184.             if (isset($optset['caption_wrap'])) {
  1185.                 $next_option->setCaptionWrap($optset['caption_wrap']);
  1186.             }
  1187.  
  1188.             /* If provided, set the size for this option. */
  1189.             if (isset($optset['size'])) {
  1190.                 $next_option->setSize($optset['size']);
  1191.             }
  1192.  
  1193.             /* If provided, set the trailing_text for this option. */
  1194.             if (isset($optset['trailing_text'])) {
  1195.                 $next_option->setTrailingText($optset['trailing_text']);
  1196.             }
  1197.  
  1198.             /* If provided, set the trailing_text_small for this option. */
  1199.             if (isset($optset['trailing_text_small'])) {
  1200.                 $next_option->setTrailingTextSmall($optset['trailing_text_small']);
  1201.             }
  1202.  
  1203.             /* If provided, set the trailing_text_is_html for this option. */
  1204.             if (isset($optset['trailing_text_is_html'])) {
  1205.                 $next_option->setTrailingTextIsHtml($optset['trailing_text_is_html']);
  1206.             }
  1207.  
  1208.             /* If provided, set the yes_text for this option. */
  1209.             if (isset($optset['yes_text'])) {
  1210.                 $next_option->setYesText($optset['yes_text']);
  1211.             }
  1212.  
  1213.             /* If provided, set the no_text for this option. */
  1214.             if (isset($optset['no_text'])) {
  1215.                 $next_option->setNoText($optset['no_text']);
  1216.             }
  1217.  
  1218.             /* If provided, set the poss_value_folders value for this option. */
  1219.             if (isset($optset['poss_value_folders'])) {
  1220.                 $next_option->setPossValueFolders($optset['poss_value_folders']);
  1221.             }
  1222.  
  1223.             /* If provided, set the layout type for this option. */
  1224.             if (isset($optset['layout_type'])) {
  1225.                 $next_option->setLayoutType($optset['layout_type']);
  1226.             }
  1227.  
  1228.             /* If provided, set the use_add_widget value for this option. */
  1229.             if (isset($optset['use_add_widget'])) {
  1230.                 $next_option->setUseAddWidget($optset['use_add_widget']);
  1231.             }
  1232.  
  1233.             /* If provided, set the use_delete_widget value for this option. */
  1234.             if (isset($optset['use_delete_widget'])) {
  1235.                 $next_option->setUseDeleteWidget($optset['use_delete_widget']);
  1236.             }
  1237.  
  1238.             /* If provided, set the comment for this option. */
  1239.             if (isset($optset['comment'])) {
  1240.                 $next_option->setComment($optset['comment']);
  1241.             }
  1242.  
  1243.             /* If provided, set the save function for this option. */
  1244.             if (isset($optset['save'])) {
  1245.                 $next_option->setSaveFunction($optset['save']);
  1246.             }
  1247.  
  1248.             /* If provided, set the extra attributes for this option. */
  1249.             if (isset($optset['extra_attributes'])) {
  1250.                 $next_option->setExtraAttributes($optset['extra_attributes']);
  1251.             }
  1252.  
  1253.             /* If provided, set the "post script" for this option. */
  1254.             if (isset($optset['post_script'])) {
  1255.                 $next_option->setPostScript($optset['post_script']);
  1256.             }
  1257.  
  1258.             /* If provided, set the folder_filter for this option. */
  1259.             if (isset($optset['folder_filter'])) {
  1260.                 $next_option->setFolderFilter($optset['folder_filter']);
  1261.             }
  1262.  
  1263.             /* Add this option to the option array. */
  1264.             $result[$grpkey]['options'][$next_option;
  1265.         }
  1266.     }
  1267.  
  1268.     /* Return our resulting array. */
  1269.     return ($result);
  1270. }

Documentation generated on Wed, 13 Dec 2017 04:23:54 +0100 by phpDocumentor 1.4.3