File Source for iCalcreator.class.php

<?php
/*********************************************************************************/
/**
* iCalcreator class v2.4.3
* copyright (c) 2007-2008 Kjell-Inge Gustafsson kigkonsult
* www.kigkonsult.se/iCalcreator/index.php
* ical@kigkonsult.se
*
* Description:
* This file is a PHP implementation of RFC 2445.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/*********************************************************************************/
/*********************************************************************************/
/* A little setup */
/*********************************************************************************/
/* your local language code */
// define( 'ICAL_LANG', 'sv' );
// alt. autosetting
/*
$langstr = $_SERVER['HTTP_ACCEPT_LANGUAGE'];
$pos = strpos( $langstr, ';' );
if ($pos !== false) {
$langstr = substr( $langstr, 0, $pos );
$pos = strpos( $langstr, ',' );
if ($pos !== false) {
$pos = strpos( $langstr, ',' );
$langstr = substr( $langstr, 0, $pos );
}
define( 'ICAL_LANG', $langstr );
}
*/
/* only for phpversion 5.x, date management, default timezone setting */
if( substr( phpversion(), 0, 1) >= '5' ) // && ( 'UTC' == date_default_timezone_get() )) {
date_default_timezone_set( 'Europe/Stockholm' );
/* version string, do NOT remove!! */
define( 'ICALCREATOR_VERSION', 'iCalcreator 2.4.3' );
/*********************************************************************************/
/*********************************************************************************/
/**
* vcalendar class
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-12-30
*/
class vcalendar {
// calendar property variables
var $calscale;
var $method;
var $prodid;
var $version;
var $xprop;
// container for calendar components
var $components;
// component config variables
var $allowEmpty;
var $unique_id;
var $language;
var $directory;
var $filename;
var $url;
var $delimiter;
var $nl;
var $format;
// component internal variables
var $attributeDelimiter;
var $valueInit;
// component xCal declaration container
var $xcaldecl;
/*
* constructor for calendar object
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-12-30
* @return void
*/
function vcalendar () {
$this->_makeVersion();
$this->calscale = null;
$this->method = null;
$this->_makeUnique_id();
$this->prodid = null;
$this->xprop = array();
/**
* language = <Text identifying a language, as defined in [RFC 1766]>
*/
if( defined( 'ICAL_LANG' ))
$this->setConfig( 'language', ICAL_LANG );
$this->setConfig( 'allowEmpty', TRUE );
$this->setConfig( 'nl', "\n" );
$this->setConfig( 'format', 'iCal');
$this->directory = null;
$this->filename = null;
$this->url = null;
$this->setConfig( 'delimiter', DIRECTORY_SEPARATOR );
$this->xcaldecl = array();
$this->components = array();
}
/*********************************************************************************/
/**
* Property Name: CALSCALE
*/
/**
* creates formatted output for calendar property calscale
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createCalscale() {
if( !isset( $this->calscale ))
return;
switch( $this->format ) {
case 'xcal':
return ' calscale="'.$this->calscale.'"'.$this->nl;
break;
default:
return 'CALSCALE:'.$this->calscale.$this->nl;
break;
}
}
/**
* set calendar property calscale
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-13
* @param string $value
* @return void
*/
function setCalscale( $value ) {
$this->calscale = $value;
}
/*********************************************************************************/
/**
* Property Name: METHOD
*/
/**
* creates formatted output for calendar property method
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createMethod() {
if( !isset( $this->method ))
return;
switch( $this->format ) {
case 'xcal':
return ' method="'.$this->method.'"'.$this->nl;
break;
default:
return 'METHOD:'.$this->method.$this->nl;
break;
}
}
/**
* set calendar property method
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-13
* @param string $method
* @return void
*/
function setMethod( $method ) {
$this->method = $method;
}
/*********************************************************************************/
/**
* Property Name: PRODID
*
* The identifier is RECOMMENDED to be the identical syntax to the
* [RFC 822] addr-spec. A good method to assure uniqueness is to put the
* domain name or a domain literal IP address of the host on which.. .
*/
/**
* creates formatted output for calendar property prodid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createProdid() {
if( !isset( $this->prodid ))
$this->_makeProdid();
switch( $this->format ) {
case 'xcal':
return ' prodid="'.$this->prodid.'"'.$this->nl;
break;
default:
return 'PRODID:'.$this->prodid.$this->nl;
break;
}
}
/**
* make default value for calendar prodid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-10
* @return void
*/
function _makeProdid() {
$this->prodid = '-//'.$this->unique_id.'//NONSGML '.ICALCREATOR_VERSION.'//'.strtoupper( $this->language );
}
/**
* Conformance: The property MUST be specified once in an iCalendar object.
* Description: The vendor of the implementation SHOULD assure that this
* is a globally unique identifier; using some technique such as an FPI
* value, as defined in [ISO 9070].
*/
/**
* make default unique_id for calendar prodid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-10
* @return void
*/
function _makeUnique_id() {
$this->unique_id = gethostbyname( $_SERVER['SERVER_NAME'] );
}
/*********************************************************************************/
/**
* Property Name: VERSION
*
* Description: A value of "2.0" corresponds to this memo.
*/
/**
* creates formatted output for calendar property version
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createVersion() {
if( !isset( $this->version ))
$this->_makeVersion();
switch( $this->format ) {
case 'xcal':
return ' version="'.$this->version.'"'.$this->nl;
break;
default:
return 'VERSION:'.$this->version.$this->nl;
break;
}
}
/**
* set default calendar version
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-10
* @return void
*/
function _makeVersion() {
$this->version = '2.0';
}
/**
* set calendar version
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-10
* @param string version
* @return void
*/
function setVersion( $version ) {
$this->version = $version;
}
/*********************************************************************************/
/**
* Property Name: x-prop
*/
/**
* creates formatted output for calendar property x-prop, iCal format only
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @return string
*/
function createXprop() {
if( 'xcal' == $this->format )
return false;
if( 0 >= count( $this->xprop ))
return;
$xprop = null;
$toolbox = new calendarComponent();
$toolbox->setConfig( 'language', $this->getConfig( 'language' ));
$toolbox->setConfig( 'nl', $this->getConfig( 'nl' ));
$toolbox->_createFormat( $this->getConfig( 'format' ));
foreach( $this->xprop as $label => $xpropPart ) {
$attributes = $toolbox->_createParams( $xpropPart['params'], array( 'LANGUAGE' ));
if( is_array( $xpropPart['value'] )) {
foreach( $xpropPart['value'] as $pix => $theXpart )
$xpropPart['value'][$pix] = $toolbox->_strrep( $theXpart );
$xpropPart['value'] = implode( ',', $xpropPart['value'] );
}
else
$xpropPart['value'] = $toolbox->_strrep( $xpropPart['value'] );
$xprop .= $toolbox->_createElement( strtoupper( $label ), $attributes, $xpropPart['value'] );
}
return $xprop;
}
/**
* set calendar property x-prop
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.7 - 2007-06-21
* @param string $label
* @param string $value
* @param array $params optional
* @return void
*/
function setXprop( $label, $value, $params=FALSE ) {
if( empty( $label ) || empty( $value ))
return;
$xprop = array( 'value' => $value );
$toolbox = new calendarComponent();
$xprop['params'] = $toolbox->_setParams( $params );
$this->xprop[$label] = $xprop;
}
/*********************************************************************************/
/**
* delete calendar property value
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.15 - 2007-10-29
* @param string $propName
* @param int @propix, optional, if specific property is wanted in case of multiply occurences
* @return bool, if successfull delete
*/
function deleteProperty( $propName, $propix=FALSE ) {
$propName = ( $propName ) ? strtoupper( $propName ) : 'X-PROP';
if( !$propix )
$propix = ( isset( $this->propdelix[$propName] )) ? $this->propdelix[$propName] + 2 : 1;
$this->propdelix[$propName] = --$propix;
$return = FALSE;
switch( $propName ) {
case 'CALSCALE':
$this->calscale = null;
$return = TRUE;
break;
case 'METHOD':
$this->method = null;
$return = TRUE;
break;
default:
if( $propName != 'X-PROP' ) {
if( !isset( $this->xprop[$propName] )) return FALSE;
unset( $this->xprop[$propName] );
$return = TRUE;
}
else {
if( count( $this->xprop ) <= $propix ) return FALSE;
$xpropno = 0;
foreach( $this->xprop as $xpropkey => $xpropvalue ) {
if( $propix == $xpropno ) {
unset( $this->xprop[$xpropkey] );
$return = TRUE;
break 2;
}
else
$xpropno++;
}
}
}
return $return;
}
/**
* get calendar property value/params
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.8 - 2007-07-07
* @param string $propName, optional
* @param int @propix, optional, if specific property is wanted in case of multiply occurences
* @param bool $inclParam=FALSE
* @return mixed
*/
function getProperty( $propName=FALSE, $propix=FALSE, $inclParam=FALSE ) {
$propName = ( $propName ) ? strtoupper( $propName ) : 'X-PROP';
if( !$propix )
$propix = ( isset( $this->propix[$propName] )) ? $this->propix[$propName] + 2 : 1;
$this->propix[$propName] = --$propix;
switch( $propName ) {
case 'CALSCALE':
if( 0 < $propix ) return FALSE;
return ( !empty( $this->calscale )) ? $this->calscale : null;
break;
case 'METHOD':
if( 0 < $propix ) return FALSE;
return ( !empty( $this->method )) ? $this->method : null;
break;
case 'PRODID':
if( 0 < $propix ) return FALSE;
if( empty( $this->prodid ))
$this->_makeProdid();
return $this->prodid;
break;
case 'VERSION':
if( 0 < $propix ) return FALSE;
return ( !empty( $this->version )) ? $this->version : null;
break;
default:
if( $propName != 'X-PROP' ) {
if( !isset( $this->xprop[$propName] )) return FALSE;
return ( $inclParam ) ? array( $propName, $this->xprop[$propName] )
: array( $propName, $this->xprop[$propName]['value'] );
}
else {
if( count( $this->xprop ) <= $propix ) return FALSE;
$xpropno = 0;
foreach( $this->xprop as $xpropkey => $xpropvalue ) {
if( $propix == $xpropno )
return ( $inclParam ) ? array( $xpropkey, $this->xprop[$xpropkey] )
: array( $xpropkey, $this->xprop[$xpropkey]['value'] );
else
$xpropno++;
}
return FALSE; // not found ??
}
}
return FALSE;
}
/**
* general vcalendar property setting
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-10-23
* @param mixed $args variable number of function arguments,
* first argument is ALWAYS component name,
* second ALWAYS component value!
* @return void
*/
function setProperty () {
$numargs = func_num_args();
if( 1 >= $numargs )
return FALSE;
$arglist = func_get_args();
if( !$this->getConfig( 'allowEmpty' ) && ( !isset( $arglist[1] ) || empty( $arglist[1] )))
return;
$arglist[0] = strtoupper( $arglist[0] );
for( $argix=$numargs; $argix < 3; $argix++ ) {
if( !isset( $arglist[$argix] ))
$arglist[$argix] = null;
}
switch( $arglist[0] ) {
case 'CALSCALE':
$this->setCalscale( $arglist[1] );
break;
case 'METHOD':
$this->setMethod( $arglist[1] );
break;
case 'VERSION':
$this->setVersion( $arglist[1] );
break;
default:
$this->setXprop( $arglist[0], $arglist[1], $arglist[2] );
break;
}
}
/*********************************************************************************/
/**
* get vcalendar config values or * calendar components
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-12-30
* @param string $config
* @return value
*/
function getConfig( $config ) {
switch( strtoupper( $config )) {
case 'ALLOWEMPTY':
return $this->allowEmpty;
break;
case 'COMPSINFO':
unset( $this->compix );
$info = array();
foreach( $this->components as $cix => $component ) {
unset( $component->propix );
$info[$cix]['ordno'] = $cix + 1;
$info[$cix]['type'] = $component->objName;
$info[$cix]['uid'] = $component->getProperty( 'uid' );
$info[$cix]['props'] = $component->getConfig( 'propinfo' );
$info[$cix]['sub'] = $component->getConfig( 'compsinfo' );
unset( $component->propix );
}
return $info;
break;
case 'DELIMITER':
return $this->delimiter;
break;
case 'DIRECTORY':
if( empty( $this->directory ))
$this->directory = '.';
return $this->directory;
break;
case 'DIRFILE':
return $this->getConfig( 'directory' ).$this->getConfig( 'delimiter' ).$this->getConfig( 'filename' );
break;
case 'FILEINFO':
return array( $this->getConfig( 'directory' )
, $this->getConfig( 'filename' )
, $this->getConfig( 'filesize' ));
break;
case 'FILENAME':
if( empty( $this->filename )) {
if( 'xcal' == $this->format )
$this->filename = date( 'YmdHis' ).'.xml'; // recommended xcs.. .
else
$this->filename = date( 'YmdHis' ).'.ics';
}
return $this->filename;
break;
case 'FILESIZE':
$size = 0;
if( empty( $this->url )) {
$dirfile = $this->getConfig( 'dirfile' );
if( FALSE === ( $size = filesize( $dirfile )))
$size = 0;
clearstatcache();
}
return $size;
break;
case 'FORMAT':
return $this->format;
break;
case 'LANGUAGE':
/* get language for calendar component as defined in [RFC 1766] */
return $this->language;
break;
case 'NL':
case 'NEWLINECHAR':
return $this->nl;
break;
case 'UNIQUE_ID':
return $this->unique_id;
break;
case 'URL':
if( !empty( $this->url ))
return $this->url;
else
return FALSE;
break;
}
}
/**
* general vcalendar config setting
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-12-30
* @param string $config
* @param string $value
* @return void
*/
function setConfig( $config, $value ) {
switch( strtoupper( $config )) {
case 'ALLOWEMPTY':
$this->allowEmpty = $value;
break;
case 'DELIMITER':
$this->delimiter = $value;
break;
case 'DIRECTORY':
$value = trim( $value );
$nl = $this->getConfig('delimiter');
if( $nl == substr( $value, ( 0 - strlen( $nl ))))
$value = substr( $value, 0, ( strlen( $value ) - strlen( $nl )));
if( is_dir( $value )) {
/* local directory */
clearstatcache();
$this->directory = $value;
$this->url = null;
return TRUE;
}
else
return FALSE;
break;
case 'FILENAME':
$value = trim( $value );
if( !empty( $this->url )) {
/* remote directory+file - URL */
$this->filename = $value;
return TRUE;
}
$dirfile = $this->getConfig( 'directory' ).$this->getConfig( 'delimiter' ).$value;
if( file_exists( $dirfile )) {
/* local existing file */
if( is_readable( $dirfile ) || is_writable( $dirfile )) {
clearstatcache();
$this->filename = $value;
return TRUE;
}
else
return FALSE;
}
elseif( FALSE !== touch( $dirfile )) {
/* new local file created */
$this->filename = $value;
return TRUE;
}
else
return FALSE;
break;
case 'FORMAT':
$value = trim( $value );
if( 'xcal' == strtolower( $value )) {
$this->format = 'xcal';
$this->attributeDelimiter = $this->nl;
$this->valueInit = null;
}
else {
$this->format = null;
$this->attributeDelimiter = ';';
$this->valueInit = ':';
}
break;
case 'LANGUAGE':
// set language for calendar component as defined in [RFC 1766]
$value = trim( $value );
$this->language = $value;
break;
case 'NL':
case 'NEWLINECHAR':
$this->nl = $value;
break;
case 'UNIQUE_ID':
$value = trim( $value );
$this->unique_id = $value;
break;
case 'URL':
/* remote file - URL */
$value = trim( $value );
$value = str_replace( 'HTTP://', 'http://', $value );
$value = str_replace( 'WEBCAL://', 'http://', $value );
$value = str_replace( 'webcal://', 'http://', $value );
$this->url = $value;
$this->directory = null;
$parts = pathinfo( $value );
return $this->setConfig( 'filename', $parts['basename'] );
break;
}
}
/*********************************************************************************/
/**
* validDate
*
* convert input parameters to (valid) iCalcreator date in array format (or FALSE)
* if $utc=TRUE and $tz = utc offset ([[+/]-]HHmm) input (local) date array + UTC offset
* returns ouput in UTC format date
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param mixed $tz optional
* @param bool $utc optional
* @return bool false / array $date
*/
function validDate( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $tz=FALSE, $utc=FALSE ) {
$input = array();
$toolbox = new calendarComponent();
$parno = null;
if( is_array( $year ) && isset( $year['timestamp'] )) {
$input = $toolbox->_date_time_string( date( 'Y-m-d H:i:s', $year['timestamp'] ), 6 );
$input['tz'] = ( isset( $year['tz'] )) ? $year['tz'] : null;
$utc = ( TRUE === $month ) ? TRUE : FALSE;
}
elseif( is_array( $year ) && ( in_array( count( $year ), array( 3, 4, 6, 7 )))) {
if( isset( $year['tz'] ) || ( 4 == count( $year )) || ( 7 == count( $year )))
$parno = 7;
elseif( isset( $year['hour'] ) || isset( $year['min'] ) || isset( $year['sec'] ) ||
( 6 == count( $year )))
$parno = 6;
else
$parno = 3;
$input = $toolbox->_date_time_array( $year, $parno );
$utc = ( TRUE === $month ) ? TRUE : FALSE;
}
elseif( 8 <= strlen( trim( $year ))) { // ex. 2006-08-03 10:12:18
$input = $toolbox->_date_time_string( $year );
$utc = ( TRUE === $month ) ? TRUE : FALSE;
}
elseif(( $year !== FALSE ) && ( $month !== FALSE ) && ( $day !== FALSE )) {
if(( 0 > (int) $year ) || (2100 < (int) $year ))
return FALSE;
$month = (int) $month;
if(( 1 > $month ) || ( 12 < $month ))
return FALSE;
$day = (int) $day;
if(( 1 > $day ) || ( 31 < $day ))
return FALSE;
$input['year'] = $year;
$input['month'] = $month;
$input['day'] = $day;
if(( $hour !== FALSE ) || ( $min !== FALSE ) || ( $sec !== FALSE )) {
$parno = 6;
if( $hour !== FALSE )
$input['hour'] = $hour;
if( $min !== FALSE )
$input['min'] = $min;
if( $sec !== FALSE )
$input['sec'] = $sec;
}
if( $tz !== FALSE ) {
$parno = 7;
$input['tz'] = $tz;
}
elseif( !$parno )
$parno = 3;
$input = $toolbox->_date_time_array( $input, $parno );
}
else
return FALSE;
if( !checkdate ( $input['month'], $input['day'], $input['year'] ))
return FALSE;
if( isset( $input['hour'] ) &&
(( 0 > $input['hour'] ) || ( 23 < $input['hour'] )))
return FALSE;
if( isset( $input['min'] ) &&
(( 0 > $input['min'] ) || ( 59 < $input['min'] )))
return FALSE;
if( isset( $input['sec'] ) &&
(( 0 > $input['sec'] ) || ( 59 < $input['sec'] )))
return FALSE;
if( isset( $input['tz'] ) && ( '' < trim ( $input['tz'] ))) {
$input['tz'] = (string) trim( $input['tz'] );
if( ctype_digit( $input['tz']{1} )) { // only numeric tz=offset
$offset = 0;
if( ctype_digit( $input['tz']{0} ))
$input['tz'] = '+'.$input['tz'];
$offset = $toolbox->_tz2offset( $input['tz'] );
if( 0 != $offset) {
if( !isset( $input['hour'] ))
$input['hour'] = 0;
if( !isset( $input['min'] ))
$input['min'] = 0;
if( !isset( $input['sec'] ))
$input['sec'] = 0;
$input = date('Y-m-d H:i:s\Z', mktime( $input['hour']
, $input['min']
, $input['sec'] + $offset
, $input['month']
, $input['day']
, $input['year']));
$parno = ( $utc ) ? 7 : 6 ;
$input = $toolbox->_date_time_string( $input, $parno );
if( !$utc && isset( $input['tz'] ) && ( 'Z' == $input['tz'] ))
unset( $input['tz'] );
}
}
}
return $input;
}
/*********************************************************************************/
/**
* add calendar component to container
*
* alias to setComponent
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-04-24
* @param object $component calendar component
* @return void
*/
function addComponent( $component ) {
$this->setComponent( $component );
}
/**
* delete calendar component from container
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.4 - 2007-06-14
* @param mixed $arg1 ordno / component type / component uid
* @param mixed $arg2 optional, ordno if arg1 = component type
* @return void
*/
function deleteComponent( $arg1, $arg2=FALSE ) {
$argType = $index = null;
if ( ctype_digit( (string) $arg1 )) {
$argType = 'INDEX';
$index = (int) $arg1 - 1;
}
elseif(( strlen( $arg1 ) <= strlen( 'vfreebusy' )) && ( FALSE === strpos( $arg1, '@' ))) {
$argType = strtolower( $arg1 );
$index = ( !empty( $arg2 ) && ctype_digit( (string) $arg2 )) ? (( int ) $arg2 - 1 ) : 1;
}
$cix1dC = 0;
foreach ( $this->components as $cix => $component) {
unset( $component->propix );
if(( 'INDEX' == $argType ) && ( $index == $cix )) {
unset( $this->components[$cix] );
return TRUE;
}
elseif( $argType == $component->objName ) {
if( $index == $cix1dC ) {
unset( $this->components[$cix] );
return TRUE;
}
$cix1dC++;
}
elseif( !$argType && ($arg1 == $component->getProperty( 'uid' ))) {
unset( $this->components[$cix] );
return TRUE;
}
}
return FALSE;
}
/**
* get calendar component from container
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.16 - 2007-11-11
* @param mixed $arg1 optional, ordno/component type/ component uid
* @param mixed $arg2 optional, ordno if arg1 = component type
* @return object
*/
function getComponent( $arg1=FALSE, $arg2=FALSE ) {
$index = $argType = null;
if ( !$arg1 ) {
$argType = 'INDEX';
$index = $this->compix['INDEX'] =
( isset( $this->compix['INDEX'] )) ? $this->compix['INDEX'] + 1 : 1;
}
elseif ( ctype_digit( (string) $arg1 )) {
$argType = 'INDEX';
$index = (int) $arg1;
unset( $this->compix );
}
elseif(( strlen( $arg1 ) <= strlen( 'vfreebusy' )) && ( FALSE === strpos( $arg1, '@' ))) {
unset( $this->compix['INDEX'] );
$argType = strtolower( $arg1 );
if( !$arg2 )
$index = $this->compix[$argType] =
( isset( $this->compix[$argType] )) ? $this->compix[$argType] + 1 : 1;
else
$index = (int) $arg2;
}
$index -= 1;
$ckeys = array_keys( $this->components );
if( !empty( $index) && ( $index > end( $ckeys )))
return FALSE;
$cix1gC = 0;
foreach ( $this->components as $cix => $component) {
unset( $component->propix );
if(( 'INDEX' == $argType ) && ( $index == $cix ))
return $component->copy();
elseif( $argType == $component->objName ) {
if( $index == $cix1gC )
return $component->copy();
$cix1gC++;
}
elseif( !$argType && ($arg1 == $component->getProperty( 'uid' ))) {
unset( $component->propix );
return $component->copy();
}
}
/* not found.. . */
unset( $this->compix );
return false;
}
/**
* select components from calendar on date basis
*
* Ensure DTSTART is set for every component.
* No date controls occurs.
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.4.1 - 2008-02-05
* @param int $startY optional, start Year, default current Year
* @param int $startM optional, start Month, default current Month
* @param int $startD optional, start Day, default current Day
* @param int $endY optional, end Year, default $startY
* @param int $endY optional, end Month, default $startM
* @param int $endY optional, end Day, default $startD
* @param mixed $cType optional, calendar component type(-s), default FALSE=all else string/array type(-s)
* @param bool $flat optional, FALSE (default) => output : array[Year][Month][Day][]
* TRUE => output : array[] (ignores split)
* @param bool $any optional, TRUE (default) - select component that take place within period
* FALSE - only components that starts within period
* @param bool $split optional, TRUE (default) - one component copy every day it take place during the
* period (implies flat=FALSE)
* FALSE - one occurance of component only in output array</tr>
* @return array or FALSE
*/
function selectComponents( $startY=FALSE, $startM=FALSE, $startD=FALSE, $endY=FALSE, $endM=FALSE, $endD=FALSE, $cType=FALSE, $flat=FALSE, $any=TRUE, $split=TRUE ) {
/* check if empty calendar */
if( 0 >= count( $this->components ))
return FALSE;
/* check default dates */
if( !$startY ) $startY = date( 'Y' );
if( !$startM ) $startM = date( 'm' );
if( !$startD ) $startD = date( 'd' );
$startDate = mktime( 0, 0, 0, $startM, $startD, $startY );
if( !$endY ) $endY = $startY;
if( !$endM ) $endM = $startM;
if( !$endD ) $endD = $startD;
$endDate = mktime( 23, 59, 59, $endM, $endD, $endY );
/* check component types */
$validTypes = array('vevent', 'vtodo', 'vjournal', 'vfreebusy' );
if( is_array( $cType )) {
foreach( $cType as $cix => $theType ) {
$cType[$cix] = $theType = strtolower( $theType );
if( !in_array( $theType, $validTypes ))
$cType[$cix] = 'vevent';
}
$cType = array_unique( $cType );
}
elseif( !empty( $cType )) {
$cType = strtolower( $cType );
if( !in_array( $cType, $validTypes ))
$cType = array( 'vevent' );
else
$cType = array( $cType );
}
else
$cType = $validTypes;
if( 0 >= count( $cType ))
$cType = $validTypes;
/* iterate components */
$result = array();
foreach ( $this->components as $cix => $component ) {
unset( $component->propix, $start );
/* deselect unvalid type components */
if( !in_array( $component->objName, $cType ))
continue;
/* deselect components without dtstart set */
if( FALSE === ( $start = $component->getProperty( 'dtstart' )))
continue;
$dtendExist = $dueExist = FALSE;
unset( $end, $startWdate, $endWdate, $rdurWsecs, $rdur, $exdatelist, $workstart, $workend ); // clean up
$startWdate = $component->_date2timestamp( $start );
/* get end date from dtend/due/duration properties */
$end = $component->getProperty( 'dtend' );
if( !empty( $end ))
$dtendExist = TRUE;
//if( !empty($end)) echo 'selectComponents 1 start='.implode('-',$start).' end='.implode('-',$end)." \n"; // test ###
if( empty($end) && ( $component->objName == 'vtodo' )) {
$end = $component->getProperty( 'due' );
if( !empty( $end ))
$dueExist = TRUE;
//if( !empty($end)) echo 'selectComponents 2 start='.implode('-',$start).' end='.implode('-',$end)." \n"; // test ###
}
elseif( !empty($end) && !isset( $end['hour'] )) {
/* a DTEND without time part regards an event that ends the day before,
for an all-day event DTSTART=20071201 DTEND=20071202 (taking place 20071201!!! */
$end = array( 'year' => $end['year'], 'month' => $end['month'], 'day' => ($end['day'] - 1), 'hour' => 23, 'min' => 59, 'sec' => 59 );
//if( !empty($end)) echo 'selectComponents 3 start='.implode('-',$start).' end='.implode('-',$end)." \n"; // test ###
}
if( empty( $end )) {
$end = $component->getProperty( 'duration', FALSE, FALSE, TRUE );// in dtend (array) format
//if( !empty($end)) echo 'selectComponents 4 start='.implode('-',$start).' end='.implode('-',$end)." \n"; // test ###
}
if( empty( $end )) { // assume one day duration if missing end date
$end = array( 'year' => $start['year'], 'month' => $start['month'], 'day' => $start['day'], 'hour' => 23, 'min' => 59, 'sec' => 59 );
//if( isset($end)) echo 'selectComponents 5 start='.implode('-',$start).' end='.implode('-',$end)." \n"; // test ###
}
$endWdate = $component->_date2timestamp( $end );
if( $endWdate < $startWdate ) { // MUST be after start date!!
$end = array( 'year' => $start['year'], 'month' => $start['month'], 'day' => $start['day'], 'hour' => 23, 'min' => 59, 'sec' => 59 );
$endWdate = $component->_date2timestamp( $end );
}
$rdurWsecs = $endWdate - $startWdate; // compute component duration in seconds
$rdur = $component->_date2duration( $start, $end ); // compute component duration, array
/* make a list of optional exclude dates for component occurence, exrule, exdate */
$exdatelist = array();
$workstart = $component->_date_time_string( date('Y-m-d H:i:s', ( $startDate - $rdurWsecs )), 6);
$workend = $component->_date_time_string( date('Y-m-d H:i:s', ( $endDate + $rdurWsecs )), 6);
while( FALSE !== ( $exrule = $component->getProperty( 'exrule' )))
$component->_recur2date( $exdatelist, $exrule, $start, $workstart, $workend );
while( FALSE !== ( $exdate = $component->getProperty( 'exdate' ))) {
foreach( $exdate as $theExdate ) {
$exWdate = $component->_date2timestamp( $theExdate );
if((( $startDate - $rdurWsecs ) <= $exWdate ) && ( $endDate >= $exWdate ))
$exdatelist[$exWdate] = TRUE;
}
}
/* if 'any' components, check repeating components, removing all excluding dates */
if( TRUE === $any ) {
/* make a list of optional repeating dates for component occurence, rrule, rdate */
$recurlist = array();
while( FALSE !== ( $rrule = $component->getProperty( 'rrule' ))) // check rrule
$component->_recur2date( $recurlist, $rrule, $start, $workstart, $workend );
foreach( $recurlist as $recurkey => $recurvalue ) // key=match date as timestamp
$recurlist[$recurkey] = $rdurWsecs; // add duration in seconds
while( FALSE !== ( $rdate = $component->getProperty( 'rdate' ))) { // check rdate
foreach( $rdate as $theRdate ) {
if( is_array( $theRdate ) && ( 2 == count( $theRdate )) && // PERIOD
array_key_exists( '0', $theRdate ) && array_key_exists( '1', $theRdate )) {
$rstart = $component->_date2timestamp( $theRdate[0] );
if(( $rstart < ( $startDate - $rdurWsecs )) || ( $rstart > $endDate ))
continue;
if( isset( $theRdate[1]['year'] )) // date-date period
$rend = $component->_date2timestamp( $theRdate[1] );
else { // date-duration period
$rend = $component->duration2date( $theRdate[0], $theRdate[1] );
$rend = $component->_date2timestamp( $rend );
}
if((( $startDate - $rdurWsecs ) <= $rstart ) && ( $endDate >= $rstart ))
$recurlist[$rstart] = ( $rstart - $rend ); // set start date + rdate duration in seconds
}
else { // single date
$theRdate = $component->_date2timestamp( $theRdate );
if((( $startDate - $rdurWsecs ) <= $theRdate ) && ( $endDate >= $theRdate ))
$recurlist[$theRdate] = $rdurWsecs; // set start date + event duration in seconds
}
}
}
if( 0 < count( $recurlist )) {
ksort( $recurlist );
foreach( $recurlist as $recurkey => $durvalue ) {
if((( $startDate - $rdurWsecs ) > $recurkey ) || ( $endDate < $recurkey )) // not within period
continue;
if( isset( $exdatelist[$recurkey] )) // check excluded dates
continue;
if( $startWdate >= $recurkey ) // exclude component start date
continue;
$component2 = $component->copy();
$rstart = $component2->_date_time_string( date('Y-m-d H:i:s', $recurkey ), 6);
$datevalue = $rstart['month'].'/'.$rstart['day'].'/'.$rstart['year'];
$dateformat = 'Y-m-d';
if( isset( $start['hour'] ) || isset( $start['min'] ) || isset( $start['sec'] )) {
$datevalue .= ( isset( $rstart['hour'] )) ? ' '.$rstart['hour'] : ' 00';
$datevalue .= ( isset( $rstart['min'] )) ? ':'.$rstart['min'] : ':00';
$datevalue .= ( isset( $rstart['sec'] )) ? ':'.$rstart['sec'] : ':00';
$dateformat .= ' H:i:s';
}
$datestring = date( $dateformat, strtotime( $datevalue ));
if( isset( $start['tz'] ))
$datestring .= ' '.$start['tz'];
$component2->setProperty( 'x-current-dtstart', $datestring );
$rend = $component2->_date_time_string( date('Y-m-d H:i:s', ( $recurkey + $durvalue )), 6);
if( isset( $datevalue ) && ( $dtendExist || $dueExist )) {
$datevalue = $rend['month'].'/'.$rend['day'].'/'.$rend['year'];
$dateformat = 'Y-m-d';
if( isset( $end['hour'] ) || isset( $end['min'] ) || isset( $end['sec'] )) {
$datevalue .= ( isset( $rend['hour'] )) ? ' '.$rend['hour'] : ' 00';
$datevalue .= ( isset( $rend['min'] )) ? ':'.$rend['min'] : ':00';
$datevalue .= ( isset( $rend['sec'] )) ? ':'.$rend['sec'] : ':00';
$dateformat .= ' H:i:s';
}
$datestring = date( $dateformat, strtotime( $datevalue ));
if( isset( $end['tz'] ))
$datestring .= ' '.$end['tz'];
if( $dtendExist )
$component2->setProperty( 'x-current-dtend', $datestring );
else
$component2->setProperty( 'x-current-due', $datestring );
}
$rend = $component2->_date2timestamp( $rend );
$rstart = $recurkey;
/* add repeating components within valid dates to output array, only start date */
if( $flat )
$result[] = $component2; // copy to output
elseif( $split ) {
if( $rend > $endDate )
$rend = $endDate;
while( $rstart <= $rend ) { // iterate
$wd = getdate( $rstart );
// if(( $rstart >= $startDate ) && // date within period
if(( $rstart > $startDate ) && // date after dtstart
!isset( $exdatelist[$rstart] )) // check exclude date
$result[$wd['year']][$wd['mon']][$wd['mday']][] = $component2->copy(); // copy to output
$rstart += ( 24*60*60 ); // step one day
}
}
elseif(( $rstart >= $startDate ) && // date within period
!isset( $exdatelist[$rstart] )) { // check exclude date
$wd = getdate( $rstart );
$result[$wd['year']][$wd['mon']][$wd['mday']][] = $component2->copy(); // copy to output
}
}
}
/* deselect components with startdate/enddate not within period */
if(( $endWdate < $startDate ) || ( $startWdate > $endDate ))
continue;
}
/* deselect components with startdate not within period */
elseif(( $startWdate < $startDate ) || ( $startWdate > $endDate ))
continue;
/* add selected components within valid dates to output array */
if( $flat ) {
$result[] = $component->copy(); // copy to output;
}
elseif( $split ) {
if( $endWdate > $endDate )
$endWdate = $endDate; // use period end date
if( !isset( $exdatelist[$startWdate] )) { // check excluded dates
if( $startWdate < $startDate )
$startWdate = $startDate; // use period start date
while( $startWdate <= $endWdate ) { // iterate
$wd = getdate( $startWdate );
$result[$wd['year']][$wd['mon']][$wd['mday']][] = $component->copy(); // copy to output
$startWdate += ( 24*60*60 ); // step one day
}
}
} // use component date
elseif( !isset( $exdatelist[$startWdate] ) && // check excluded dates
( $startWdate >= $startDate )) { // within period
$wd = getdate( $startWdate );
$result[$wd['year']][$wd['mon']][$wd['mday']][] = $component->copy(); // copy to output
}
}
if( 0 >= count( $result ))
return FALSE;
elseif( !$flat ) {
foreach( $result as $y => $yeararr ) {
foreach( $yeararr as $m => $montharr ) {
ksort( $result[$y][$m] );
}
ksort( $result[$y] );
}
ksort( $result );
}
return $result;
}
/**
* add calendar component to container
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.16 - 2007-11-11
* @param object $component calendar component
* @param mixed $arg1 optional, ordno/component type/ component uid
* @param mixed $arg2 optional, ordno if arg1 = component type
* @return void
*/
function setComponent( $component, $arg1=FALSE, $arg2=FALSE ) {
if( '' >= $component->getConfig( 'language'))
$component->setConfig( 'language', $this->getConfig( 'language' ));
$component->setConfig( 'allowEmpty', $this->getConfig( 'allowEmpty' ));
$component->setConfig( 'nl', $this->getConfig( 'nl' ));
$component->setConfig( 'unique_id', $this->getConfig( 'unique_id' ));
$component->setConfig( 'format', $this->getConfig( 'format' ));
if( !in_array( $component->objName, array( 'valarm', 'vtimezone' ))) {
unset( $component->propix );
/* make sure dtstamp and uid is set */
$dummy = $component->getProperty( 'dtstamp' );
$dummy = $component->getProperty( 'uid' );
}
if( !$arg1 ) {
$this->components[] = $component->copy();
return TRUE;
}
$argType = $index = null;
if ( ctype_digit( (string) $arg1 )) {
$argType = 'INDEX';
$index = (int) $arg1 - 1;
}
elseif(( strlen( $arg1 ) <= strlen( 'vfreebusy' )) && ( FALSE === strpos( $arg1, '@' ))) {
$argType = strtolower( $arg1 );
$index = ( ctype_digit( (string) $arg2 )) ? ((int) $arg2) - 1 : 0;
}
$cix1sC = 0;
foreach ( $this->components as $cix => $component2) {
unset( $component2->propix );
if(( 'INDEX' == $argType ) && ( $index == $cix )) {
$this->components[$cix] = $component->copy();
return TRUE;
}
elseif( $argType == $component2->objName ) {
if( $index == $cix1sC ) {
$this->components[$cix] = $component->copy();
return TRUE;
}
$cix1sC++;
}
elseif( !$argType && ( $arg1 == $component2->getProperty( 'uid' ))) {
$this->components[$cix] = $component->copy();
return TRUE;
}
}
/* not found.. . insert last in chain anyway .. .*/
$this->components[] = $component->copy();
}
/**
* sort iCal compoments, only local date sort
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.9 - 2007-10-02
* @return sort param
*
*/
function _cmpfcn( $a, $b ) {
if( 'vtimezone' == $a->objName) return -1;
if( 'vtimezone' == $b->objName) return 1;
if( isset( $a->dtstart['value'] ) ||
isset( $b->dtstart['value'] )) {
foreach( $this->_sortkeys as $key ) {
if( !isset( $a->dtstart['value'][$key] )) return -1;
elseif( !isset( $b->dtstart['value'][$key] )) return 1;
if ( $a->dtstart['value'][$key]
== $b->dtstart['value'][$key] )
continue;
if (( (int) $a->dtstart['value'][$key] ) <
( (int) $b->dtstart['value'][$key] )) return -1;
elseif(( (int) $a->dtstart['value'][$key] ) >
( (int) $b->dtstart['value'][$key] )) return 1;
}
}
if( isset( $a->dtend['value'] ))
$c = $a->dtend['value'];
if( empty( $c ) && !empty( $a->due['value'] ))
$c = $a->due['value'];
if( empty( $c ) && !empty( $a->duration['value'] ))
$c = $a->duration2date();
if( isset( $b->dtend['value'] ))
$d = $b->dtend['value'];
if( empty( $d ) && !empty( $b->due['value'] ))
$d = $b->due['value'];
if( empty( $d ) && !empty( $b->duration['value'] ))
$d = $b->duration2date();
if( isset( $c ) || isset( $d )) {
if( !isset( $c ) && isset( $d )) return -1;
if( isset( $c ) && !isset( $d )) return 1;
foreach( $this->_sortkeys as $key ) {
if ( !isset( $c[$key] )) return -1;
elseif( !isset( $d[$key] )) return 1;
if ( $c[$key]
== $d[$key] )
continue;
if (( (int) $c[$key] ) <
( (int) $d[$key] )) return -1;
elseif(( (int) $c[$key] ) >
( (int) $d[$key] )) return 1;
}
}
$c = ( isset( $a->created['value'] )) ? $a->created['value'] : $a->dtstamp['value'];
$d = ( isset( $b->created['value'] )) ? $b->created['value'] : $b->dtstamp['value'];
foreach( $this->_sortkeys as $key ) {
if( !isset( $a->created['value'][$key] )) return -1;
elseif( !isset( $b->created['value'][$key] )) return 1;
if ( $a->created['value'][$key]
== $b->created['value'][$key] )
continue;
if (( (int) $a->created['value'][$key] ) <
( (int) $b->created['value'][$key] )) return -1;
elseif(( (int) $a->created['value'][$key] ) >
( (int) $b->created['value'][$key] )) return 1;
}
if (( $a->uid['value'] ) <
( $b->uid['value'] )) return -1;
elseif(( $a->uid['value'] ) >
( $b->uid['value'] )) return 1;
return 0;
}
function sort() {
if( is_array( $this->components )) {
$this->_sortkeys = array( 'year', 'month', 'day', 'hour', 'min', 'sec' );
usort( $this->components, array( $this, '_cmpfcn' ));
}
}
/**
* parse iCal file into vcalendar, components, properties and parameters
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.4.3 - 2008-02-13
* @param string $filename optional filname (incl. opt. directory/path) or URL
* @return bool FALSE if error occurs during parsing
*
*/
function parse( $filename=FALSE ) {
if( !$filename ) {
/* directory/filename previous set via setConfig directory+filename / url */
if( FALSE === ( $filename = $this->getConfig( 'url' )))
$filename = $this->getConfig( 'dirfile' );
}
elseif(( 'http://' == strtolower( substr( $filename, 0, 7 ))) ||
( 'webcal://' == strtolower( substr( $filename, 0, 9 )))) {
/* remote file - URL */
$this->setConfig( 'URL', $filename );
if( !$filename = $this->getConfig( 'url' ))
return FALSE; /* err 2 */
}
else {
/* local directory/filename */
$parts = pathinfo( $filename );
if( !empty( $parts['dirname'] ) && ( '.' != $parts['dirname'] )) {
if( !$this->setConfig( 'directory', $parts['dirname'] ))
return FALSE; /* err 3 */
}
if( !$this->setConfig( 'filename', $parts['basename'] ))
return FALSE; /* err 4 */
}
if( 'http://' != substr( $filename, 0, 7 )) {
/* local file error tests */
if( !is_file( $filename )) /* err 5 */
return FALSE;
if( !is_readable( $filename ))
return FALSE; /* err 6 */
if( !filesize( $filename ))
return FALSE; /* err 7 */
clearstatcache();
}
/* READ FILE */
if( FALSE === ( $rows = file( $filename )))
return FALSE; /* err 1 */
/* identify BEGIN:VCALENDAR, MUST be first row */
if( 'BEGIN:VCALENDAR' != strtoupper( trim( $rows[0] )))
return FALSE; /* err 8 */
/* remove empty trailing lines */
while( '' == trim( $rows[count( $rows ) - 1] )) {
unset( $rows[count( $rows ) - 1] );
$rows = array_values( $rows );
}
/* identify ending END:VCALENDAR row */
if( 'END:VCALENDAR' != strtoupper( trim( $rows[count( $rows ) - 1] ))) {
return FALSE; /* err 9 */
}
if( 3 > count( $rows ))
return FALSE; /* err 10 */
$comp = $subcomp = null;
$actcomp = & $this;
$nl = $this->getConfig( 'nl' );
$calsync = 0;
/* identify components and update unparsed data within component */
foreach( $rows as $line ) {
if( '' == trim( $line ))
continue;
if( $nl == substr( $line, 0 - strlen( $nl )))
$line = substr( $line, 0, ( strlen( $line ) - strlen( $nl ))).'\n';
if( 'BEGIN:VCALENDAR' == strtoupper( substr( $line, 0, 15 ))) {
$calsync++;
continue;
}
elseif( 'END:VCALENDAR' == strtoupper( substr( $line, 0, 13 ))) {
$calsync--;
continue;
}
elseif( 1 != $calsync )
return FALSE; /* err 20 */
if( 'END:' == strtoupper( substr( $line, 0, 4 ))) {
if( null != $subcomp ) {
$comp->setComponent( $subcomp );
$subcomp = null;
}
else {
$this->setComponent( $comp );
$comp = null;
}
$actcomp = null;
continue;
} // end - if ( 'END:' ==.. .
elseif( 'BEGIN:' == strtoupper( substr( $line, 0, 6 ))) {
$line = str_replace( '\n', '', $line );
$compname = trim (strtoupper( substr( $line, 6 )));
if( null != $comp ) {
if( 'VALARM' == $compname )
$subcomp = new valarm();
elseif( 'STANDARD' == $compname )
$subcomp = new vtimezone( 'STANDARD' );
elseif( 'DAYLIGHT' == $compname )
$subcomp = new vtimezone( 'DAYLIGHT' );
else
return FALSE; /* err 6 */
$actcomp = & $subcomp;
}
else {
switch( $compname ) {
case 'VALARM':
$comp = new valarm();
break;
case 'VEVENT':
$comp = new vevent();
break;
case 'VFREEBUSY';
$comp = new vfreebusy();
break;
case 'VJOURNAL':
$comp = new vjournal();
break;
case 'VTODO':
$comp = new vtodo();
break;
case 'VTIMEZONE':
$comp = new vtimezone();
break;
default:
return FALSE; // err 7
break;
} // end - switch
$actcomp = & $comp;
}
continue;
} // end - elsif ( 'BEGIN:'.. .
/* update selected component with unparsed data */
$actcomp->unparsed[] = $line;
} // end - foreach( rows.. .
/* parse data for calendar (this) object */
if( is_array( $this->unparsed ) && ( 0 < count( $this->unparsed ))) {
/* concatenate property values spread over several lines */
$lastix = -1;
$propnames = array( 'calscale','method','prodid','version','x-' );
$proprows = array();
foreach( $this->unparsed as $line ) {
$newProp = FALSE;
foreach ( $propnames as $propname ) {
if( $propname == strtolower( substr( $line, 0, strlen( $propname )))) {
$newProp = TRUE;
break;
}
}
if( $newProp ) {
$newProp = FALSE;
$lastix++;
$proprows[$lastix] = $line;
}
else {
/* remove line breaks */
if(( '\n' == substr( $proprows[$lastix], -2 )) &&
( ' ' == substr( $line, 0, 1 ))) {
$proprows[$lastix] = substr( $proprows[$lastix], 0, strlen( $proprows[$lastix] ) - 2 );
$line = substr( $line, 1 );
}
$proprows[$lastix] .= $line;
}
}
$toolbox = new calendarComponent();
foreach( $proprows as $line ) {
if( '\n' == substr( $line, -2 ))
$line = substr( $line, 0, strlen( $line ) - 2 );
/* get propname */
$cix = $propname = null;
for( $cix=0; $cix < strlen( $line ); $cix++ ) {
if( in_array( $line{$cix}, array( ':', ';' )))
break;
else
$propname .= $line{$cix};
}
/* ignore version/prodid properties */
if( in_array( strtoupper( $propname ), array( 'VERSION', 'PRODID' )))
continue;
$line = substr( $line, $cix);
/* separate attributes from value */
$attr = array();
$attrix = -1;
$strlen = strlen( $line );
for( $cix=0; $cix < $strlen; $cix++ ) {
if(( ':' == $line{$cix} ) &&
( '://' != substr( $line, $cix, 3 )) &&
( 'mailto:' != strtolower( substr( $line, $cix - 6, 7 )))) {
$attrEnd = TRUE;
if(( $cix < ( $strlen - 4 )) &&
ctype_digit( substr( $line, $cix+1, 4 ))) { // an URI with a (4pos) portnr??
for( $c2ix = $cix; 3 < $c2ix; $c2ix-- ) {
if( '://' == substr( $line, $c2ix - 2, 3 )) {
$attrEnd = FALSE;
break; // an URI with a portnr!!
}
}
}
if( $attrEnd) {
$line = substr( $line, $cix + 1 );
break;
}
}
if( ';' == $line{$cix} )
$attr[++$attrix] = null;
else
$attr[$attrix] .= $line{$cix};
}
/* make attributes in array format */
$propattr = array();
foreach( $attr as $attribute ) {
$attrsplit = explode( '=', $attribute, 2 );
if( 1 < count( $attrsplit ))
$propattr[$attrsplit[0]] = $attrsplit[1];
else
$propattr[] = $attribute;
}
/* update Property */
if( FALSE !== strpos( $line, ',' )) {
$content = explode( ',', $line );
$clen = count( $content );
for( $cix = 0; $cix < $clen; $cix++ ) {
if( "\\" == substr( $content[$cix], -1 )) {
$content[$cix] .= ','.$content[$cix + 1];
unset( $content[$cix + 1] );
$cix++;
}
}
if( 1 < count( $content )) {
foreach( $content as $cix => $contentPart )
$content[$cix] = $toolbox->_strunrep( $contentPart );
$this->setProperty( $propname, $content, $propattr );
continue;
}
else
$line = reset( $content );
$line = $toolbox->_strunrep( $line );
}
$this->setProperty( $propname, trim( $line ), $propattr );
} // end - foreach( $this->unparsed.. .
} // end - if( is_array( $this->unparsed.. .
/* parse Components */
if( is_array( $this->components ) && ( 0 < count( $this->components ))) {
for( $six = 0; $six < count( $this->components ); $six++ )
$this->components[$six]->parse();
}
else
return FALSE; /* err 91 or something.. . */
}
/*********************************************************************************/
/**
* creates formatted output for calendar object instance
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-10-25
* @return string
*/
function createCalendar() {
$calendarInit1 = $calendarInit2 = $calendarxCaldecl = $calendarStart = $calendar = null;
switch( $this->format ) {
case 'xcal':
$calendarInit1 = '<?xml version="1.0" encoding="UTF-8"?>'.$this->nl.
'<!DOCTYPE iCalendar PUBLIC "-//IETF//DTD XCAL/iCalendar XML//EN"'.$this->nl.
'"http://www.ietf.org/internet-drafts/draft-ietf-calsch-many-xcal-01.txt"';
$calendarInit2 = '>'.$this->nl;
$calendarStart = '<vcalendar';
break;
default:
$calendarStart = 'BEGIN:VCALENDAR'.$this->nl;
break;
}
$calendarStart .= $this->createCalscale();
$calendarStart .= $this->createMethod();
$calendarStart .= $this->createProdid();
$calendarStart .= $this->createVersion();
switch( $this->format ) {
case 'xcal':
$nlstrlen = strlen( $this->nl );
if( $this->nl == substr( $calendarStart, ( 0 - $nlstrlen )))
$calendarStart = substr( $calendarStart, 0, ( strlen( $calendarStart ) - $nlstrlen ));
$calendarStart .= '>'.$this->nl;
break;
default:
break;
}
$calendar .= $this->createXprop();
foreach( $this->components as $component ) {
if( '' >= $component->getConfig( 'language'))
$component->setConfig( 'language', $this->getConfig( 'language' ));
$component->setConfig( 'allowEmpty', $this->getConfig( 'allowEmpty' ));
$component->setConfig( 'nl', $this->getConfig( 'nl' ));
$component->setConfig( 'unique_id', $this->getConfig( 'unique_id' ));
$component->setConfig( 'format', $this->getConfig( 'format' ));
$calendar .= $component->createComponent( $this->xcaldecl );
}
if(( 0 < count( $this->xcaldecl )) && ( 'xcal' == $this->format )) { // xCal only
$calendarInit1 .= $this->nl.'['.$this->nl;
$old_xcaldecl = array();
foreach( $this->xcaldecl as $declix => $declPart ) {
if(( 0 < count( $old_xcaldecl)) &&
( in_array( $declPart['uri'], $old_xcaldecl['uri'] )) &&
( in_array( $declPart['external'], $old_xcaldecl['external'] )))
continue; // no duplicate uri and ext. references
$calendarxCaldecl .= '<!';
foreach( $declPart as $declKey => $declValue ) {
switch( $declKey ) { // index
case 'xmldecl': // no 1
$calendarxCaldecl .= $declValue.' ';
break;
case 'uri': // no 2
$calendarxCaldecl .= $declValue.' ';
$old_xcaldecl['uri'][] = $declValue;
break;
case 'ref': // no 3
$calendarxCaldecl .= $declValue.' ';
break;
case 'external': // no 4
$calendarxCaldecl .= '"'.$declValue.'" ';
$old_xcaldecl['external'][] = $declValue;
break;
case 'type': // no 5
$calendarxCaldecl .= $declValue.' ';
break;
case 'type2': // no 6
$calendarxCaldecl .= $declValue;
break;
}
}
$calendarxCaldecl .= '>'.$this->nl;
}
$calendarInit2 = ']'.$calendarInit2;
}
switch( $this->format ) {
case 'xcal':
$calendar .= '</vcalendar>'.$this->nl;
break;
default:
$calendar .= 'END:VCALENDAR'.$this->nl;
break;
}
return $calendarInit1.$calendarxCaldecl.$calendarInit2.$calendarStart.$calendar;
}
/**
* a HTTP redirect header is sent with created, updated and/or parsed calendar
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.12 - 2007-10-23
* @return redirect
*/
function returnCalendar() {
$filename = $this->getConfig( 'filename' );
$output = $this->createCalendar();
$filesize = strlen( $output );
// if( headers_sent( $filename, $linenum ))
// die( "Headers already sent in $filename on line $linenum\n" );
if( 'xcal' == $this->format )
header( 'Content-Type: application/calendar+xml; charset=utf-8' );
else
header( 'Content-Type: text/calendar; charset=utf-8' );
header( 'Content-Length: '.$filesize );
header( 'Content-Disposition: attachment; filename="'.$filename.'"' );
header( 'Cache-Control: max-age=10' );
echo $output;
die();
}
/**
* save content in a file
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.12 - 2007-12-30
* @param string $directory optional
* @param string $filename optional
* @param string $delimiter optional
* @return bool
*/
function saveCalendar( $directory=FALSE, $filename=FALSE, $delimiter=FALSE ) {
if( $directory )
$this->setConfig( 'directory', $directory );
if( $filename )
$this->setConfig( 'filename', $filename );
if( $delimiter && ($delimiter != DIRECTORY_SEPARATOR ))
$this->setConfig( 'delimiter', $delimiter );
if( FALSE === ( $dirfile = $this->getConfig( 'url' )))
$dirfile = $this->getConfig( 'dirfile' );
$iCalFile = @fopen( $dirfile, 'w' );
if( $iCalFile ) {
if( FALSE === fwrite( $iCalFile, $this->createCalendar() ))
return FALSE;
fclose( $iCalFile );
return TRUE;
}
else
return FALSE;
}
/**
* if recent version of calendar file exists (default one hour), an HTTP redirect header is sent
* else FALSE is returned
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.12 - 2007-10-28
* @param string $directory optional alt. int timeout
* @param string $filename optional
* @param string $delimiter optional
* @param int timeout optional, default 3600 sec
* @return redirect/FALSE
*/
function useCachedCalendar( $directory=FALSE, $filename=FALSE, $delimiter=FALSE, $timeout=3600) {
if ( $directory && ctype_digit( (string) $directory ) && !$filename ) {
$timeout = (int) $directory;
$directory = FALSE;
}
if( $directory )
$this->setConfig( 'directory', $directory );
if( $filename )
$this->setConfig( 'filename', $filename );
if( $delimiter && ( $delimiter != DIRECTORY_SEPARATOR ))
$this->setConfig( 'delimiter', $delimiter );
$filesize = $this->getConfig( 'filesize' );
if( 0 >= $filesize )
return FALSE;
$dirfile = $this->getConfig( 'dirfile' );
if( time() - filemtime( $dirfile ) < $timeout) {
clearstatcache();
$dirfile = $this->getConfig( 'dirfile' );
$filename = $this->getConfig( 'filename' );
// if( headers_sent( $filename, $linenum ))
// die( "Headers already sent in $filename on line $linenum\n" );
if( 'xcal' == $this->format )
header( 'Content-Type: application/calendar+xml; charset=utf-8' );
else
header( 'Content-Type: text/calendar; charset=utf-8' );
header( 'Content-Length: '.$filesize );
header( 'Content-Disposition: attachment; filename="'.$filename.'"' );
header( 'Cache-Control: max-age=10' );
$fp = @$fopen( $dirfile, 'r' );
if( $fp ) {
fpassthru( $fp );
fclose( $fp );
}
die();
}
else
return FALSE;
}
}
/*********************************************************************************/
/*********************************************************************************/
/**
* abstract class for calendar components
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.1 - 2007-11-19
*/
class calendarComponent {
// component property variables
var $uid;
var $dtstamp;
var $action;
var $attach;
var $attendee;
var $categories;
var $comment;
var $completed;
var $contact;
var $class;
var $created;
var $description;
var $dtend;
var $dtstart;
var $due;
var $duration;
var $exdate;
var $exrule;
var $freebusy;
var $geo;
var $lastmodified;
var $location;
var $organizer;
var $percentcomplete;
var $priority;
var $rdate;
var $recurrenceid;
var $relatedto;
var $repeat;
var $requeststatus;
var $resources;
var $rrule;
var $sequence;
var $status;
var $summary;
var $transp;
var $trigger;
var $tzid;
var $tzname;
var $tzoffsetfrom;
var $tzoffsetto;
var $tzurl;
var $url;
var $xprop;
// component subcomponents container
var $components;
// component config variables
var $allowEmpty;
var $language;
var $nl;
var $unique_id;
var $format;
var $objName; // created automatically at instance creation
// component internal variables
var $componentStart1;
var $componentStart2;
var $componentEnd1;
var $componentEnd2;
var $elementStart1;
var $elementStart2;
var $elementEnd1;
var $elementEnd2;
var $intAttrDelimiter;
var $attributeDelimiter;
var $valueInit;
// component xCal declaration container
var $xcaldecl;
/**
* constructor for calendar component object
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.1 - 2007-11-19
*/
function calendarComponent() {
$this->objName = ( isset( $this->timezonetype )) ?
strtolower( $this->timezonetype ) : get_class ( $this );
$this->uid = array();
$this->dtstamp = array();
$this->action = array();
$this->attach = array();
$this->attendee = array();
$this->categories = array();
$this->class = array();
$this->comment = array();
$this->completed = array();
$this->contact = array();
$this->created = array();
$this->description = array();
$this->dtend = array();
$this->dtstart = array();
$this->due = array();
$this->duration = array();
$this->exdate = array();
$this->exrule = array();
$this->freebusy = array();
$this->geo = array();
$this->lastmodified = array();
$this->location = array();
$this->organizer = array();
$this->percentcomplete = array();
$this->priority = array();
$this->rdate = array();
$this->recurrenceid = array();
$this->relatedto = array();
$this->repeat = array();
$this->requeststatus = array();
$this->resources = array();
$this->sequence = array();
$this->rrule = array();
$this->status = array();
$this->summary = array();
$this->transp = array();
$this->trigger = array();
$this->tzid = array();
$this->tzname = array();
$this->tzoffsetfrom = array();
$this->tzoffsetto = array();
$this->tzurl = array();
$this->url = array();
$this->xprop = array();
$this->components = array();
$this->language = null;
$this->nl = null;
$this->unique_id = null;
$this->allowEmpty = TRUE;
$this->xcaldecl = array();
$this->_makeDtstamp();
}
/*********************************************************************************/
/**
* Property Name: ACTION
*/
/**
* creates formatted output for calendar component property action
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createAction() {
if( !isset( $this->action['value'] ))
return;
$attributes = $this->_createParams( $this->action['params'] );
return $this->_createElement( 'ACTION', $attributes, $this->action['value'] );
}
/**
* set calendar component property action
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.2 - 2006-11-16
* @param string $value "AUDIO" / "DISPLAY" / "EMAIL" / "PROCEDURE"
* @param mixed $params
* @return void
*/
function setAction( $value, $params=FALSE ) {
$this->action['value'] = $value;
$this->action['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: ATTACH
*/
/**
* creates formatted output for calendar component property attach
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createAttach() {
$cnt = count( $this->attach );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->attach as $attachPart ) {
$attributes = $this->_createParams( $attachPart['params'] );
$output .= $this->_createElement( 'ATTACH', $attributes, $attachPart['value'] );
}
return $output;
}
/**
* set calendar component property attach
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.22 - 2007-04-10
* @param string $value
* @param string $params
* @return void
*/
function setAttach( $value, $params=FALSE) {
$attach = array();
$attach['value'] = $value ;
$attach['params'] = $this->_setParams( $params );
$this->attach[] = $attach;
}
/*********************************************************************************/
/**
* Property Name: ATTENDEE
*/
/**
* creates formatted output for calendar component property attendee
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-20
* @return string
*/
function createAttendee() {
$cnt = count( $this->attendee );
if( 0 >= $cnt )
return;
$attendees = null;
foreach( $this->attendee as $attendeePart ) { // start foreach 1
$attendee1 = $attendee2 = $attendeeLANG = $attendeeCN = null;
foreach( $attendeePart as $paramlabel => $paramvalue ) { // start foreach 2
if( 'value' == $paramlabel ) {
$attendee2 .= 'MAILTO:'.$paramvalue;
}
elseif(( 'params' == $paramlabel ) && ( is_array( $paramvalue ))) { // start elseif
foreach( $paramvalue as $optparamlabel => $optparamvalue ) { // start foreach 3
$attendee11 = $attendee12 = null;
if( is_int( $optparamlabel )) {
$attendee1 .= $this->intAttrDelimiter.$optparamvalue;
continue;
}
switch( $optparamlabel ) { // start switch
case 'CUTYPE':
case 'PARTSTAT':
case 'ROLE':
case 'RSVP':
$attendee1 .= $this->intAttrDelimiter.$optparamlabel.'="'.$optparamvalue.'"';
break;
case 'SENT-BY':
$attendee1 .= $this->intAttrDelimiter.'SENT-BY="MAILTO:'.$optparamvalue.'"';
break;
case 'MEMBER':
$attendee11 = $this->intAttrDelimiter.'MEMBER=';
case 'DELEGATED-TO':
$attendee11 = ( !$attendee11 ) ? $this->intAttrDelimiter.'DELEGATED-TO=' : $attendee11;
case 'DELEGATED-FROM':
$attendee11 = ( !$attendee11 ) ? $this->intAttrDelimiter.'DELEGATED-FROM=' : $attendee11;
foreach( $optparamvalue as $cix => $calUserAddress ) {
$attendee12 .= ( $cix ) ? ',' : null;
$attendee12 .= '"MAILTO:'.$calUserAddress.'"';
}
$attendee1 .= $attendee11.$attendee12;
break;
case 'CN':
$attendeeCN .= $this->intAttrDelimiter.'CN="'.$optparamvalue.'"';
break;
case 'DIR':
$attendee1 .= $this->intAttrDelimiter.'DIR="'.$optparamvalue.'"';
break;
case 'LANGUAGE':
$attendeeLANG .= $this->intAttrDelimiter.'LANGUAGE='.$optparamvalue;
break;
default:
$attendee1 .= $this->intAttrDelimiter."$optparamlabel=$optparamvalue";
break;
} // end switch
} // end foreach 3
} // end elseif
} // end foreach 2
$attendees .= $this->_createElement( 'ATTENDEE', $attendee1.$attendeeLANG.$attendeeCN, $attendee2 );
} // end foreach 1
return $attendees;
}
/**
* set calendar component property attach
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-24
* @param string $value
* @param array $params optional
* @return void
*/
function setAttendee( $value, $params=FALSE ) {
$value = str_replace ( 'MAILTO:', '', $value );
$value = str_replace ( 'mailto:', '', $value );
$attendee = array( 'value' => $value, 'params' => array() );
if( is_array($params )) {
$optarrays = array();
foreach( $params as $optparamlabel => $optparamvalue ) {
$optparamlabel = strtoupper( $optparamlabel );
switch( $optparamlabel ) {
case 'MEMBER':
case 'DELEGATED-TO':
case 'DELEGATED-FROM':
if( is_array( $optparamvalue )) {
foreach( $optparamvalue as $part ) {
$part = str_replace( 'MAILTO:', '', $part );
$part = str_replace( 'mailto:', '', $part );
if(( '"' == $part{0} ) && ( '"' == $part{strlen($part)-1} ))
$part = substr( $part, 1, ( strlen($part)-2 ));
$optarrays[$optparamlabel][] = $part;
}
}
else {
$part = str_replace( 'MAILTO:', '', $optparamvalue );
$part = str_replace( 'mailto:', '', $part );
if(( '"' == $part{0} ) && ( '"' == $part{strlen($part)-1} ))
$part = substr( $part, 1, ( strlen($part)-2 ));
$optarrays[$optparamlabel][] = $part;
}
break;
default:
if( 'SENT-BY' == $optparamlabel ) {
$optparamvalue = str_replace( 'MAILTO:', '', $optparamvalue );
$optparamvalue = str_replace( 'mailto:', '', $optparamvalue );
}
if(( '"' == substr( $optparamvalue, 0, 1 )) &&
( '"' == substr( $optparamvalue, -1 )))
$optparamvalue = substr( $optparamvalue, 1, ( strlen( $optparamvalue ) - 2 ));
$attendee['params'][$optparamlabel] = $optparamvalue;
break;
} // end switch( $optparamlabel.. .
} // end foreach( $optparam.. .
foreach( $optarrays as $optparamlabel => $optparams )
$attendee['params'][$optparamlabel] = $optparams;
}
// remove defaults
if( isset( $attendee['params']['CUTYPE' ] ) &&
( strtoupper( $attendee['params']['CUTYPE' ] ) == 'INDIVIDUAL' ))
unset( $attendee['params']['CUTYPE' ] );
if( isset( $attendee['params']['PARTSTAT'] ) &&
( strtoupper( $attendee['params']['PARTSTAT'] ) == 'NEEDS-ACTION' ))
unset( $attendee['params']['PARTSTAT'] );
if( isset( $attendee['params']['ROLE'] ) &&
( strtoupper( $attendee['params']['ROLE'] ) == 'REQ-PARTICIPANT' ))
unset( $attendee['params']['ROLE'] );
if( isset( $attendee['params']['RSVP'] ) &&
( strtoupper( $attendee['params']['RSVP'] ) == 'FALSE' ))
unset( $attendee['params']['RSVP'] );
// check language setting
if( isset( $attendee['params']['CN' ] )) {
$lang = $this->getConfig( 'language' );
if( !isset( $attendee['params']['LANGUAGE' ] ) && !empty( $lang ))
$attendee['params']['LANGUAGE' ] = $lang;
}
$this->attendee[] = $attendee;
}
/*********************************************************************************/
/**
* Property Name: CATEGORIES
*/
/**
* creates formatted output for calendar component property categories
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-24
* @return string
*/
function createCategories() {
$cnt = count( $this->categories );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->categories as $category ) {
$attributes = $this->_createParams( $category['params'], array( 'LANGUAGE' ));
if( is_array( $category['value'] )) {
foreach( $category['value'] as $cix => $categoryPart )
$category['value'][$cix] = $this->_strrep( $categoryPart );
$content = implode( ',', $category['value'] );
}
else
$content = $this->_strrep( $category['value'] );
$output .= $this->_createElement( 'CATEGORIES', $attributes, $content );
}
return $output;
}
/**
* set calendar component property categories
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-24
* @param mixed $value
* @param array $params optional
* @return void
*/
function setCategories( $value, $params=FALSE ) {
$category = array();
$category['value'] = $value;
$category['params'] = $this->_setParams( $params );
$this->categories[] = $category;
}
/*********************************************************************************/
/**
* Property Name: CLASS
*/
/**
* creates formatted output for calendar component property class
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createClass() {
$cnt = count( $this->class );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->class['params'] );
return $this->_createElement( 'CLASS', $attributes, $this->class['value'] );
}
/**
* set calendar component property class
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2003-03-18
* @param string $value "PUBLIC" / "PRIVATE" / "CONFIDENTIAL" / iana-token / x-name
* @param array $params optional
* @return void
*/
function setClass( $value, $params=FALSE ) {
$this->class['value'] = $value;
$this->class['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: COMMENT
*/
/**
* creates formatted output for calendar component property comment
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createComment() {
$cnt = count( $this->comment );
if( 0 >= $cnt )
return;
$comment = null;
foreach( $this->comment as $commentPart ) {
$attributes = $this->_createParams( $commentPart['params'], array( 'ALTREP', 'LANGUAGE' ));
$content = $this->_strrep( $commentPart['value'] );
$comment .= $this->_createElement( 'COMMENT', $attributes, $content );
}
return $comment;
}
/**
* set calendar component property comment
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param array $params optional
* @return void
*/
function setComment( $value, $params=FALSE ) {
$comment['value'] = $value;
$comment['params'] = $this->_setParams( $params );
$this->comment[] = $comment;
}
/*********************************************************************************/
/**
* Property Name: COMPLETED
*/
/**
* creates formatted output for calendar component property completed
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createCompleted( ) {
if( !isset( $this->completed['value']['year'] ) &&
!isset( $this->completed['value']['month'] ) &&
!isset( $this->completed['value']['day'] ) &&
!isset( $this->completed['value']['hour'] ) &&
!isset( $this->completed['value']['min'] ) &&
!isset( $this->completed['value']['sec'] ))
return;
$formatted = $this->_format_date_time( $this->completed['value'], 7 );
$attributes = $this->_createParams( $this->completed['params'] );
return $this->_createElement( 'COMPLETED', $attributes, $formatted );
}
/**
* set calendar component property completed
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-08-02
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return void
*/
function setCompleted( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $params=FALSE ) {
$this->completed = $this->_setDate2( $year, $month, $day, $hour, $min, $sec, $params );
}
/*********************************************************************************/
/**
* Property Name: CONTACT
*/
/**
* creates formatted output for calendar component property contact
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-24
* @return string
*/
function createContact() {
$cnt = count( $this->contact );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->contact as $contact ) {
$attributes = $this->_createParams( $contact['params'], array( 'ALTREP', 'LANGUAGE' ));
$content = $this->_strrep( $contact['value'] );
$output .= $this->_createElement( 'CONTACT', $attributes, $content );
}
return $output;
}
/**
* set calendar component property contact
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @param string $value
* @param array $params optional
* @return void
*/
function setContact( $value, $params=FALSE ) {
$contact['value'] = $value;
$contact['params'] = $this->_setParams( $params );
$this->contact[] = $contact;
}
/*********************************************************************************/
/**
* Property Name: CREATED
*/
/**
* creates formatted output for calendar component property created
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createCreated() {
if( !isset( $this->created['value']['year'] ) &&
!isset( $this->created['value']['month'] ) &&
!isset( $this->created['value']['day'] ) &&
!isset( $this->created['value']['hour'] ) &&
!isset( $this->created['value']['min'] ) &&
!isset( $this->created['value']['sec'] ))
return;
$formatted = $this->_format_date_time( $this->created['value'], 7 );
$attributes = $this->_createParams( $this->created['params'] );
return $this->_createElement( 'CREATED', $attributes, $formatted );
}
/**
* set calendar component property created
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-08-02
* @param mixed $year optional
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param mixed $params optional
* @return void
*/
function setCreated( $year=FALSE, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $params=FALSE ) {
if( !isset( $year )) {
$year = date('Ymd\THis', mktime( date( 'H' ), date( 'i' ), date( 's' ) - date( 'Z'), date( 'm' ), date( 'd' ), date( 'Y' )));
}
$this->created = $this->_setDate2( $year, $month, $day, $hour, $min, $sec, $params );
}
/*********************************************************************************/
/**
* Property Name: DESCRIPTION
*/
/**
* creates formatted output for calendar component property description
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createDescription() {
$cnt = count( $this->description );
if( 0 >= $cnt )
return;
$descriptions = null;
foreach( $this->description as $description ) {
$attributes = $this->_createParams( $description['params'], array( 'ALTREP', 'LANGUAGE' ));
$content = $this->_strrep( $description['value'] );
$descriptions .= $this->_createElement( 'DESCRIPTION', $attributes, $content );
}
return $descriptions;
}
/**
* set calendar component property description
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param array $params optional
* @return void
*/
function setDescription( $value, $params=FALSE ) {
$description['value'] = $value;
$description['params'] = $this->_setParams( $params );
$this->description[] = $description;
}
/*********************************************************************************/
/**
* Property Name: DTEND
*/
/**
* creates formatted output for calendar component property dtend
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.19 - 2007-03-27
* @return string
*/
function createDtend() {
if( !isset( $this->dtend['value']['year'] ) &&
!isset( $this->dtend['value']['month'] ) &&
!isset( $this->dtend['value']['day'] ) &&
!isset( $this->dtend['value']['hour'] ) &&
!isset( $this->dtend['value']['min'] ) &&
!isset( $this->dtend['value']['sec'] ))
return;
$formatted = $this->_format_date_time( $this->dtend['value'] );
$attributes = $this->_createParams( $this->dtend['params'] );
return $this->_createElement( 'DTEND', $attributes, $formatted );
}
/**
* set calendar component property dtend
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param string $tz optional
* @param array params optional
* @return void
*/
function setDtend( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $tz=FALSE, $params=FALSE ) {
$this->dtend = $this->_setDate( $year, $month, $day, $hour, $min, $sec, $tz, $params );
}
/*********************************************************************************/
/**
* Property Name: DTSTAMP
*/
/**
* creates formatted output for calendar component property dtstamp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.4 - 2007-08-01
* @return string
*/
function createDtstamp() {
if( !isset( $htis->dtstamp['value']['year'] ) &&
!isset( $this->dtstamp['value']['month'] ) &&
!isset( $this->dtstamp['value']['day'] ) &&
!isset( $this->dtstamp['value']['hour'] ) &&
!isset( $this->dtstamp['value']['min'] ) &&
!isset( $this->dtstamp['value']['sec'] ))
$this->_makeDtstamp();
$formatted = $this->_format_date_time( $this->dtstamp['value'], 7 );
$attributes = $this->_createParams( $this->dtstamp['params'] );
return $this->_createElement( 'DTSTAMP', $attributes, $formatted );
}
/**
* computes datestamp for calendar component object instance dtstamp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-13
* @return void
*/
function _makeDtstamp() {
$this->dtstamp['value'] = array( 'year' => date( 'Y' )
, 'month' => date( 'm' )
, 'day' => date( 'd' )
, 'hour' => date( 'H' )
, 'min' => date( 'i' )
, 'sec' => date( 's' ) - date( 'Z' ));
$this->dtstamp['params'] = null;
}
/**
* set calendar component property dtstamp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-08-02
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return void
*/
function setDtstamp( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $params=FALSE ) {
$this->dtstamp = $this->_setDate2( $year, $month, $day, $hour, $min, $sec, $params );
}
/*********************************************************************************/
/**
* Property Name: DTSTART
*/
/**
* creates formatted output for calendar component property dtstart
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @param bool $localtime optional, default FALSE
* @return string
*/
function createDtstart( $localtime=FALSE ) {
if( !isset( $this->dtstart['value']['year'] ) &&
!isset( $this->dtstart['value']['month'] ) &&
!isset( $this->dtstart['value']['day'] ) &&
!isset( $this->dtstart['value']['hour'] ) &&
!isset( $this->dtstart['value']['min'] ) &&
!isset( $this->dtstart['value']['sec'] ))
return;
if( $localtime )
unset( $this->dtstart['value']['tz'] );
$formatted = $this->_format_date_time( $this->dtstart['value'] );
$attributes = $this->_createParams( $this->dtstart['params'] );
return $this->_createElement( 'DTSTART', $attributes, $formatted );
}
/**
* set calendar component property dtstart
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param string $tz optional
* @param array $params optional
* @return void
*/
function setDtstart( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $tz=FALSE, $params=FALSE ) {
$this->dtstart = $this->_setDate( $year, $month, $day, $hour, $min, $sec, $tz, $params );
}
/*********************************************************************************/
/**
* Property Name: DUE
*/
/**
* creates formatted output for calendar component property due
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.19 - 2007-03-27
* @return string
*/
function createDue() {
if( !isset( $this->due['value']['year'] ) &&
!isset( $this->due['value']['month'] ) &&
!isset( $this->due['value']['day'] ) &&
!isset( $this->due['value']['hour'] ) &&
!isset( $this->due['value']['min'] ) &&
!isset( $this->due['value']['sec'] ))
return;
$formatted = $this->_format_date_time( $this->due['value'] );
$attributes = $this->_createParams( $this->due['params'] );
return $this->_createElement( 'DUE', $attributes, $formatted );
}
/**
* set calendar component property due
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return void
*/
function setDue( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $tz=FALSE, $params=FALSE ) {
$this->due = $this->_setDate( $year, $month, $day, $hour, $min, $sec, $tz, $params );
}
/*********************************************************************************/
/**
* Property Name: DURATION
*/
/**
* creates formatted output for calendar component property duration
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createDuration() {
if( !isset( $this->duration['value']['week'] ) &&
!isset( $this->duration['value']['day'] ) &&
!isset( $this->duration['value']['hour'] ) &&
!isset( $this->duration['value']['min'] ) &&
!isset( $this->duration['value']['sec'] ))
return;
$attributes = $this->_createParams( $this->duration['params'] );
return $this->_createElement( 'DURATION', $attributes, $this->_format_duration( $this->duration['value'] ));
}
/**
* set calendar component property duration
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param mixed $week
* @param mixed $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return void
*/
function setDuration( $week=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $params=FALSE ) {
if( is_array( $week )) {
$this->duration['value'] = $this->_duration_array( $week );
$this->duration['params'] = $this->_setParams( $day );
}
elseif( is_string( $week ) && ( 3 <= strlen( trim( $week )))) {
if( in_array( substr( $week,0, 1 ), array( '+', '-' )))
$week = substr( $week, 1 );
$this->duration['value'] = $this->_duration_string( $week );
$this->duration['params'] = $this->_setParams( $day );
}
else {
$this->duration['value'] = $this->_duration_array( array( $week, $day, $hour, $min, $sec ));
$this->duration['params'] = $this->_setParams( $params );
}
}
/*********************************************************************************/
/**
* Property Name: EXDATE
*/
/**
* creates formatted output for calendar component property exdate
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createExdate() {
$cnt = count( $this->exdate );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->exdate as $theExdate ) {
$content = $attributes = null;
foreach( $theExdate['value'] as $eix => $exdatePart ) {
$formatted = $this->_format_date_time( $exdatePart );
if( isset( $theExdate['params']['TZID'] ))
$formatted = str_replace( 'Z', '', $formatted);
if( 0 < $eix ) {
if( isset( $theExdate['value'][0]['tz'] ) &&
( ctype_digit( substr( $theExdate['value'][0]['tz'], -4 )) ||
( 'Z' == $theExdate['value'][0]['tz'] ))) {
if( 'Z' != substr( $formatted, -1 ))
$formatted .= 'Z';
}
else
$formatted = str_replace( 'Z', '', $formatted );
}
if( 0 < $eix )
$content .= ',';
$content .= $formatted;
}
$attributes .= $this->_createParams( $theExdate['params'] );
$output .= $this->_createElement( 'EXDATE', $attributes, $content );
}
return $output;
}
/**
* set calendar component property exdate
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.5 - 2007-06-22
* @param array exdates
* @param array $params optional
* @return void
*/
function setExdate( $exdates, $params=FALSE ) {
$exdate = array();
$exdate['params'] = $this->_setParams( $params, array( 'VALUE' => 'DATE-TIME' ) );
$parno = ( isset( $exdate['params']['TZID'] )) ? 6 : null;
$parno = $this->_existRem( $exdate['params'], 'VALUE', 'DATE-TIME', 7, $parno );
if( !isset( $parno )) $parno = $this->_existRem( $exdate['params'], 'VALUE', 'DATE', 3 );
foreach( $exdates as $eix => $theExdate ) {
if( is_array( $theExdate ) &&
( in_array( count( $theExdate ), array( 3, 4, 6, 7 )))) {
if( isset( $exdate['params']['TZID'] ))
$theExdate['tz'] = $exdate['params']['TZID'];
if( !isset( $parno )) {
if( 4 < count( $theExdate ))
$parno = 7;
else
$parno = 3;
}
$exdatea = $this->_date_time_array( $theExdate, $parno );
}
elseif( is_array( $theExdate ) && isset( $theExdate['timestamp'] )) {
if( isset( $exdate['params']['TZID'] ))
$theExdate['tz'] = $exdate['params']['TZID'];
$tz = ( isset( $theExdate['tz'] )) ? ' '.$theExdate['tz'] : null;
if( !isset( $parno ))
$parno = ( !empty( $tz )) ? 7 : 6;
$exdatea = $this->_date_time_string( date( 'Y-m-d H:i:s', $theExdate['timestamp'] ).$tz, $parno );
}
elseif( 8 <= strlen( trim( $theExdate ))) { // ex. 2006-08-03 10:12:18
$exdatea = $this->_date_time_string( $theExdate, $parno );
if( isset( $exdate['params']['TZID'] ))
$exdatea['tz'] = $exdate['params']['TZID'];
}
if( !isset( $parno )) {
$parno = count( $exdatea );
if( 6 == $parno )
$parno = 7;
}
if( isset( $exdatea['tz'] ))
$exdatea['tz'] = (string) $exdatea['tz'];
$exdate['value'][] = $exdatea;
}
if( 0 < count( $exdate['value'] )) {
if( 3 == $parno ) {
$exdate['params']['VALUE'] = 'DATE';
foreach( $exdate['value'] as $eix => $exdatea )
unset( $exdate['value'][$eix]['tz'] );
unset( $exdate['params']['TZID'] );
}
if( !empty( $exdate['value'][0]['tz'] ) &&
( $exdate['value'][0]['tz'] != 'Z' ) &&
( !( in_array($exdate['value'][0]['tz']{0}, array( '+', '-' )) &&
ctype_digit( substr( $exdate['value'][0]['tz'], 1 ))) &&
!ctype_digit( $exdate['value'][0]['tz'] ) ) ) {
$exdate['params']['TZID'] = $exdate['value'][0]['tz'];
foreach( $exdate['value'] as $exix => $exdatea ) {
if( !empty( $exdate['value'][0]['tz'] ) &&
( $exdate['value'][0]['tz'] != 'Z' ) &&
( !( in_array($exdate['value'][0]['tz']{0}, array( '+', '-' )) &&
ctype_digit( substr( $exdate['value'][0]['tz'], 1 ))) &&
!ctype_digit( $exdate['value'][0]['tz'] ) ) )
unset( $exdate['value'][$exix]['tz'] );
}
}
elseif( isset( $exdate['params']['TZID'] ))
unset( $exdate['params']['TZID'] );
$this->exdate[] = $exdate;
}
}
/*********************************************************************************/
/**
* Property Name: EXRULE
*/
/**
* creates formatted output for calendar component property exrule
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.7.28 - 2006-09-13
* @return string
*/
function createExrule() {
$cnt = count( $this->exrule );
if( 0 >= $cnt )
return;
$exrule = 'EXRULE';
return $this->_format_recur( $exrule, $this->exrule );
}
/**
* set calendar component property exdate
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param array $exruleset
* @param array $params optional
* @return void
*/
function setExrule( $exruleset, $params=FALSE ) {
$exrule = array();
foreach( $exruleset as $exrulelabel => $exrulevalue ) {
$exrulelabel = strtoupper( $exrulelabel );
if( 'UNTIL' != $exrulelabel )
$exrule['value'][$exrulelabel] = $exrulevalue;
elseif( is_array( $exrulevalue ) &&
(( 3 == count( $exrulevalue )) ||
( 6 == count( $exrulevalue )) ||
( 7 == count( $exrulevalue )) ||
( array_key_exists( 'year', $exrulevalue )))) {
$parno = ( 3 < count( $exrulevalue )) ? 7 : 3 ;
$date = $this->_date_time_array( $exrulevalue, $parno );
if(( 3 < count( $date )) && !isset( $date['tz'] ))
$date['tz'] = 'Z';
$exrule['value'][$exrulelabel] = $date;
}
elseif( is_array( $exrulevalue ) && isset( $exrulevalue['timestamp'] )) {
$date = $this->_date_time_string( date( 'Y-m-d H:i:s', $exrulevalue['timestamp'] ), 6 );
$date['tz'] = 'Z';
$exrule['value'][$exrulelabel] = $date;
}
elseif( 8 <= strlen( trim( $exrulevalue ))) { // ex. 2006-08-03 10:12:18
$date = $this->_date_time_string( $exrulevalue );
if(( 3 < count( $date )) && !isset( $date['tz'] ))
$date['tz'] = 'Z';
$exrule['value'][$exrulelabel] = $date;
}
}
$exrule['params'] = $this->_setParams( $params );
$this->exrule[] = $exrule;
}
/*********************************************************************************/
/**
* Property Name: FREEBUSY
*/
/**
* creates formatted output for calendar component property freebusy
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-16
* @return string
*/
function createFreebusy() {
$cnt = count( $this->freebusy );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->freebusy as $freebusyPart ) {
$attributes = $content = null;
if( isset( $freebusyPart['value']['fbtype'] )) {
$attributes .= $this->intAttrDelimiter.'FBTYPE='.$freebusyPart['value']['fbtype'];
unset( $freebusyPart['value']['fbtype'] );
$freebusyPart['value'] = array_values( $freebusyPart['value'] );
}
else
$attributes .= $this->intAttrDelimiter.'FBTYPE=BUSY';
$attributes .= $this->_createParams( $freebusyPart['params'] );
$fno = 1;
$cnt = count( $freebusyPart['value']);
foreach( $freebusyPart['value'] as $periodix => $freebusyPeriod ) {
$formatted = $this->_format_date_time( $freebusyPeriod[0] );
$content .= $formatted;
$content .= '/';
$cnt2 = count( $freebusyPeriod[1]);
if( array_key_exists( 'year', $freebusyPeriod[1] )) // date-time
$cnt2 = 7;
elseif( array_key_exists( 'week', $freebusyPeriod[1] )) // duration
$cnt2 = 5;
if(( 7 == $cnt2 ) && // period= -> date-time
isset( $freebusyPeriod[1]['year'] ) &&
isset( $freebusyPeriod[1]['month'] ) &&
isset( $freebusyPeriod[1]['day'] )) {
$content .= $this->_format_date_time( $freebusyPeriod[1] );
}
else { // period= -> dur-time
$content .= $this->_format_duration( $freebusyPeriod[1] );
}
if( $fno < $cnt )
$content .= ',';
$fno++;
}
$output .= $this->_createElement( 'FREEBUSY', $attributes, $content );
}
return $output;
}
/**
* set calendar component property freebusy
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $fbType
* @param array $fbValues
* @param array $params optional
* @return void
*/
function setFreebusy( $fbType, $fbValues, $params=FALSE ) {
$fbType = strtoupper( $fbType );
if(( !in_array( $fbType, array( 'FREE', 'BUSY', 'BUSY-UNAVAILABLE', 'BUSY-TENTATIVE' ))) &&
( 'X-' != substr( $fbType, 0, 2 )))
$fbType = 'BUSY';
$freebusy['value'] = array( 'fbtype' => $fbType );
foreach( $fbValues as $fbPeriod ) { // periods => period
$freebusyPeriod = array();
foreach( $fbPeriod as $fbMember ) { // pairs => singlepart
$freebusyPairMember = array();
if( is_array( $fbMember )) {
$cnt = count( $fbMember );
if(( 6 == $cnt ) || ( 7 == $cnt ) || ( array_key_exists( 'year', $fbMember ))) { // date-time value
$date = $this->_date_time_array( $fbMember, 7 );
$date['tz'] = ( !isset( $date['tz'] )) ? 'Z' : $date['tz'];
$freebusyPairMember = $date;
}
elseif( array_key_exists( 'timestamp', $fbMember )) { // timestamp value
$tz = ( isset( $fbMember['tz'] )) ? ' '.$fbMember['tz'] : null;
$parno = ( !empty( $tz )) ? 7 : 6;
$date = $this->_date_time_string( date( 'Y-m-d H:i:s', $fbMember['timestamp'] ).$tz, $parno );
$date['tz'] = ( !isset( $date['tz'] )) ? 'Z' : $date['tz'];
$freebusyPairMember = $date;
}
else { // array format duration
$freebusyPairMember = $this->_duration_array( $fbMember );
}
}
elseif(( 3 <= strlen( trim( $fbMember ))) && // string format duration
( in_array( $fbMember{0}, array( 'P', '+', '-' )))) {
if( 'P' != $fbMember{0} )
$fbmember = substr( $fbMember, 1 );
$freebusyPairMember = $this->_duration_string( $fbMember );
}
elseif( 8 <= strlen( trim( $fbMember ))) { // ex. 2006-08-03 10:12:18
$date = $this->_date_time_string( $fbMember, 7 );
$date['tz'] = ( !isset( $date['tz'] )) ? 'Z' : $date['tz'];
$freebusyPairMember = $date;
}
$freebusyPeriod[] = $freebusyPairMember;
}
$freebusy['value'][] = $freebusyPeriod;
}
$freebusy['params'] = $this->_setParams( $params );
$this->freebusy[] = $freebusy;
}
/*********************************************************************************/
/**
* Property Name: GEO
*/
/**
* creates formatted output for calendar component property geo
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createGeo() {
$cnt = count( $this->geo );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->geo['params'] );
$content = null;
$content .= number_format( (float) $this->geo['value']['latitude'], 6, '.', '');
$content .= ';';
$content .= number_format( (float) $this->geo['value']['longitude'], 6, '.', '');
return $this->_createElement( 'GEO', $attributes, $content );
}
/**
* set calendar component property geo
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param float $latitude
* @param float $longitude
* @param array $params optional
* @return void
*/
function setGeo( $latitude, $longitude, $params=FALSE ) {
$this->geo['value']['latitude'] = $latitude;
$this->geo['value']['longitude'] = $longitude;
$this->geo['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: LAST-MODIFIED
*/
/**
* creates formatted output for calendar component property last-modified
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createLastModified() {
if( !isset( $this->lastmodified['value']['year'] ) &&
!isset( $this->lastmodified['value']['month'] ) &&
!isset( $this->lastmodified['value']['day'] ) &&
!isset( $this->lastmodified['value']['hour'] ) &&
!isset( $this->lastmodified['value']['min'] ) &&
!isset( $this->lastmodified['value']['sec'] ))
return;
$attributes = $this->_createParams( $this->lastmodified['params'] );
$formatted = $this->_format_date_time( $this->lastmodified['value'], 7 );
return $this->_createElement( 'LAST-MODIFIED', $attributes, $formatted );
}
/**
* set calendar component property completed
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-08-02
* @param mixed $year optional
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return void
*/
function setLastModified( $year=FALSE, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $params=FALSE ) {
if( !isset( $year )) {
$year = date('Ymd\THis', mktime( date( 'H' ), date( 'i' ), date( 's' ) - date( 'Z'), date( 'm' ), date( 'd' ), date( 'Y' )));
}
$this->lastmodified = $this->_setDate2( $year, $month, $day, $hour, $min, $sec, $params );
}
/*********************************************************************************/
/**
* Property Name: LOCATION
*/
/**
* creates formatted output for calendar component property location
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createLocation() {
$cnt = count( $this->location );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->location['params'], array( 'ALTREP', 'LANGUAGE' ));
$content = $this->_strrep( $this->location['value'] );
return $this->_createElement( 'LOCATION', $attributes, $content );
}
/**
* set calendar component property location
'
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param array params optional
* @return void
*/
function setLocation( $value, $params=FALSE ) {
$this->location['value'] = $value;
$this->location['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: ORGANIZER
*/
/**
* creates formatted output for calendar component property organizer
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createOrganizer() {
$cnt = count( $this->organizer );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->organizer['params']
, array( 'CN', 'DIR', 'LANGUAGE', 'SENT-BY' ));
$content = 'MAILTO:'.$this->organizer['value'];
return $this->_createElement( 'ORGANIZER', $attributes, $content );
}
/**
* set calendar component property organizer
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.9 - 2007-06-30
* @param string $value
* @param array params optional
* @return void
*/
function setOrganizer( $value, $params=FALSE ) {
$value = str_replace ( 'MAILTO:', '', $value );
$value = str_replace ( 'mailto:', '', $value );
$this->organizer['value'] = $value;
$this->organizer['params'] = $this->_setParams( $params );
if( isset($this->organizer['params']['SENT-BY'] )) {
if( 'MAILTO' == strtoupper( substr( $this->organizer['params']['SENT-BY'], 0, 6 )))
$this->organizer['params']['SENT-BY'] = substr( $this->organizer['params']['SENT-BY'], 7 );
}
}
/*********************************************************************************/
/**
* Property Name: PERCENT-COMPLETE
*/
/**
* creates formatted output for calendar component property percent-complete
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createPercentComplete() {
$cnt = count( $this->percentcomplete );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->percentcomplete['params'] );
return $this->_createElement( 'PERCENT-COMPLETE', $attributes, $this->percentcomplete['value'] );
}
/**
* set calendar component property percent-complete
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param int $value
* @param array $params optional
* @return void
*/
function setPercentComplete( $value, $params=FALSE ) {
$this->percentcomplete['value'] = $value;
$this->percentcomplete['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: PRIORITY
*/
/**
* creates formatted output for calendar component property priority
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createPriority() {
$cnt = count( $this->priority );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->priority['params'] );
return $this->_createElement( 'PRIORITY', $attributes, $this->priority['value'] );
}
/**
* set calendar component property priority
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param int $value
* @param array $params optional
* @return void
*/
function setPriority( $value, $params=FALSE ) {
$this->priority['value'] = $value;
$this->priority['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: RDATE
*/
/**
* creates formatted output for calendar component property rdate
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-13
* @param bool $localtime optional, default FALSE
* @return string
*/
function createRdate( $localtime=FALSE ) {
$cnt = count( $this->rdate );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->rdate as $theRdate ) {
$attributes = $this->_createParams( $theRdate['params'] );
$cnt = count( $theRdate['value'] );
$content = null;
$rno = 1;
foreach( $theRdate['value'] as $rpix =>$rdatePart ) {
$contentPart = null;
if( is_array( $rdatePart ) &&
( 2 == count( $rdatePart )) &&
array_key_exists( '0', $rdatePart ) &&
array_key_exists( '1', $rdatePart )) { // PERIOD
if( $localtime )
unset( $rdatePart[0]['tz'] );
$formatted = $this->_format_date_time( $rdatePart[0]);
if( isset( $theRdate['params']['TZID'] ))
$formatted = str_replace( 'Z', '', $formatted);
if( 0 < $rpix ) {
if( isset( $rdatePart[0]['tz'] ) &&
( ctype_digit( substr( $rdatePart[0]['tz'], -4 )) ||
( 'Z' == $rdatePart[0]['tz'] ))) {
if( 'Z' != substr( $formatted, -1 ))
$formatted .= 'Z';
}
else
$formatted = str_replace( 'Z', '', $formatted );
}
$contentPart .= $formatted;
if( 1 == $rno )
$attributes .= $this->intAttrDelimiter.'VALUE=PERIOD';
$contentPart .= '/';
$cnt2 = count( $rdatePart[1]);
if( array_key_exists( 'year', $rdatePart[1] )) {
if( array_key_exists( 'hour', $rdatePart[1] ))
$cnt2 = 7; // date-time
else
$cnt2 = 3; // date
}
elseif( array_key_exists( 'week', $rdatePart[1] )) // duration
$cnt2 = 5;
if(( 7 == $cnt2 ) && // period= -> date-time
isset( $rdatePart[1]['year'] ) &&
isset( $rdatePart[1]['month'] ) &&
isset( $rdatePart[1]['day'] )) {
if( $localtime )
unset( $rdatePart[1]['tz'] );
$formatted = $this->_format_date_time( $rdatePart[1] );
if( isset( $theRdate['params']['TZID'] ))
$formatted = str_replace( 'Z', '', $formatted);
if( isset( $rdatePart[0]['tz'] ) &&
( ctype_digit( substr( $rdatePart[0]['tz'], -4 )) ||
( 'Z' == $rdatePart[0]['tz'] ))) {
if( 'Z' != substr( $formatted, -1 ))
$formatted .= 'Z';
}
else
$formatted = str_replace( 'Z', '', $formatted );
$contentPart .= $formatted;
}
else { // period= -> dur-time
$contentPart .= $this->_format_duration( $rdatePart[1] );
}
} // PERIOD end
else { // single date start
if( $localtime )
unset( $rdatePart['tz'] );
$formatted = $this->_format_date_time( $rdatePart);
if( isset( $theRdate['params']['TZID'] ))
$formatted = str_replace( 'Z', '', $formatted);
if( 0 < $rpix ) {
$firstPart = ( 2 == count( $theRdate['value'][0] ))
? $theRdate['value'][0][0] : $theRdate['value'][0];
if( isset( $firstPart['tz'] ) &&
( ctype_digit( substr( $firstPart['tz'], -4 )) ||
( 'Z' == $firstPart['tz'] ))) {
if( 'Z' != substr( $formatted, -1 ))
$formatted .= 'Z';
}
else
$formatted = str_replace( 'Z', '', $formatted );
}
$contentPart .= $formatted;
}
$content .= $contentPart;
if( $rno < $cnt )
$content .= ',';
$rno++;
}
$output .= $this->_createElement( 'RDATE', $attributes, $content );
}
return $output;
}
/**
* set calendar component property rdate
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.14 - 2007-10-30
* @param array $rdates
* @param array $params optional
* @return void
*/
function setRdate( $rdates, $params=FALSE ) {
$input = array();
$input['params'] = $this->_setParams( $params, array( 'VALUE' => 'DATE-TIME' ));
$this->_existRem( $input['params'], 'VALUE', 'PERIOD' );
$parno = ( isset( $input['params']['TZID'] )) ? 6 : null;
$parno = ( !$parno ) ? $this->_existRem( $input['params'], 'VALUE', 'DATE-TIME', 7 ) : null;
$parno = ( !$parno ) ? $this->_existRem( $input['params'], 'VALUE', 'DATE', 3 ) : 6;
$this->_existRem( $input['params'], 'VALUE', 'DATE-TIME' );
foreach( $rdates as $theRdate ) {
// echo 'setRdate in '; print_r ( $theRdate ); echo " \n"; // test ##
$inputa = null;
if( is_array( $theRdate )) {
if(( 2 == count( $theRdate )) &&
array_key_exists( '0', $theRdate ) &&
array_key_exists( '1', $theRdate ) &&
!array_key_exists( 'timestamp', $theRdate )) { // PERIOD
foreach( $theRdate as $rix => $rPeriod ) {
// echo 'setRdate i2 '; print_r ( $rPeriod ); echo " \n"; // test ##
if( is_array( $rPeriod )) {
// echo 'setRdate i3 '; print_r ( $rPeriod ); echo " \n"; // test ##
if (( 1 == count( $rPeriod )) &&
( 8 <= strlen( reset( $rPeriod )))) { // text-date
// echo 'setRdate i4 '; print_r ( $rPeriod ); echo " \n"; // test ##
$inputab = $this->_date_time_string( reset( $rPeriod ), $parno );
if ( isset( $input['params']['TZID'] ))
$inputab['tz'] = (string) $input['params']['TZID'];
elseif( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
else
unset( $inputab['tz'] );
$parno = ( !isset( $parno )) ? count( $inputab ) : $parno;
if(( 7 == $parno ) && !isset( $inputab['tz'] ))
$inputab['tz'] = 'Z';
if( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
$inputa[] = $inputab;
}
elseif (((3 == count( $rPeriod )) && ( $rix < 1 )) ||
( 6 == count( $rPeriod )) ||
( 7 == count( $rPeriod )) ||
( array_key_exists( 'year', $rPeriod ))) { // date[-time] (only 1st rperiod)
if( !isset( $parno ) && 3 < count( $rPeriod ))
$parno = 7;
$inputab = $this->_date_time_array( $rPeriod, $parno );
if ( isset( $input['params']['TZID'] ))
$inputab['tz'] = (string) $input['params']['TZID'];
elseif( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
else
unset( $inputab['tz'] );
$parno = ( !isset( $parno )) ? count( $inputab ) : $parno;
if(( 7 == $parno ) && !isset( $inputab['tz'] ))
$inputab['tz'] = 'Z';
if( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
$inputa[] = $inputab;
}
elseif( isset( $rPeriod['timestamp'] )) { // timestamp
$tz = ( isset( $rPeriod['tz'] )) ? ' '.$rPeriod['tz'] : null;
$tz = ( isset( $input['params']['TZID'] )) ? ' '.$input['params']['TZID'] : $tz;
if( !isset( $parno )) $parno = ( !empty( $tz )) ? 7 : 6;
$inputab = $this->_date_time_string( date( 'Y-m-d H:i:s', $rPeriod['timestamp'] ).$tz, $parno );
if(( 7 == $parno ) && !isset( $inputab['tz'] ))
$inputab['tz'] = 'Z';
if( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
$inputa[] = $inputab;
}
else { // array format duration
$inputa[] = $this->_duration_array( $rPeriod );
}
}
elseif(( 3 <= strlen( trim( $rPeriod ))) && // string format duration
( in_array( $rPeriod{0}, array( 'P', '+', '-' )))) {
if( 'P' != $rPeriod{0} )
$rPeriod = substr( $rPeriod, 1 );
$inputa[] = $this->_duration_string( $rPeriod );
}
elseif( 8 <= strlen( trim( $rPeriod ))) { // ex. 2006-08-03 10:12:18
$tz = ( isset( $input['params']['TZID'] )) ? ' '.$input['params']['TZID'] : '';
$inputab = $this->_date_time_string( $rPeriod.$tz, $parno );
if ( isset( $input['params']['TZID'] ))
$inputab['tz'] = (string) $input['params']['TZID'];
elseif( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
else
unset( $inputab['tz'] );
$inputa[] = $inputab;
$parno = ( !isset( $parno )) ? count( $inputab ) : $parno;
}
}
}
elseif ( array_key_exists( 'timestamp', $theRdate )) { // timestamp
$tz = ( isset( $theRdate['tz'] )) ? ' '.$theRdate['tz'] : null;
$tz = ( isset( $input['params']['TZID'] )) ? ' '.$input['params']['TZID'] : $tz;
if( !isset( $parno )) $parno = ( !empty( $tz )) ? 7 : 6;
$inputab = $this->_date_time_string( date( 'Y-m-d H:i:s', $theRdate['timestamp'] ).$tz, $parno );
if(( 7 == $parno ) && !isset( $inputab['tz'] ))
$inputab['tz'] = 'Z';
if( isset( $inputab['tz'] ))
$inputab['tz'] = (string) $inputab['tz'];
$inputa = $inputab;
}
elseif (( in_array( count( $theRdate ), array( 3, 4, 6, 7 ))) ||
( array_key_exists( 'year', $theRdate ))) { // date[-time]
if( isset( $input['params']['TZID'] ))
$theRdate['tz'] = $input['params']['TZID'];
elseif( !isset( $theRdate['tz'] )) {
if(( 7 == count( $theRdate )) && isset( $theRdate[6] )) {
$theRdate['tz'] = $theRdate[6];
unset( $theRdate[6] );
}
elseif(( 4 == count( $theRdate )) && isset( $theRdate[3] )) {
$theRdate['tz'] = $theRdate[3];
unset( $theRdate[3] );
}
}
if( !isset( $parno ) && 3 < count( $theRdate ))
$parno = ( isset( $theRdate['tz'] )) ? 7 : count( $theRdate );
elseif( !isset( $parno ))
$parno = 3;
$inputa = $this->_date_time_array( $theRdate, $parno );
if(( 7 == $parno ) && !isset( $inputa['tz'] ))
$inputa['tz'] = 'Z';
if( isset( $inputa['tz'] ))
$inputa['tz'] = (string) $inputa['tz'];
}
}
elseif( 8 <= strlen( trim( $theRdate ))) { // ex. 2006-08-03 10:12:18
$inputa = $this->_date_time_string( $theRdate, $parno );
if( isset( $input['params']['TZID'] ))
$inputa['tz'] = (string) $input['params']['TZID'];
elseif( isset( $inputa['tz'] ))
$inputa['tz'] = (string) $inputa['tz'];
else
unset( $inputa['tz'] );
$parno = ( !isset( $parno )) ? count( $inputa ) : $parno;
if(( 7 == $parno ) && !isset( $inputa['tz'] ))
$inputa['tz'] = 'Z';
if( isset( $inputa['tz'] ))
$inputa['tz'] = (string) $inputa['tz'];
// echo 'setRdate inputa single string '; print_r ( $inputa ); echo " \n"; // test ##
}
$input['value'][] = $inputa;
}
if( 0 < count( $input['value'] )) {
// echo 'setRdate ut 1 '; print_r ( $input ); echo " \n"; // test ##
if( 3 == $parno ) {
$input['params']['VALUE'] = 'DATE';
foreach( $input['value'] as $eix => $inputa )
unset( $input['value'][$eix]['tz'] );
unset( $input['params']['TZID'] );
}
if( empty( $input['value'][0]['tz'] ) ||
( $input['value'][0]['tz'] == 'Z' ))
$dummy = TRUE;
elseif( in_array($input['value'][0]['tz']{0}, array( '+', '-' )) &&
ctype_digit( substr( $input['value'][0]['tz'], 1 )))
$dummy = TRUE;
elseif( ctype_digit( $input['value'][0]['tz'] ))
$dummy = TRUE;
elseif( isset( $input['value'][0]['tz'] )) {
$input['params']['TZID'] = $input['value'][0]['tz'];
foreach( $input['value'] as $eix => $inputa ) {
if( !empty( $input['value'][0]['tz'] ) &&
( $input['value'][0]['tz'] != 'Z' ) &&
( !( in_array( $input['value'][0]['tz']{0}, array( '+', '-' )) &&
ctype_digit( substr( $input['value'][0]['tz'], 1 ))) &&
!ctype_digit( $input['value'][0]['tz'] ) ) )
unset( $input['value'][$eix]['tz'] );
}
}
elseif( isset( $input['params']['TZID'] ))
unset( $input['params']['TZID'] );
$this->rdate[] = $input;
// echo 'setRdate ut 2 '; print_r ( $input ); echo " \n"; // test ##
}
}
/*********************************************************************************/
/**
* Property Name: RECURRENCE-ID
*/
/**
* creates formatted output for calendar component property recurrence-id
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-26
* @return string
*/
function createRecurrenceid() {
$cnt = count( $this->recurrenceid );
if( 0 >= $cnt )
return;
$formatted = $this->_format_date_time( $this->recurrenceid['value'] );
$attributes = $this->_createParams( $this->recurrenceid['params'] );
return $this->_createElement( 'RECURRENCE-ID', $attributes, $formatted );
}
/**
* set calendar component property recurrence-id
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return void
*/
function setRecurrenceid( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $tz=FALSE, $params=FALSE ) {
$this->recurrenceid = $this->_setDate( $year, $month, $day, $hour, $min, $sec, $tz, $params );
}
/*********************************************************************************/
/**
* Property Name: RELATED-TO
*/
/**
* creates formatted output for calendar component property related-to
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @return string
*/
function createRelatedTo() {
$cnt = count( $this->relatedto );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->relatedto as $relation ) {
$attributes = $this->_createParams( $relation['params'] );
$content = '<'.$this->_strrep( $relation['value'] ).'>';
$output .= $this->_createElement( 'RELATED-TO', $attributes, $content );
}
return $output;
}
/**
* set calendar component property related-to
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-24
* @param float $relid
* @param array $params optional
* @return void
*/
function setRelatedTo( $relid, $params=FALSE ) {
$relation = array();
if(( '<' == substr( $relid, 0, 1 )) &&
( '>' == substr( $relid, -1 )))
$relid = substr( $relid, 1, ( strlen( $relid ) - 2 ));
$relation['value'] = $relid;
$relation['params'] = $this->_setParams( $params );
// remove default
if( isset( $relation['params']['RELTYPE'] ) &&
( strtoupper( $relation['params']['RELTYPE'] ) == 'PARENT' ))
unset( $relation['params']['RELTYPE'] );
$this->relatedto[] = $relation;
}
/*********************************************************************************/
/**
* Property Name: REPEAT
*/
/**
* creates formatted output for calendar component property repeat
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createRepeat() {
$cnt = count( $this->repeat );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->repeat['params'] );
return $this->_createElement( 'REPEAT', $attributes, $this->repeat['value'] );
}
/**
* set calendar component property transp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param array $params optional
* @return void
*/
function setRepeat( $value, $params=FALSE ) {
$this->repeat['value'] = $value;
$this->repeat['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: REQUEST-STATUS
*/
/**
* creates formatted output for calendar component property request-status
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-16
* @return string
*/
function createRequestStatus() {
$cnt = count( $this->requeststatus );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->requeststatus as $rstat ) {
$attributes = $this->_createParams( $rstat['params'], array( 'LANGUAGE' ));
$content = number_format( (float) $rstat['value']['statcode'], 2, '.', '');
$content .= ';'.$this->_strrep( $rstat['value']['text'] );
if( isset( $rstat['value']['extdata'] ))
$content .= ';'.$this->_strrep( $rstat['value']['extdata'] );
$output .= $this->_createElement( 'REQUEST-STATUS', $attributes, $content );
}
return $output;
}
/**
* set calendar component property request-status
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-16
* @param float $statcode
* @param string $text
* @param string $extdata optional
* @param array params optional
* @return void
*/
function setRequestStatus( $statcode, $text, $extdata=FALSE, $params=FALSE ) {
$input = array();
$input['value']['statcode'] = $statcode;
$input['value']['text'] = $text;
if( $extdata )
$input['value']['extdata'] = $extdata;
$input['params'] = $this->_setParams( $params);
$this->requeststatus[] = $input;
}
/*********************************************************************************/
/**
* Property Name: RESOURCES
*/
/**
* creates formatted output for calendar component property resources
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-24
* @return string
*/
function createResources() {
if( 0 >= count( $this->resources ))
return;
$output = null;
foreach( $this->resources as $resource ) {
$attributes = $this->_createParams( $resource['params'], array( 'ALTREP', 'LANGUAGE' ));
if( is_array( $resource['value'] )) {
foreach( $resource['value'] as $rix => $resourcePart )
$resource['value'][$rix] = $this->_strrep( $resourcePart );
$content = implode( ',', $resource['value'] );
}
else
$content = $this->_strrep( $resource['value'] );
$output .= $this->_createElement( 'RESOURCES', $attributes, $content );
}
return $output;
}
/**
* set calendar component property recources
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-24
* @param mixed $value
* @param array params optional
* @return void
*/
function setResources( $value, $params=FALSE ) {
$input = array();
$input['value'] = $value;
$input['params'] = $this->_setParams( $params );
$this->resources[] = $input;
}
/*********************************************************************************/
/**
* Property Name: RRULE
*/
/**
* creates formatted output for calendar component property rrule
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.7.43 - 2006-09-15
* @return string
*/
function createRrule() {
$cnt = count( $this->rrule );
if( 0 >= $cnt )
return;
return $this->_format_recur( 'RRULE', $this->rrule );
}
/**
* set calendar component property rrule
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param array $rruleset
* @param array $params optional
* @return void
*/
function setRrule( $rruleset, $params=FALSE ) {
$exrule = array();
foreach( $rruleset as $rrulelabel => $rrulevalue ) {
$rrulelabel = strtoupper( $rrulelabel );
if( 'UNTIL' != $rrulelabel )
$rrule['value'][$rrulelabel] = $rrulevalue;
elseif( is_array( $rrulevalue ) &&
(( 3 == count( $rrulevalue )) ||
( 6 == count( $rrulevalue )) ||
( 7 == count( $rrulevalue )) ||
( array_key_exists( 'year', $rrulevalue )))) {
$parno = ( 3 < count( $rrulevalue )) ? 7 : 3 ; // datetime / date
$date = $this->_date_time_array( $rrulevalue, $parno );
if(( 3 < count( $date )) && !isset( $date['tz'] ))
$date['tz'] = 'Z';
$rrule['value'][$rrulelabel] = $date;
}
elseif( is_array( $rrulevalue ) && isset( $rrulevalue['timestamp'] )) {
$date = $this->_date_time_string( date( 'Y-m-d H:i:s', $rrulevalue['timestamp'] ), 6 );
$date['tz'] = 'Z';
$rrule['value'][$rrulelabel] = $date;
}
elseif( 8 <= strlen( trim( $rrulevalue ))) { // ex. 2006-08-03 10:12:18
$date = $this->_date_time_string( $rrulevalue );
if(( 3 < count( $date )) && !isset( $date['tz'] ))
$date['tz'] = 'Z';
$rrule['value'][$rrulelabel] = $date;
}
}
$rrule['params'] = $this->_setParams( $params );
$this->rrule[] = $rrule;
}
/*********************************************************************************/
/**
* Property Name: SEQUENCE
*/
/**
* creates formatted output for calendar component property sequence
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createSequence() {
$cnt = count( $this->sequence );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->sequence['params'] );
return $this->_createElement( 'SEQUENCE', $attributes, $this->sequence['value'] );
}
/**
* set calendar component property sequence
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-04-25
* @param int $value optional
* @param array $params optional
* @return void
*/
function setSequence( $value=FALSE, $params=FALSE ) {
if( !$value )
$value = $this->getProperty( 'sequence' ) + 1;
$this->sequence['value'] = $value;
$this->sequence['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: STATUS
*/
/**
* creates formatted output for calendar component property status
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createStatus() {
$cnt = count( $this->status );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->status['params'] );
return $this->_createElement( 'STATUS', $attributes, $this->status['value'] );
}
/**
* set calendar component property status
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param array $params optional
* @return void
*/
function setStatus( $value, $params=FALSE ) {
$this->status['value'] = $value;
$this->status['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: SUMMARY
*/
/**
* creates formatted output for calendar component property summary
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createSummary() {
$cnt = count( $this->summary );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->summary['params'], array( 'ALTREP', 'LANGUAGE' ));
$content = $this->_strrep( $this->summary['value'] );
return $this->_createElement( 'SUMMARY', $attributes, $content );
}
/**
* set calendar component property summary
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param string $params optional
* @return void
*/
function setSummary( $value, $params=FALSE ) {
$this->summary['value'] = $value;
$this->summary['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: TRANSP
*/
/**
* creates formatted output for calendar component property transp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createTransp() {
$cnt = count( $this->transp );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->transp['params'] );
return $this->_createElement( 'TRANSP', $attributes, $this->transp['value'] );
}
/**
* set calendar component property transp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param string $params optional
* @return void
*/
function setTransp( $value, $params=FALSE ) {
$this->transp['value'] = $value;
$this->transp['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: TRIGGER
*/
/**
* creates formatted output for calendar component property trigger
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.19 - 2007-03-27
* @return string
*/
function createTrigger() {
$cnt = count( $this->trigger );
if( 0 >= $cnt )
return;
$content = $attributes = null;
if( isset( $this->trigger['value']['year'] ) &&
isset( $this->trigger['value']['month'] ) &&
isset( $this->trigger['value']['day'] ))
$content .= $this->_format_date_time( $this->trigger['value'] );
else {
if( TRUE !== $this->trigger['value']['relatedstart'] )
$attributes .= $this->intAttrDelimiter.'RELATED=END';
if( $this->trigger['value']['before'] )
$content .= '-';
$content .= $this->_format_duration( $this->trigger['value'] );
}
$attributes .= $this->_createParams( $this->trigger['params'] );
return $this->_createElement( 'TRIGGER', $attributes, $content );
}
/**
* set calendar component property trigger
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.1.1 - 2007-07-07
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $week optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param bool $relatedEnd optional
* @param bool $after optional
* @param string $tz optional
* @param array $params optional
* @return void
* @toto fix is_int
*/
function setTrigger( $year=FALSE, $month=FALSE, $day=FALSE, $week=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $relatedEnd=FALSE, $after=FALSE, $tz=FALSE, $params=FALSE ) {
if( is_array( $year ) && array_key_exists( 'timestamp', $year )) { // timestamp
$params = $this->_setParams( $month );
$this->_existRem( $params, 'VALUE', 'DATE-TIME' );
if( isset( $params['TZID'] )) {
$year['tz'] = $params['TZID'];
unset( $params['TZID'] );
}
$tz = ( isset( $year['tz'] )) ? ' '.$year['tz'] : null;
$parno = ( isset( $tz )) ? 7 : 6;
$date = $this->_date_time_string( date( 'Y-m-d H:i:s', $year['timestamp'] ).$tz, $parno );
foreach( $date as $k => $v )
$$k = $v;
}
elseif( is_array( $year )) {
if( array_key_exists( 'year', $year ) &&
array_key_exists( 'month', $year ) &&
array_key_exists( 'day', $year )) { // date-time
$params = $this->_setParams( $month );
if( isset( $params['TZID'] )) {
$year['tz'] = $params['TZID'];
unset( $params['TZID'] );
}
}
else { // duration
$year = $this->_duration_array( $year );
$relatedEnd = $month;
$after = $day;
$params = $this->_setParams( $week );
}
$this->_existRem( $params, 'VALUE', 'DATE-TIME' );
$this->_existRem( $params, 'VALUE', 'DURATION' );
$SSYY = ( array_key_exists( 'year', $year )) ? $year['year'] : null;
$month = ( array_key_exists( 'month', $year )) ? $year['month'] : null;
$day = ( array_key_exists( 'day', $year )) ? $year['day'] : null;
$week = ( array_key_exists( 'week', $year )) ? $year['week'] : null;
$hour = ( array_key_exists( 'hour', $year )) ? $year['hour'] : null;
$min = ( array_key_exists( 'min', $year )) ? $year['min'] : null;
$sec = ( array_key_exists( 'sec', $year )) ? $year['sec'] : null;
$tz = ( array_key_exists( 'tz', $year )) ? $year['tz'] : null;
$year = $SSYY;
}
elseif( is_string($year) && !ctype_digit( (string) $year )) { // duration or date in a string
$params = $this->_setParams( $month );
unset( $month );
$this->_existRem( $params, 'VALUE', 'DATE-TIME' ); // ??
$this->_existRem( $params, 'VALUE', 'DURATION' );
if( in_array( $year{0}, array( 'P', '+', '-' ))) { // duration
if( '-' == $year{0} )
$after = FALSE;
elseif( '+' == $year{0} )
$after = TRUE;
elseif( 'P' == $year{0} )
$after = TRUE;
if( 'P' != $year{0} )
$year = substr( $year, 1 );
$date = $this->_duration_string( $year);
}
else {
$date = $this->_date_time_string( $year, 7 ); // date
if( isset( $params['TZID'] )) {
$date['tz'] = $params['TZID'];
unset( $params['TZID'] );
}
}
foreach( $date as $k => $v )
$$k = $v;
}
else
$params = $this->_setParams( $params );
if( !empty( $year ) && !empty( $month ) && !empty( $day ) ) { // date
$params['VALUE'] = 'DATE-TIME';
$this->trigger['value'] = array( 'year' => $year
, 'month' => $month
, 'day' => $day);
$this->trigger['value']['hour'] = $hour;
$this->trigger['value']['min'] = $min;
$this->trigger['value']['sec'] = $sec;
if( !empty( $tz ))
$this->trigger['value']['tz'] = $tz;
else
$this->trigger['value']['tz'] = 'Z';
}
else { // duration
$this->_existRem( $params, 'VALUE', 'DURATION' );
if( $this->_existRem( $params, 'RELATED', 'END', TRUE ))
$relatedEnd = TRUE;
elseif( $this->_existRem( $params, 'RELATED', 'START', TRUE ))
$relatedEnd = FALSE;
if( !empty( $week )) {
$this->trigger['value'] = array( 'week' => $week
, 'relatedstart' => !$relatedEnd
, 'before' => !$after );
}
else {
$this->trigger['value'] = array( 'day' => $day
, 'hour' => $hour
, 'min' => $min
, 'sec' => $sec
, 'relatedstart' => !$relatedEnd
, 'before' => !$after );
}
}
if( !isset( $this->trigger['value'] ))
return;
$this->trigger['params'] = $params;
}
/*********************************************************************************/
/**
* Property Name: TZID
*/
/**
* creates formatted output for calendar component property tzid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @return string
*/
function createTzid() {
$cnt = count( $this->tzid );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->tzid['params'] );
return $this->_createElement( 'TZID', $attributes, $this->_strrep( $this->tzid['value'] ));
}
/**
* set calendar component property tzid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @param string $value
* @param array $params optional
* @return void
*/
function setTzid( $value, $params=FALSE ) {
if( empty( $value ))
return;
$this->tzid['value'] = $value;
$this->tzid['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* .. .
* Property Name: TZNAME
*/
/**
* creates formatted output for calendar component property tzname
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @return string
*/
function createTzname() {
$cnt = count( $this->tzname );
if( 0 >= $cnt )
return;
$output = null;
foreach( $this->tzname as $theName ) {
$attributes = $this->_createParams( $theName['params'], array( 'LANGUAGE' ));
$output .= $this->_createElement( 'TZNAME', $attributes, $this->_strrep( $theName['value'] ));
}
return $output;
}
/**
* set calendar component property tzname
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @param string $value
* @param string $params optional
* @return void
*/
function setTzname( $value, $params=FALSE ) {
if( empty( $value ))
return;
$input['value'] = $value;
$input['params'] = $this->_setParams( $params );
$this->tzname[] = $input;
}
/*********************************************************************************/
/**
* Property Name: TZOFFSETFROM
*/
/**
* creates formatted output for calendar component property tzoffsetfrom
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createTzoffsetfrom() {
$cnt = count( $this->tzoffsetfrom );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->tzoffsetfrom['params'] );
return $this->_createElement( 'TZOFFSETFROM', $attributes, $this->tzoffsetfrom['value'] );
}
/**
* set calendar component property tzoffsetfrom
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-25
* @param string $value
* @param string $params optional
* @return void
*/
function setTzoffsetfrom( $value, $params=FALSE ) {
$this->tzoffsetfrom['value'] = $value;
if( empty( $this->tzoffsetfrom['value'] ))
return;
$this->tzoffsetfrom['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: TZOFFSETTO
*/
/**
* creates formatted output for calendar component property tzoffsetto
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createTzoffsetto() {
$cnt = count( $this->tzoffsetto );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->tzoffsetto['params'] );
return $this->_createElement( 'TZOFFSETTO', $attributes, $this->tzoffsetto['value'] );
}
/**
* set calendar component property tzoffsetto
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param string $params optional
* @return void
*/
function setTzoffsetto( $value, $params=FALSE ) {
$this->tzoffsetto['value'] = $value;
if( empty( $this->tzoffsetto['value'] ))
return;
$this->tzoffsetto['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: TZURL
*/
/**
* creates formatted output for calendar component property tzurl
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createTzurl() {
$cnt = count( $this->tzurl );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->tzurl['params'] );
return $this->_createElement( 'TZURL', $attributes, $this->tzurl['value'] );
}
/**
* set calendar component property tzurl
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param string $params optional
* @return void
*/
function setTzurl( $value, $params=FALSE ) {
$this->tzurl['value'] = $value;
if( empty( $this->tzurl['value'] ))
return;
$this->tzurl['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: UID
*/
/**
* creates formatted output for calendar component property uid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createUid() {
$cnt = count( $this->uid );
if( 0 >= $cnt ) {
$this->_makeuid();
}
$attributes = $this->_createParams( $this->uid['params'] );
return $this->_createElement( 'UID', $attributes, $this->uid['value'] );
}
/**
* create an unique id for this calendar component object instance
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.7 - 2007-09-04
* @return void
*/
function _makeUid() {
$date = date('Ymd\THisT');
$unique = substr(microtime(), 2, 4);
$base = 'aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPrRsStTuUvVxXuUvVwWzZ1234567890';
$start = 0;
$end = strlen( $base ) - 1;
$length = 6;
$str = null;
for( $p = 0; $p < $length; $p++ )
$unique .= $base{mt_rand( $start, $end )};
$this->uid['value'] = $date.'-'.$unique.'@'.$this->getConfig( 'unique_id' );
$this->uid['params'] = null;
}
/**
* set calendar component property uid
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param string $params optional
* @return void
*/
function setUid( $value, $params=FALSE ) {
$this->uid['value'] = $value;
if( empty( $this->uid['value'] ))
return;
$this->uid['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: URL
*/
/**
* creates formatted output for calendar component property url
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @return string
*/
function createUrl() {
$cnt = count( $this->url );
if( 0 >= $cnt )
return;
$attributes = $this->_createParams( $this->url['params'] );
return $this->_createElement( 'URL', $attributes, $this->url['value'] );
}
/**
* set calendar component property url
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.18 - 2007-03-18
* @param string $value
* @param string $params optional
* @return void
*/
function setUrl( $value, $params=FALSE ) {
$this->url['value'] = $value;
if( empty( $this->url['value'] ))
return;
$this->url['params'] = $this->_setParams( $params );
}
/*********************************************************************************/
/**
* Property Name: x-prop
*/
/**
* creates formatted output for calendar component property x-prop
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.3.2 - 2007-11-25
* @return string
*/
function createXprop() {
if( 0 >= count( $this->xprop ))
return;
$xprop = null;
foreach( $this->xprop as $label => $xpropPart ) {
$attributes = $this->_createParams( $xpropPart['params'], array( 'LANGUAGE' ));
if( is_array( $xpropPart['value'] )) {
foreach( $xpropPart['value'] as $pix => $theXpart )
$xpropPart['value'][$pix] = $this->_strrep( $theXpart );
$xpropPart['value'] = implode( ',', $xpropPart['value'] );
}
else
$xpropPart['value'] = $this->_strrep( $xpropPart['value'] );
$xprop .= $this->_createElement( strtoupper( $label ), $attributes, $xpropPart['value'] );
}
return $xprop;
}
/**
* set calendar component property x-prop
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.7 - 2007-06-21
* @param string $label
* @param mixed $value
* @param array $params optional
* @return void
*/
function setXprop( $label, $value, $params=FALSE ) {
if( empty( $label ) || empty( $value ))
return;
$xprop = array( 'value' => $value );
$toolbox = new calendarComponent();
$xprop['params'] = $toolbox->_setParams( $params );
$this->xprop[$label] = $xprop;
}
/*********************************************************************************/
/*********************************************************************************/
/**
* create element format parts
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.6 - 2006-06-20
* @return string
*/
function _createFormat() {
$objectname = null;
switch( $this->format ) {
case 'xcal':
$objectname = ( isset( $this->timezonetype )) ?
strtolower( $this->timezonetype ) : strtolower( $this->objName );
$this->componentStart1 = $this->elementStart1 = '<';
$this->componentStart2 = $this->elementStart2 = '>';
$this->componentEnd1 = $this->elementEnd1 = '</';
$this->componentEnd2 = $this->elementEnd2 = '>'.$this->nl;
$this->intAttrDelimiter = '';
$this->attributeDelimiter = $this->nl;
$this->valueInit = null;
break;
default:
$objectname = ( isset( $this->timezonetype )) ?
strtoupper( $this->timezonetype ) : strtoupper( $this->objName );
$this->componentStart1 = 'BEGIN:';
$this->componentStart2 = null;
$this->componentEnd1 = 'END:';
$this->componentEnd2 = $this->nl;
$this->elementStart1 = null;
$this->elementStart2 = null;
$this->elementEnd1 = null;
$this->elementEnd2 = $this->nl;
$this->intAttrDelimiter = '';
$this->attributeDelimiter = ';';
$this->valueInit = ':';
break;
}
return $objectname;
}
/**
* creates formatted output for calendar component property
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.15 - 2007-01-08
* @param string $label property name
* @param string $attributes property attributes
* @param string $content property content (optional)
* @return string
*/
function _createElement( $label, $attributes, $content=FALSE ) {
$label = $this->_formatPropertyName( $label );
$output = $this->elementStart1.$label;
$categoriesAttrLang = null;
$attachInlineBinary = FALSE;
$attachfmttype = null;
if( !empty( $attributes )) {
$attributes = trim( $attributes );
if ( 'xcal' == $this->format) {
$attributes2 = explode( $this->intAttrDelimiter, $attributes );
$attributes = null;
foreach( $attributes2 as $attribute ) {
$attrKVarr = explode( '=', $attribute );
if( empty( $attrKVarr[0] ))
continue;
if( !isset( $attrKVarr[1] )) {
$attrValue = $attrKVarr[0];
$attrKey = null;
}
elseif( 2 == count( $attrKVarr)) {
$attrKey = strtolower( $attrKVarr[0] );
$attrValue = $attrKVarr[1];
}
else {
$attrKey = strtolower( $attrKVarr[0] );
unset( $attrKVarr[0] );
$attrValue = implode( '=', $attrKVarr );
}
if(( 'attach' == $label ) && ( in_array( $attrKey, array( 'fmttype', 'encoding', 'value' )))) {
$attachInlineBinary = TRUE;
if( 'fmttype' == $attrKey )
$attachfmttype = $attrKey.'='.$attrValue;
continue;
}
elseif(( 'categories' == $label ) && ( 'language' == $attrKey ))
$categoriesAttrLang = $attrKey.'='.$attrValue;
else {
$attributes .= ( empty( $attributes )) ? ' ' : $this->attributeDelimiter.' ';
$attributes .= ( !empty( $attrKey )) ? $attrKey.'=' : null;
if(( '"' == substr( $attrValue, 0, 1 )) && ( '"' == substr( $attrValue, -1 ))) {
$attrValue = substr( $attrValue, 1, ( strlen( $attrValue ) - 2 ));
$attrValue = str_replace( '"', '', $attrValue );
}
$attributes .= '"'.htmlspecialchars( $attrValue ).'"';
}
}
}
else {
$attributes = str_replace( $this->intAttrDelimiter, $this->attributeDelimiter, $attributes );
}
}
if(((( 'attach' == $label ) && !$attachInlineBinary ) ||
( in_array( $label, array( 'tzurl', 'url' )))) && ( 'xcal' == $this->format)) {
$pos = strrpos($content, "/");
$docname = ( $pos !== false) ? substr( $content, (1 - strlen( $content ) + $pos )) : $content;
$this->xcaldecl[] = array( 'xmldecl' => 'ENTITY'
, 'uri' => $docname
, 'ref' => 'SYSTEM'
, 'external' => $content
, 'type' => 'NDATA'
, 'type2' => 'BINERY' );
$attributes .= ( empty( $attributes )) ? ' ' : $this->attributeDelimiter.' ';
$attributes .= 'uri="'.$docname.'"';
$content = null;
if( 'attach' == $label ) {
$attributes = str_replace( $this->attributeDelimiter, $this->intAttrDelimiter, $attributes );
$content = $this->_createElement( 'extref', $attributes, null );
$attributes = null;
}
}
elseif(( 'attach' == $label ) && $attachInlineBinary && ( 'xcal' == $this->format)) {
$content = $this->nl.$this->_createElement( 'b64bin', $attachfmttype, $content ); // max one attribute
}
$output .= $attributes;
if( !$content ) {
switch( $this->format ) {
case 'xcal':
$output .= ' /';
$output .= $this->elementStart2;
return $output;
break;
default:
$output .= $this->elementStart2;
return $this->_size75( $output );
break;
}
}
$output .= $this->elementStart2;
switch( $label ) {
case 'categories':
// case 'resources': ??
$output .= $this->nl;
$items = explode(',', $content);
$content = null;
foreach( $items as $item )
$content .= $this->_createElement( 'item', $categoriesAttrLang, $item ); // max one attribute
break;
case 'geo':
$output .= $this->nl;
list($lat, $lon) = explode(';', $content);
$content = null;
$content .= $this->_createElement( 'lat', null, $lat );
$content .= $this->_createElement( 'lon', null, $lon );
break;
default:
break;
}
$output .= $this->valueInit.$content;
switch( $this->format ) {
case 'xcal':
return $output.$this->elementEnd1.$label.$this->elementEnd2;
break;
default:
return $this->_size75( $output );
break;
}
}
/**
* creates formatted output for calendar component property parameters
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.22 - 2007-04-10
* @param array $params optional
* @param array $ctrKeys optional
* @return string
*/
function _createParams( $params=array(), $ctrKeys=array() ) {
$attrLANG = $attr1 = $attr2 = null;
$CNattrKey = ( in_array( 'CN', $ctrKeys )) ? TRUE : FALSE ;
$LANGattrKey = ( in_array( 'LANGUAGE', $ctrKeys )) ? TRUE : FALSE ;
$CNattrExist = $LANGattrExist = FALSE;
if( is_array( $params )) {
foreach( $params as $paramKey => $paramValue ) {
if( is_int( $paramKey ))
$attr2 .= $this->intAttrDelimiter.$paramValue;
elseif(( 'LANGUAGE' == $paramKey ) && $LANGattrKey ) {
$attrLANG .= $this->intAttrDelimiter."LANGUAGE=$paramValue";
$LANGattrExist = TRUE;
}
elseif(( 'CN' == $paramKey ) && $CNattrKey ) {
$attr1 = $this->intAttrDelimiter.'CN="'.$paramValue.'"';
$CNattrExist = TRUE;
}
elseif(( 'ALTREP' == $paramKey ) && in_array( $paramKey, $ctrKeys ))
$attr2 .= $this->intAttrDelimiter.'ALTREP="'.$paramValue.'"';
elseif(( 'DIR' == $paramKey ) && in_array( $paramKey, $ctrKeys ))
$attr2 .= $this->intAttrDelimiter.'DIR="'.$paramValue.'"';
elseif(( 'SENT-BY' == $paramKey ) && in_array( $paramKey, $ctrKeys ))
$attr2 .= $this->intAttrDelimiter.'SENT-BY="MAILTO:'.$paramValue.'"';
else
$attr2 .= $this->intAttrDelimiter."$paramKey=$paramValue";
}
}
if( !$LANGattrExist ) {
$lang = $this->getConfig( 'language' );
if(( $CNattrExist || $LANGattrKey ) && $lang )
$attrLANG .= $this->intAttrDelimiter.'LANGUAGE='.$lang;
}
return $attrLANG.$attr1.$attr2;
}
/**
* convert local startdate/enddate (Ymd[His]) to duration
*
* uses this component dates if missing input dates
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.11 - 2007-11-03
* @param array $startdate, optional
* @param array $duration, optional
* @return array duration
*/
function _date2duration( $startdate=FALSE, $enddate=FALSE ) {
if( !$startdate || !$enddate ) {
if( FALSE === ( $startdate = $this->getProperty( 'dtstart' )))
return null;
if( FALSE === ( $enddate = $this->getProperty( 'dtend' ))) // vevent/vfreebusy
if( FALSE === ( $enddate = $this->getProperty( 'due' ))) // vtodo
return null;
}
if( !$startdate || !$enddate )
return null;
$startWdate = mktime( 0, 0, 0, $startdate['month'], $startdate['day'], $startdate['year'] );
$endWdate = mktime( 0, 0, 0, $enddate['month'], $enddate['day'], $enddate['year'] );
$wduration = $endWdate - $startWdate;
$dur = array();
$dur['week'] = (int) floor( $wduration / ( 7 * 24 * 60 * 60 ));
$wduration = $wduration % ( 7 * 24 * 60 * 60 );
$dur['day'] = (int) floor( $wduration / ( 24 * 60 * 60 ));
$wduration = $wduration % ( 24 * 60 * 60 );
$dur['hour'] = (int) floor( $wduration / ( 60 * 60 ));
$wduration = $wduration % ( 60 * 60 );
$dur['min'] = (int) floor( $wduration / ( 60 ));
$dur['sec'] = (int) $wduration % ( 60 );
return $dur;
}
/**
* convert date/datetime to timestamp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param array $datetime datetime/(date)
* @param string $tz timezone
* @return timestamp
*/
function _date2timestamp( $datetime, $tz=null ) {
$output = null;
if( !isset( $datetime['hour'] )) $datetime['hour'] = '0';
if( !isset( $datetime['min'] )) $datetime['min'] = '0';
if( !isset( $datetime['sec'] )) $datetime['sec'] = '0';
foreach( $datetime as $dkey => $dvalue ) {
if( 'tz' != $dkey )
$datetime[$dkey] = (integer) $dvalue;
}
if( $tz )
$datetime['tz'] = $tz;
$offset = 0;
if( isset( $datetime['tz'] ) && ( '' < trim ( $datetime['tz'] )))
$offset = $this->_tz2offset( $datetime['tz'] );
$output = mktime( $datetime['hour']
, $datetime['min']
, $datetime['sec'] + $offset
, $datetime['month']
, $datetime['day']
, $datetime['year'] );
return $output;
}
/**
* ensures internal date-time/date format for input date-time/date in array format
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.3.0 - 2006-08-15
* @param array $datetime
* @param int $parno optional, default FALSE
* @return array
*/
function _date_time_array( $datetime, $parno=FALSE ) {
$output = array();
foreach( $datetime as $dateKey => $datePart ) {
switch ( $dateKey ) {
case '0': case 'year': $output['year'] = $datePart; break;
case '1': case 'month': $output['month'] = $datePart; break;
case '2': case 'day': $output['day'] = $datePart; break;
}
if( 3 != $parno ) {
switch ( $dateKey ) {
case '0':
case '1':
case '2': break;
case '3': case 'hour': $output['hour'] = $datePart; break;
case '4': case 'min' : $output['min'] = $datePart; break;
case '5': case 'sec' : $output['sec'] = $datePart; break;
case '6': case 'tz' : $output['tz'] = $datePart; break;
}
}
}
if( 3 != $parno ) {
if( !isset( $output['hour'] ))
$output['hour'] = 0;
if( !isset( $output['min'] ))
$output['min'] = 0;
if( !isset( $output['sec'] ))
$output['sec'] = 0;
}
return $output;
}
/**
* ensures internal date-time/date format for input date-time/date in string fromat
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.10 - 2007-10-19
* @param array $datetime
* @param int $parno optional, default FALSE
* @return array
*/
function _date_time_string( $datetime, $parno=FALSE ) {
$datetime = (string) trim( $datetime );
$tz = null;
$len = strlen( $datetime ) - 1;
if( 'Z' == substr( $datetime, -1 )) {
$tz = 'Z';
$datetime = trim( substr( $datetime, 0, $len ));
}
elseif( ( ctype_digit( substr( $datetime, -2, 2 ))) && // time or date
( '-' == substr( $datetime, -3, 1 )) ||
( ':' == substr( $datetime, -3, 1 )) ||
( '.' == substr( $datetime, -3, 1 ))) {
$continue = TRUE;
}
elseif( ( ctype_digit( substr( $datetime, -4, 4 ))) && // 4 pos offset
( ' +' == substr( $datetime, -6, 2 )) ||
( ' -' == substr( $datetime, -6, 2 ))) {
$tz = substr( $datetime, -5, 5 );
$datetime = substr( $datetime, 0, ($len - 5));
}
elseif( ( ctype_digit( substr( $datetime, -6, 6 ))) && // 6 pos offset
( ' +' == substr( $datetime, -8, 2 )) ||
( ' -' == substr( $datetime, -8, 2 ))) {
$tz = substr( $datetime, -7, 7 );
$datetime = substr( $datetime, 0, ($len - 7));
}
elseif( ( 6 < $len ) && ( ctype_digit( substr( $datetime, -6, 6 )))) {
$continue = TRUE;
}
elseif( 'T' == substr( $datetime, -7, 1 )) {
$continue = TRUE;
}
else {
//echo "_date_time_string 1: $datetime tz=$tz. \n"; // test ###
$cx = $tx = 0; // 19970415T133000 US-Eastern
for( $cx = -1; $cx > ( 9 - $len ); $cx-- ) {
if(( ' ' == substr( $datetime, $cx, 1 )) || ctype_digit( substr( $datetime, $cx, 1 )))
break; // if exists, tz ends here.. . ?
elseif( ctype_alpha( substr( $datetime, $cx, 1 )) ||
( in_array( substr( $datetime, $cx, 1 ), array( '-', '/' ))))
$tx--; // tz length counter
}
if( 0 > $tx ) {
$tz = substr( $datetime, $tx );
$datetime = trim( substr( $datetime, 0, $len + $tx + 1 ));
}
}
//echo "_date_time_string 1a: $datetime tz=$tz. \n"; // test ###
if( 0 < substr_count( $datetime, '-' )) {
$datetime = str_replace( '-', '/', $datetime );
//echo "_date_time_string 1b: $datetime tz=$tz. \n"; // test ###
}
elseif( ctype_digit( substr( $datetime, 0, 8 )) &&
( 'T' == substr( $datetime, 8, 1 )) &&
ctype_digit( substr( $datetime, 9, 6 ))) {
$datetime = substr( $datetime, 4, 2 )
.'/'.substr( $datetime, 6, 2 )
.'/'.substr( $datetime, 0, 4 )
.' '.substr( $datetime, 9, 2 )
.':'.substr( $datetime, 11, 2 )
.':'.substr( $datetime, 13);
// $datetime = substr( $datetime, 0, 8 ).substr( $datetime, 9 ); // not PHP 4.x compatible
//echo "_date_time_string 1c: $datetime tz=$tz. \n"; // test ###
}
$datestring = date( 'Y-m-d H:i:s', strtotime( $datetime ));
// echo "_date_time_string 2: $datestring tz=$tz. datetime=$datetime \n"; // test ###
$tz = trim( $tz );
$output = array();
$output['year'] = substr( $datestring, 0, 4 );
$output['month'] = substr( $datestring, 5, 2 );
$output['day'] = substr( $datestring, 8, 2 );
if(( 6 == $parno ) || ( 7 == $parno )) {
$output['hour'] = substr( $datestring, 11, 2 );
$output['min'] = substr( $datestring, 14, 2 );
$output['sec'] = substr( $datestring, 17, 2 );
if( !empty( $tz ))
$output['tz'] = $tz;
}
elseif( 3 != $parno ) {
if(( '00' < substr( $datestring, 11, 2 )) ||
( '00' < substr( $datestring, 14, 2 )) ||
( '00' < substr( $datestring, 17, 2 ))) {
$output['hour'] = substr( $datestring, 11, 2 );
$output['min'] = substr( $datestring, 14, 2 );
$output['sec'] = substr( $datestring, 17, 2 );
}
if( !empty( $tz ))
$output['tz'] = $tz;
}
return $output;
}
/**
* ensures internal duration format for input in array format
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.1.1 - 2007-06-24
* @param array $duration
* @return array
*/
function _duration_array( $duration ) {
$output = array();
if( is_array( $duration ) &&
( 1 == count( $duration )) &&
isset( $duration['sec'] ) &&
( 60 < $duration['sec'] )) {
$durseconds = $duration['sec'];
$output['week'] = floor( $durseconds / ( 60 * 60 * 24 * 7 ));
$durseconds = $durseconds % ( 60 * 60 * 24 * 7 );
$output['day'] = floor( $durseconds / ( 60 * 60 * 24 ));
$durseconds = $durseconds % ( 60 * 60 * 24 );
$output['hour'] = floor( $durseconds / ( 60 * 60 ));
$durseconds = $durseconds % ( 60 * 60 );
$output['min'] = floor( $durseconds / ( 60 ));
$output['sec'] = ( $durseconds % ( 60 ));
}
else {
foreach( $duration as $durKey => $durValue ) {
switch ( $durKey ) {
case '0': case 'week': $output['week'] = $durValue; break;
case '1': case 'day': $output['day'] = $durValue; break;
case '2': case 'hour': $output['hour'] = $durValue; break;
case '3': case 'min': $output['min'] = $durValue; break;
case '4': case 'sec': $output['sec'] = $durValue; break;
}
}
}
if( isset( $output['week'] ) && ( 0 < $output['week'] ))
return $output;
elseif (( isset( $output['hour'] ) && ( 0 < $output['hour'] )) ||
( isset( $output['min'] ) && ( 0 < $output['min'] )) ||
(isset( $output['sec'] ) && ( 0 < $output['sec'] ))) {
if( !isset( $output['hour'] ))
$output['hour'] = 0;
if( !isset( $output['min'] ))
$output['min'] = 0;
if( !isset( $output['sec'] ))
$output['sec'] = 0;
}
return $output;
}
/**
* convert duration to date in array format based on dtstart value
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.11 - 2007-12-02
* @param array $startdate, optional
* @param array $duration, optional
* @return array, date format
*/
function duration2date($startdate=FALSE, $duration=FALSE) {
if( $startdate && $duration ) {
$d1 = $startdate;
$dur = $duration;
}
elseif( isset( $this->dtstart['value'] ) && isset( $this->duration['value'] )) {
$d1 = $this->dtstart['value'];
$dur = $this->duration['value'];
}
else
return null;
$dateOnly = ( isset( $d1['hour'] ) || isset( $d1['min'] ) || isset( $d1['sec'] )) ? FALSE : TRUE;
$d1['hour'] = ( isset( $d1['hour'] )) ? $d1['hour'] : 0;
$d1['min'] = ( isset( $d1['min'] )) ? $d1['min'] : 0;
$d1['sec'] = ( isset( $d1['sec'] )) ? $d1['sec'] : 0;
$dtend = mktime( $d1['hour']
, $d1['min']
, $d1['sec']
, $d1['month']
, $d1['day']
, $d1['year'] );
if( isset( $dur['week'] ))
$dtend += ( $dur['week'] * 7 * 24 * 60 * 60 );
if( isset( $dur['day'] ))
$dtend += ( $dur['day'] * 24 * 60 * 60 );
if( isset( $dur['hour'] ))
$dtend += ( $dur['hour'] * 60 *60 );
if( isset( $dur['min'] ))
$dtend += ( $dur['min'] * 60 );
if( isset( $dur['sec'] ))
$dtend += $dur['sec'];
$dtend2 = array();
$dtend2['year'] = date('Y', $dtend );
$dtend2['month'] = date('m', $dtend );
$dtend2['day'] = date('d', $dtend );
$dtend2['hour'] = date('H', $dtend );
$dtend2['min'] = date('i', $dtend );
$dtend2['sec'] = date('s', $dtend );
if( isset( $d1['tz'] ))
$dtend2['tz'] = $d1['tz'];
if( $dateOnly && (( 0 == $dtend2['hour'] ) && ( 0 == $dtend2['min'] ) && ( 0 == $dtend2['sec'] )))
unset( $dtend2['hour'], $dtend2['min'], $dtend2['sec'] );
return $dtend2;
}
/**
* ensures internal duration format for input in string format
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.0.5 - 2007-03-14
* @param string $duration
* @return array
*/
function _duration_string( $duration ) {
$duration = (string) trim( $duration );
while( 'P' != strtoupper( substr( $duration, 0, 1 ))) {
if( 0 < strlen( $duration ))
$duration = substr( $duration, 1 );
else
return false; // no leading P !?!?
}
$duration = substr( $duration, 1 ); // skip P
$duration = str_replace ( 't', 'T', $duration );
$duration = str_replace ( 'T', '', $duration );
$output = array();
$val = null;
for( $ix=0; $ix < strlen( $duration ); $ix++ ) {
switch( strtoupper( $duration{$ix} )) {
case 'W':
$output['week'] = $val;
$val = null;
break;
case 'D':
$output['day'] = $val;
$val = null;
break;
case 'H':
$output['hour'] = $val;
$val = null;
break;
case 'M':
$output['min'] = $val;
$val = null;
break;
case 'S':
$output['sec'] = $val;
$val = null;
break;
default:
if( !ctype_digit( $duration{$ix} ))
return false; // unknown duration controll character !?!?
else
$val .= $duration{$ix};
}
}
return $this->_duration_array( $output );
}
/**
* if exist, remove key with expected value from array and return spec. value
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.19 - 2007-03-18
* @param array $array
* @param string $expkey
* @param string $expval
* @param int $hitval optional
* @return int
*/
function _existRem( &$array, $expkey, $expval=FALSE, $hitval=null ) {
if( !is_array( $array ) || ( 0 == count( $array )))
return null;
if( !isset( $array[$expkey] ))
return null;
if( !$expval )
return $hitval;
if( $expval != $array[$expkey] )
return null;
unset( $array[$expkey] );
return $hitval;
}
/**
* creates formatted output for calendar component property data value type date/date-time
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param array $datetime
* @param int $parno, optional, default 6
* @return string
*/
function _format_date_time( $datetime, $parno=6 ) {
if( !isset( $datetime['year'] ) &&
!isset( $datetime['month'] ) &&
!isset( $datetime['day'] ) &&
!isset( $datetime['hour'] ) &&
!isset( $datetime['min'] ) &&
!isset( $datetime['sec'] ))
return ;
$output = null;
$output = date('Ymd', mktime( 0, 0, 0
, (integer) $datetime['month']
, (integer) $datetime['day']
, (integer) $datetime['year']));
if( isset( $datetime['hour'] ) ||
isset( $datetime['min'] ) ||
isset( $datetime['sec'] ) ||
isset( $datetime['tz'] )) {
if( isset( $datetime['tz'] ) &&
!isset( $datetime['hour'] ))
$datetime['hour'] = '0';
if( isset( $datetime['hour'] ) &&
!isset( $datetime['min'] ))
$datetime['min'] = '0';
if( isset( $datetime['hour'] ) &&
isset( $datetime['min'] ) &&
!isset( $datetime['sec'] ))
$datetime['sec'] = '0';
foreach( $datetime as $dkey => $dvalue ) {
if( 'tz' != $dkey )
$datetime[$dkey] = (integer) $dvalue;
}
$output .= date('\THis', mktime( $datetime['hour']
, $datetime['min']
, $datetime['sec']
, $datetime['month']
, $datetime['day']
, $datetime['year']));
if( isset( $datetime['tz'] ) && ( '' < trim ( $datetime['tz'] ))) {
$datetime['tz'] = trim( $datetime['tz'] );
if( 'Z' == $datetime['tz'] )
$output .= 'Z';
$offset = 0;
$offset = $this->_tz2offset( $datetime['tz'] );
if( 0 != $offset ) {
$output = date('Ymd\THis\Z', mktime( $datetime['hour']
, $datetime['min']
, $datetime['sec'] + $offset
, $datetime['month']
, $datetime['day']
, $datetime['year']));
}
}
elseif( 7 == $parno )
$output .= 'Z';
}
return $output;
}
/**
* creates formatted output for calendar component property data value type duration
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-13
* @param array $duration ( week, day, hour, min, sec )
* @return string
*/
function _format_duration( $duration ) {
if( !isset( $duration['week'] ) &&
!isset( $duration['day'] ) &&
!isset( $duration['hour'] ) &&
!isset( $duration['min'] ) &&
!isset( $duration['sec'] ))
return;
$output = 'P';
if( isset( $duration['week'] ) && ( 0 < $duration['week'] ))
$output .= $duration['week'].'W';
else {
if( isset($duration['day'] ) && ( 0 < $duration['day'] ))
$output .= $duration['day'].'D';
if(( isset( $duration['hour']) && ( 0 < $duration['hour'] )) ||
( isset( $duration['min']) && ( 0 < $duration['min'] )) ||
( isset( $duration['sec']) && ( 0 < $duration['sec'] ))) {
$output .= 'T';
if( 0 < $duration['hour'] ) {
$output .= $duration['hour'].'H';
if( 0 < $duration['min'] ) {
$output .= $duration['min'].'M';
if( 0 < $duration['sec'] )
$output .= $duration['sec'].'S';
}
elseif( 0 < $duration['sec'] )
$output .= '0M'.$duration['sec'].'S';
}
elseif( 0 < $duration['min'] ) {
$output .= '0H'.$duration['min'].'M';
if( 0 < $duration['sec'] )
$output .= $duration['sec'].'S';
}
elseif( 0 < $duration['sec'] )
$output .= '0H0M'.$duration['sec'].'S';
}
}
return $output;
}
/**
* creates formatted output for calendar component property data value type recur
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @param array $recurlabel
* @param array $recurdata
* @return string
*/
function _format_recur ( $recurlabel, $recurdata ) {
$recur = null;
foreach( $recurdata as $therule ) {
$attributes = ( isset( $therule['params'] )) ? $this->_createParams( $therule['params'] ) : null;
$content1 = $content2 = null;
foreach( $therule['value'] as $rulelabel => $rulevalue ) {
switch( $rulelabel ) {
case 'FREQ': {
$content1 .= "FREQ=$rulevalue";
break;
}
case 'UNTIL': {
$content2 .= ";UNTIL=";
$content2 .= $this->_format_date_time( $rulevalue );
break;
}
case 'COUNT':
case 'INTERVAL':
case 'WKST': {
$content2 .= ";$rulelabel=$rulevalue";
break;
}
case 'BYSECOND':
case 'BYMINUTE':
case 'BYHOUR':
case 'BYMONTHDAY':
case 'BYYEARDAY':
case 'BYWEEKNO':
case 'BYMONTH':
case 'BYSETPOS': {
$content2 .= ";$rulelabel=";
if( is_array( $rulevalue )) {
foreach( $rulevalue as $vix => $valuePart ) {
$content2 .= ( $vix ) ? ',' : null;
$content2 .= $valuePart;
}
}
else
$content2 .= $rulevalue;
break;
}
case 'BYDAY': {
$content2 .= ";$rulelabel=";
$bydaycnt = 0;
foreach( $rulevalue as $vix => $valuePart ) {
$content21 = $content22 = null;
if( is_array( $valuePart )) {
$content2 .= ( $bydaycnt ) ? ',' : null;
foreach( $valuePart as $vix2 => $valuePart2 ) {
if( 'DAY' != strtoupper( $vix2 ))
$content21 .= $valuePart2;
else
$content22 .= $valuePart2;
}
$content2 .= $content21.$content22;
$bydaycnt++;
}
else {
$content2 .= ( $bydaycnt ) ? ',' : null;
if( 'DAY' != strtoupper( $vix ))
$content21 .= $valuePart;
else {
$content22 .= $valuePart;
$bydaycnt++;
}
$content2 .= $content21.$content22;
}
}
break;
}
default: {
$content2 .= ";$rulelabel=$rulevalue";
break;
}
}
}
$recur .= $this->_createElement( $recurlabel, $attributes, $content1.$content2 );
}
return $recur;
}
/**
* create property name case - lower/upper
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 0.9.7 - 2006-11-20
* @param string $propertyName
* @return string
*/
function _formatPropertyName( $propertyName ) {
switch( $this->format ) {
case 'xcal':
return strtolower( $propertyName );
break;
default:
return strtoupper( $propertyName );
break;
}
}
/**
* remakes a recur pattern to an array of dates
*
* if missing, UNTIL is set 1 year from startdate (emergency break)
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.11 - 2007-11-26
* @param array $result, array to update, array([timestamp] => timestamp)
* @param array $recur, pattern for recurrency (only value part, params ignored)
* @param array $wdate, component start date
* @param array $startdate, start date
* @param array $enddate, optional
* @return array of recurrence (start-)dates as index
* @todo BYHOUR, BYMINUTE, BYSECOND, ev. BYSETPOS due to ambiguity, WEEKLY at year end/start
*/
function _recur2date( & $result, $recur, $wdate, $startdate, $enddate=FALSE ) {
foreach( $wdate as $k => $v ) if( ctype_digit( $v )) $wdate[$k] = (int) $v;
$wdatets = $this->_date2timestamp( $wdate );
$startdatets = $this->_date2timestamp( $startdate );
if( !$enddate ) {
$enddate = $startdate;
$enddate['year'] += 1;
// echo "recur __in_ ".implode('-',$startdate)." period start ".implode('-',$wdate)." period end ".implode('-',$enddate)." \n";print_r($recur);echo " \n";//test###
}
$endDatets = $this->_date2timestamp( $enddate ); // fix break
if( !isset( $recur['COUNT'] ) && !isset( $recur['UNTIL'] ))
$recur['UNTIL'] = $enddate; // create break
if( isset( $recur['UNTIL'] )) {
$tdatets = $this->_date2timestamp( $recur['UNTIL'] );
if( $endDatets > $tdatets ) {
$endDatets = $tdatets; // emergency break
$enddate = $this->_date_time_string( date('Y-m-d H:i:s', $endDatets ));
}
else
$recur['UNTIL'] = $this->_date_time_string( date('Y-m-d H:i:s', $endDatets ));
}
if( $wdatets > $endDatets ) {
//echo "recur out of date ".implode('-',$this->_date_time_string(date('Y-m-d H:i:s',$wdatets),6))." \n";//test
return array(); // nothing to do.. .
}
if( !isset( $recur['FREQ'] )) // "MUST be specified.. ."
$recur['FREQ'] = 'DAILY'; // ??
$wkst = ( isset( $recur['WKST'] ) && ( 'SU' == $recur['WKST'] )) ? 24*60*60 : 0; // ??
if( !isset( $recur['INTERVAL'] ))
$recur['INTERVAL'] = 1;
$countcnt = ( !isset( $recur['BYSETPOS'] )) ? 1 : 0; // DTSTART counts as the first occurrence
/* find out how to step up dates and set index for interval count */
$step = array();
if( 'YEARLY' == $recur['FREQ'] )
$step['year'] = 1;
elseif( 'MONTHLY' == $recur['FREQ'] )
$step['month'] = 1;
elseif( 'WEEKLY' == $recur['FREQ'] )
$step['day'] = 7;
else
$step['day'] = 1;
if( isset( $step['year'] ) && isset( $recur['BYMONTH'] ))
$step = array( 'month' => 1 );
if( empty( $step ) && isset( $recur['BYWEEKNO'] )) // ??
$step = array( 'day' => 7 );
if( isset( $recur['BYYEARDAY'] ) || isset( $recur['BYMONTHDAY'] ) || isset( $recur['BYDAY'] ))
$step = array( 'day' => 1 );
$intervalarr = array();
if( 1 < $recur['INTERVAL'] ) {
$intervalix = $this->_recurIntervalIx( $recur['FREQ'], $wdate, $wkst );
$intervalarr = array( $intervalix => 0 );
}
if( isset( $recur['BYSETPOS'] )) { // save start date + weekno
$bysetposymd1 = $bysetposymd2 = $bysetposw1 = $bysetposw2 = array();
$bysetposWold = (int) date( 'W', ( $wdatets + $wkst ));
$bysetposYold = $wdate['year'];
$bysetposMold = $wdate['month'];
$bysetposDold = $wdate['day'];
if( is_array( $recur['BYSETPOS'] )) {
foreach( $recur['BYSETPOS'] as $bix => $bval )
$recur['BYSETPOS'][$bix] = (int) $bval;
}
else
$recur['BYSETPOS'] = array( (int) $recur['BYSETPOS'] );
$this->_stepdate( $enddate, $endDatets, $step); // make sure to count whole last period
}
$this->_stepdate( $wdate, $wdatets, $step);
$year_old = null;
$daynames = array( 'SU', 'MO', 'TU', 'WE', 'TH', 'FR', 'SA' );
/* MAIN LOOP */
// echo "recur start ".implode('-',$wdate)." end ".implode('-',$enddate)." \n";//test
while( TRUE ) {
if( isset( $endDatets ) && ( $wdatets > $endDatets ))
break;
if( isset( $recur['COUNT'] ) && ( $countcnt >= $recur['COUNT'] ))
break;
if( $year_old != $wdate['year'] ) {
$year_old = $wdate['year'];
$daycnts = array();
$yeardays = $weekno = 0;
$yeardaycnt = array();
for( $m = 1; $m <= 12; $m++ ) { // count up and update up-counters
$daycnts[$m] = array();
$weekdaycnt = array();
foreach( $daynames as $dn )
$yeardaycnt[$dn] = $weekdaycnt[$dn] = 0;
$mcnt = date( 't', mktime( 0, 0, 0, $m, 1, $wdate['year'] ));
for( $d = 1; $d <= $mcnt; $d++ ) {
$daycnts[$m][$d] = array();
if( isset( $recur['BYYEARDAY'] )) {
$yeardays++;
$daycnts[$m][$d]['yearcnt_up'] = $yeardays;
}
if( isset( $recur['BYDAY'] )) {
$day = date( 'w', mktime( 0, 0, 0, $m, $d, $wdate['year'] ));
$day = $daynames[$day];
$daycnts[$m][$d]['DAY'] = $day;
$weekdaycnt[$day]++;
$daycnts[$m][$d]['monthdayno_up'] = $weekdaycnt[$day];
$yeardaycnt[$day]++;
$daycnts[$m][$d]['yeardayno_up'] = $yeardaycnt[$day];
}
if( isset( $recur['BYWEEKNO'] ) || ( $recur['FREQ'] == 'WEEKLY' ))
$daycnts[$m][$d]['weekno_up'] =(int)date('W',mktime(0,0,$wkst,$m,$d,$wdate['year']));
}
}
$daycnt = 0;
$yeardaycnt = array();
if( isset( $recur['BYWEEKNO'] ) || ( $recur['FREQ'] == 'WEEKLY' )) {
$weekno = null;
for( $d=31; $d > 25; $d-- ) { // get last weekno for year
if( !$weekno )
$weekno = $daycnts[12][$d]['weekno_up'];
elseif( $weekno < $daycnts[12][$d]['weekno_up'] ) {
$weekno = $daycnts[12][$d]['weekno_up'];
break;
}
}
}
for( $m = 12; $m > 0; $m-- ) { // count down and update down-counters
$weekdaycnt = array();
foreach( $daynames as $dn )
$yeardaycnt[$dn] = $weekdaycnt[$dn] = 0;
$monthcnt = 0;
$mcnt = date( 't', mktime( 0, 0, 0, $m, 1, $wdate['year'] ));
for( $d = $mcnt; $d > 0; $d-- ) {
if( isset( $recur['BYYEARDAY'] )) {
$daycnt -= 1;
$daycnts[$m][$d]['yearcnt_down'] = $daycnt;
}
if( isset( $recur['BYMONTHDAY'] )) {
$monthcnt -= 1;
$daycnts[$m][$d]['monthcnt_down'] = $monthcnt;
}
if( isset( $recur['BYDAY'] )) {
$day = $daycnts[$m][$d]['DAY'];
$weekdaycnt[$day] -= 1;
$daycnts[$m][$d]['monthdayno_down'] = $weekdaycnt[$day];
$yeardaycnt[$day] -= 1;
$daycnts[$m][$d]['yeardayno_down'] = $yeardaycnt[$day];
}
if( isset( $recur['BYWEEKNO'] ) || ( $recur['FREQ'] == 'WEEKLY' ))
$daycnts[$m][$d]['weekno_down'] = ($daycnts[$m][$d]['weekno_up'] - $weekno - 1);
}
}
}
/* check interval */
if( 1 < $recur['INTERVAL'] ) {
/* create interval index */
$intervalix = $this->_recurIntervalIx( $recur['FREQ'], $wdate, $wkst );
/* check interval */
$currentKey = array_keys( $intervalarr );
$currentKey = end( $currentKey ); // get last index
if( $currentKey != $intervalix )
$intervalarr = array( $intervalix => ( $intervalarr[$currentKey] + 1 ));
if(( $recur['INTERVAL'] != $intervalarr[$intervalix] ) &&
( 0 != $intervalarr[$intervalix] )) {
/* step up date */
//echo "skip: ".implode('-',$wdate)." ix=$intervalix old=$currentKey interval=".$intervalarr[$intervalix]." \n";//test
$this->_stepdate( $wdate, $wdatets, $step);
continue;
}
else // continue within the selected interval
$intervalarr[$intervalix] = 0;
//echo "cont: ".implode('-',$wdate)." ix=$intervalix old=$currentKey interval=".$intervalarr[$intervalix]." \n";//test
}
$updateOK = TRUE;
if( $updateOK && isset( $recur['BYMONTH'] ))
$updateOK = $this->_recurBYcntcheck( $recur['BYMONTH']
, $wdate['month']
,($wdate['month'] - 13));
if( $updateOK && isset( $recur['BYWEEKNO'] ))
$updateOK = $this->_recurBYcntcheck( $recur['BYWEEKNO']
, $daycnts[$wdate['month']][$wdate['day']]['weekno_up']
, $daycnts[$wdate['month']][$wdate['day']]['weekno_down'] );
if( $updateOK && isset( $recur['BYYEARDAY'] ))
$updateOK = $this->_recurBYcntcheck( $recur['BYYEARDAY']
, $daycnts[$wdate['month']][$wdate['day']]['yearcnt_up']
, $daycnts[$wdate['month']][$wdate['day']]['yearcnt_down'] );
if( $updateOK && isset( $recur['BYMONTHDAY'] ))
$updateOK = $this->_recurBYcntcheck( $recur['BYMONTHDAY']
, $wdate['day']
, $daycnts[$wdate['month']][$wdate['day']]['monthcnt_down'] );
//echo "efter BYMONTHDAY: ".implode('-',$wdate).' status: '; echo ($updateOK) ? 'TRUE' : 'FALSE'; echo " \n";//test###
if( $updateOK && isset( $recur['BYDAY'] )) {
$updateOK = FALSE;
$m = $wdate['month'];
$d = $wdate['day'];
if( isset( $recur['BYDAY']['DAY'] )) { // single day, opt with year/month day order no
$daynoexists = $daynosw = $daynamesw = FALSE;
if( $recur['BYDAY']['DAY'] == $daycnts[$m][$d]['DAY'] )
$daynamesw = TRUE;
if( isset( $recur['BYDAY'][0] )) {
$daynoexists = TRUE;
if(( isset( $recur['FREQ'] ) && ( $recur['FREQ'] == 'MONTHLY' )) || isset( $recur['BYMONTH'] ))
$daynosw = $this->_recurBYcntcheck( $recur['BYDAY'][0]
, $daycnts[$m][$d]['monthdayno_up']
, $daycnts[$m][$d]['monthdayno_down'] );
elseif( isset( $recur['FREQ'] ) && ( $recur['FREQ'] == 'YEARLY' ))
$daynosw = $this->_recurBYcntcheck( $recur['BYDAY'][0]
, $daycnts[$m][$d]['yeardayno_up']
, $daycnts[$m][$d]['yeardayno_down'] );
}
if(( $daynoexists && $daynosw && $daynamesw ) ||
( !$daynoexists && !$daynosw && $daynamesw )) {
$updateOK = TRUE;
}
//echo "daynoexists:$daynoexists daynosw:$daynosw daynamesw:$daynamesw \n"; // test ###
}
else {
foreach( $recur['BYDAY'] as $bydayvalue ) {
$daynoexists = $daynosw = $daynamesw = FALSE;
if( isset( $bydayvalue['DAY'] ) &&
( $bydayvalue['DAY'] == $daycnts[$m][$d]['DAY'] ))
$daynamesw = TRUE;
if( isset( $bydayvalue[0] )) {
$daynoexists = TRUE;
if(( isset( $recur['FREQ'] ) && ( $recur['FREQ'] == 'MONTHLY' )) ||
isset( $recur['BYMONTH'] ))
$daynosw = $this->_recurBYcntcheck( $bydayvalue['0']
, $daycnts[$m][$d]['monthdayno_up']
, $daycnts[$m][$d]['monthdayno_down'] );
elseif( isset( $recur['FREQ'] ) && ( $recur['FREQ'] == 'YEARLY' ))
$daynosw = $this->_recurBYcntcheck( $bydayvalue['0']
, $daycnts[$m][$d]['yeardayno_up']
, $daycnts[$m][$d]['yeardayno_down'] );
}
//echo "daynoexists:$daynoexists daynosw:$daynosw daynamesw:$daynamesw \n"; // test ###
if(( $daynoexists && $daynosw && $daynamesw ) ||
( !$daynoexists && !$daynosw && $daynamesw )) {
$updateOK = TRUE;
break;
}
}
}
}
//echo "efter BYDAY: ".implode('-',$wdate).' status: '; echo ($updateOK) ? 'TRUE' : 'FALSE'; echo " \n"; // test ###
/* check BYSETPOS */
if( $updateOK ) {
if( isset( $recur['BYSETPOS'] ) &&
( in_array( $recur['FREQ'], array( 'YEARLY', 'MONTHLY', 'WEEKLY', 'DAILY' )))) {
if( isset( $recur['WEEKLY'] )) {
if( $bysetposWold == $daycnts[$wdate['month']][$wdate['day']]['weekno_up'] )
$bysetposw1[] = $wdatets;
else
$bysetposw2[] = $wdatets;
}
else {
if(( isset( $recur['FREQ'] ) && ( 'YEARLY' == $recur['FREQ'] ) &&
( $bysetposYold == $wdate['year'] )) ||
( isset( $recur['FREQ'] ) && ( 'MONTHLY' == $recur['FREQ'] ) &&
(( $bysetposYold == $wdate['year'] ) &&
( $bysetposMold == $wdate['month'] ))) ||
( isset( $recur['FREQ'] ) && ( 'MONTHLY' == $recur['FREQ'] ) &&
(( $bysetposYold == $wdate['year'] ) &&
( $bysetposMold == $wdate['month']) &&
( $bysetposDold == $wdate['sday'] ))))
$bysetposymd1[] = $wdatets;
else
$bysetposymd2[] = $wdatets;
}
}
else {
/* update result array if BYSETPOS is set */
$countcnt++;
if( $startdatets <= $wdatets ) { // only output within period
$result[$wdatets] = TRUE;
//echo "recur ".implode('-',$this->_date_time_string(date('Y-m-d H:i:s',$wdatets),6))." \n";//test
}
//else echo "recur undate ".implode('-',$this->_date_time_string(date('Y-m-d H:i:s',$wdatets),6))." okdatstart ".implode('-',$this->_date_time_string(date('Y-m-d H:i:s',$startdatets),6))." \n";//test
$updateOK = FALSE;
}
}
/* step up date */
$this->_stepdate( $wdate, $wdatets, $step);
/* check if BYSETPOS is set for updating result array */
if( $updateOK && isset( $recur['BYSETPOS'] )) {
$bysetpos = FALSE;
if( isset( $recur['FREQ'] ) && ( 'YEARLY' == $recur['FREQ'] ) &&
( $bysetposYold != $wdate['year'] )) {
$bysetpos = TRUE;
$bysetposYold = $wdate['year'];
}
elseif( isset( $recur['FREQ'] ) && ( 'MONTHLY' == $recur['FREQ'] &&
(( $bysetposYold != $wdate['year'] ) || ( $bysetposMold != $wdate['month'] )))) {
$bysetpos = TRUE;
$bysetposYold = $wdate['year'];
$bysetposMold = $wdate['month'];
}
elseif( isset( $recur['FREQ'] ) && ( 'WEEKLY' == $recur['FREQ'] )) {
$weekno = (int) date( 'W', mktime( 0, 0, $wkst, $wdate['month'], $wdate['day'], $wdate['year']));
if( $bysetposWold != $weekno ) {
$bysetposWold = $weekno;
$bysetpos = TRUE;
}
}
elseif( isset( $recur['FREQ'] ) && ( 'DAILY' == $recur['FREQ'] ) &&
(( $bysetposYold != $wdate['year'] ) ||
( $bysetposMold != $wdate['month'] ) ||
( $bysetposDold != $wdate['sday'] ))) {
$bysetpos = TRUE;
$bysetposYold = $wdate['year'];
$bysetposMold = $wdate['month'];
$bysetposDold = $wdate['day'];
}
if( $bysetpos ) {
if( isset( $recur['BYWEEKNO'] )) {
$bysetposarr1 = & $bysetposw1;
$bysetposarr2 = & $bysetposw2;
}
else {
$bysetposarr1 = & $bysetposymd1;
$bysetposarr2 = & $bysetposymd2;
}
foreach( $recur['BYSETPOS'] as $ix ) {
if( 0 > $ix ) // both positive and negative BYSETPOS allowed
$ix = ( count( $bysetposarr1 ) + $ix + 1);
$ix--;
if( isset( $bysetposarr1[$ix] )) {
if( $startdatets <= $bysetposarr1[$ix] ) { // only output within period
$result[$bysetposarr1[$ix]] = TRUE;
//echo "recur ".implode('-',$this->_date_time_string(date('Y-m-d H:i:s',$bysetposarr1[$ix]),6))." \n";//test
}
$countcnt++;
}
if( isset( $recur['COUNT'] ) && ( $countcnt >= $recur['COUNT'] ))
break;
}
$bysetposarr1 = $bysetposarr2;
$bysetposarr2 = array();
}
}
}
}
function _recurBYcntcheck( $BYvalue, $upValue, $downValue ) {
if( is_array( $BYvalue ) &&
( in_array( $upValue, $BYvalue ) || in_array( $downValue, $BYvalue )))
return TRUE;
elseif(( $BYvalue == $upValue ) || ( $BYvalue == $downValue ))
return TRUE;
else
return FALSE;
}
function _recurIntervalIx( $freq, $date, $wkst ) {
/* create interval index */
switch( $freq ) {
case 'YEARLY':
$intervalix = $date['year'];
break;
case 'MONTHLY':
$intervalix = $date['year'].'-'.$date['month'];
break;
case 'WEEKLY':
$wdatets = $this->_date2timestamp( $date );
$intervalix = (int) date( 'W', ( $wdatets + $wkst ));
break;
case 'DAILY':
default:
$intervalix = $date['year'].'-'.$date['month'].'-'.$date['day'];
break;
}
return $intervalix;
}
/**
* convert format for input date to internal date with parameters
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-08-01
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return array
*/
function _setDate( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $tz=FALSE, $params=FALSE ) {
$input = $parno = null;
if( is_array( $year ) && ( in_array( count( $year ), array( 3, 4, 6, 7 )))) {
$input['params'] = $this->_setParams( $month, array( 'VALUE' => 'DATE-TIME' ));
if( isset( $input['params']['TZID'] ))
$year['tz'] = $input['params']['TZID'];
$hitval = ( !empty( $year['tz'] ) || !empty( $year[6] ) || ( 4 == count( $year ))) ? 7 : 6;
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE-TIME', $hitval );
if( !isset( $parno ))
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE', 3 );
if( !isset( $parno ))
$parno = count( $year );
$input['value'] = $this->_date_time_array( $year, $parno );
}
elseif( is_array( $year ) && isset( $year['timestamp'] )) {
$input['params'] = $this->_setParams( $month, array( 'VALUE' => 'DATE-TIME' ));
if( isset( $input['params']['TZID'] ))
$year['tz'] = $input['params']['TZID'];
$tz = ( isset( $year['tz'] )) ? ' '.$year['tz'] : null;
$hitval = ( !empty( $tz )) ? 7 : 6;
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE-TIME', $hitval );
if( !isset( $parno ))
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE', 3 );
if( !isset( $parno ))
$parno = $hitval;
$input['value'] = $this->_date_time_string( date('Y-m-d H:i:s',$year['timestamp']).$tz,$parno );
}
elseif( 8 <= strlen( trim( $year ))) { // ex. 2006-08-03 10:12:18
$input['params'] = $this->_setParams( $month, array( 'VALUE' => 'DATE-TIME' ));
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE-TIME', 7 );
if( !isset( $parno ))
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE', 3 );
$input['value'] = $this->_date_time_string( $year, $parno );
if( isset( $input['params']['TZID'] ))
$input['value']['tz'] = $input['params']['TZID'];
}
else {
$input['params'] = $this->_setParams( $params, array( 'VALUE' => 'DATE-TIME' ));
if( isset( $input['params']['TZID'] ))
$tz = $input['params']['TZID'];
$hitval = ( !empty( $tz )) ? 7 : null;
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE-TIME', $hitval );
if( !isset( $parno ))
$parno = $this->_existRem( $input['params'], 'VALUE', 'DATE', 3 );
$input['value'] = array( 'year' => $year, 'month' => $month, 'day' => $day );
if( 3 != $parno ) {
$input['value']['hour'] = ( $hour ) ? $hour : '0';
$input['value']['min'] = ( $min ) ? $min : '0';
$input['value']['sec'] = ( $sec ) ? $sec : '0';
if( !empty( $tz ))
$input['value']['tz'] = $tz;
}
}
if( 3 == $parno ) {
$input['params']['VALUE'] = 'DATE';
unset( $input['value']['tz'] );
unset( $input['params']['TZID'] );
}
if( isset( $input['value']['tz'] ))
$input['value']['tz'] = (string) $input['value']['tz'];
if( !empty( $input['value']['tz'] ) &&
( $input['value']['tz'] != 'Z' ) &&
( !( in_array($input['value']['tz']{0}, array( '+', '-' )) &&
ctype_digit( substr( $input['value']['tz'], 1 ))) &&
!ctype_digit( $input['value']['tz'] ) ) ) {
$input['params']['TZID'] = $input['value']['tz'];
unset( $input['value']['tz'] );
}
elseif( isset( $input['params']['TZID'] ))
unset( $input['params']['TZID'] );
return $input;
}
/**
* convert format for input date (UTC) to internal date with parameters
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-08-02
* @param mixed $year
* @param mixed $month optional
* @param int $day optional
* @param int $hour optional
* @param int $min optional
* @param int $sec optional
* @param array $params optional
* @return array
*/
function _setDate2( $year, $month=FALSE, $day=FALSE, $hour=FALSE, $min=FALSE, $sec=FALSE, $params=FALSE ) {
$input = null;
if( is_array( $year ) &&
(( 6 == count( $year )) ||
( array_key_exists( 'year', $year )))) {
$input['value'] = $this->_date_time_array( $year, 7 );
$input['params'] = $this->_setParams( $month );
}
elseif( is_array( $year ) && isset( $year['timestamp'] )) {
$input['value'] = $this->_date_time_string( date( 'Y-m-d H:i:s', $year['timestamp'] ), 7 );
$input['params'] = $this->_setParams( $month );
}
elseif( 8 <= strlen( trim( $year ))) { // ex. 2006-08-03 10:12:18
$input['value'] = $this->_date_time_string( $year, 7 );
$input['params'] = $this->_setParams( $month );
}
else {
$input['value'] = array( 'year' => $year
, 'month' => $month
, 'day' => $day
, 'hour' => $hour
, 'min' => $min
, 'sec' => $sec );
$input['params'] = $this->_setParams( $params );
}
if( !isset( $input['value']['hour'] ))
$input['value']['hour'] = 0;
if( !isset( $input['value']['min'] ))
$input['value']['min'] = 0;
if( !isset( $input['value']['sec'] ))
$input['value']['sec'] = 0;
$input['value']['tz'] = 'Z';
return $input;
}
/**
* set input (formatted) parameters- component property attributes
*
* default parameters can be set, if missing
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 1.x.x - 2007-05-01
* @param array $params
* @param array $defaults
* @return array
*/
function _setParams( $params, $defaults=FALSE ) {
if( !is_array( $params))
$params = array();
$input = array();
foreach( $params as $paramKey => $paramValue ) {
if( is_array( $paramValue )) {
foreach( $paramValue as $pkey => $pValue ) {
if(( '"' == substr( $pValue, 0, 1 )) && ( '"' == substr( $pValue, -1 )))
$paramValue[$pkey] = substr( $pValue, 1, ( strlen( $pValue ) - 2 ));
}
}
elseif(( '"' == substr( $paramValue, 0, 1 )) && ( '"' == substr( $paramValue, -1 )))
$paramValue = substr( $paramValue, 1, ( strlen( $paramValue ) - 2 ));
if( 'VALUE' == strtoupper( $paramKey ))
$input['VALUE'] = strtoupper( $paramValue );
else
$input[strtoupper( $paramKey )] = $paramValue;
}
if( is_array( $defaults )) {
foreach( $defaults as $paramKey => $paramValue ) {
if( !isset( $input[$paramKey] ))
$input[$paramKey] = $paramValue;
}
}
return (0 < count( $input )) ? $input : null;
}
/**
* step date, return updated date, array and timpstamp
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.15 - 2007-11-12
* @param array $date, date to step
* @param int $timestamp
* @param array $step, default array( 'day' => 1 )
* @return void
*/
function _stepdate( &$date, &$timestamp, $step=array( 'day' => 1 )) {
foreach( $step as $stepix => $stepvalue )
$date[$stepix] += $stepvalue;
$timestamp = $this->_date2timestamp( $date );
$date = $this->_date_time_string( date('Y-m-d H:i:s', $timestamp ), 6);
foreach( $date as $k => $v ) {
if( ctype_digit( $v ))
$date[$k] = (int) $v;
}
}
/**
* convert (numeric) tz to offset seconds
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.2 - 2007-07-29
* @param string $offset
* @return integer
*/
function _tz2offset( $tz ) {
$tz = trim( (string) $tz );
$offset = 0;
if(( 5 == strlen( $tz )) &&
( '0000' <= substr( $tz, -4 )) &&
( '9999' >= substr( $tz, -4 )) &&
(( '+' == substr( $tz, 0, 1 )) ||
( '-' == substr( $tz, 0, 1 )))) {
$hours2sec = substr( $tz, 1, 2 ) * 3600;
$min2sec = substr( $tz, -2 ) * 60;
$sign = substr( $tz, 0, 1 );
$offset = (int) ( $sign.'1' * ($hours2sec + $min2sec ));
}
elseif(( 7 == strlen( $tz )) &&
( '000000' <= substr( $tz, -6 )) &&
( '999999' >= substr( $tz, -6 )) &&
(( '+' == substr( $tz, 0, 1 )) ||
( '-' == substr( $tz, 0, 1 )))) {
$hours2sec = substr( $tz, 1, 2 ) * 3600;
$min2sec = substr( $tz, 3, 2 ) * 60;
$sec = substr( $tz, -2 );
$sign = substr( $tz, 0, 1 );
$offset = (int) ( $sign.'1' * ( $hours2sec + $min2sec + $sec ));
}
return $offset;
}
/*********************************************************************************/
/*********************************************************************************/
/**
* get general component config variables or info about subcomponents
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-10-23
* @param string $config
* @return value
*/
function getConfig( $config ) {
switch( strtoupper( $config )) {
case 'ALLOWEMPTY':
return $this->allowEmpty;
break;
case 'COMPSINFO':
unset( $this->compix );
$info = array();
foreach( $this->components as $cix => $component ) {
unset( $component->propix );
$info[$cix]['ordno'] = $cix + 1;
$info[$cix]['type'] = $component->objName;
$info[$cix]['uid'] = $component->getProperty( 'uid' );
$info[$cix]['props'] = $component->getConfig( 'propinfo' );
$info[$cix]['sub'] = $component->getConfig( 'compsinfo' );
unset( $component->propix );
}
return $info;
break;
case 'FORMAT':
return $this->format;
break;
case 'LANGUAGE':
// get language for calendar component as defined in [RFC 1766]
return $this->language;
break;
case 'NL':
return $this->nl;
break;
case 'PROPINFO':
$output = array();
if( 0 < count( $this->action ))
$output['ACTION'] = count( $this->action ) / 2;
if( 0 < count( $this->attach ))
$output['ATTACH'] = count( $this->attach );
if( 0 < count( $this->attendee ))
$output['ATTENDEE'] = count( $this->attendee );
if( 0 < count( $this->categories ))
$output['CATEGORIES'] = count( $this->categories );
if( 0 < count( $this->class ))
$output['CLASS'] = count( $this->class ) / 2;
if( 0 < count( $this->comment ))
$output['COMMENT'] = count( $this->comment );
if( 0 < count( $this->completed ))
$output['COMPLETED'] = count( $this->completed ) / 2;
if( 0 < count( $this->contact ))
$output['CONTACT'] = count( $this->contact );
if( 0 < count( $this->created ))
$output['CREATED'] = count( $this->created ) / 2;
if( 0 < count( $this->description ))
$output['DESCRIPTION'] = count( $this->description );
if( 0 < count( $this->dtend ))
$output['DTEND'] = count( $this->dtend ) / 2;
if( 0 < count( $this->dtstart ))
$output['DTSTART'] = count( $this->dtstart ) / 2;
if( 0 < count( $this->dtstamp ))
$output['DTSTAMP'] = count( $this->dtstamp ) / 2;
if( 0 < count( $this->due ))
$output['DUE'] = count( $this->due ) / 2;
if( 0 < count( $this->duration ))
$output['DURATION'] = count( $this->duration ) / 2;
if( 0 < count( $this->exdate ))
$output['EXDATE'] = count( $this->exdate );
if( 0 < count( $this->exrule ))
$output['EXRULE'] = count( $this->exrule );
if( 0 < count( $this->freebusy ))
$output['FREEBUSY'] = count( $this->freebusy );
if( 0 < count( $this->geo ))
$output['GEO'] = count( $this->geo ) / 2;
if( 0 < count( $this->lastmodified ))
$output['LAST-MODIFIED'] = count( $this->lastmodified ) / 2;
if( 0 < count( $this->location ))
$output['LOCATION'] = count( $this->location ) / 2;
if( 0 < count( $this->organizer ))
$output['ORGANIZER'] = count( $this->organizer ) / 2;
if( 0 < count( $this->percentcomplete ))
$output['PERCENT-COMPLETE'] = count( $this->percentcomplete ) / 2;
if( 0 < count( $this->priority ))
$output['PRIORITY'] = count( $this->priority ) / 2;
if( 0 < count( $this->rdate ))
$output['RDATE'] = count( $this->rdate );
if( 0 < count( $this->recurrenceid ))
$output['RECURRENCE-ID'] = count( $this->recurrenceid ) / 2;
if( 0 < count( $this->relatedto ))
$output['RELATED-TO'] = count( $this->relatedto );
if( 0 < count( $this->repeat ))
$output['REPEAT'] = count( $this->repeat ) / 2;
if( 0 < count( $this->requeststatus ))
$output['REQUEST-STATUS'] = count( $this->requeststatus );
if( 0 < count( $this->resources ))
$output['RESOURCES'] = count( $this->resources );
if( 0 < count( $this->sequence ))
$output['SEQUENCE'] = count( $this->sequence ) / 2;
if( 0 < count( $this->rrule ))
$output['RRULE'] = count( $this->rrule );
if( 0 < count( $this->status ))
$output['STATUS'] = count( $this->status ) / 2;
if( 0 < count( $this->summary ))
$output['SUMMARY'] = count( $this->summary ) / 2;
if( 0 < count( $this->transp ))
$output['TRANSP'] = count( $this->transp ) / 2;
if( 0 < count( $this->trigger ))
$output['TRIGGER'] = count( $this->trigger ) / 2;
if( 0 < count( $this->tzid ))
$output['TZID'] = count( $this->tzid ) / 2;
if( 0 < count( $this->tzname ))
$output['TZNAME'] = count( $this->tzname );
if( 0 < count( $this->tzoffsetfrom ))
$output['TZOFFSETTFROM'] = count( $this->tzoffsetfrom ) / 2;
if( 0 < count( $this->tzoffsetto ))
$output['TZOFFSETTO'] = count( $this->tzoffsetto ) / 2;
if( 0 < count( $this->tzurl ))
$output['TZURL'] = count( $this->tzurl ) / 2;
if( !in_array( $this->objName, array( 'valarm', 'vtimezone' ))) {
if( empty( $this->uid['value'] ))
$this->_makeuid();
$output['UID'] = 1;
}
if( 0 < count( $this->url ))
$output['URL'] = count( $this->url ) / 2;
if( 0 < count( $this->xprop ))
$output['X-PROP'] = count( $this->xprop );
return $output;
break;
case 'UNIQUE_ID':
if( empty( $this->unique_id ))
$this->unique_id = gethostbyname( $_SERVER['SERVER_NAME'] );
return $this->unique_id;
break;
}
}
/**
* general component config setting
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-10-25
* @param string $config
* @param string $value
* @return void
*/
function setConfig( $config, $value ) {
switch( strtoupper( $config )) {
case 'ALLOWEMPTY':
$this->allowEmpty = $value;
break;
case 'FORMAT':
$value = trim( $value );
$this->format = $value;
break;
case 'LANGUAGE':
// set language for calendar component as defined in [RFC 1766]
$value = trim( $value );
$this->language = $value;
break;
case 'NL':
$this->nl = $value;
break;
case 'UNIQUE_ID':
$value = trim( $value );
$this->unique_id = $value;
break;
}
}
/*********************************************************************************/
/**
* delete component property value
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.15 - 2007-10-29
* @param string $propName
* @param int @propix, optional, if specific property is wanted in case of multiply occurences
* @return bool, if successfull delete TRUE
*/
function deleteProperty( $propName, $propix=FALSE ) {
$propName = ( $propName ) ? strtoupper( $propName ) : 'X-PROP';
if( !$propix )
$propix = ( isset( $this->propdelix[$propName] )) ? $this->propdelix[$propName] + 2 : 1;
$this->propdelix[$propName] = --$propix;
$return = FALSE;
switch( $propName ) {
case 'ACTION':
if(( 0 < $propix ) || !isset( $this->action['value'] )) return FALSE;
$this->action = array();
return TRUE;
break;
case 'ATTACH':
if( count( $this->attach ) <= $propix ) return FALSE;
$this->attach[$propix] = null;
return TRUE;
break;
case 'ATTENDEE':
if( count( $this->attendee ) <= $propix ) return FALSE;
$this->attendee[$propix] = null;
return TRUE;
break;
case 'CATEGORIES':
if( !isset( $this->categories[$propix])) return FALSE;
$this->categories[$propix] = null;
return TRUE;
break;
case 'CLASS':
if(( 0 < $propix ) || !isset( $this->class['value'] )) return FALSE;
$this->class = array();
return TRUE;
break;
case 'COMMENT':
if( !isset( $this->comment[$propix])) return FALSE;
$this->comment[$propix] = null;
return TRUE;
break;
case 'COMPLETED':
if(( 0 < $propix ) || !isset( $this->completed['value'] )) return FALSE;
$this->completed = array();
return TRUE;
break;
case 'CONTACT':
if( !isset( $this->contact[$propix])) return FALSE;
$this->contact[$propix] = null;
return TRUE;
break;
case 'CREATED':
if(( 0 < $propix ) || !isset( $this->created['value'] )) return FALSE;
$this->created = array();
return TRUE;
break;
case 'DESCRIPTION':
if( !isset( $this->description[$propix])) return FALSE;
$this->description[$propix] = null;
return TRUE;
break;
case 'DTEND':
if(( 0 < $propix ) || !isset( $this->dtend['value'] )) return FALSE;
$this->dtend = array();
return TRUE;
break;
case 'DTSTAMP':
if( in_array( $this->objName, array( 'valarm', 'vtimezone' )))
return FALSE;
if(( 0 < $propix ) || !isset( $this->dtstamp['value'] )) return FALSE;
$this->dtstamp = array();
return TRUE;
break;
case 'DTSTART':
if(( 0 < $propix ) || !isset( $this->dtstart['value'] )) return FALSE;
$this->dtstart = array();
return TRUE;
break;
case 'DUE':
if(( 0 < $propix ) || !isset( $this->due['value'] )) return FALSE;
$this->due = array();
return TRUE;
break;
case 'DURATION':
if(( 0 < $propix ) || !isset( $this->duration['value'] )) return FALSE;
$this->duration = array();
return TRUE;
break;
case 'EXDATE':
if( !isset( $this->exdate[$propix])) return FALSE;
$this->exdate[$propix] = null;
return TRUE;
break;
case 'EXRULE':
if( !isset( $this->exrule[$propix])) return FALSE;
$this->exrule[$propix]['value'];
return TRUE;
break;
case 'FREEBUSY':
if( !isset( $this->freebusy[$propix])) return FALSE;
$this->freebusy[$propix] = null;
return TRUE;
break;
case 'GEO':
if(( 0 < $propix ) || !isset( $this->geo['value'] )) return FALSE;
$this->geo = array();
return TRUE;
break;
case 'LAST-MODIFIED':
if(( 0 < $propix ) || !isset( $this->lastmodified['value'] )) return FALSE;
$this->lastmodified = array();
return TRUE;
break;
case 'LOCATION':
if(( 0 < $propix ) || !isset( $this->location['value'] )) return FALSE;
$this->location = array();
return TRUE;
break;
case 'ORGANIZER':
if(( 0 < $propix ) || !isset( $this->organizer['value'] )) return FALSE;
$this->organizer = array();
return TRUE;
break;
case 'PERCENT-COMPLETE':
if(( 0 < $propix ) || !isset( $this->percentcomplete['value'] )) return FALSE;
$this->percentcomplete = array();
return TRUE;
break;
case 'PRIORITY':
if(( 0 < $propix ) || !isset( $this->priority['value'] )) return FALSE;
$this->priority = array();
return TRUE;
break;
case 'RDATE':
if( !isset( $this->rdate[$propix])) return FALSE;
$this->rdate[$propix] = null;
return TRUE;
break;
case 'RECURRENCE-ID':
if(( 0 < $propix ) || !isset( $this->recurrenceid['value'] )) return FALSE;
$this->recurrenceid = array();
return TRUE;
break;
case 'RELATED-TO':
if( !isset( $this->relatedto[$propix])) return FALSE;
$this->relatedto[$propix] = null;
return TRUE;
break;
case 'REPEAT':
if(( 0 < $propix ) || !isset( $this->repeat['value'] )) return FALSE;
$this->repeat = array();
return TRUE;
break;
case 'REQUEST-STATUS':
if( !isset( $this->requeststatus[$propix])) return FALSE;
$this->requeststatus[$propix] = null;
return TRUE;
break;
case 'RESOURCES':
if( !isset( $this->resources[$propix])) return FALSE;
$this->resources[$propix] = null;
return TRUE;
break;
case 'RRULE':
if( !isset( $this->rrule[$propix])) return FALSE;
$this->rrule[$propix] = null;
return TRUE;
break;
case 'SEQUENCE':
if(( 0 < $propix ) || !isset( $this->sequence['value'] )) return FALSE;
$this->sequence = array();
return TRUE;
break;
case 'STATUS':
if(( 0 < $propix ) || !isset( $this->status['value'] )) return FALSE;
$this->status = array();
return TRUE;
break;
case 'SUMMARY':
if(( 0 < $propix ) || !isset( $this->summary['value'] )) return FALSE;
$this->summary = array();
return TRUE;
break;
case 'TRANSP':
if(( 0 < $propix ) || !isset( $this->transp['value'] )) return FALSE;
$this->transp = array();
return TRUE;
break;
case 'TRIGGER':
if(( 0 < $propix ) || !isset( $this->trigger['value'] )) return FALSE;
$this->trigger = array();
return TRUE;
break;
case 'TZID':
if(( 0 < $propix ) || !isset( $this->tzid['value'] )) return FALSE;
$this->tzid = array();
return TRUE;
break;
case 'TZNAME':
if( !isset( $this->tzname[$propix])) return FALSE;
$this->tzname[$propix] = null;
return TRUE;
break;
case 'TZOFFSETFROM':
if(( 0 < $propix ) || !isset( $this->tzoffsetfrom['value'] )) return FALSE;
$this->tzoffsetfrom = array();
return TRUE;
break;
case 'TZOFFSETTO':
if(( 0 < $propix ) || !isset( $this->tzoffsetto['value'] )) return FALSE;
$this->tzoffsetto = array();
return TRUE;
break;
case 'TZURL':
if(( 0 < $propix ) || !isset( $this->tzurl['value'] )) return FALSE;
$this->tzurl = array();
return TRUE;
break;
case 'UID':
if( in_array( $this->objName, array( 'valarm', 'vtimezone' )))
return FALSE;
if(( 0 < $propix ) || !isset( $this->uid['value'] )) return FALSE;
$this->uid = array();
return TRUE;
break;
case 'URL':
if(( 0 < $propix ) || !isset( $this->url['value'] )) return FALSE;
$this->url = array();
return TRUE;
break;
default:
if( $propName != 'X-PROP' ) {
if( !isset( $this->xprop[$propName] )) return FALSE;
unset( $this->xprop[$propName] );
return TRUE;
}
else {
if( count( $this->xprop ) <= $propix ) return FALSE;
$xpropno = 0;
foreach( $this->xprop as $xpropkey => $xpropvalue ) {
if( $propix == $xpropno ) {
unset( $this->xprop[$xpropkey] );
$return = TRUE;
break 2;
}
else
$xpropno++;
}
}
}
return $return;
}
/**
* get component property value/params
*
* if property has multiply values, consequtive function calls are needed
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.1.1 - 2007-07-07
* @param string $propName, optional
* @param int @propix, optional, if specific property is wanted in case of multiply occurences
* @param bool $inclParam=FALSE
* @param bool $specform=FALSE
* @return mixed
*/
function getProperty( $propName=FALSE, $propix=FALSE, $inclParam=FALSE, $specform=FALSE ) {
$propName = ( $propName ) ? strtoupper( $propName ) : 'X-PROP';
if( !$propix )
$propix = ( isset( $this->propix[$propName] )) ? $this->propix[$propName] + 2 : 1;
$this->propix[$propName] = --$propix;
switch( $propName ) {
case 'ACTION':
if(( 0 < $propix ) || !isset( $this->action['value'] )) return FALSE;
return ( $inclParam ) ? $this->action : $this->action['value'];
break;
case 'ATTACH':
if( count( $this->attach ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->attach[$propix] : $this->attach[$propix]['value'];
break;
case 'ATTENDEE':
if( count( $this->attendee ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->attendee[$propix] : $this->attendee[$propix]['value'];
break;
case 'CATEGORIES':
if( count( $this->categories ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->categories[$propix] : $this->categories[$propix]['value'];
break;
case 'CLASS':
if(( 0 < $propix ) || !isset( $this->class['value'] )) return FALSE;
return ( $inclParam ) ? $this->class : $this->class['value'];
break;
case 'COMMENT':
if( count( $this->comment ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->comment[$propix] : $this->comment[$propix]['value'];
break;
case 'COMPLETED':
if(( 0 < $propix ) || !isset( $this->completed['value'] )) return FALSE;
return ( $inclParam ) ? $this->completed : $this->completed['value'];
break;
case 'CONTACT':
if( count( $this->contact ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->contact[$propix] : $this->contact[$propix]['value'];
break;
case 'CREATED':
if(( 0 < $propix ) || !isset( $this->created['value'] )) return FALSE;
return ( $inclParam ) ? $this->created : $this->created['value'];
break;
case 'DESCRIPTION':
if( count( $this->description ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->description[$propix] : $this->description[$propix]['value'];
break;
case 'DTEND':
if(( 0 < $propix ) || !isset( $this->dtend['value'] )) return FALSE;
return ( $inclParam ) ? $this->dtend : $this->dtend['value'];
break;
case 'DTSTAMP':
if( in_array( $this->objName, array( 'valarm', 'vtimezone' )))
return;
if( 0 < $propix )
return null;
if( !isset( $this->dtstamp['value'] ))
$this->_makeDtstamp();
return ( $inclParam ) ? $this->dtstamp : $this->dtstamp['value'];
break;
case 'DTSTART':
if(( 0 < $propix ) || !isset( $this->dtstart['value'] )) return FALSE;
return ( $inclParam ) ? $this->dtstart : $this->dtstart['value'];
break;
case 'DUE':
if(( 0 < $propix ) || !isset( $this->due['value'] )) return FALSE;
return ( $inclParam ) ? $this->due : $this->due['value'];
break;
case 'DURATION':
if(( 0 < $propix ) || !isset( $this->duration['value'] )) return FALSE;
$value = ( $specform ) ? $this->duration2date() : $this->duration['value'];
return ( $inclParam ) ? array( 'value' => $value, 'params' => $this->duration['params'] ) : $value;
break;
case 'EXDATE':
if( count( $this->exdate ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->exdate[$propix] : $this->exdate[$propix]['value'];
break;
case 'EXRULE':
if( count( $this->exrule ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->exrule[$propix] : $this->exrule[$propix]['value'];
break;
case 'FREEBUSY':
if( count( $this->freebusy ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->freebusy[$propix] : $this->freebusy[$propix]['value'];
break;
case 'GEO':
if(( 0 < $propix ) || !isset( $this->geo['value'] )) return FALSE;
return ( $inclParam ) ? $this->geo : $this->geo['value'];
break;
case 'LAST-MODIFIED':
if(( 0 < $propix ) || !isset( $this->lastmodified['value'] )) return FALSE;
return ( $inclParam ) ? $this->lastmodified : $this->lastmodified['value'];
break;
case 'LOCATION':
if(( 0 < $propix ) || !isset( $this->location['value'] )) return FALSE;
return ( $inclParam ) ? $this->location : $this->location['value'];
break;
case 'ORGANIZER':
if(( 0 < $propix ) || !isset( $this->organizer['value'] )) return FALSE;
return ( $inclParam ) ? $this->organizer : $this->organizer['value'];
break;
case 'PERCENT-COMPLETE':
if(( 0 < $propix ) || !isset( $this->percentcomplete['value'] )) return FALSE;
return ( $inclParam ) ? $this->percentcomplete : $this->percentcomplete['value'];
break;
case 'PRIORITY':
if(( 0 < $propix ) || !isset( $this->priority['value'] )) return FALSE;
return ( $inclParam ) ? $this->priority : $this->priority['value'];
break;
case 'RDATE':
if( count( $this->rdate ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->rdate[$propix] : $this->rdate[$propix]['value'];
break;
case 'RECURRENCE-ID':
if(( 0 < $propix ) || !isset( $this->recurrenceid['value'] )) return FALSE;
return ( $inclParam ) ? $this->recurrenceid : $this->recurrenceid['value'];
break;
case 'RELATED-TO':
if( count( $this->relatedto ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->relatedto[$propix] : $this->relatedto[$propix]['value'];
break;
case 'REPEAT':
if(( 0 < $propix ) || !isset( $this->repeat['value'] )) return FALSE;
return ( $inclParam ) ? $this->repeat : $this->repeat['value'];
break;
case 'REQUEST-STATUS':
if( count( $this->requeststatus ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->requeststatus[$propix] : $this->requeststatus[$propix]['value'];
break;
case 'RESOURCES':
if( count( $this->resources ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->resources[$propix] : $this->resources[$propix]['value'];
break;
case 'RRULE':
if( count( $this->rrule ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->rrule[$propix] : $this->rrule[$propix]['value'];
break;
case 'SEQUENCE':
if(( 0 < $propix ) || !isset( $this->sequence['value'] )) return FALSE;
return ( $inclParam ) ? $this->sequence : $this->sequence['value'];
break;
case 'STATUS':
if(( 0 < $propix ) || !isset( $this->status['value'] )) return FALSE;
return ( $inclParam ) ? $this->status : $this->status['value'];
break;
case 'SUMMARY':
if(( 0 < $propix ) || !isset( $this->summary['value'] )) return FALSE;
return ( $inclParam ) ? $this->summary : $this->summary['value'];
break;
case 'TRANSP':
if(( 0 < $propix ) || !isset( $this->transp['value'] )) return FALSE;
return ( $inclParam ) ? $this->transp : $this->transp['value'];
break;
case 'TRIGGER':
if(( 0 < $propix ) || !isset( $this->trigger['value'] )) return FALSE;
return ( $inclParam ) ? $this->trigger : $this->trigger['value'];
break;
case 'TZID':
if(( 0 < $propix ) || !isset( $this->tzid['value'] )) return FALSE;
return ( $inclParam ) ? $this->tzid : $this->tzid['value'];
break;
case 'TZNAME':
if( count( $this->tzname ) <= $propix ) return FALSE;
return ( $inclParam ) ? $this->tzname[$propix] : $this->tzname[$propix]['value'];
break;
case 'TZOFFSETFROM':
if(( 0 < $propix ) || !isset( $this->tzoffsetfrom['value'] )) return FALSE;
return ( $inclParam ) ? $this->tzoffsetfrom : $this->tzoffsetfrom['value'];
break;
case 'TZOFFSETTO':
if(( 0 < $propix ) || !isset( $this->tzoffsetto['value'] )) return FALSE;
return ( $inclParam ) ? $this->tzoffsetto : $this->tzoffsetto['value'];
break;
case 'TZURL':
if(( 0 < $propix ) || !isset( $this->tzurl['value'] )) return FALSE;
return ( $inclParam ) ? $this->tzurl : $this->tzurl['value'];
break;
case 'UID':
if( in_array( $this->objName, array( 'valarm', 'vtimezone' )))
return;
if( 0 < $propix )
return null;
if( empty( $this->uid['value'] ))
$this->_makeuid();
return ( $inclParam ) ? $this->uid : $this->uid['value'];
break;
case 'URL':
if(( 0 < $propix ) || !isset( $this->url['value'] )) return FALSE;
return ( $inclParam ) ? $this->url : $this->url['value'];
break;
default:
if( $propName != 'X-PROP' ) {
if( !isset( $this->xprop[$propName] )) return FALSE;
return ( $inclParam ) ? array( $propName, $this->xprop[$propName] )
: array( $propName, $this->xprop[$propName]['value'] );
}
else {
if( count( $this->xprop ) <= $propix ) return FALSE;
$xpropno = 0;
foreach( $this->xprop as $xpropkey => $xpropvalue ) {
if( $propix == $xpropno )
return ( $inclParam ) ? array( $xpropkey, $this->xprop[$xpropkey] )
: array( $xpropkey, $this->xprop[$xpropkey]['value'] );
else
$xpropno++;
}
return FALSE; // not found ??
}
}
return FALSE;
}
/**
* general component property setting
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.2.13 - 2007-10-25
* @param mixed $args variable number of function arguments,
* first argument is ALWAYS component name,
* second ALWAYS component value!
* @return void
*/
function setProperty() {
$numargs = func_num_args();
if( 1 > $numargs )
return FALSE;
$arglist = func_get_args();
if( !$this->getConfig( 'allowEmpty' ) && ( !isset( $arglist[1] ) || empty( $arglist[1] )))
return;
$arglist[0] = strtoupper( $arglist[0] );
for( $argix=$numargs; $argix < 12; $argix++ ) {
if( !isset( $arglist[$argix] ))
$arglist[$argix] = null;
}
switch( $arglist[0] ) {
case 'ACTION':
$this->setAction( $arglist[1], $arglist[2] );
break;
case 'ATTACH':
$this->setAttach( $arglist[1], $arglist[2] );
break;
case 'ATTENDEE':
$this->setAttendee( $arglist[1], $arglist[2] );
break;
case 'CATEGORIES':
$this->setCategories( $arglist[1], $arglist[2] );
break;
case 'CLASS':
$this->setClass( $arglist[1], $arglist[2] );
break;
case 'COMMENT':
$this->setComment( $arglist[1], $arglist[2] );
break;
case 'COMPLETED':
$this->setCompleted( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7] );
break;
case 'CONTACT':
$this->setContact( $arglist[1], $arglist[2] );
break;
case 'CREATED':
$this->setCreated( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7] );
break;
case 'DESCRIPTION':
$this->setDescription( $arglist[1], $arglist[2] );
break;
case 'DTEND':
$this->setDtend( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7], $arglist[8] );
break;
case 'DTSTAMP':
$this->setDtstamp( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7] );
break;
case 'DTSTART':
$this->setDtstart( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7], $arglist[8] );
break;
case 'DUE':
$this->setDue( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7], $arglist[8] );
break;
case 'DURATION':
$this->setDuration( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6] );
break;
case 'EXDATE':
$this->setExdate( $arglist[1], $arglist[2] );
break;
case 'EXRULE':
$this->setExrule( $arglist[1], $arglist[2] );
break;
case 'FREEBUSY':
$this->setFreebusy( $arglist[1], $arglist[2], $arglist[3] );
break;
case 'GEO':
$this->setGeo( $arglist[1], $arglist[2], $arglist[3] );
break;
case 'LAST-MODIFIED':
$this->setLastModified( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7] );
break;
case 'LOCATION':
$this->setLocation( $arglist[1], $arglist[2] );
break;
case 'ORGANIZER':
$this->setOrganizer( $arglist[1], $arglist[2] );
break;
case 'PERCENT-COMPLETE':
$this->setPercentComplete( $arglist[1], $arglist[2] );
break;
case 'PRIORITY':
$this->setPriority( $arglist[1], $arglist[2] );
break;
case 'RDATE':
$this->setRdate( $arglist[1], $arglist[2] );
break;
case 'RECURRENCE-ID':
$this->setRecurrenceid( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7], $arglist[8] );
break;
case 'RELATED-TO':
$this->setRelatedTo( $arglist[1], $arglist[2] );
break;
case 'REPEAT':
$this->setRepeat( $arglist[1], $arglist[2] );
break;
case 'REQUEST-STATUS':
$this->setRequestStatus( $arglist[1], $arglist[2], $arglist[3], $arglist[4] );
break;
case 'RESOURCES':
$this->setResources( $arglist[1], $arglist[2] );
break;
case 'RRULE':
$this->setRrule( $arglist[1], $arglist[2] );
break;
case 'SEQUENCE':
$this->setSequence( $arglist[1], $arglist[2] );
break;
case 'STATUS':
$this->setStatus( $arglist[1], $arglist[2] );
break;
case 'SUMMARY':
$this->setSummary( $arglist[1], $arglist[2] );
break;
case 'TRANSP':
$this->setTransp( $arglist[1], $arglist[2] );
break;
case 'TRIGGER':
$this->setTrigger( $arglist[1], $arglist[2], $arglist[3], $arglist[4], $arglist[5], $arglist[6], $arglist[7], $arglist[8], $arglist[9], $arglist[10], $arglist[11] );
break;
case 'TZID':
$this->setTzid( $arglist[1], $arglist[2] );
break;
case 'TZNAME':
$this->setTzname( $arglist[1], $arglist[2] );
break;
case 'TZOFFSETFROM':
$this->setTzoffsetfrom( $arglist[1], $arglist[2] );
break;
case 'TZOFFSETTO':
$this->setTzoffsetto( $arglist[1], $arglist[2] );
break;
case 'TZURL':
$this->setTzurl( $arglist[1], $arglist[2] );
break;
case 'UID':
$this->setUid( $arglist[1], $arglist[2] );
break;
case 'URL':
$this->setUrl( $arglist[1], $arglist[2] );
break;
default:
$this->setXprop( $arglist[0], $arglist[1], $arglist[2] );
break;
}
}
/*********************************************************************************/
/**
* parse component unparsed data into properties
*
* @author Kjell-Inge Gustafsson <ical@kigkonsult.se>
* @since 2.4.2 - 2008-02-07
* @param mixed $unparsedtext, strict rfc2445 formatted, single property string or array of property strings
* @return bool FALSE if error occurs during parsing
*
*/
function parse( $unparsedtext=null ) {
if( $unparsedtext ) {
$this->unparsed = array();
if( is_array( $unparsedtext )) {
$comp = & $this;
foreach ( $unparsedtext as $line ) {
if( 'END:VALARM' == strtoupper( substr( $line, 0, 10 ))) {
$this->setComponent( $comp );
$comp = & $this;
continue;
}
elseif( 'BEGIN:VALARM

Source for file iCalcreator.class.php