checkbox_multiselect('$name',".array2string($key).",".array2string($arr).",$no_lang,'$options',$multiple,$selected_first,'$style')

'; if (empty($font) && empty($font_size)) $font_span = ''; // we need to enable double encoding here, as ckEditor has to undo one level of encoding // otherwise < and > chars eg. from html markup entered in regular (not source) input, will turn into html! //error_log(__METHOD__.__LINE__.' '.Header\UserAgent::type().','.Header\UserAgent::version()); return self::textarea($_name,$_content,'id="'.htmlspecialchars($_name).'"',true). // true = double encoding ' '; } /** * this static function is a wrapper for tinymce to create some reuseable layouts * * Please note: if you did not run init_tinymce already you this static function need to be called before the call to phpgw_header() !!! * * @param string $_name name and id of the input-field * @param string $_mode display mode of the tinymce editor can be: simple, extended or advanced * @param string $_content ='' of the tinymce (will be run through htmlspecialchars !!!), default '' * @param string $_height ='400px' * @param string $_width ='100%' * @param boolean $_purify =true * @param string $_border ='0px' NOT used for CKEditor * @param mixed (boolean/string) $_focusToBody=false USED only for CKEDIOR true means yes, focus on top, you may specify TOP or BOTTOM (to focus on the end of the editor area) * @param string $_executeJSAfterInit ='' Javascript to be executed after InstanceReady of CKEditor * @return string the necessary html for the textarea */ static function fckEditorQuick($_name, $_mode, $_content='', $_height='400px', $_width='100%',$_purify=true, $_border='0px',$_focusToBody=false,$_executeJSAfterInit='') { if (!self::htmlarea_availible() || $_mode == 'ascii') { //TODO: use self::textarea return "$_content"; } else { return self::fckEditor($_name, $_content, $_mode, array(), $_height, $_width,'',$_purify,$_focusToBody,$_executeJSAfterInit); } } /** * represents html's input tag * * @param string $name name * @param string $value default value of the field * @param string $type type, default ''=not specified = text * @param string $options attributes for the tag, default ''=none */ static function input($name,$value='',$type='',$options='' ) { switch ((string)$type) { case ''; break; default: $type = 'type="'.htmlspecialchars($type).'"'; } return "\n"; } static protected $default_background_images = array( 'save' => '/save(&|\]|$)/', 'apply' => '/apply(&|\]|$)/', 'cancel' => '/cancel(&|\]|$)/', 'delete' => '/delete(&|\]|$)/', 'edit' => '/edit(&|\]|$)/', 'next' => '/(next|continue)(&|\]|$)/', 'finish' => '/finish(&|\]|$)/', 'back' => '/(back|previous)(&|\]|$)/', 'copy' => '/copy(&|\]|$)/', 'more' => '/more(&|\]|$)/', 'check' => '/(yes|check)(&|\]|$)/', 'cancelled' => '/no(&|\]|$)/', 'ok' => '/ok(&|\]|$)/', 'close' => '/close(&|\]|$)/', 'add' => '/(add(&|\]|$)|create)/', // customfields use create* ); static protected $default_classes = array( 'et2_button_cancel' => '/cancel(&|\]|$)/', // yellow 'et2_button_question' => '/(yes|no)(&|\]|$)/', // yellow 'et2_button_delete' => '/delete(&|\]|$)/' // red ); /** * represents html's button (input type submit or input type button or image) * * @param string $name name * @param string $label label of the button * @param string $onClick javascript to call, when button is clicked * @param boolean $no_lang NOT running the label through lang(), default false=use lang() * @param string $options attributes for the tag, default ''=none * @param string $image to show instead of the label, default ''=none * @param string $app app to search the image in * @param string $buttontype which type of html button (button|submit), default ='submit' * @return string html */ static function submit_button($name,$label,$onClick='',$no_lang=false,$options='',$image='',$app='phpgwapi', $buttontype='submit') { // workaround for idots and IE button problem (wrong cursor-image) if (Header\UserAgent::type() == 'msie') { $options .= ' style="cursor: pointer;"'; } // add et2_classes to "old" buttons $classes = array('et2_button'); if ($image != '') { $image = str_replace(array('.gif','.GIF','.png','.PNG'),'',$image); if (!($path = Image::find($app, $image))) { $path = $image; // name may already contain absolut path } $image = ' src="'.$path.'"'; $classes[] = 'image_button'; } if (!$no_lang) { $label = lang($label); } if (($accesskey = @strstr($label,'&')) && $accesskey[1] != ' ' && (($pos = strpos($accesskey,';')) === false || $pos > 5)) { $label_u = str_replace('&'.$accesskey[1],''.$accesskey[1].'',$label); $label = str_replace('&','',$label); $options .= ' accesskey="'.$accesskey[1].'" '.$options; } else { $accesskey = ''; $label_u = $label; } if ($onClick) $options .= ' onclick="'.str_replace('"','\\"',$onClick).'"'; // add default background-image to get et2 like buttons foreach(self::$default_background_images as $img => $reg_exp) { if (preg_match($reg_exp, $name) && ($url = Image::find($GLOBALS['egw_info']['flags']['currentapp'], $img))) { $options .= ' style="background-image: url('.$url.');"'; $classes[] = 'et2_button_with_image et2_button_text'; break; } } // add default class for cancel, delete or yes/no buttons foreach(self::$default_classes as $class => $reg_exp) { if (preg_match($reg_exp, $name)) { $classes[] = $class; break; } } if (strpos($options, 'class="') !== false) { $options = str_replace('class="', 'class="'.implode(' ', $classes).' ', $options); } else { $options .= ' class="'.implode(' ', $classes).'"'; } return ''. ($image != '' ? ' ' : ''). ($image == '' || $accesskey ? self::htmlspecialchars($label_u) : '').''; } /** * creates an absolut link + the query / get-variables * * Example link('/index.php?menuaction=infolog.uiinfolog.get_list',array('info_id' => 123)) * gives 'http://domain/phpgw-path/index.php?menuaction=infolog.uiinfolog.get_list&info_id=123' * * @param string $_url egw-relative link, may include query / get-vars * @param array|string $vars query or array ('name' => 'value', ...) with query * @return string absolut link already run through $phpgw->link */ static function link($_url,$vars='') { if (!is_array($vars)) { parse_str($vars,$vars); } list($url,$v) = explode('?', $_url); // url may contain additional vars if ($v) { parse_str($v,$v); $vars += $v; } return Framework::link($url,$vars); } /** * represents html checkbox * * @param string $name name * @param boolean $checked box checked on display * @param string $value value the var should be set to, default 'True' * @param string $options attributes for the tag, default ''=none * @return string html */ static function checkbox($name,$checked=false,$value='True',$options='') { return '\n"; } /** * represents a html form * * @param string $content of the form, if '' only the opening tag gets returned * @param array $hidden_vars array with name-value pairs for hidden input fields * @param string $_url eGW relative URL, will be run through the link function, if empty the current url is used * @param string|array $url_vars parameters for the URL, send to link static function too * @param string $name name of the form, defaul ''=none * @param string $options attributes for the tag, default ''=none * @param string $method method of the form, default 'POST' * @return string html */ static function form($content,$hidden_vars,$_url,$url_vars='',$name='',$options='',$method='POST') { $url = $_url ? self::link($_url, $url_vars) : $_SERVER['PHP_SELF'].'?'.$_SERVER['QUERY_STRING']; $html = "

\n"; $html .= self::input_hidden($hidden_vars); if ($content) { $html .= $content; $html .= "

\n"; } return $html; } /** * represents a html form with one button * * @param string $name name of the button * @param string $label label of the button * @param array $hidden_vars array with name-value pairs for hidden input fields * @param string $url eGW relative URL, will be run through the link function * @param string|array $url_vars parameters for the URL, send to link static function too * @param string $options attributes for the tag, default ''=none * @param string $form_name name of the form, defaul ''=none * @param string $method method of the form, default 'POST' * @return string html */ static function form_1button($name,$label,$hidden_vars,$url,$url_vars='',$form_name='',$method='POST') { return self::form(self::submit_button($name,$label),$hidden_vars,$url,$url_vars,$form_name,' style="display: inline-block"',$method); } const THEAD = 1; const TFOOT = 2; const TBODY = 3; static $part2tag = array( self::THEAD => 'thead', self::TFOOT => 'tfoot', self::TBODY => 'tbody', ); /** * creates table from array of rows * * abstracts the html stuff for the table creation * Example: $rows = array ( * 'h1' => array( // optional header row(s) * ), * 'f1' => array( // optional footer row(s) * ), * '1' => array( * 1 => 'cell1', '.1' => 'colspan=3', * 2 => 'cell2', * 3 => 'cell3', '.3' => 'width="10%"' * ),'.1' => 'BGCOLOR="#0000FF"' ); * table($rows,'width="100%"') = '

cell1

cell2

cell3

' * * @param array $rows with rows, each row is an array of the cols * @param string $options options for the table-tag * @param boolean $no_table_tr dont return the table- and outmost tr-tabs, default false=return table+tr * @return string with html-code of the table */ static function table($rows,$options = '',$no_table_tr=False) { $html = $no_table_tr ? '' : "\n"; $part = 0; foreach($rows as $key => $row) { if (!is_array($row)) { continue; // parameter } // get the current part from the optional 'h' or 'f' prefix of the key $p = $key[0] == 'h' ? self::THEAD : ($key[0] == 'f' ? self::TFOOT : self::TBODY); if ($part < $p && ($part || $p < self::TBODY)) // add only allowed and neccessary transitions { if ($part) $html .= '\n"; $html .= '<'.self::$part2tag[$part=$p].">\n"; } $html .= $no_table_tr && $key == 1 ? '' : "\t\n"; foreach($row as $key => $cell) { if ($key[0] == '.') { continue; // parameter } $table_pos = strpos($cell,'$cell\n"; } } $html .= "\t\n"; } if (!is_array($rows)) { echo "

".function_backtrace()."

\n"; } if ($part) // close current part { $html .= "\n"; } $html .= "\n"; if ($no_table_tr) { $html = substr($html,0,-16); } return $html; } /** * changes a selectbox to submit the form if it gets changed, to be used with the sbox-class * * @param string $sbox html with the select-box * @param boolean $no_script if true generate a submit-button if javascript is off * @return string html */ static function sbox_submit( $sbox,$no_script=false ) { $html = str_replace('').''; } return $html; } /** * html-widget showing progessbar with a view div's (html4 only, textual percentage otherwise) * * @param mixed $_percent percent-value, gets casted to int * @param string $_title title for the progressbar, default ''=the percentage itself * @param string $options attributes for the outmost div (may include onclick="...") * @param string $width width, default 30px * @param string $color color, default '#D00000' (dark red) * @param string $height height, default 5px * @return string html */ static function progressbar($_percent, $_title='',$options='',$width='',$color='',$height='' ) { $percent = (int)$_percent; if (!$width) $width = '30px'; if (!$height)$height= '5px'; if (!$color) $color = '#D00000'; $title = $_title ? self::htmlspecialchars($_title) : $percent.'%'; if (self::$netscape4) { return $title; } return '

'.$title.'

'."\n\t". '

'."\n

\n"; } /** * representates a html img tag, output a picture * * If the name ends with a '%' and the rest is numeric, a progressionbar is shown instead of an image. * The vfs:/ pseudo protocoll allows to access images in the vfs, eg. vfs:/home/ralf/me.png * Instead of a name you specify an array with get-vars, it is passed to eGW's link function. * This way session-information gets passed, eg. $name=array('menuaction'=>'myapp.class.image','id'=>123). * * @param string $app app-name to search the image * @param string|array $name image-name or URL (incl. vfs:/) or array with get-vars * @param string $title tooltip, default '' = none * @param string $options further options for the tag, default '' = none * @return string the html */ static function image( $app,$name,$title='',$options='' ) { if (is_array($name)) // menuaction and other get-vars { $name = $GLOBALS['egw']->link('/index.php',$name); } if (substr($name,0,5) == 'vfs:/') // vfs pseudo protocoll { $name = Framework::link(Vfs::download_url(substr($name,4))); } if ($name[0] == '/' || substr($name,0,7) == 'http://' || substr($name,0,8) == 'https://' || stripos($name,'api/thumbnail.php') ) { if (!($name[0] == '/' || substr($name,0,7) == 'http://' || substr($name,0,8) == 'https://')) $name = '/'.$name; $url = $name; } else // no URL, so try searching the image { $name = str_replace(array('.gif','.GIF','.png','.PNG'),'',$name); if (!($url = Image::find($app,$name))) { $url = $name; // name may already contain absolut path } if($GLOBALS['egw_info']['server']['webserver_url']) { list(,$path) = explode($GLOBALS['egw_info']['server']['webserver_url'],$url); if (!is_null($path)) $path = EGW_SERVER_ROOT.$path; } else { $path = EGW_SERVER_ROOT.$url; } if (is_null($path) || (!@is_readable($path) && stripos($path,'webdav.php')===false)) { // if the image-name is a percentage, use a progressbar if (substr($name,-1) == '%' && is_numeric($percent = substr($name,0,-1))) { return self::progressbar($percent,$title); } return $title; } } if ($title) { $options .= ' title="'.self::htmlspecialchars($title).'"'; } // This block makes pngfix.js useless, adding a check on disable_pngfix to have pngfix.js do its thing if (Header\UserAgent::type() == 'msie' && Header\UserAgent::version() < 7.0 && substr($url,-4) == '.png' && ($GLOBALS['egw_info']['user']['preferences']['common']['disable_pngfix'] || !isset($GLOBALS['egw_info']['user']['preferences']['common']['disable_pngfix']))) { $extra_styles = "display: inline-block; filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='$url',sizingMethod='image'); width: 1px; height: 1px;"; if (false!==strpos($options,'style="')) { $options = str_replace('style="','style="'.$extra_styles, $options); } else { $options .= ' style="'.$extra_styles.'"'; } return ""; } return ""; } /** * representates a html link * * @param string $content of the link, if '' only the opening tag gets returned * @param string $url eGW relative URL, will be run through the link function * @param string|array $vars parameters for the URL, send to link static function too * @param string $options attributes for the tag, default ''=none * @return string the html */ static function a_href( $content,$url,$vars='',$options='') { if (is_array($url)) { $vars = $url; $url = '/index.php'; } elseif (strpos($url,'/')===false && count(explode('.',$url)) >= 3 && !(strpos($url,'mailto:')!==false || strpos($url,'://')!==false || strpos($url,'javascript:')!==false)) { $url = "/index.php?menuaction=$url"; } if ($url[0] == '/') // link relative to eGW { $url = self::link($url,$vars); } //echo "

