Source for file DBMS_FIELD_DBLOOKUPMULTISELECTLIST.phpclass

Documentation is available at DBMS_FIELD_DBLOOKUPMULTISELECTLIST.phpclass

  1. <?php
  2. /**
  3.   * Class file DBMS_FIELD_DBLOOKUPMULTISELECTLIST.phpclass
  4.   *
  5.   * @project    Open CSP-Management
  6.   * @package    dbms_field
  7.   * @category   any
  8.   *
  9.   * @author     Peter Krebs <p.krebs@lvus.at>
  10.   * @copyright  &copy; 2002-2005 by Peter Krebs and Landesverlag Unternehmensservice
  11.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  12.   *
  13.   ***/
  14.  
  15. if (!class_exists("DBMS_FIELD_DBLOOKUPSELECTLIST")) {
  16.     require_once dirname(__FILE__) . _OCSP_DIRSEP_ . "DBMS_FIELD_DBLOOKUPSELECTLIST.phpclass";
  17. }
  18.  
  19. /**
  20.   * Class DBMS_FIELD_DBLOOKUPMULTISELECTLIST
  21.   *
  22.   * handels multi select lists form a database
  23.   * where the input is done
  24.   *
  25.   *
  26.   *
  27.   * @project    Open CSP-Management
  28.   * @package    dbms_field
  29.   * @category   any
  30.   *
  31.   * @author     Peter Krebs <p.krebs@wpus.at>
  32.   * @copyright  &copy; 2002-2005 by Peter Krebs and Landesverlag Unternehmensservice
  33.   * @copyright  &copy; 2005-2006 by Peter Krebs and WURM & Partner Unternehmensservice
  34.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  35.   *
  36.   * @since pk-06-02-10
  37.   * @version pk-06-03-07 (bugfix,debug)
  38.   *
  39.   ***/
  40. class DBMS_FIELD_DBLOOKUPMULTISELECTLIST extends DBMS_FIELD_DBLOOKUPSELECTLIST {
  41.  
  42.  
  43.     // ###########################################################
  44.     // OBJECT (CONST) VAR DECLARATION
  45.     // ###########################################################
  46.  
  47.     /**
  48.       * overwrite variables:
  49.       **/
  50.  
  51.      protected $className         ="DB MultiSelectList";
  52.      
  53.      protected $classSrcFile      =__FILE__;
  54.      
  55.      protected $mySeperator       =",";
  56.  
  57.     // ###########################################################
  58.     // OBJECT SETTINGS METHODS
  59.     // ###########################################################
  60.  
  61.     /**
  62.       * returns an array of field to bie shown in the edit form
  63.       * by using editTbl_echoForm
  64.       *
  65.       * the array is in the form:
  66.       *
  67.       * <code>
  68.       * [_sectionName_]
  69.       *      [TITLE] -> string
  70.       *      [_rowName_]
  71.       *         [FLDLAB]  (complete html code with <td></td>)
  72.       *         [FLDVAL] (complete html code with <td></td>)
  73.       * </code>
  74.       *
  75.       * @param boolean $debug 
  76.       *
  77.       * @returns array
  78.       *
  79.       * @since pk-06-04-26
  80.       *
  81.       *  /
  82.     function editTbl_getFieldEditArr($debug=FALSE) {
  83.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_DBSELECTLIST::editTbl_getFieldEditArr","",0);
  84.         $a_ret=parent::editTbl_getFieldEditArr($debug);
  85.  
  86.  
  87.         $a_ret['SELECT']['FLD_VALSEPERATOR']=array(
  88.             'FLDLAB'=>"Wert Trennzeichen:",
  89.             'FLDVAL'=>"<input name=\"mySeperator\" type=\"text\" value=\"".$this->mySeperator."\" size=\"2\" maxLength=\"1\">"
  90.         );
  91.  
  92.         return $a_ret;
  93.     }
  94.  
  95.     /**
  96.       *  save the filed definition form
  97.       *
  98.       * @returns boolean
  99.       *
  100.       ***/
  101.     function save() {
  102.         $ret=parent::save();
  103.         if (isset($_POST['mySeperator']) && !empty($_POST['mySeperator']))
  104.         {
  105.             $this->mySeperator=$_POST['mySeperator'];
  106.         } else {
  107.             $this->mySeperator=",";
  108.         }
  109.         return $ret;
  110.     }
  111.  
  112.     // ###########################################################
  113.     // OBJECT DATA METHODS
  114.     // ###########################################################
  115.  
  116.  
  117.     // ###########################################################
  118.     // OBJECT HTML FORM METHODS
  119.     // ###########################################################
  120.  
  121.  
  122.  
  123.     /**
  124.       * returns the html option list of all elements in $aValArr
  125.       *
  126.       * @param array $aValArr 
  127.       * @param boolean $debug 
  128.       *
  129.       * @returns string
  130.       *
  131.       ***/
  132.     protected function getOptionListIn($aValArr,$debug=FALSE) {
  133.         $debug=($debug | $this->fldDebug);
  134.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_DBLOOKUPMULTISELECTLIST::getOptionListIn()","",0);
  135.  
  136.         $s_ret="";
  137.         $b_IsEmpty=TRUE;
  138.         if (is_array($aValArr)) {
  139.             foreach($aValArr as $m_key) {
  140.                 if (!empty($m_key)) {
  141.                     $s_ret.="\t<option value=\"".$m_key."\">".htmlspecialchars($this->getDBValue($m_key,$debug))."</option>\n";
  142.                     $b_IsEmpty=FALSE;
  143.                 }
  144.             }
  145.         }
  146.         if ($b_IsEmpty) {
  147.             $s_ret.="\t<option value\"\" disabled>--- keine Werte ---</option>\n";
  148.         }
  149.         return $s_ret;
  150.     }
  151.  
  152.     /**
  153.       * returns the html option list of all elements in $aValArr
  154.       *
  155.       * @param array $aValArr 
  156.       * @param boolean $debug 
  157.       *
  158.       * @returns string
  159.       *
  160.       * @version pk-06-03-07 (bugfix)
  161.       *
  162.       ***/
  163.     protected function getOptionListOut($aValArr,$debug=FALSE) {
  164.         $debug=($debug | $this->fldDebug);
  165.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_DBLOOKUPMULTISELECTLIST::getOptionListIn()","",0);
  166.  
  167.         $this->setMyValues($this->myDataArrName,$debug); // <pk-06-03-07 />
  168.  
  169.         $s_ret="";
  170.         $b_IsEmpty=TRUE;
  171.         $a_allValues=$this->myValues;
  172.         if (is_array($a_allValues)) {
  173.             if (is_array($aValArr)) {
  174.                 foreach($aValArr as $m_key) {
  175.                     // remove selected form list
  176.                     unset($a_allValues[$m_key]);
  177.                 }
  178.             }
  179.             foreach($a_allValues as $m_key => $s_label) {
  180.                 if (!empty($m_key)) {
  181.                     $s_ret.="\t<option value=\"".$m_key."\">".htmlspecialchars($s_label)."</option>\n";
  182.                     $b_IsEmpty=FALSE;
  183.                 }
  184.             }
  185.         }
  186.         if ($b_IsEmpty) {
  187.             $s_ret.="\t<option value\"\" disabled>--- keine Werte ---</option>\n";
  188.         }
  189.         return $s_ret;
  190.     }
  191.  
  192.  
  193.     /**
  194.       * returns the html code for the select
  195.       *
  196.       * @param string $aValue 
  197.       * @param array $arrName 
  198.       * @param boolean $debug 
  199.       *
  200.       * @returns string
  201.       *
  202.       * @version pk-05-12-01
  203.       * @version pk-06-02-06 popUp_frmId
  204.       * @version pk-08-05-19
  205.       */
  206.     function getInputTag($aValue,$arrName="DBVAL",$debug=FALSE) {
  207.  
  208.         if (!empty($arrName)) $this->myDataArrName=$arrName;
  209.         global ${$this->myDataArrName};
  210.  
  211.         if ($debug) echoDebugMethod(__FILE__,get_class($this)."DBMS_FIELD_DBLOOKUPMULTISELECTLIST::getInputTag()","",0);
  212.  
  213.         $this->setMyValues($arrName,$debug);
  214.  
  215.         if (is_array($aValue)) {
  216.             $s_valStr=implode($this->mySeperator,$aValue);
  217.             $a_valArr=$aValue;
  218.         } else {
  219.             $s_valStr=$aValue;
  220.             $a_valArr=explode($this->mySeperator,$aValue);
  221.         }
  222.         if (!is_array($a_valArr)) {
  223.             // set empty array to avoid errors
  224.             $a_valArr=array();
  225.         }
  226.  
  227.         if ($this->selectsize < 6) $this->selectsize=6;
  228.         
  229.         $str_ret ="
  230.             <input type=\"hidden\" id=\"" . $this->getDOMId() ."\" name=\"".$arrName."[".$this->myName."]\" value=\"$s_valStr\">
  231.             <table align=\"center\" border=\"0\" class=\"frmSelInOut\">
  232.                 <tr>
  233.                     <td width=\"45%\" align=\"center\">gew&auml;hlt</td>
  234.                     <td width=\"10%\">
  235.                     <td width=\"45%\" align=\"center\">verf&uuml;gbar</td>
  236.                 </tr>
  237.                 <tr>
  238.                     <td width=\"45%\" align=\"center\">
  239.                         <select 
  240.                             id=\"" . $this->getDOMId() ."_inList\" 
  241.                             name=\"".$arrName."[".$this->myName."_inList]\" 
  242.                             size=\"".intval($this->selectsize)."\" 
  243.                             ondblclick=\"document.getElementById('" . $this->getDOMId() . "').jOCSPFldObj.removeValue(this.value);\" 
  244.                             multiple>
  245.                             " . $this->getOptionListIn($a_valArr,$debug) . "
  246.                         </select>
  247.                     </td>
  248.                     <td valign=\"middle\" width=\"10%\" align=\"center\">
  249.                         <img 
  250.                             src=\"" . OCSP_OBJ::getConf('SYSIMGURL') . "icons-16x16/2leftarrow.gif\"
  251.                             border=\"0\" alt=\"alle Eif&uuml;gen\" align=\"middle\" class=\"button\"
  252.                             onclick=\"
  253.                                 document.getElementById('" . $this->getDOMId() . "').jOCSPFldObj.addAll();
  254.                             \"
  255.                         /><br />
  256.                         <img 
  257.                             src=\"" . OCSP_OBJ::getConf('SYSIMGURL') . "icons-16x16/1leftarrow.gif\"
  258.                             border=\"0\" alt=\"gew&auml;hlte Eif&uuml;gen\" align=\"middle\" class=\"button\"
  259.                             onclick=\"
  260.                                 document.getElementById('" . $this->getDOMId() . "').jOCSPFldObj.addSelected();
  261.                             \"
  262.                         /><br />
  263.                         <img 
  264.                             src=\"" . OCSP_OBJ::getConf('SYSIMGURL') . "icons-16x16/1rightarrow.gif\"
  265.                             border=\"0\" alt=\"gew&auml;hlte Entfernen\" align=\"middle\" class=\"button\"
  266.                             onclick=\"
  267.                                 document.getElementById('" . $this->getDOMId() . "').jOCSPFldObj.removeSelected();
  268.                             \"
  269.                         /><br />
  270.                         <img 
  271.                             src=\"" . OCSP_OBJ::getConf('SYSIMGURL') . "icons-16x16/2rightarrow.gif\"
  272.                             border=\"0\" alt=\"alle Entfernen\" align=\"middle\" class=\"button\"
  273.                             onclick=\"
  274.                                 document.getElementById('" . $this->getDOMId() . "').jOCSPFldObj.removeAll();
  275.                             \"
  276.                         />
  277.                     </td>
  278.                     <td width=\"45%\" align=\"center\">
  279.                         <select id=\"" . $this->getDOMId() ."_outList\" 
  280.                              name=\"".$arrName."[".$this->myName."_outList]\" 
  281.                              size=\"".intval($this->selectsize)."\" 
  282.                             ondblclick=\"document.getElementById('" . $this->getDOMId() . "').jOCSPFldObj.addValue(this.value);\" 
  283.                             multiple>
  284.                             " . $this->getOptionListOut($a_valArr,$debug) ."
  285.                         </select>
  286.                     </td>
  287.                 </tr>
  288.             </table>
  289.         ";
  290.  
  291.  
  292.         /**
  293.           * @todo populink
  294.           *
  295.         if (($this->allowAddValues) && (intval($this->popUp_frmId))) { // <pk-06-02-06>
  296.             $ret.="<!--\n\t\t _______ ADD VALUES BUTTON _______ \n";
  297.             $ret.="\t\t--> <a name=\"".$this->getMyFormName()."_".$this->myName."\" href=\"javascript:{";
  298.             $ret.=$this->getPopupLinkJs(FRM_MODE_NEW,$this->myName."_inList","nOpt_".$arrName."_".$this->myName,$debug);
  299.             $ret.="}\n";
  300.             $ret.="\t\t \"><img src=\"".$GLOBALS['PROJECT']['SYSIMGURL']."icons-16x16/filenew.gif\" border=\"0\" alt=\"neuer Eintrag\" align=\"middle\" class=\"button\">";
  301.             $ret.="</a><!--\n";
  302.             $ret.="\t\t _______ ADD VALUES BUTTON _______ \n-->";
  303.         }
  304.           *
  305.           **/
  306.  
  307.  
  308.         return $str_ret;
  309.     }
  310.  
  311.     // ###########################################################
  312.     // SEARCH FORM METHODS
  313.     // ###########################################################
  314.  
  315.     // ###########################################################
  316.     // OBJECT HTML FORM METHODS
  317.     // ###########################################################
  318.  
  319.     // ###########################################################
  320.     // OBJECT VALUE CHECK/RETURN METHODS
  321.     // ###########################################################
  322.  
  323.     /**
  324.       * returns the field value checks for empty values
  325.       *
  326.       * @param  string $aValue the value
  327.       * @param  array $err error array
  328.       * @param  string $arrName name of the array to access fieldsarray  gloabl ${$arrName}
  329.       * @param  boolean $debug 
  330.       *
  331.       * @returns string
  332.       *
  333.       * @since   pk-06-03-07
  334.       *
  335.       ***/
  336.     function getValue($aValue,&$err,$arrName="DBVAL",$debug=FALSE) {
  337.         $debug=($debug || $this->fldDebug);
  338.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_DBLOOKUPMULTISELECTLIST::getValue()|".$this->myName,print_r($aValue,TRUE),0);
  339.         if ((!is_array($aValue)) && (strstr($aValue,$this->mySeperator))) {
  340.             // remove empty values
  341.             $a_valArr=explode($this->mySeperator,$aValue);
  342.             $s_sep="";
  343.             if (is_array($a_valArr)) {
  344.                 $aValue="";
  345.                 foreach($a_valArr as $s_val) {
  346.                     $s_val=trim($s_val);
  347.                     if ((!empty($s_val) || ($s_val==="0"))) { // "0" is empty -> check with ===
  348.                         $aValue.=$s_sep.$s_val;
  349.                         $s_sep=$this->mySeperator;
  350.                     }
  351.                 }
  352.             }
  353.         }
  354.         return parent::getValue($aValue,$err,$arrName,$debug);
  355.  
  356.     }
  357.     
  358.     // --------------------------------------------------------
  359.     // jOCSP
  360.     // --------------------------------------------------------
  361.  
  362.     /**
  363.      * returns an array of jOCSP/jQuery Modules which are required
  364.      * 
  365.      * $arr_ret[]="script url";
  366.      *
  367.      * @param boolean $debug 
  368.      * 
  369.      * @global array $OCSP_CONF 
  370.      * 
  371.      * @return string 
  372.      */
  373.     public function jOCSP_getRequiredModules($debug=FALSE)
  374.     {        
  375.         if ($debug) echoDebugMethod(__FILE__,get_classe($this),"DBMS_FIELD::jOCSP_getRequiredModules()");
  376.         
  377.         $arr_ret = parent::jOCSP_getRequiredModules($debug);
  378.         
  379.         $arr_ret[] = array(
  380.             'CLASS' => 'jOCSP.FLDOBJ_DBMultiSelectList',
  381.             'SRC'     => OCSP_OBJ::getConf('SYSTEMURL')."jOCSP/formFields/jOCSP_FLDOBJ_DBMultiSelectList.js"
  382.         );
  383.                
  384.         return $arr_ret;
  385.     }
  386.  
  387.    /**
  388.      * returns additional object elements of the field object
  389.      * 
  390.      * array definition: [elemName] = value
  391.      * 
  392.      * NOTE: do not js_escapte value this is done when building the json object
  393.      *
  394.      * @param boolean $debug 
  395.      * 
  396.      * @return array 
  397.      * 
  398.      * @since pk-08-02-06
  399.      */
  400.     protected function jOCSP_getAdditonalFieldObjElems($debug=False)
  401.     {  
  402.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_FILESELECT::jOCSP_getAdditonalFieldObjElems()");
  403.         $arr_ret = parent::jOCSP_getAdditonalFieldObjElems($debug);        
  404.         $arr_ret['fldClass'] = "'FLDOBJ_DBMultiSelectList'";    
  405.         $arr_ret['valSep']= "'" . $this->mySeperator . "'";
  406.         //$arr_ret['debug'] = True;
  407.         return $arr_ret;          
  408.     }    
  409.  
  410. } // end class DBMS_FIELD_DBLOOKUPMULTISELECTLIST
  411. ?>

Documentation generated on Thu, 08 Jan 2009 17:41:00 +0100 by phpDocumentor 1.4.0a2