* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @version $Id$
*/
/**************************************************************************\
* eGroupWare - API jsCalendar wrapper-class *
* http://www.eGroupWare.org *
* Written by Ralf Becker *
* -------------------------------------------- *
* 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$ */
/*!
@class jscalendar
@author ralfbecker
@abstract wrapper for the jsCalendar
@discussion the constructor load the necessary javascript-files
*/
/**
* Wrapper for the jsCalendar
*
* The constructor load the necessary javascript-files.
*
* @package api
* @subpackage html
* @access public
*/
class jscalendar
{
/**
* url to the jscalendar files
*
* @var string
*/
var $jscalendar_url;
/**
* dateformat from the user-prefs
*
* @var string
*/
var $dateformat;
/**
* Constructor
*
* @param boolean $do_header=true if true, necessary javascript and css gets loaded, only needed for input
* @param string $path='jscalendar'
* @return jscalendar
*/
function jscalendar($do_header=True,$path='jscalendar')
{
$this->jscalendar_url = $GLOBALS['egw_info']['server']['webserver_url'].'/phpgwapi/js/'.$path;
$this->dateformat = $GLOBALS['egw_info']['user']['preferences']['common']['dateformat'];
if ($do_header && !strstr($GLOBALS['egw_info']['flags']['java_script'],'jscalendar'))
{
$GLOBALS['egw_info']['flags']['java_script'] .=
'
';
}
}
/**
* Creates an inputfield for the jscalendar (returns the necessary html and js)
*
* @param string $name name and id of the input-field (it also names the id of the img $name.'-toggle')
* @param int/string $date date as string or unix timestamp (in server timezone)
* @param int $year=0 if $date is not used
* @param int $month=0 if $date is not used
* @param int $day=0 if $date is not used
* @param string $helpmsg='' a helpmessage for the statusline of the browser
* @param string $options='' any other options to the inputfield
* @param boolean $jsreturn=false
* @return string html
*/
function input($name,$date,$year=0,$month=0,$day=0,$helpmsg='',$options='',$jsreturn=false)
{
//echo "
\n";
if ($date && (is_int($date) || is_numeric($date)))
{
$year = (int)adodb_date('Y',$date);
$month = (int)adodb_date('n',$date);
$day = (int)adodb_date('d',$date);
}
if ($year && $month && $day)
{
$date = adodb_date($this->dateformat,$ts = adodb_mktime(12,0,0,$month,$day,$year));
if (strpos($this->dateformat,'M') !== False)
{
$short = lang(adodb_date('M',$ts)); // check if we have a translation of the short-cut
if (substr($short,-1) == '*') // if not generate one by truncating the translation of the long name
{
$short = substr(lang(adodb_date('F',$ts)),0,(int) lang('3 number of chars for month-shortcut'));
}
$date = str_replace(adodb_date('M',$ts),$short,$date);
}
}
if ($helpmsg !== '')
{
$options .= " onFocus=\"self.status='".addslashes($helpmsg)."'; return true;\"" .
" onBlur=\"self.status=''; return true;\"";
}
if ($jsreturn)
{
$return_array = array(
'html' => '',
'js' => 'Calendar.setup({inputField : "'.$name.'",button: "'.$name.'-trigger" });'
);
return $return_array;
}
return
'
';
}
/**
* Flat jscalendar with tooltips and url's for days, weeks and month
*
* @param string $url url to call if user clicks on a date (&date=YYYYmmdd is appended automatically)
* @param string/int $date=null format YYYYmmdd or timestamp
* @param string $weekUrl=''
* @param string $weekTTip=''
* @param string $monthUrl=''
* @param string $monthTTip=''
* @param string $id='calendar-container'
* @return string html
*/
function flat($url,$date=null,$weekUrl='',$weekTTip='',$monthUrl='',$monthTTip='',$id='calendar-container')
{
if ($date) // string if format YYYYmmdd or timestamp
{
$date = is_int($date) ? adodb_date('m/d/Y',$date) :
substr($date,4,2).'/'.substr($date,6,2).'/'.substr($date,0,4);
}
return '
';
}
/**
* Converts the date-string back to an array with year, month, day and a timestamp
*
* @param string $datestr content of the inputfield generated by jscalendar::input()
* @param boolean/string $raw='raw' key of the timestamp-field in the returned array or False of no timestamp
* @param string $day='day' keys for the array, eg. to set mday instead of day
* @param string $month='month' keys for the array
* @param string $year='year' keys for the array
* @return array/boolean array with the specified keys and values or false if $datestr == ''
*/
function input2date($datestr,$raw='raw',$day='day',$month='month',$year='year')
{
//echo "