self::a_href('".self::htmlspecialchars($content)."','$url',".print_r($vars,True).") = ".self::link($url,$vars)."

"; return ''.$content.''; } /** * representates a b tag (bold) * * @param string $content of the link, if '' only the opening tag gets returned * @return string the html */ static function bold($content) { return ''.($content?$content.'':''); } /** * representates a hr tag (horizontal rule) * * @param string $width default ''=none given * @param string $options attributes for the tag, default ''=none * @return string the html */ static function hr($width='',$options='') { if ($width) $options .= " width=\"$width\""; return "

---

\n"; } /** * formats option-string for most of the above functions * * Example: formatOptions('100%,,1','width,height,border') = ' width="100%" border="1"' * * @param mixed $options String (or Array) with option-values eg. '100%,,1' * @param mixed $names String (or Array) with the option-names eg. 'WIDTH,HEIGHT,BORDER' * @return string with options/attributes */ static function formatOptions($options,$names) { if (!is_array($options)) $options = explode(',',$options); if (!is_array($names)) $names = explode(',',$names); foreach($options as $n => $val) { if ($val != '' && $names[$n] != '') { $html .= ' '.strtolower($names[$n]).'="'.$val.'"'; } } return $html; } /** * html style tag (incl. type) * * @param string $styles css-style definitions * @return string html */ static function style($styles) { return $styles ? "" : ''; } /** * html label tag * * @param string $content the label * @param string $id for the for attribute, default ''=none * @param string $accesskey accesskey, default ''=none * @param string $options attributes for the tag, default ''=none * @return string the html */ static function label($content,$id='',$accesskey='',$options='') { if ($id != '') { $id = " for=\"$id\""; } if ($accesskey != '') { $accesskey = " accesskey=\"$accesskey\""; } return "$content"; } /** * html fieldset, eg. groups a group of radiobuttons * * @param string $content the content * @param string $legend legend / label of the fieldset, default ''=none * @param string $options attributes for the tag, default ''=none * @return string the html */ static function fieldset($content,$legend='',$options='') { $html = "

".($legend ? '

'.self::htmlspecialchars($legend).'

' : '')."\n"; if ($content) { $html .= $content; $html .= "\n

\n"; } return $html; } /** * tree widget using dhtmlXtree * * Code inspired by Lars's Felamimail uiwidgets::createFolderTree() * * @author Lars Kneschke original code in felamimail * @param array $_folders array of folders: pairs path => node (string label or array with keys: label, (optional) image, (optional) title, (optional) checked) * @param string $_selected path of selected folder * @param mixed $_topFolder =false node of topFolder or false for none * @param string $_onNodeSelect ='alert' js static function to call if node gets selected * @param string $tree ='foldertree' id of the div and name of the variable containing the tree object * @param string $_divClass ='' css class of the div * @param string $_leafImage ='' default image of a leaf-node, ''=default of foldertree, set it eg. 'folderClosed.gif' to show leafs as folders * @param boolean|string $_onCheckHandler =false string with handler-name to display a checkbox for each folder, or false (default), 'null' switches checkboxes on without an handler! * @param string $delimiter ='/' path-delimiter, default / * @param string $folderImageDir =null string path to the tree menu images, null uses default path * @param string|array $autoLoading =null EGw relative path or array with get parameter, both send through Framework::link * @param string $dataMode ='JSON' data type for autoloading: XML, JSON, CSV * @param boolean $dragndrop =false true to enable drag-n-drop (must be before autoloading get enabled!) * * @return string the html code, to be added into the template */ static function tree($_folders,$_selected,$_topFolder=false,$_onNodeSelect="null",$tree='foldertree',$_divClass='', $_leafImage='',$_onCheckHandler=false,$delimiter='/',$folderImageDir=null,$autoLoading=null,$dataMode='JSON', $dragndrop=false) { $webserver_url = $GLOBALS['egw_info']['server']['webserver_url']; if (empty($folderImageDir)) { $folderImageDir = $webserver_url.'/phpgwapi/templates/default/images'; } // check if we have template-set specific image path $image_path = $folderImageDir; if ($webserver_url && $webserver_url != '/') { list(,$image_path) = explode($webserver_url, $image_path, 2); } $templated_path = strtr($image_path, array( '/phpgwapi/templates/default' => $GLOBALS['egw']->framework->template_dir, '/default/' => '/'.$GLOBALS['egw']->framework->template.'/', )); if (file_exists(EGW_SERVER_ROOT.$templated_path.'/dhtmlxtree')) { $folderImageDir = ($webserver_url != '/' ? $webserver_url : '').$templated_path; //error_log(__METHOD__."() setting templated image-path: $folderImageDir"); } static $tree_initialised=false; if (!$tree_initialised) { Framework::includeCSS('/api/js/dhtmlxtree/codebase/dhtmlxtree.css'); Framework::includeJS('/api/js/dhtmlxtree/codebase/dhtmlxcommon.js'); Framework::includeJS('/api/js/dhtmlxtree/sources/dhtmlxtree.js'); if ($autoLoading && $dataMode != 'XML') Framework::includeJS('/api/js/dhtmlxtree/sources/ext/dhtmlxtree_json.js'); $tree_initialised = true; if (!$_folders && !$autoLoading) return null; } $html = self::div("\n",'id="'.$tree.'"',$_divClass).$html; $html .= "\n"; } } $top = 0; if ($_topFolder) { $top = '--topfolder--'; $topImage = ''; if (is_array($_topFolder)) { $label = $_topFolder['label']; if (isset($_topFolder['image'])) { $topImage = $_topFolder['image']; } } else { $label = $_topFolder; } $html .= "\n$tree.insertNewItem(0,'$top','".addslashes($label)."',$_onNodeSelect,'$topImage','$topImage','$topImage','CHILD,TOP');\n"; if (is_array($_topFolder) && isset($_topFolder['title'])) { $html .= "$tree.setItemText('$top','".addslashes($label)."','".addslashes($_topFolder['title'])."');\n"; } } if (is_string($_folders)) { switch($dataMode) { case 'JSON': $html .= "$tree.loadJSONObject($_folders);\n"; break; case 'XML': $html .= "$tree.loadXMLString('$_folders');\n"; break; } } else { // evtl. remove leading delimiter if ($_selected[0] == $delimiter) $_selected = substr($_selected,1); $n = 0; foreach($_folders as $path => $data) { if (!is_array($data)) { $data = array('label' => $data); } $image1 = $image2 = $image3 = '0'; // if _leafImage given, set it only for leaves, not for folders containing children if ($_leafImage) { $image1 = $image2 = $image3 = "'".$_leafImage."'"; if (($next_item = array_slice($_folders, $n+1, 1, true))) { list($next_path) = each($next_item); if (substr($next_path,0,strlen($path)+1) == $path.'/') { $image1 = $image2 = $image3 = '0'; } } } if (isset($data['image'])) { $image1 = $image2 = $image3 = "'".$data['image']."'"; } // evtl. remove leading delimiter if ($path[0] == $delimiter) $path = substr($path,1); $folderParts = explode($delimiter,$path); //get rightmost folderpart $label = array_pop($folderParts); if (isset($data['label'])) $label = $data['label']; // the rest of the array is the name of the parent $parentName = implode((array)$folderParts,$delimiter); if(empty($parentName)) $parentName = $top; $entryOptions = !isset($data['child']) || $data['child'] ? 'CHILD' : ''; if ($_onCheckHandler && $_selected) // check selected items on multi selection { if (!is_array($_selected)) $_selected = explode(',',$_selected); if (array_search("$path",$_selected)!==false) $entryOptions .= ',CHECKED'; //echo "

path=$path, _selected=".print_r($_selected,true).": $entryOptions

\n"; } // highlight current item elseif ((string)$_selected === (string)$path) { $entryOptions .= ',SELECT'; } $html .= "$tree.insertNewItem('".addslashes($parentName)."','".addslashes($path)."','".addslashes($label). "',$_onNodeSelect,$image1,$image2,$image3,'$entryOptions');\n"; if (isset($data['title'])) { $html .= "$tree.setItemText('".addslashes($path)."','".addslashes($label)."','".addslashes($data['title'])."');\n"; } ++$n; } } $html .= "$tree.closeAllItems(0);\n"; if ($_selected) { foreach(is_array($_selected)?$_selected:array($_selected) as $path) { $html .= "$tree.openItem('".addslashes($path)."');\n"; } } else { $html .= "$tree.openItem('$top');\n"; } $html .= "});"; $html .= "\n"; return $html; } /** * Runs HTMLPurifier over supplied html to remove malicious code * * @param string $html * @param array|string $config =null - config to influence the behavior of current purifying engine * @param array|string $spec =null - spec to influence the behavior of current purifying engine * The $spec argument can be used to disallow an otherwise legal attribute for an element, * or to restrict the attribute's values * @param boolean $_force =null - force the config passed to be used without merging to the default */ static function purify($html,$config=null,$spec=array(),$_force=false) { return Html\HtmLawed::purify($html, $config, $spec, $_force); } }