forked from extern/egroupware
834 lines
29 KiB
PHP
834 lines
29 KiB
PHP
<?php
|
|
/**************************************************************************\
|
|
* eGroupWare - EditableTemplates - Buiseness Objects *
|
|
* http://www.eGroupWare.org *
|
|
* Written by Ralf Becker <RalfBecker@outdoor-training.de> *
|
|
* -------------------------------------------- *
|
|
* 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.soetemplate.inc.php');
|
|
|
|
/*!
|
|
@class boetemplate
|
|
@author ralfbecker
|
|
@abstract Buiseness Objects for eTemplates
|
|
@discussion Not so much so far, as the most logic is still in the UI-class
|
|
@param $types,$alings converts internal names/values to (more) human readible ones
|
|
*/
|
|
class boetemplate extends soetemplate
|
|
{
|
|
var $extensions = array();
|
|
|
|
var $types = array(
|
|
'label' => 'Label', // Label $cell['label'] is (to be translated) textual content
|
|
'text' => 'Text', // Textfield 1 Line (size = [length][,maxlength])
|
|
'int' => 'Integer', // like text, but only numbers (size = [min][,max])
|
|
'float' => 'Floating Point', // --------------- " --------------------------
|
|
'textarea'=> 'Textarea', // Multiline Text Input (size = [rows][,cols])
|
|
'htmlarea' => 'Formatted Text (HTML)',
|
|
'checkbox'=> 'Checkbox',
|
|
'radio' => 'Radiobutton', // Radiobutton (size = value if checked)
|
|
'button' => 'Submitbutton',
|
|
'hrule' => 'Horizontal Rule',
|
|
'template'=> 'Template', // $cell['name'] contains template-name, $cell['size'] index into $content,$cname,$readonlys
|
|
'image' => 'Image', // label = url, name=link or method, help=alt or title
|
|
'date' => '', // Datefield, size='' timestamp or size=format like 'm/d/Y'
|
|
'select' => 'Selectbox', // Selectbox ($sel_options[$name] or $content[options-$name] is array with options)
|
|
// if size > 1 then multiple selections, size lines showed
|
|
'html' => 'Html', // Raw html in $content[$cell['name']]
|
|
'file' => 'FileUpload', // show an input type='file', set the local name as ${name}_path
|
|
'vbox' => 'VBox', // a (vertical) box to contain widgets in rows, size = # of rows
|
|
'hbox' => 'HBox', // a (horizontal) box to contain widgets in cols, size = # of cols
|
|
'deck' => 'Deck' // a container of elements where only one is visible, size = # of elem.
|
|
);
|
|
/*!
|
|
@function boetemplate
|
|
@abstract constructor of class
|
|
@param $name name of etemplate or array with name and other keys
|
|
@param $load_via name/array with keys of other etemplate to load in order to get $name
|
|
@discussion Calls the constructor of soetemplate
|
|
*/
|
|
function boetemplate($name='',$load_via='')
|
|
{
|
|
$this->public_functions += array(
|
|
'set_row_attribute' => True,
|
|
'disable_row' => True,
|
|
'set_column_attribute' => True,
|
|
'disable_column' => True,
|
|
'disable_cells' => True,
|
|
'set_cell_attribute' => True,
|
|
'get_cell_attribute' => True,
|
|
'get_array' => True,
|
|
'set_array' => True,
|
|
'unset_array' => True
|
|
);
|
|
$this->soetemplate();
|
|
|
|
$tname = &$name;
|
|
if (is_array($name))
|
|
{
|
|
$tname = &$name['name'];
|
|
}
|
|
$tname = (strstr($tname,'.') === False && !empty($tname) ?
|
|
(is_array($load_via) ? $load_via['name'] : $load_via).'.':'').$tname;
|
|
|
|
if (empty($tname) || !$this->read($name,'','',0,'',$load_via))
|
|
{
|
|
$this->init($name);
|
|
}
|
|
}
|
|
|
|
/*!
|
|
@function expand_name
|
|
@syntax expand_name( $name,$c,$row,$c_='',$row_='',$cont='' )
|
|
@author ralfbecker
|
|
@abstract allows a few variables (eg. row-number) to be used in field-names
|
|
@discussion This is mainly used for autorepeat, but other use is possible.
|
|
@discussion You need to be aware of the rules PHP uses to expand vars in strings, a name
|
|
@discussion of "Row$row[length]" will expand to 'Row' as $row is scalar, you need to use
|
|
@discussion "Row${row}[length]" instead. Only one indirection is allowd in a string by php !!!
|
|
@discussion Out of that reason we have now the variable $row_cont, which is $cont[$row] too.
|
|
@discussion Attention !!!
|
|
@discussion Using only number as index in field-names causes a lot trouble, as depending
|
|
@discussion on the variable type (which php determines itself) you used filling and later
|
|
@discussion accessing the array it can by the index or the key of an array element.
|
|
@discussion To make it short and clear, use "Row$row" or "$col$row" not "$row" or "$row$col" !!!
|
|
@param $name the name to expand
|
|
@param $c is the column index starting with 0 (if you have row-headers, data-cells start at 1)
|
|
@param $row is the row number starting with 0 (if you have col-headers, data-cells start at 1)
|
|
@param $c_, $row_ are the respective values of the previous template-inclusion,
|
|
@param eg. the column-headers in the eTemplate-editor are templates itself,
|
|
@param to show the column-name in the header you can not use $col as it will
|
|
@param be constant as it is always the same col in the header-template,
|
|
@param what you want is the value of the previous template-inclusion.
|
|
@param $cont content array of the template, you might use it to generate button-names with
|
|
@param id values in it: "del[$cont[id]]" expands to "del[123]" if $cont = array('id' => 123)
|
|
*/
|
|
function expand_name($name,$c,$row,$c_='',$row_='',$cont='')
|
|
{
|
|
if (strstr($name,'$') !== False)
|
|
{
|
|
if (!$cont)
|
|
{
|
|
$cont = array();
|
|
}
|
|
$col = $this->num2chrs($c-1); // $c-1 to get: 0:'@', 1:'A', ...
|
|
$col_ = $this->num2chrs($c_-1);
|
|
$row_cont = $cont[$row];
|
|
$col_row_cont = $cont[$col.$row];
|
|
|
|
eval('$name = "'.$name.'";');
|
|
}
|
|
if ($name[0] == '@')
|
|
{
|
|
$name = $this->get_array($cont,substr($name,1));
|
|
}
|
|
return $name;
|
|
}
|
|
|
|
/*!
|
|
@function autorepeat_idx
|
|
@abstract Checks if we have an row- or column autorepeat and sets the indexes for $content, etc.
|
|
@discussion Autorepeat is important to allow a variable numer of rows or cols, eg. for a list.
|
|
@discussion The eTemplate has only one (have to be the last) row or column, which gets
|
|
@discussion automaticaly repeated as long as content is availible. To check this the content
|
|
@discussion has to be in an sub-array of content. The index / subscript into content is
|
|
@discussion determined by the content of size for templates or name for regular fields.
|
|
@discussion An autorepeat is defined by an index which contains variables to expand.
|
|
@discussion (vor variable expansion in names see expand_names). Usually I use the keys
|
|
@discussion $row: 0, 1, 2, 3, ... for only rows, $col: '@', 'A', 'B', 'C', ... for only cols or
|
|
@discussion $col$row: '@0','A0',... '@1','A1','B1',... '@2','A2','B2',... for both rows and cells.
|
|
@discussion In general everything expand_names can generate is ok - see there.
|
|
@discussion As you usually have col- and row-headers, data-cells start with '1' or 'A' !!!
|
|
@syntax autorepeat_idx($cell,$c,$r,&$idx,&$idx_cname,$check_col=False)
|
|
@param $cell array with data of cell: name, type, size, ...
|
|
@param $c,$r col/row index starting from 0
|
|
@param &$idx returns the index in $content and $readonlys (NOT $sel_options !!!)
|
|
@param &$idx_cname returns the basename for the form-name: is $idx if only one value
|
|
@param (no ',') is given in size (name (not template-fields) are always only one value)
|
|
@param $check_col boolean to check for col- or row-autorepeat
|
|
@result true if cell is autorepeat (has index with vars / '$') or false otherwise
|
|
*/
|
|
function autorepeat_idx($cell,$c,$r,&$idx,&$idx_cname,$check_col=False)
|
|
{
|
|
$org_idx = $idx = $cell[ $cell['type'] == 'template' ? 'size' : 'name' ];
|
|
|
|
$idx = $this->expand_name($idx,$c,$r);
|
|
if (!($komma = strpos($idx,',')))
|
|
{
|
|
$idx_cname = $idx;
|
|
}
|
|
else
|
|
{
|
|
$idx_cname = substr($idx,1+$komma);
|
|
$idx = substr($idx,0,$komma);
|
|
}
|
|
$Ok = False;
|
|
$pat = $org_idx;
|
|
while (!$Ok && ($pat = strstr($pat,'$')))
|
|
{
|
|
$pat = substr($pat,$pat[1] == '{' ? 2 : 1);
|
|
|
|
if ($check_col)
|
|
{
|
|
$Ok = $pat[0] == 'c' && !(substr($pat,0,4) == 'cont' ||
|
|
substr($pat,0,2) == 'c_' || substr($pat,0,4) == 'col_');
|
|
}
|
|
else
|
|
{
|
|
$Ok = $pat[0] == 'r' && !(substr($pat,0,2) == 'r_' ||
|
|
substr($pat,0,4) == 'row_' && substr($pat,0,8) != 'row_cont');
|
|
}
|
|
}
|
|
if ($this->name && $this->name == $this->debug)
|
|
{
|
|
echo "$this->name ".($check_col ? 'col' : 'row')."-check: c=$c, r=$r, idx='$org_idx'='$idx' idx_cname='$idx_cname' ==> ".($Ok?'True':'False')."<p>\n";
|
|
}
|
|
return $Ok;
|
|
}
|
|
|
|
/*!
|
|
@function appsession_id
|
|
@syntax appsession_id( )
|
|
@author ralfbecker
|
|
@abstract creates a new appsession-id via microtime()
|
|
*/
|
|
function appsession_id()
|
|
{
|
|
list($msec,$sec) = explode(' ',microtime());
|
|
$id = $GLOBALS['phpgw_info']['flags']['currentapp'] . (intval(1000000 * $msec) + 1000000 * ($sec % 100000));
|
|
//echo "<p>microtime()=".microtime().", sec=$sec, msec=$msec, id=$id</p>\n";
|
|
return $id;
|
|
}
|
|
|
|
/*!
|
|
@functin appsession
|
|
@syntax appsession($location = 'default', $appname = '', $data = '##NOTHING##')
|
|
@abstract db-sessions appsession function
|
|
@note It is used to overcome the problem with overflowing php4-sessions
|
|
*/
|
|
function appsession($location = 'default', $appname = '', $data = '##NOTHING##')
|
|
{
|
|
// use the version from the sessions-class if we use db-sessions
|
|
//
|
|
if ($GLOBALS['phpgw_info']['server']['sessions_type'] == 'db')
|
|
{
|
|
return $GLOBALS['phpgw']->session->appsession($location,$appname,$data);
|
|
}
|
|
// if not, we use or own copy of the appsessions function
|
|
// setting these class vars to be compatible with the session-class
|
|
//
|
|
$this->sessionid = $GLOBALS['phpgw']->session->sessionid;
|
|
$this->account_id = $GLOBALS['phpgw']->session->account_id;
|
|
|
|
if (! $appname)
|
|
{
|
|
$appname = $GLOBALS['phpgw_info']['flags']['currentapp'];
|
|
}
|
|
|
|
if ($data == '##NOTHING##')
|
|
{
|
|
$query = "SELECT content FROM phpgw_app_sessions WHERE"
|
|
." sessionid='".$this->sessionid."' AND loginid='".$this->account_id."'"
|
|
." AND app = '".$appname."' AND location='".$location."'";
|
|
|
|
$GLOBALS['phpgw']->db->query($query,__LINE__,__FILE__);
|
|
$GLOBALS['phpgw']->db->next_record();
|
|
|
|
// I added these into seperate steps for easier debugging
|
|
$data = $GLOBALS['phpgw']->db->f('content');
|
|
// Changed by Skeeter 2001 Mar 04 0400Z
|
|
// This was not properly decoding structures saved into session data properly
|
|
// $data = $GLOBALS['phpgw']->common->decrypt($data);
|
|
// return stripslashes($data);
|
|
// Changed by milosch 2001 Dec 20
|
|
// do not stripslashes here unless this proves to be a problem.
|
|
// Changed by milosch 2001 Dec 25
|
|
/* do not decrypt and return if no data (decrypt returning garbage) */
|
|
if($data)
|
|
{
|
|
$data = $GLOBALS['phpgw']->crypto->decrypt($data);
|
|
// echo 'appsession returning: '; _debug_array($data);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
$GLOBALS['phpgw']->db->query("SELECT content FROM phpgw_app_sessions WHERE "
|
|
. "sessionid = '".$this->sessionid."' AND loginid = '".$this->account_id."'"
|
|
. " AND app = '".$appname."' AND location = '".$location."'",__LINE__,__FILE__);
|
|
|
|
$encrypteddata = $GLOBALS['phpgw']->crypto->encrypt($data);
|
|
$encrypteddata = $GLOBALS['phpgw']->db->db_addslashes($encrypteddata);
|
|
|
|
if ($GLOBALS['phpgw']->db->num_rows()==0)
|
|
{
|
|
$GLOBALS['phpgw']->db->query("INSERT INTO phpgw_app_sessions (sessionid,loginid,app,location,content,session_dla) "
|
|
. "VALUES ('".$this->sessionid."','".$this->account_id."','".$appname
|
|
. "','".$location."','".$encrypteddata."','" . time() . "')",__LINE__,__FILE__);
|
|
}
|
|
else
|
|
{
|
|
$GLOBALS['phpgw']->db->query("UPDATE phpgw_app_sessions SET content='".$encrypteddata."'"
|
|
. "WHERE sessionid = '".$this->sessionid."'"
|
|
. "AND loginid = '".$this->account_id."' AND app = '".$appname."'"
|
|
. "AND location = '".$location."'",__LINE__,__FILE__);
|
|
}
|
|
}
|
|
// we need to clean up not longer used records, else the db gets bigger and bigger
|
|
//
|
|
$GLOBALS['phpgw']->db->query("DELETE FROM phpgw_app_sessions WHERE session_dla <= '" . (time() - $GLOBALS['phpgw_info']['server']['sessions_timeout'])
|
|
. "'",__LINE__,__FILE__);
|
|
|
|
return $data;
|
|
}
|
|
|
|
/*!
|
|
@function save_appsession
|
|
@syntax save_appsession( $data,$id='' )
|
|
@author ralfbecker
|
|
@abstract saves content,readonlys,template-keys, ... via the appsession function
|
|
@discussion As a user may open several windows with the same content/template wie generate a location-id from microtime
|
|
@discussion which is used as location for appsession to descriminate between the different windows. This location-id
|
|
@discussion is then saved as a hidden-var in the form. The above mentions session-id has nothing to do / is different
|
|
@discussion from the session-id which is constant for all windows opened in one session.
|
|
@param $data the data to save
|
|
@param $id the id to use or '' to generate a new id
|
|
@result the location-id
|
|
*/
|
|
function save_appsession($data,$id='')
|
|
{
|
|
if (!$id)
|
|
{
|
|
$id = $this->appsession_id;
|
|
}
|
|
$this/*GLOBALS['phpgw']->session*/->appsession($id,'etemplate',$data);
|
|
|
|
return $id;
|
|
}
|
|
|
|
/*!
|
|
@function get_appsession
|
|
@syntax get_appsession( $id )
|
|
@author ralfbecker
|
|
@abstract gets content,readonlys,template-keys, ... back from the appsession function
|
|
@param $id the location-id
|
|
@result the session-data
|
|
*/
|
|
function get_appsession($id)
|
|
{
|
|
$data = $this/*GLOBALS['phpgw']->session*/->appsession($id,'etemplate');
|
|
|
|
//echo "<p>get_appsession('$id') data="; _debug_array($data);
|
|
|
|
// if we delete the returned value here, we cant get back (back-button),
|
|
// not even to a non-submitted page
|
|
//$GLOBALS['phpgw']->session->appsession_delete($id,'etemplate');
|
|
|
|
return $data;
|
|
}
|
|
|
|
/*!
|
|
@function get_cell_attribute
|
|
@syntax get_cell_attribute( $name,$attr )
|
|
@author ralfbecker
|
|
@abstract gets an attribute in a named cell
|
|
@result the attribute or False if named cell not found
|
|
*/
|
|
function get_cell_attribute($name,$attr)
|
|
{
|
|
reset($this->data);
|
|
while(list($row,$cols) = each($this->data))
|
|
{
|
|
while(list($col,$cell) = each($cols))
|
|
{
|
|
if ($cell['name'] == $name)
|
|
{
|
|
reset($this->data);
|
|
return $this->data[$row][$col][$attr];
|
|
}
|
|
}
|
|
}
|
|
reset($this->data);
|
|
|
|
return False;
|
|
}
|
|
|
|
/*!
|
|
@function set_cell_attribute
|
|
@syntax set_cell_attribute( $name,$attr,$val )
|
|
@author ralfbecker
|
|
@abstract set an attribute in a named cell
|
|
@result the number of changed cells
|
|
*/
|
|
function set_cell_attribute($name,$attr,$val)
|
|
{
|
|
//echo "<p>set_cell_attribute(tpl->name=$this->name, name='$name', attr='$attr',val='$val')</p>\n";
|
|
|
|
$n = 0;
|
|
foreach($this->data as $row => $cols)
|
|
{
|
|
foreach($cols as $col => $cell)
|
|
{
|
|
if ($cell['name'] == $name)
|
|
{
|
|
$this->data[$row][$col][$attr] = $val;
|
|
++$n;
|
|
}
|
|
if ($cell['type'] == 'template' && (is_object($cell['obj']) || $cell['name'][0] != '@'))
|
|
{
|
|
if (!is_object($cell['obj']))
|
|
{
|
|
$this->data[$row][$col]['obj'] = CreateObject('etemplate.etemplate',$cell['name']);
|
|
}
|
|
$n += $this->data[$row][$col]['obj']->set_cell_attribute($name,$attr,$val);
|
|
}
|
|
}
|
|
}
|
|
|
|
return $n;
|
|
}
|
|
|
|
/*!
|
|
@function disable_cells
|
|
@syntax disable_cells( $name )
|
|
@author ralfbecker
|
|
@abstract disables all cells with name == $name
|
|
*/
|
|
function disable_cells($name)
|
|
{
|
|
return $this->set_cell_attribute($name,'disabled',True);
|
|
}
|
|
|
|
/*!
|
|
@function set_row_attributes
|
|
@syntax set_row_attibutes( $n,$height=0,$class=0,$valign=0,$disabled=0 )
|
|
@author ralfbecker
|
|
@abstract set one or more attibutes for row $n
|
|
@param $n is numerical row-number starting with 1 (!)
|
|
@param $height in percent or pixel or '' for no height
|
|
@param $class name of css class (without the leading '.') or '' for no class
|
|
@param $valign alignment (top,middle,bottom) or '' for none
|
|
@param $disabled True or expression or False to disable or enable the row
|
|
@param Only the number 0 means dont change the attribute !!!
|
|
*/
|
|
function set_row_attributes($n,$height=0,$class=0,$valign=0,$disabled=0)
|
|
{
|
|
list($old_height,$old_disabled) = explode(',',$this->data[0]["h$n"]);
|
|
$disabled = $disabled !== 0 ? $disabled : $old_disabled;
|
|
$this->data[0]["h$n"] = ($height !== 0 ? $height : $old_height).
|
|
($disabled ? ','.$disabled : '');
|
|
list($old_class,$old_valign) = explode(',',$this->data[0]["c$n"]);
|
|
$valign = $valign !== 0 ? $valign : $old_valign;
|
|
$this->data[0]["c$n"] = ($class !== 0 ? $class : $old_class).
|
|
($valign ? ','.$valign : '');
|
|
}
|
|
|
|
/*!
|
|
@function disable_row
|
|
@syntax disable_row( $n,$enable=False )
|
|
@author ralfbecker
|
|
@abstract disables row $n
|
|
@param $n is numerical row-number starting with 1 (!)
|
|
@param $enable can be used to re-enable a row if set to True
|
|
*/
|
|
function disable_row($n,$enable=False)
|
|
{
|
|
$this->set_row_attributes($n,0,0,0,!$enable);
|
|
}
|
|
|
|
/*!
|
|
@function set_column_attributes
|
|
@syntax set_column_attibutes( $n,$width=0,$disabled=0 )
|
|
@author ralfbecker
|
|
@abstract set one or more attibutes for column $c
|
|
@param $c is numerical column-number starting with 0 (!), or the char-code starting with 'A'
|
|
@param $width in percent or pixel or '' for no height
|
|
@param $disabled True or expression or False to disable or enable the column
|
|
@param Only the number 0 means dont change the attribute !!!
|
|
*/
|
|
function set_column_attributes($c,$width=0,$disabled=0)
|
|
{
|
|
if (is_numeric($c))
|
|
{
|
|
$c = $this->num2chrs($c);
|
|
}
|
|
list($old_width,$old_disabled) = explode(',',$this->data[0][$c]);
|
|
$disabled = $disabled !== 0 ? $disabled : $old_disabled;
|
|
$this->data[0][$c] = ($width !== 0 ? $width : $old_width).
|
|
($disabled ? ','.$disabled : '');
|
|
}
|
|
|
|
/*!
|
|
@function disable_column
|
|
@syntax disable_column( $c,$enable=False )
|
|
@author ralfbecker
|
|
@abstract disables column $c
|
|
@param $c is numerical column-number starting with 0 (!), or the char-code starting with 'A'
|
|
@param $enable can be used to re-enable a column if set to True
|
|
*/
|
|
function disable_column($c,$enable=False)
|
|
{
|
|
$this->set_column_attributes($c,0,!$enable);
|
|
}
|
|
|
|
/*!
|
|
@function loadExtension
|
|
@syntax loadExtension( $type )
|
|
@author ralfbecker
|
|
@abstact trys to load the Extension / Widget-class from the app or etemplate
|
|
@param $name name of the extension, the classname should be class.${name}_widget.inc.php
|
|
@discussion the $name might be "$name.$app" to give a app-name (default is the current app,or template-name)
|
|
*/
|
|
function loadExtension($type)
|
|
{
|
|
list($class,$app) = explode('.',$type);
|
|
$class .= '_widget';
|
|
|
|
if ($app == '')
|
|
{
|
|
$app = $GLOBALS['phpgw_info']['flags']['current_app'];
|
|
}
|
|
if (!file_exists(PHPGW_SERVER_ROOT."/$app/inc/class.$class.inc.php"))
|
|
{
|
|
list($app) = explode('.',$this->name);
|
|
}
|
|
if (!file_exists(PHPGW_SERVER_ROOT."/$app/inc/class.$class.inc.php"))
|
|
{
|
|
$app = 'etemplate';
|
|
}
|
|
if (!file_exists(PHPGW_SERVER_ROOT."/$app/inc/class.$class.inc.php"))
|
|
{
|
|
return $GLOBALS['phpgw_info']['etemplate']['extension'][$type] = False;
|
|
}
|
|
$GLOBALS['phpgw_info']['etemplate']['extension'][$type] = CreateObject($app.'.'.$class,$ui='html');
|
|
|
|
return $GLOBALS['phpgw_info']['etemplate']['extension'][$type]->human_name;
|
|
}
|
|
|
|
function haveExtension($type,$function='')
|
|
/*
|
|
@function haveExtension
|
|
@syntax haveExtension($type)
|
|
@author ralfbecker
|
|
@abstract checks if extension is loaded and load it if it isnt
|
|
*/
|
|
{
|
|
return ($GLOBALS['phpgw_info']['etemplate']['extension'][$type] || $this->loadExtension($type,$ui)) &&
|
|
($function == '' || $GLOBALS['phpgw_info']['etemplate']['extension'][$type]->public_functions[$function]);
|
|
}
|
|
|
|
function extensionPreProcess($type,$name,&$value,&$cell,&$readonlys)
|
|
/*
|
|
@function extensionPreProcess
|
|
@syntax extensionPreProcess(&$cell,&$value,&$readonlys)
|
|
@param $type of the extension
|
|
@param $name form-name of this widget/field (used as a unique index into extension_data)
|
|
@param &$cell table-cell on which the extension operates
|
|
@param &$value value of the extensions content(-array)
|
|
@param &$readonlys value of the extensions readonly-setting(-array)
|
|
@abstract executes the pre_process-function of the extension $cell[]type]
|
|
@author ralfbecker
|
|
*/
|
|
{
|
|
if (!$this->haveExtension($type))
|
|
{
|
|
return False;
|
|
}
|
|
return $GLOBALS['phpgw_info']['etemplate']['extension'][$type]->pre_process($name,$value,$cell,$readonlys,
|
|
$GLOBALS['phpgw_info']['etemplate']['extension_data'][$name],$this);
|
|
}
|
|
|
|
function extensionPostProcess($type,$name,&$value,$value_in)
|
|
/*
|
|
@function extensionPostProcess
|
|
@syntax extensionPostProcess(&$cell,&$value)
|
|
@param $type of the extension
|
|
@param $name form-name of this widget/field (used as a unique index into extension_data)
|
|
@param &$value value of the extensions content(-array)
|
|
@abstract executes the post_process-function of the extension $cell[type]
|
|
@returns True if a value should be returned (default for no postprocess fkt.), else False
|
|
@author ralfbecker
|
|
*/
|
|
{
|
|
if (!$this->haveExtension($type,'post_process'))
|
|
{
|
|
return True;
|
|
}
|
|
return $GLOBALS['phpgw_info']['etemplate']['extension'][$type]->post_process($name,$value,
|
|
$GLOBALS['phpgw_info']['etemplate']['extension_data'][$name],
|
|
$GLOBALS['phpgw_info']['etemplate']['loop'],$this,$value_in);
|
|
}
|
|
|
|
function extensionRender($type,$name,&$value,&$cell,$readonly)
|
|
/*
|
|
@function extensionRender
|
|
@syntax extensionRender(&$cell,$form_name,&$value,$readonly)
|
|
@abstract executes the render-function of the extension $cell[type]
|
|
@author ralfbecker
|
|
*/
|
|
{
|
|
if (!$this->haveExtension($type,'render'))
|
|
{
|
|
return False;
|
|
}
|
|
return $GLOBALS['phpgw_info']['etemplate']['extension'][$type]->render($cell,$name,$value,$readonly,
|
|
$GLOBALS['phpgw_info']['etemplate']['extension_data'][$name],$this);
|
|
}
|
|
|
|
/*!
|
|
@function isset_array
|
|
@syntax isset_array( $arr,$idx )
|
|
@author ralfbecker
|
|
@abstract checks if idx, which may contain multiple subindex (eg.'x[y][z]'), is set in array
|
|
@author ralfbecker
|
|
*/
|
|
function isset_array($arr,$idx)
|
|
{
|
|
$idxs = explode('[',str_replace(']','',$idx));
|
|
$last_idx = array_pop($idxs);
|
|
$pos = &$arr;
|
|
foreach($idxs as $idx)
|
|
{
|
|
if (!is_array($pos))
|
|
{
|
|
return False;
|
|
}
|
|
$pos = &$pos[$idx];
|
|
}
|
|
return isset($pos[$last_idx]);
|
|
}
|
|
|
|
/*!
|
|
@function set_array
|
|
@abstract sets $arr[$idx] = $val
|
|
@author ralfbecker
|
|
@syntax set_array( &$arr,$idx,$val )
|
|
@param $arr array the array to search, referenz as a referenz gets returned
|
|
@param $idx string the index, may contain sub-indices like a[b], see example below
|
|
@discussion This works for non-trival indexes like 'a[b][c]' too: $arr['a']['b']['c'] = $val;
|
|
@author ralfbecker
|
|
*/
|
|
function set_array(&$arr,$idx,$val)
|
|
{
|
|
if (!is_array($arr))
|
|
{
|
|
die('set_array() $arr is no array');
|
|
}
|
|
$idxs = explode('[',str_replace(']','',$idx));
|
|
$pos = &$arr;
|
|
foreach($idxs as $idx)
|
|
{
|
|
$pos = &$pos[$idx];
|
|
}
|
|
$pos = $val;
|
|
}
|
|
|
|
/*!
|
|
@function get_array
|
|
@abstract return a var-param to $arr[$idx]
|
|
@author ralfbecker
|
|
@syntax get_array( &$arr,$idx,$referenz_into=False )
|
|
@param $arr array the array to search, referenz as a referenz gets returned
|
|
@param $idx string the index, may contain sub-indices like a[b], see example below
|
|
@param $referenz_into boolean default False, if True none-existing sub-arrays/-indices get created to be returned as referenz, else False is returned
|
|
@example $sub = get_array($arr,'a[b]'); $sub = 'c'; is equivalent to $arr['a']['b'] = 'c';
|
|
@discussion This works for non-trival indexes like 'a[b][c]' too: it returns &$arr[a][b][c]
|
|
*/
|
|
function &get_array(&$arr,$idx,$referenz_into=False)
|
|
{
|
|
if (!is_array($arr))
|
|
{
|
|
die('set_array() $arr is no array');
|
|
}
|
|
$idxs = explode('[',str_replace(']','',$idx));
|
|
$pos = &$arr;
|
|
foreach($idxs as $idx)
|
|
{
|
|
if (!is_array($pos) && !$referenz_info)
|
|
{
|
|
return False;
|
|
}
|
|
$pos = &$pos[$idx];
|
|
}
|
|
return $pos;
|
|
}
|
|
|
|
/*!
|
|
@function unset_array
|
|
@abstract unsets $arr[$idx]
|
|
@author ralfbecker
|
|
@syntax unset_array( &$arr,$idx )
|
|
@param $arr array the array to search, referenz as a referenz gets returned
|
|
@param $idx string the index, may contain sub-indices like a[b], see example below
|
|
@example unset_array($arr,'a[b]'); is equivalent to unset($arr['a']['b']);
|
|
@discussion This works for non-trival indexes like 'a[b][c]' too
|
|
*/
|
|
function unset_array(&$arr,$idx)
|
|
{
|
|
if (!is_array($arr))
|
|
{
|
|
die('set_array() $arr is no array');
|
|
}
|
|
$idxs = explode('[',str_replace(']','',$idx));
|
|
$last_idx = array_pop($idxs);
|
|
$pos = &$arr;
|
|
foreach($idxs as $idx)
|
|
{
|
|
$pos = &$pos[$idx];
|
|
}
|
|
unset($pos[$last_idx]);
|
|
}
|
|
|
|
/*!
|
|
@function complete_array_merge
|
|
@syntax complete_array_merge( $old,$new )
|
|
@author ralfbecker
|
|
@abstract merges $old and $new, content of $new has precedence over $old
|
|
@discussion THIS IS NOT THE SAME AS PHP4: array_merge (as it calls itself recursive for values which are arrays.
|
|
*/
|
|
function complete_array_merge($old,$new)
|
|
{
|
|
@reset($new);
|
|
while (list($k,$v) = @each($new))
|
|
{
|
|
if (!is_array($v) || !isset($old[$k]))
|
|
{
|
|
$old[$k] = $v;
|
|
}
|
|
else
|
|
{
|
|
$old[$k] = $this->complete_array_merge($old[$k],$v);
|
|
}
|
|
}
|
|
return $old;
|
|
}
|
|
|
|
|
|
function cache_name($name='',$template='default',$lang='default')
|
|
{
|
|
if (empty($name))
|
|
{
|
|
$name = $this->name;
|
|
$template = $this->template;
|
|
$lang = $this->lang;
|
|
}
|
|
elseif (is_array($name))
|
|
{
|
|
$template = $name['template'];
|
|
$lang = $name['lang'];
|
|
$name = $name['name'];
|
|
}
|
|
if (empty($template))
|
|
{
|
|
$template = 'default';
|
|
}
|
|
$cname = $template . '/' . $name . (!empty($lang) && $lang != 'default' ? '.' . $lang : '');
|
|
//echo "cache_name('$name','$template','$lang') = '$cname'";
|
|
|
|
return $cname;
|
|
}
|
|
|
|
/*!
|
|
@function store_in_cache()
|
|
@abstract stores the etemplate in the cache in phpgw_info
|
|
*/
|
|
function store_in_cache()
|
|
{
|
|
//echo "<p>store_in_cache('$this->name','$this->template','$this->lang','$this->version')</p>\n";
|
|
$GLOBALS['phpgw_info']['etemplate']['cache'][$this->cache_name()] = $this->as_array(1);
|
|
}
|
|
|
|
function in_cache($name,$template='default',$lang='default',$group=0,$version='')
|
|
{
|
|
$cname = $this->cache_name($name,$template,$lang);
|
|
if (is_array($name))
|
|
{
|
|
$version = $name['version'];
|
|
$name = $name['name'];
|
|
}
|
|
if (!isset($GLOBALS['phpgw_info']['etemplate']['cache'][$cname]) ||
|
|
!empty($version) && $GLOBALS['phpgw_info']['etemplate']['cache'][$cname]['version'] != $version)
|
|
{
|
|
//echo " NOT found in cache</p>\n";
|
|
return False;
|
|
}
|
|
//echo " found in cache</p>\n";
|
|
return $cname;
|
|
}
|
|
|
|
function read_from_cache($name,$template='default',$lang='default',$group=0,$version='')
|
|
{
|
|
//if (is_array($name)) $version = $name['version']; echo "<p>read_from_cache(,,,version='$version'): ";
|
|
if ($cname = $this->in_cache($name,$template,$lang,$group))
|
|
{
|
|
$this->init($GLOBALS['phpgw_info']['etemplate']['cache'][$cname]);
|
|
|
|
return True;
|
|
}
|
|
return False;
|
|
}
|
|
|
|
/*!
|
|
@function read
|
|
@abstract Reads an eTemplate from the cache or database / filesystem (and updates the cache)
|
|
@param as discripted in soetemplate::read
|
|
@param $load_via name/array of keys of etemplate to load in order to get $name (only as second try!)
|
|
@result True if a fitting template is found, else False
|
|
*/
|
|
function read($name,$template='default',$lang='default',$group=0,$version='',$load_via='')
|
|
{
|
|
if (is_array($name)) {
|
|
$pname = &$name['name'];
|
|
}
|
|
else
|
|
{
|
|
$pname = &$name;
|
|
}
|
|
if (empty($pname))
|
|
{
|
|
return False;
|
|
}
|
|
$parent = is_array($load_via) ? $load_via['name'] : $load_via;
|
|
if (strstr($pname,'.') === False && !empty($parent))
|
|
{
|
|
$pname = $parent . '.' . $pname;
|
|
}
|
|
if (!$this->read_from_cache($name,$template,$lang,$group,$version))
|
|
{
|
|
if (!soetemplate::read($name,$template,$lang,$group,$version))
|
|
{
|
|
if ($load_via && (is_string($load_via) ||
|
|
!isset($load_via['tpls_in_file']) || $load_via['tpls_in_file'] > 1))
|
|
{
|
|
soetemplate::read($load_via);
|
|
return $this->read_from_cache($name,$template,$lang,$group,$version);
|
|
}
|
|
return False;
|
|
}
|
|
$this->store_in_cache();
|
|
}
|
|
return True;
|
|
}
|
|
|
|
/*!
|
|
@function save
|
|
@abstract saves eTemplate-object to db and update the cache
|
|
@params keys see soetemplate::save
|
|
@result the number of affected rows, 1 should be ok, 0 somethings wrong
|
|
*/
|
|
function save($name='',$template='.',$lang='.',$group='',$version='.')
|
|
{
|
|
if ($result = soetemplate::save($name,$template,$lang,$group,$version))
|
|
{
|
|
$this->store_in_cache();
|
|
}
|
|
return $result;
|
|
}
|
|
};
|