* * -------------------------------------------- * * This program is free software; you can redistribute it and/or modify it * * under the terms of the GNU General Public License as published by the * * Free Software Foundation; either version 2 of the License, or (at your * * option) any later version. * \**************************************************************************/ /* $Id$ */ include_once(PHPGW_INCLUDE_ROOT . '/etemplate/inc/class.boetemplate.inc.php'); /** * creates dialogs / HTML-forms from eTemplate descriptions * * etemplate or uietemplate extends boetemplate, all vars and public functions are inherited * * $tmpl = CreateObject('etemplate.etemplate','app.template.name'); * $tmpl->exec('app.class.callback',$content_to_show); * This creates a form from the eTemplate 'app.template.name' and takes care that * the method / public function 'callback' in (bo)class 'class' of 'app' gets called * if the user submitts the form. Vor the complete param's see the description of exec. * * @package etemplate * @author RalfBecker-AT-outdoor-training.de * @license GPL */ class etemplate extends boetemplate { /** * @var int/string='' integer debug-level or template-name or cell-type or '' = off * 1=calls to show and process_show, 2=content after process_show, * 3=calls to show_cell and process_show_cell */ var $debug; var $html; /* instance of html-class */ var $xslt = false; /* do we run in the xslt framework (true) or the regular eGW one (false) */ var $class_conf = array('nmh' => 'th','nmr0' => 'row_on','nmr1' => 'row_off'); var $public_functions = array('process_exec' => True); /** * constructor of etemplate class, reads an eTemplate if $name is given * * @param string $name of etemplate or array with name and other keys * @param string/array $load_via with keys of other etemplate to load in order to get $name */ function etemplate($name='',$load_via='') { if (!is_object($GLOBALS['phpgw']->html)) { $GLOBALS['phpgw']->html = CreateObject('phpgwapi.html'); } $this->html = &$GLOBALS['phpgw']->html; $this->boetemplate($name,$load_via); $this->xslt = is_object($GLOBALS['phpgw']->xslttpl); } /** * Abstracts a html-location-header call * * In other UI's than html this needs to call the methode, defined by menuaction or * open a browser-window for any other links. * * @param string/array $params url or array with get-params incl. menuaction */ function location($params='') { $GLOBALS['phpgw']->redirect_link(is_array($params) ? '/index.php' : $params, is_array($params) ? $params : ''); } /** * Generats a Dialog from an eTemplate - abstract the UI-layer * * This is the only function an application should use, all other are INTERNAL and * do NOT abstract the UI-layer, because they return HTML. * Generates a webpage with a form from the template and puts process_exec in the * form as submit-url to call process_show for the template before it * ExecuteMethod's the given $method of the caller. * * @param string $method Methode (e.g. 'etemplate.editor.edit') to be called if form is submitted * @param array $content with content to fill the input-fields of template, eg. the text-field * with name 'name' gets its content from $content['name'] * @param $sel_options array or arrays with the options for each select-field, keys are the * field-names, eg. array('name' => array(1 => 'one',2 => 'two')) set the * options for field 'name'. ($content['options-name'] is possible too !!!) * @param array $readonlys with field-names as keys for fields with should be readonly * (eg. to implement ACL grants on field-level or to remove buttons not applicable) * @param array $preserv with vars which should be transported to the $method-call (eg. an id) array('id' => $id) sets $_POST['id'] for the $method-call * @param int $output_mode 0 = echo incl. navbar, 1 = return html, 2 = echo without navbar (eg. for popups) * @param array $changes change made in the last call if looping, only used internaly by process_exec * @return string html for $output_mode == 1, else nothing */ function exec($method,$content,$sel_options='',$readonlys='',$preserv='',$output_mode=0,$changes='') { //echo "
globals[java_script] = '".$GLOBALS['phpgw_info']['etemplate']['java_script']."', this->java_script() = '".$this->java_script()."'\n"; if (!$sel_options) { $sel_options = array(); } if (!$readonlys) { $readonlys = array(); } if (!$preserv) { $preserv = array(); } if (!$changes) { $changes = array(); } if (isset($content['app_header'])) { $GLOBALS['phpgw_info']['flags']['app_header'] = $content['app_header']; } if ($GLOBALS['phpgw_info']['flags']['currentapp'] != 'etemplate') { $GLOBALS['phpgw']->translation->add_app('etemplate'); // some extensions have own texts } $id = $this->appsession_id(); $GLOBALS['phpgw_info']['etemplate']['loop'] = False; $GLOBALS['phpgw_info']['etemplate']['form_options'] = ''; // might be set in show $GLOBALS['phpgw_info']['etemplate']['to_process'] = array(); $html = (!$this->xslt ? $this->html->themeStyles()."\n\n" : ''). // so they get included once $this->html->form($this->include_java_script(1). $this->html->input_hidden('submit_button','',False). $this->show($this->complete_array_merge($content,$changes),$sel_options,$readonlys,'exec'),array( 'etemplate_exec_id' => $id ),'/etemplate/process_exec.php?menuaction='.$method,'','eTemplate',$GLOBALS['phpgw_info']['etemplate']['form_options']); //_debug_array($GLOBALS['phpgw_info']['etemplate']['to_process']); if (!$this->xslt) { $hooked = $GLOBALS['phpgw']->template->get_var('phpgw_body'); if (!@$GLOBALS['phpgw_info']['etemplate']['hooked'] && (int) $output_mode != 1) // not just returning the html { $GLOBALS['phpgw_info']['flags']['java_script'] .= $this->include_java_script(2); $GLOBALS['phpgw']->common->phpgw_header(); } else { $html = $this->include_java_script(2).$html; // better than nothing } } else { $hooked = $GLOBALS['phpgw']->xslttpl->get_var('phpgw'); $hooked = $hooked['body_data']; $GLOBALS['phpgw']->xslttpl->set_var('phpgw',array('java_script' => $GLOBALS['phpgw_info']['flags']['java_script'].$this->include_java_script(2))); } $id = $this->save_appsession($this->as_array(1) + array( 'readonlys' => $readonlys, 'content' => $content, 'changes' => $changes, 'sel_options' => $sel_options, 'preserv' => $preserv, 'extension_data' => $GLOBALS['phpgw_info']['etemplate']['extension_data'], 'to_process' => $GLOBALS['phpgw_info']['etemplate']['to_process'], 'java_script' => $GLOBALS['phpgw_info']['etemplate']['java_script'], 'dom_enabled' => $GLOBALS['phpgw_info']['etemplate']['dom_enabled'], 'hooked' => $hooked != '' ? $hooked : $GLOBALS['phpgw_info']['etemplate']['hook_content'], 'app_header' => $GLOBALS['phpgw_info']['flags']['app_header'], 'output_mode' => $output_mode, ),$id); if ((int) $output_mode == 1) // return html { return $html; } if (!$this->xslt) { if (!@$GLOBALS['phpgw_info']['etemplate']['hooked']) { if((int) $output_mode != 2) { echo parse_navbar(); } else { echo '
'."\n"; } } echo $GLOBALS['phpgw_info']['etemplate']['hook_content'].$html; if (!@$GLOBALS['phpgw_info']['etemplate']['hooked'] && (!isset($_GET['menuaction']) || strstr($_SERVER['PHP_SELF'],'process_exec.php'))) { if((int) $output_mode == 2) { echo "
\n"; } $GLOBALS['phpgw']->common->phpgw_footer(); } } else { // need to add some logic here to support popups (output_mode==2) for xslt, but who cares ... $GLOBALS['phpgw']->xslttpl->set_var('phpgw',array('body_data' => $html)); } } /** * Makes the necessary adjustments to _POST before it calls the app's method * * This function is only to submit forms to, create with exec. * All eTemplates / forms executed with exec are submited to this function * via /etemplate/process_exec.php?menuaction=. We cant use the global index.php as * it would set some constants to etemplate instead of the calling app. * process_exec then calls process_show for the eTemplate (to adjust the content of the _POST) and * ExecMethod's the given callback from the app with the content of the form as first argument. */ function process_exec() { //echo "process_exec: _POST ="; _debug_array($_POST); $session_data = $this->get_appsession($_POST['etemplate_exec_id']); //echo "

process_exec: session_data ="; _debug_array($session_data); if (!$_POST['etemplate_exec_id'] || !is_array($session_data) || count($session_data) < 10) { // this prevents an empty screen, if the sessiondata gets lost somehow $this->location(array('menuaction' => $_GET['menuaction'])); } if (isset($_POST['submit_button']) && !empty($_POST['submit_button'])) { $this->set_array($_POST,$_POST['submit_button'],'pressed'); } $content = $_POST['exec']; if (!is_array($content)) { $content = array(); } $this->init($session_data); $GLOBALS['phpgw_info']['etemplate']['extension_data'] = $session_data['extension_data']; $GLOBALS['phpgw_info']['etemplate']['java_script'] = $session_data['java_script'] || $_POST['java_script']; $GLOBALS['phpgw_info']['etemplate']['dom_enabled'] = $session_data['dom_enabled'] || $_POST['dom_enabled']; //echo "globals[java_script] = '".$GLOBALS['phpgw_info']['etemplate']['java_script']."', session_data[java_script] = '".$session_data['java_script']."', _POST[java_script] = '".$_POST['java_script']."'\n"; //echo "process_exec($this->name) content ="; _debug_array($content); if ($GLOBALS['phpgw_info']['flags']['currentapp'] != 'etemplate') { $GLOBALS['phpgw']->translation->add_app('etemplate'); // some extensions have own texts } $this->process_show($content,$session_data['to_process'],'exec'); $GLOBALS['phpgw_info']['etemplate']['loop'] |= !$this->canceled && $this->button_pressed && count($GLOBALS['phpgw_info']['etemplate']['validation_errors']) > 0; // set by process_show //echo "process_exec($this->name) process_show(content) ="; _debug_array($content); //echo "process_exec($this->name) session_data[changes] ="; _debug_array($session_data['changes']); $content = $this->complete_array_merge($session_data['changes'],$content); //echo "process_exec($this->name) merge(changes,content) ="; _debug_array($content); if ($GLOBALS['phpgw_info']['etemplate']['loop']) { if ($session_data['hooked'] != '') // set previous phpgw_body if we are called as hook { if (!$this->xslt) { //echo "

process_exec: hook_content set

\n"; $GLOBALS['phpgw_info']['etemplate']['hook_content'] = $session_data['hooked']; } else { $GLOBALS['phpgw']->xslttpl->set_var('phpgw',array('body_data' => $session_data['hooked'])); } } if (!empty($session_data['app_header'])) { $GLOBALS['phpgw_info']['flags']['app_header'] = $session_data['app_header']; } //echo "

process_exec($this->name): loop is set, content=

\n"; _debug_array($content); $this->exec($_GET['menuaction'],$session_data['content'],$session_data['sel_options'], $session_data['readonlys'],$session_data['preserv'],$session_data['output_mode'],$content); } else { ExecMethod($_GET['menuaction'],$this->complete_array_merge($session_data['preserv'],$content)); } } /** * creates HTML from an eTemplate * * This is done by calling show_cell for each cell in the form. show_cell itself * calls show recursivly for each included eTemplate. * You could use it in the UI-layer of an app, just make shure to call process_show !!! * This is intended as internal function and should NOT be called by new app's direct, * as it deals with HTML and is so UI-dependent, use exec instead. * * @internal * @param array $content with content for the cells, keys are the names given in the cells/form elements * @param array $sel_options with options for the selectboxes, keys are the name of the selectbox * @param array $readonlys with names of cells/form-elements to be not allowed to change * This is to facilitate complex ACL's which denies access on field-level !!! * @param string $cname basename of names for form-elements, means index in $_POST * eg. $cname='cont', element-name = 'name' returned content in $_POST['cont']['name'] * @param string $show_c name/index for name expansion * @param string $show_row name/index for name expansion * @return string the generated HTML */ function show($content,$sel_options='',$readonlys='',$cname='',$show_c=0,$show_row=0) { if (!$sel_options) { $sel_options = array(); } if (!$readonlys) { $readonlys = array(); } if (is_int($this->debug) && $this->debug >= 1 || $this->name && $this->debug == $this->name) { echo "

etemplate.show($this->name): $cname =\n"; _debug_array($content); } if (!is_array($content)) { $content = array(); // happens if incl. template has no content } $html = "\n\n\n\n"; if (!$GLOBALS['phpgw_info']['etemplate']['styles_included'][$this->name]) { $GLOBALS['phpgw_info']['etemplate']['styles_included'][$this->name] = True; $html .= $this->html->style($this->style)."\n\n"; } $path = '/'; foreach ($this->children as $n => $child) { $html .= $this->show_cell($child,$content,$sel_options,$readonlys,$cname,$show_c,$show_row,$nul,$nul,$path.$n); } return $html."\n\n"; } /** * creates HTML from an eTemplate * * This is done by calling show_cell for each cell in the form. show_cell itself * calls show recursivly for each included eTemplate. * You can use it in the UI-layer of an app, just make shure to call process_show !!! * This is intended as internal function and should NOT be called by new app's direct, * as it deals with HTML and is so UI-dependent, use exec instead. * * @internal * @param array $grid representing a grid * @param array $content with content for the cells, keys are the names given in the cells/form elements * @param array $sel_options with options for the selectboxes, keys are the name of the selectbox * @param array $readonlys with names of cells/form-elements to be not allowed to change * This is to facilitate complex ACL's which denies access on field-level !!! * @param string $cname basename of names for form-elements, means index in $_POST * eg. $cname='cont', element-name = 'name' returned content in $_POST['cont']['name'] * @param string $show_c name/index for name expansion * @param string $show_row name/index for name expansion * @param string $path path in the widget tree * @return string the generated HTML */ function show_grid(&$grid,$content,$sel_options='',$readonlys='',$cname='',$show_c=0,$show_row=0,$path='') { if (!$sel_options) { $sel_options = array(); } if (!$readonlys) { $readonlys = array(); } if (is_int($this->debug) && $this->debug >= 2 || $grid['name'] && $this->debug == $grid['name']) { echo "

etemplate.show_grid($grid[name]): $cname =\n"; _debug_array($content); } if (!is_array($content)) { $content = array(); // happens if incl. template has no content } $content += array( // for var-expansion in names in show_cell '.c' => $show_c, '.col' => $this->num2chrs($show_c-1), '.row' => $show_row ); $data = &$grid['data']; reset($data); if (isset($data[0])) { list(,$opts) = each($data); } else { $opts = array(); } for ($r = 0; $row = 1+$r /*list($row,$cols) = each($data)*/; ++$r) { if (!(list($r_key) = each($data))) // no further row { if (!(($this->autorepeat_idx($cols['A'],0,$r,$idx,$idx_cname) && $idx_cname) || (substr($cols['A']['type'],1) == 'box' && $this->autorepeat_idx($cols['A'][1],0,$r,$idx,$idx_cname) && $idx_cname) || ($this->autorepeat_idx($cols['B'],1,$r,$idx,$idx_cname) && $idx_cname)) || !$this->isset_array($content,$idx_cname)) { break; // no auto-row-repeat } } else { $cols = &$data[$r_key]; list($height,$disabled) = explode(',',$opts["h$row"]); $class = /*TEST-RB$no_table_tr ? $tr_class :*/ $opts["c$row"]; } if ($disabled != '' && $this->check_disabled($disabled,$content)) { continue; // row is disabled } $rows[".$row"] .= $this->html->formatOptions($height,'HEIGHT'); list($cl) = explode(',',$class); if ($cl == 'nmr' || $cl == 'row') { $cl = 'row_'.($nmr_alternate++ & 1 ? 'off' : 'on'); // alternate color } $cl = isset($this->class_conf[$cl]) ? $this->class_conf[$cl] : $cl; $rows[".$row"] .= $this->html->formatOptions($cl,'CLASS'); $rows[".$row"] .= $this->html->formatOptions($class,',VALIGN'); reset ($cols); $row_data = array(); for ($c = 0; True /*list($col,$cell) = each($cols)*/; ++$c) { $col = $this->num2chrs($c); if (!(list($c_key) = each($cols))) // no further cols { if (!$this->autorepeat_idx($cell,$c,$r,$idx,$idx_cname,True) || !$this->isset_array($content,$idx)) { break; // no auto-col-repeat } } else { $cell = &$cols[$c_key]; list($col_width,$col_disabled) = explode(',',$opts[$col]); if (!$cell['height']) // if not set, cell-height = height of row { $cell['height'] = $height; } if (!$cell['width']) // if not set, cell-width = width of column or table { list($col_span) = explode(',',$cell['span']); if ($col_span == 'all' && !$c) { list($cell['width']) = explode(',',$this->size); } else { $cell['width'] = $col_width; } } } /*TEST-RB if ($cell['type'] == 'template' && $cell['onchange']) { $cell['tr_class'] = $cl; }*/ if ($col_disabled != '' && $this->check_disabled($col_disabled,$content)) { continue; // col is disabled } $row_data[$col] = $this->show_cell($cell,$content,$sel_options,$readonlys,$cname,$c,$r,$span,$cl,$path.'/'.$r_key.$c_key); if ($row_data[$col] == '' && $this->rows == 1) { unset($row_data[$col]); // omit empty/disabled cells if only one row continue; } if ($cell['onclick']) // can only be set via source at the moment { $row_data[".$col"] .= ' onClick="'.$cell['onclick'].'"'; if ($cell['id']) { $row_data[".$col"] .= ' ID="'.$cell['id'].'"'; } } $colspan = $span == 'all' ? $this->cols-$c : 0+$span; if ($colspan > 1) { $row_data[".$col"] .= " COLSPAN=\"$colspan\""; for ($i = 1; $i < $colspan; ++$i,++$c) { each($cols); // skip next cell(s) } } else { list($width,$disable) = explode(',',$opts[$col]); if ($width) // width only once for a non colspan cell { $row_data[".$col"] .= " WIDTH=\"$width\""; $opts[$col] = "0,$disable"; } } $row_data[".$col"] .= $this->html->formatOptions($cell['align']?$cell['align']:'left','ALIGN'); $cl = $this->expand_name(isset($this->class_conf[$cl]) ? $this->class_conf[$cl] : $cl, $c,$r,$show_c,$show_row,$content); $row_data[".$col"] .= $this->html->formatOptions($cl,'CLASS'); } $rows[$row] = $row_data; } $html = $this->html->table($rows,$this->html->formatOptions($grid['size'],'WIDTH,HEIGHT,BORDER,CLASS,CELLSPACING,CELLPADDING')/*TEST-RB,$no_table_tr*/); list($width,$height,,,,,$overflow) = explode(',',$grid['size']); if (!empty($overflow)) { $div_style=' STYLE="'.($width?"width: $width; ":'').($height ? "height: $height; ":'')."overflow: $overflow\""; $html = $this->html->div($html,$div_style); } return "\n\n\n$html\n\n"; } /** * build the name of a form-element from a basename and name * * name and basename can contain sub-indices in square bracets, eg. basename="base[basesub1][basesub2]" * and name = "name[sub]" gives "base[basesub1][basesub2][name][sub]" * * @param string $cname basename * @param string $name name * @return string complete form-name */ function form_name($cname,$name) { $name_parts = explode('[',str_replace(']','',$name)); if (!empty($cname)) { array_unshift($name_parts,$cname); } $form_name = array_shift($name_parts); if (count($name_parts)) { $form_name .= '['.implode('][',$name_parts).']'; } return $form_name; } /** * generates HTML for 1 input-field / cell * * calls show to generate included eTemplates. Again only an INTERMAL function. * * @internal * @param array $cell with data of the cell: name, type, ... * @param array $content with content for the cells, keys are the names given in the cells/form elements * @param array $sel_options with options for the selectboxes, keys are the name of the selectbox * @param array $readonlys with names of cells/form-elements to be not allowed to change * This is to facilitate complex ACL's which denies access on field-level !!! * @param string $cname basename of names for form-elements, means index in $_POST * eg. $cname='cont', element-name = 'name' returned content in $_POST['cont']['name'] * @param string $show_c name/index for name expansion * @param string $show_row name/index for name expansion * @param string &$span on return number of cells to span or 'all' for the rest (only used for grids) * @param string &$class on return the css class of the cell, to be set in the tag * @param string $path path in the widget tree * @return string the generated HTML */ function show_cell($cell,$content,$sel_options,$readonlys,$cname,$show_c,$show_row,&$span,&$class,$path='') { if (is_int($this->debug) && $this->debug >= 3 || $this->debug == $cell['type']) { echo "

etemplate.show_cell($this->name,name='${cell['name']}',type='${cell['type']}',cname='$cname')

\n"; } list($span) = explode(',',$cell['span']); // evtl. overriten later for type template if ($cell['name'][0] == '@' && $cell['type'] != 'template') { $cell['name'] = $this->get_array($content,substr($cell['name'],1)); } $name = $this->expand_name($cell['name'],$show_c,$show_row,$content['.c'],$content['.row'],$content); $form_name = $this->form_name($cname,$name); $value = $this->get_array($content,$name); if ($readonly = $cell['readonly'] || (@$readonlys[$name] && !is_array($readonlys[$name])) || $readonlys['__ALL__']) { $options .= ' READONLY'; } if ($cell['disabled'] || $readonly && $cell['type'] == 'button' && !strstr($cell['size'],',')) { if ($this->rows == 1) { return ''; // if only one row omit cell } $cell = $this->empty_cell(); // show nothing $value = ''; } $extra_label = True; list($type,$sub_type) = explode('-',$cell['type']); if ((!$this->types[$cell['type']] || !empty($sub_type)) && $this->haveExtension($type,'pre_process')) { $ext_type = $type; $extra_label = $this->extensionPreProcess($ext_type,$form_name,$value,$cell,$readonlys[$name]); $readonly = $readonly || $cell['readonly']; // might be set by extension $this->set_array($content,$name,$value); } list(,$class) = explode(',',$cell['span']); // might be set by extension $cell_options = $cell['size']; if (strchr($cell_options,'$')) { $cell_options = $this->expand_name($cell_options,$show_c,$show_row,$content['.c'],$content['.row'],$content); } if ($cell_options[0] == '@') { $cell_options = $this->get_array($content,substr($cell_options,1)); } $label = $this->expand_name($cell['label'],$show_c,$show_row,$content['.c'],$content['.row'],$content); $help = $cell['help']; if ($help[0] == '@') { $help = $this->get_array($content,substr($help,1)); } $blur = $cell['blur'][0] == '@' ? $this->get_array($content,substr($cell['blur'],1)) : (strlen($cell['blur']) <= 1 ? $cell['blur'] : lang($cell['blur'])); if ($this->java_script()) { if ($blur) { if (empty($value)) { $value = $blur; } $onFocus .= "if(this.value=='".addslashes($this->html->htmlspecialchars($blur))."') this.value='';"; $onBlur .= "if(this.value=='') this.value='".addslashes($this->html->htmlspecialchars($blur))."';"; } if ($help) { if ((int)$cell['no_lang'] < 2) { $help = lang($help); } $onFocus .= "self.status='".addslashes($this->html->htmlspecialchars($help))."'; return true;"; $onBlur .= "self.status=''; return true;"; if ($cell['type'] == 'button' || $cell['type'] == 'file') // for button additionally when mouse over button { $options .= " onMouseOver=\"self.status='".addslashes($this->html->htmlspecialchars($help))."'; return true;\""; $options .= " onMouseOut=\"self.status=''; return true;\""; } } if ($onBlur) { $options .= " onFocus=\"$onFocus\" onBlur=\"$onBlur\""; } if ($cell['onchange'] && $cell['type'] != 'button') // values != '1' can only set by a program (not in the editor so fa { $options .= ' onChange="'.($cell['onchange']=='1'?'this.form.submit();':$cell['onchange']).'"'; } } if ($form_name != '') { $options = "ID=\"$form_name\" $options"; } list($type,$sub_type) = explode('-',$cell['type']); switch ($type) { case 'label': // size: [[b]old][[i]talic][,link][,activate_links][,label_for] if (is_array($value)) break; list($style,$extra_link,$activate_links,$label_for) = explode(',',$cell_options); $value = strlen($value) > 1 && !$cell['no_lang'] ? lang($value) : $value; $value = nl2br($this->html->htmlspecialchars($value)); if ($activate_links) $value = $this->html->activate_links($value); if ($value != '' && strstr($style,'b')) $value = $this->html->bold($value); if ($value != '' && strstr($style,'i')) $value = $this->html->italic($value); $html .= $value; break; case 'html': $extra_link = $cell_options; $html .= $value; break; case 'int': // size: [min][,[max][,len]] case 'float': list($min,$max,$cell_options) = explode(',',$cell_options); if ($cell_options == '') { $cell_options = $cell['type'] == 'int' ? 5 : 8; } $cell_options .= ',,'.($cell['type'] == 'int' ? '/^-?[0-9]*$/' : '/^-?[0-9]*[,.]?[0-9]*$/'); // fall-through case 'text': // size: [length][,maxLength[,preg]] if ($readonly) { $html .= $this->html->bold($this->html->htmlspecialchars($value)); } else { $html .= $this->html->input($form_name,$value,'', $options.$this->html->formatOptions($cell_options,'SIZE,MAXLENGTH')); $cell_options = explode(',',$cell_options,3); $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = array( 'type' => $cell['type'], 'maxlength' => $cell_options[1], 'needed' => $cell['needed'], 'preg' => $cell_options[2], 'min' => $min, // int and float only 'max' => $max, ); } break; case 'textarea': // Multiline Text Input, size: [rows][,cols] $html .= $this->html->textarea($form_name,$value, $options.$this->html->formatOptions($cell_options,'ROWS,COLS')); if (!$readonly) { $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = array( 'type' => $cell['type'], 'needed' => $cell['needed'], ); } break; case 'htmlarea': // Multiline formatted Text Input, size: [inline styles for the widget][,plugins (comma-sep.)] if (!$readonly) { list($styles,$plugins) = explode(',',$cell_options,2); $html .= $this->html->htmlarea($form_name,$value,$styles,'',$plugins); $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = array( 'type' => $cell['type'], 'needed' => $cell['needed'], ); } else { $html .= $this->html->div($this->html->activate_links($value),'style="overflow: auto; border: thin inset black;'.$cell_options.'"'); } break; case 'checkbox': if (!empty($cell_options)) { list($true_val,$false_val,$ro_true,$ro_false) = explode(',',$cell_options); $value = $value == $true_val; } else { $ro_true = 'x'; $ro_false = ''; } if ($value) { $options .= ' checked="1"'; } if ($readonly) { $html .= $value ? $this->html->bold($ro_true) : $ro_false; } else { $html .= $this->html->input($form_name,'1','CHECKBOX',$options); $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = array( 'type' => $cell['type'], 'values' => $cell_options ); } break; case 'radio': // size: value if checked $set_val = $this->expand_name($cell_options,$show_c,$show_row,$content['.c'],$content['.row'],$content); if ($value == $set_val) { $options .= ' checked="1"'; } if ($readonly) { $html .= $value == $set_val ? $this->html->bold('x') : ''; } else { $html .= $this->html->input($form_name,$set_val,'RADIO',$options); $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = $cell['type']; } break; case 'button': case 'cancel': // cancel button list($app) = explode('.',$this->name); list($img,$ro_img) = explode(',',$cell_options); $title = strlen($label) <= 1 || $cell['no_lang'] ? $label : lang($label); if ($this->java_script() && ($cell['onchange'] != '' || $img && !$readonly) && !$cell['needed']) // use a link instead of a button { $onclick = ($cell['onchange'] == 1 || $img) ? "return submitit(document.eTemplate,'$form_name');" : $cell['onchange'].'; return false;'; if (!$this->html->netscape4 && substr($img,-1) == '%' && is_numeric($percent = substr($img,0,-1))) { $html .= $this->html->progressbar($percent,$title,'onclick="'.$onclick.'" '.$options); } else { $html .= '' . ($img ? $this->html->image($app,$img,$title,'border="0"') : $title) . ''; } } else { if (!empty($img)) { $options .= ' title="'.$title.'"'; } $html .= !$readonly ? $this->html->submit_button($form_name,$label,$cell['onchange'], strlen($label) <= 1 || $cell['no_lang'],$options,$img,$app) : $this->html->image($app,$ro_img); } $extra_label = False; if (!$readonly) { $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = $cell['type']; if (strtolower($name) == 'cancel') { $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = 'cancel'; } } break; case 'hrule': $html .= $this->html->hr($cell_options); break; case 'grid': if ($readonly) { if (!is_array($readonlys)) $readonlys = array(); $readonlys['__ALL__'] = True; } if ($name != '') { $cname .= $cname == '' ? $name : '['.str_replace('[','][',str_replace(']','',$name)).']'; } $html .= $this->show_grid($cell,$name ? $value : $content,$sel_options,$readonlys,$cname,$show_c,$show_row,$path); break; case 'template': // size: index in content-array (if not full content is past further on) if (is_object($cell['name'])) { $cell['obj'] = &$cell['name']; unset($cell['name']); $cell['name'] = 'was Object'; echo "

Object in Name in tpl '$this->name': "; _debug_array($grid); } $obj_read = 'already loaded'; if (!is_object($cell['obj'])) { if ($cell['name'][0] == '@') { $cell['obj'] = $this->get_array($content,substr($cell['name'],1)); $obj_read = is_object($cell['obj']) ? 'obj from content' : 'obj read, obj-name from content'; if (!is_object($cell['obj'])) { $cell['obj'] = new etemplate($cell['obj'],$this->as_array()); } } else { $obj_read = 'obj read'; $cell['obj'] = new etemplate($name,$this->as_array()); } } if (is_int($this->debug) && $this->debug >= 3 || $this->debug == $cell['type']) { echo "

show_cell::template(tpl=$this->name,name=$cell[name]): $obj_read

\n"; } if ($this->autorepeat_idx($cell,$show_c,$show_row,$idx,$idx_cname) || $cell_options != '') { if ($span == '' && isset($content[$idx]['span'])) { // this allows a colspan in autorepeated cells like the editor list($span) = explode(',',$content[$idx]['span']); if ($span == 'all') { $span = 1 + $content['cols'] - $show_c; } } $readonlys = $this->get_array($readonlys,$idx); //$readonlys[$idx]; $content = $this->get_array($content,$idx); // $content[$idx]; if ($idx_cname != '') { $cname .= $cname == '' ? $idx_cname : '['.str_replace('[','][',str_replace(']','',$idx_cname)).']'; } //echo "

show_cell-autorepeat($name,$show_c,$show_row,cname='$cname',idx='$idx',idx_cname='$idx_cname',span='$span'): content ="; _debug_array($content); } if ($readonly) { if (!is_array($readonlys)) $readonlys = array(); $readonlys['__ALL__'] = True; } // propagate our onclick handler to embeded templates, if they dont have their own if (!isset($cell['obj']->onclick_handler)) $cell['obj']->onclick_handler = $this->onclick_handler; if ($cell['obj']->no_onclick) { $cell['obj']->onclick_proxy = $this->onclick_proxy ? $this->onclick_proxy : $this->name.':'.$path; } $html = $cell['obj']->show($content,$sel_options,$readonlys,$cname,$show_c,$show_row); break; case 'select': // size:[linesOnMultiselect] $sels = array(); list($multiple) = explode(',',$cell_options); if (!empty($multiple) && 0+$multiple <= 0) { $sels[''] = $multiple < 0 ? 'all' : $multiple; // extra-option: no_lang=0 gets translated later and no_lang=1 gets translated too (now), only no_lang>1 gets not translated if ((int)$cell['no_lang'] == 1) { $sels[''] = lang($sels['']); } $multiple = 0; } if (!empty($cell['sel_options'])) { if (!is_array($cell['sel_options'])) { $opts = explode(',',$cell['sel_options']); while (list(,$opt) = each($opts)) { list($k,$v) = explode('=',$opt); $sels[$k] = $v; } } else { $sels += $cell['sel_options']; } } if (isset($sel_options[$name]) && is_array($sel_options[$name])) { $sels += $sel_options[$name]; } elseif (count($name_parts)) { $org_name = $name_parts[count($name_parts)-1]; if (isset($sel_options[$org_name]) && is_array($sel_options[$org_name])) { $sels += $sel_options[$org_name]; } elseif (isset($sel_options[$name_parts[0]]) && is_array($sel_options[$name_parts[0]])) { $sels += $sel_options[$name_parts[0]]; } } if (isset($content["options-$name"])) { $sels += $content["options-$name"]; } if ($readonly) { $html .= $cell['no_lang'] ? $sels[$value] : lang($sels[$value]); } else { $html .= $this->html->select($form_name.($multiple > 1 ? '[]' : ''),$value,$sels, $cell['no_lang'],$options,$multiple); if (!isset($GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name])) { $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = $cell['type']; } } break; case 'image': $image = $value != '' ? $value : $name; $image = $this->html->image(substr($this->name,0,strpos($this->name,'.')), $image,strlen($label) > 1 && !$cell['no_lang'] ? lang($label) : $label,'border="0"'); $html .= $image; $extra_link = $cell_options; $extra_label = False; break; case 'file': $html .= $this->html->input_hidden($path = str_replace($name,$name.'_path',$form_name),'.'); $html .= $this->html->input($form_name,'','file',$options); $GLOBALS['phpgw_info']['etemplate']['form_options'] = "enctype=\"multipart/form-data\" onSubmit=\"set_element2(this,'$path','$form_name')\""; $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = $cell['type']; break; case 'vbox': case 'hbox': case 'groupbox': case 'box': $rows = array(); $box_row = 1; $box_col = 'A'; $box_anz = 0; for ($n = 1; $n <= (int) $cell_options; ++$n) { $h = $this->show_cell($cell[$n],$content,$sel_options,$readonlys,$cname,$show_c,$show_row,$nul,$cl,$path.'/'.$n); if ($h != '' && $h != ' ') { if ($cell['type'] != 'hbox') { $box_row = $n; } else { $box_col = $this->num2chrs($n); } if ($cell['type'] == 'box') { $html .= $h; } else { $rows[$box_row][$box_col] = $html = $h; } $box_anz++; if ($cell[$n]['align']) { $rows[$box_row]['.'.$box_col] = $this->html->formatOptions($cell[$n]['align'],'ALIGN'); } $cl = $this->expand_name(isset($this->class_conf[$cl]) ? $this->class_conf[$cl] : $cl, $show_c,$show_row,$content['.c'],$content['.row'],$content); $rows[$box_row]['.'.$box_col] .= $this->html->formatOptions($cl,'CLASS'); } } if ($box_anz > 1 && $cell['type'] != 'box') // a single cell is NOT placed into a table { $html = $this->html->table($rows,$this->html->formatOptions($cell_options,',CELLPADDING,CELLSPACING'). ($cell['align'] && $type != 'hbox' ? ' WIDTH="100%"' : '')); // alignment only works if table has full width } if ($cell['type'] == 'groupbox') { if (strlen($label) > 1 && $cell['label'] == $label) { $label = lang($label); } $html = $this->html->fieldset($html,$label); } elseif ($cell['type'] == 'box') { $html = $this->html->div($html,$this->html->formatOptions(array( $cell['height'], $cell['width'], $cell['class'], ),'HEIGHT,WIDTH,CLASS')); } if ($box_anz > 1) // small docu in the html-source { $html = "\n\n\n\n".$html."\n\n\n\n"; } $extra_label = False; break; case 'deck': for ($n = 1; $n <= $cell_options && (empty($value) || $value != $cell[$n]['name']); ++$n) ; if ($n > $cell_options) { $value = $cell[1]['name']; } if ($s_width = $cell['width']) { $s_width = "width: $s_width".(substr($s_width,-1) != '%' ? 'px' : '').';'; } if ($s_height = $cell['height']) { $s_height = "height: $s_height".(substr($s_height,-1) != '%' ? 'px' : '').';'; } for ($n = 1; $n <= $cell_options; ++$n) { $h = $this->show_cell($cell[$n],$content,$sel_options,$readonlys,$cname,$show_c,$show_row,$path.'/'.$n); $vis = !empty($value) && $value == $cell_options[$n]['name'] || $n == 1 && $first ? 'visible' : 'hidden'; list (,$cl) = explode(',',$cell[$n]['span']); $html .= $this->html->div($h,$this->html->formatOptions(array( $cl.($cl ? ' ':'').'tab_body', "$s_width $s_height position: absolute; left: 0px; top: 0px; visibility: $vis; z-index: 50;", $cell[$n]['name'] ),'CLASS,STYLE,ID')); } $html .= $this->html->input_hidden($form_name,$value); // to store active plane list (,$cl) = explode(',',$cell['span']); $html = $this->html->input_hidden($form_name,$value)."\n". // to store active plane $this->html->div($html,$this->html->formatOptions(array( $cl, "$s_width $s_height position: relative; z-index: 100;" ),'CLASS,STYLE')); break; default: if ($ext_type && $this->haveExtension($ext_type,'render')) { $html .= $this->extensionRender($ext_type,$form_name,$value,$cell,$readonly); } else { $html .= "unknown type '$cell[type]'"; } break; } // extension-processing need to be after all other and only with diff. name if ($ext_type && !$readonly && $this->haveExtension($ext_type,'post_process')) { // unset it first, if it is already set, to be after the other widgets of the ext. unset($GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name]); $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = 'ext-'.$ext_type; } // save blur-value to strip it in process_exec if (!empty($blur) && isset($GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name])) { if (!is_array($GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name])) { $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] = array( 'type' => $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name] ); } $GLOBALS['phpgw_info']['etemplate']['to_process'][$form_name]['blur'] = $blur; } if ($extra_label && ($label != '' || $html == '')) { if (strlen($label) > 1 && !($cell['no_lang'] && $cell['label'] != $label || (int)$cell['no_lang'] == 2)) { $label = lang($label); } $accesskey = false; if (($accesskey = strstr($label,'&')) && $accesskey[1] != ' ' && $form_name != '' && (($pos = strpos($accesskey,';')) === False || $pos > 5)) { $label = str_replace('&'.$accesskey[1],''.$accesskey[1].'',$label); $accesskey = $accesskey[1]; } if ($accesskey || $label_for || $cell['name']) { $label = $this->html->label($label,$label_for ? $this->form_name($cname,$label_for) : $form_name,$accesskey); } if ($type == 'radio' || $type == 'checkbox' || strstr($label,'%s')) // default for radio is label after the button { $html = strstr($label,'%s') ? str_replace('%s',$html,$label) : $html.' '.$label; } elseif (($html = $label . ' ' . $html) == ' ') { $html = ' '; } } if ($extra_link) { $extra_link = $this->expand_name($extra_link,$show_c,$show_row,$content['.c'],$content['.row'],$content); if ($extra_link[0] == '@') { $extra_link = $this->get_array($content,substr($extra_link,1)); } if ($extra_link) { $options = " onMouseOver=\"self.status='".addslashes(lang($help))."'; return true;\""; $options .= " onMouseOut=\"self.status=''; return true;\""; return $this->html->a_href($html,$extra_link,'',$help != '' ? $options : ''); } } // if necessary show validation-error behind field if (isset($GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name])) { $html .= ' '.$GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name].''; } // generate an extra div, if we have an onclick handler and NO children or it's an extension //echo "

$this->name($this->onclick_handler:$this->no_onclick:$this->onclick_proxy): $cell[type]/$cell[name]

\n"; if ($this->onclick_handler && !isset($this->widgets_with_children[$cell['type']])) { $handler = str_replace('%p',$this->no_onclick ? $this->onclick_proxy : $this->name.':'.$path, $this->onclick_handler); if ($type == 'select') $html .= ' '; return $this->html->div($html,' ondblclick="'.$handler.'"','clickWidgetToEdit'); } return $html; } /** * applies stripslashes recursivly on each element of an array * * @param array &$var * @return array */ function array_stripslashes($var) { if (!is_array($var)) { return stripslashes($var); } foreach($var as $key => $val) { $var[$key] = is_array($val) ? $this->array_stripslashes($val) : stripslashes($val); } return $var; } /** * makes necessary adjustments on $_POST after a eTemplate / form gots submitted * * This is only an internal function, dont call it direct use only exec * Process_show uses a list of input-fields/widgets generated by show. * * @internal * @param array $content $_POST[$cname], on return the adjusted content * @param array $to_process list of widgets/form-fields to process * @param string $cname basename of our returnt content (same as in call to show) * @return int number of validation errors (the adjusted content is returned by the var-param &$content !) */ function process_show(&$content,$to_process,$cname='') { if (!isset($content) || !is_array($content) || !is_array($to_process)) { return; } if (is_int($this->debug) && $this->debug >= 1 || $this->debug == $this->name && $this->name) { echo "

process_show($this->name) cname='$cname' start: content ="; _debug_array($content); } $content_in = $cname ? array($cname => $content) : $content; $content = array(); if (get_magic_quotes_gpc()) { $content_in = $this->array_stripslashes($content_in); } $GLOBALS['phpgw_info']['etemplate']['validation_errors'] = array(); $this->canceled = $this->button_pressed = False; foreach($to_process as $form_name => $type) { if (is_array($type)) { $attr = $type; $type = $attr['type']; } else { $attr = array(); } $value = $this->get_array($content_in,$form_name,True); if (isset($attr['blur']) && $attr['blur'] == $value) { $value = ''; // blur-values is equal to emtpy } // echo "

process_show($this->name) $type: $form_name = '$value'

\n"; list($type,$sub) = explode('-',$type); switch ($type) { case 'ext': $_cont = &$this->get_array($content,$form_name,True); if (!$this->extensionPostProcess($sub,$form_name,$_cont,$value)) { $this->unset_array($content,$form_name); } // this else should NOT be unnecessary as $_cont is a reference to the index // $form_name of $content, but under some circumstances a set/changed $_cont // does not result in a change in $content -- RalfBecker 2004/09/18 elseif ($_cont && !$this->isset_array($content,$form_name)) { $this->set_array($content,$form_name,$_cont); } break; case 'htmlarea': $this->set_array($content,$form_name,$value); break; case 'int': case 'float': case 'text': case 'textarea': if ($value === '' && $attr['needed']) { $GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name] = lang('Field must not be empty !!!',$value); } if ((int) $attr['maxlength'] > 0 && strlen($value) > (int) $attr['maxlength']) { $value = substr($value,0,(int) $attr['maxlength']); } if ($attr['preg'] && !preg_match($attr['preg'],$value)) { switch($type) { case 'int': $GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name] = lang("'%1' is not a valid integer !!!",$value); break; case 'float': $GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name] = lang("'%1' is not a valid floatingpoint number !!!",$value); break; default: $GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name] = lang("'%1' has an invalid format !!!",$value); break; } } elseif ($type == 'int' || $type == 'float') // cast int and float and check range { if ($value !== '' || $attr['needed']) // empty values are Ok if needed is not set { $value = $type == 'int' ? (int) $value : (float) str_replace(',','.',$value); // allow for german (and maybe other) format if (!empty($attr['min']) && $value < $attr['min']) { $GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name] = lang("Value has to be at least '%1' !!!",$attr['min']); $value = $type == 'int' ? (int) $attr['min'] : (float) $attr['min']; } if (!empty($attr['max']) && $value > $attr['max']) { $GLOBALS['phpgw_info']['etemplate']['validation_errors'][$form_name] = lang("Value has to be at maximum '%1' !!!",$attr['max']); $value = $type == 'int' ? (int) $attr['max'] : (float) $attr['max']; } } } $this->set_array($content,$form_name,$value); break; case 'cancel': // cancel button ==> dont care for validation errors if ($value) { $this->canceled = True; $this->set_array($content,$form_name,$value); } break; case 'button': if ($value) { $this->button_pressed = True; $this->set_array($content,$form_name,$value); } break; case 'select': $this->set_array($content,$form_name,is_array($value) ? implode(',',$value) : $value); break; case 'checkbox': if (!isset($value)) // checkbox was not checked { $value = 0; // need to be reported too } if (!empty($attr['values'])) { list($true_val,$false_val) = explode(',',$attr['values']); $value = $value ? $true_val : $false_val; } $this->set_array($content,$form_name,$value); break; case 'file': $parts = explode('[',str_replace(']','',$form_name)); $name = array_shift($parts); $index = count($parts) ? '['.implode('][',$parts).']' : ''; $value = array(); foreach(array('tmp_name','type','size','name') as $part) { $value[$part] = is_array($_FILES[$name]) ? $this->get_array($_FILES[$name],$part.$index) : False; } $value['path'] = $this->get_array($content_in,substr($form_name,0,-1).'_path]'); $value['ip'] = get_var('REMOTE_ADDR',Array('SERVER')); if (function_exists('is_uploaded_file') && !is_uploaded_file($value['tmp_name'])) { $value = array(); // to be on the save side } //_debug_array($value); // fall-throught default: $this->set_array($content,$form_name,$value); break; } } if ($cname) { $content = $content[$cname]; } if (is_int($this->debug) && $this->debug >= 2 || $this->debug == $this->name && $this->name) { echo "

process_show($this->name) end: content ="; _debug_array($content); if (count($GLOBALS['phpgw_info']['etemplate']['validation_errors'])) { echo "

validation_errors = "; _debug_array($GLOBALS['phpgw_info']['etemplate']['validation_errors']); } } return count($GLOBALS['phpgw_info']['etemplate']['validation_errors']); } /** * is javascript enabled? * * this should be tested by the api at login * * @return boolean true if javascript is enabled or not yet tested and $consider_not_tested_as_enabled */ function java_script($consider_not_tested_as_enabled = True) { $ret = !!$GLOBALS['phpgw_info']['etemplate']['java_script'] || $consider_not_tested_as_enabled && !isset($GLOBALS['phpgw_info']['etemplate']['java_script']); //echo "

java_script($consider_not_tested_as_enabled)='$ret', java_script='".$GLOBALS['phpgw_info']['etemplate']['java_script']."', isset(java_script)=".isset($GLOBALS['phpgw_info']['etemplate']['java_script'])."

\n"; return $ret; return !!$GLOBALS['phpgw_info']['etemplate']['java_script'] || $consider_not_tested_as_enabled && (!isset($GLOBALS['phpgw_info']['etemplate']['java_script']) || $GLOBALS['phpgw_info']['etemplate']['java_script'].'' == ''); } /** * returns the javascript to be included by exec * * @param int $what &1 = returns the test, note: has to be included in the body, not the header, * &2 = returns the common functions, best to be included in the header * @return string javascript */ function include_java_script($what = 3) { // this is to test if javascript is enabled if ($what & 1 && !isset($GLOBALS['phpgw_info']['etemplate']['java_script'])) { $js = ' '; } // here are going all the necesarry functions if javascript is enabled if ($what & 2 && $this->java_script(True)) { $js .= ''; } return $js; } };