mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-11-27 10:23:28 +01:00
326 lines
11 KiB
PHP
326 lines
11 KiB
PHP
<?php
|
|
/* WARNING: EXPERIMENTAL CODE DO NOT USE FOR PRODUCTION */
|
|
/**
|
|
* @file
|
|
* Icalsrv: Export and Import Egw events and task as ICalendar over http
|
|
*
|
|
* Possible clients include Mozilla Calendar/Sunbird, Korganizer, Apple Ical
|
|
* and Evolution.
|
|
* @note <b> THIS IS STILL EXPERIMENTAL CODE </b> do not use in production.
|
|
* @note this script is supposed to be at: egw-root/icalsrv.php
|
|
*
|
|
* @version 0.9.08-R1 initial version for icalsrv as egw application
|
|
* @date 20060318
|
|
* @author Jan van Lieshout <jvl (at) xs4all.nl> Rewrite and extension for egw 1.2.
|
|
* $Id$
|
|
* (see: @url http://www.egroupware.org )
|
|
*
|
|
* Based on some code from:
|
|
* @author RalfBecker@outdoor-training.de (some original code base)
|
|
* @author bbeckmann (at) optaros.com (some modificationas)
|
|
* @author l.tulipan (at) mpwi.at (Additional Modifications for egw 1.2).
|
|
*
|
|
* <b>license:</b><br>
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the
|
|
* Free Software Foundation; either version 2 of the License, or (at your
|
|
* option) any later version.
|
|
*
|
|
* @since 0.9.06 collect all (todos via query filter iso just 15)
|
|
* @since 0.9.00 use of the new egwical class for iCalendar handling with WURH
|
|
* TODO list:
|
|
* @todo incorporate this icalsrv.php script in
|
|
* standard egroupware access url, via a setup routine or so.
|
|
* @todo make this 'ical-service' enabled/disabled from the egw
|
|
* admin interface
|
|
* @todo make some parameters of this 'ical-service' interface user
|
|
* specific configurable, for example the vevent and vtodo export
|
|
* period (define search filters..) or overwrite or duplicate mode
|
|
* etc.
|
|
* @todo for ical GET: get the agent name from the http header
|
|
* and use to set the ical product field when exporting.
|
|
* @warning the current calendar filter will export only events in the period
|
|
* from one month ago till one year ahead.
|
|
* @warning all and only those events and todos are exported that you have access to
|
|
* according to the default calendar and infolog settings (is this correct Ralf?)
|
|
*/
|
|
|
|
|
|
$logdir = false; // set to false for no logging
|
|
#$logdir = '/tmp'; // set to a valid (writable) directory to get log file generation
|
|
|
|
# WHY THIS? IS IT NEEDED?
|
|
$GLOBALS['egw_info'] =
|
|
array('flags' => array('currentapp' => 'calendar',
|
|
'noheader' => True,
|
|
'nofooter' => True,
|
|
),);
|
|
|
|
$GLOBALS['egw_info']['flags']['currentapp'] = 'login';
|
|
$GLOBALS['egw_info']['flags']['noapi'] = True;
|
|
include ('./header.inc.php');
|
|
|
|
include ('./phpgwapi/inc/functions.inc.php');
|
|
|
|
$GLOBALS['egw_info']['flags']['currentapp'] = 'calendar';
|
|
|
|
|
|
// oke there we go .....
|
|
|
|
// exit on non authenticated http request
|
|
if ((!isset($_SERVER['PHP_AUTH_USER'])) ||
|
|
(!$GLOBALS['egw']->auth->authenticate($_SERVER['PHP_AUTH_USER'],
|
|
$_SERVER['PHP_AUTH_PW']))) {
|
|
header('WWW-Authenticate: Basic realm="ICal Server"');
|
|
header('HTTP/1.1 401 Unauthorized');
|
|
exit;
|
|
}
|
|
|
|
$user = $GLOBALS['egw']->accounts->name2id($_SERVER['PHP_AUTH_USER']);
|
|
$pw = $GLOBALS['egw']->preferences->account_id = $user;
|
|
|
|
# WHY THIS? IS IT NEEDED?
|
|
$GLOBALS['egw_info']['user']['preferences'] =
|
|
$GLOBALS['egw']->preferences->read_repository();
|
|
|
|
$GLOBALS['egw_info']['user']['account_id'] = $user;
|
|
$GLOBALS['egw_info']['user']['account_lid'] = $_SERVER['PHP_AUTH_USER'];
|
|
|
|
|
|
/* WARNING:
|
|
* SET $euid_export ONLY TO TRUE IF YOU NEED IT TO USE THE EXPORTED ICAL INFO
|
|
* SEPARATED FROM EGW, IN A CONTEXT WHERE IT ORIGINATED FROM. SO NORMALLY LEAVE IT
|
|
* TO FALSE IF WANT TO USE YOUR CLIENT REGULARY (TO SUBSCRIBE/PUBLISH TO) WITH EGW
|
|
*/
|
|
$euid_export = false;
|
|
|
|
|
|
/* select mode for importing the ical components,
|
|
* safeMode=-1 -> allows new creation and deletion (in combi with $importMode = 'OVERWRITE')
|
|
* 0 -> allow new creation and change, but no deletion?
|
|
* WARNING:
|
|
* USE safeMode = -1 WILL DELETE EXISTING events WHEN NO VALID ATTENDEES ARE
|
|
* GIVEN IN THE RELATED ICAL IMPORTED VEVENT !!
|
|
* ---!!! USE WITH CARE OR YOUR DATA GETS LOST!! ---------
|
|
*/
|
|
$safeMode = 0;
|
|
|
|
$importMode = 'OVERWRITE'; // OVERWRITE or DUPLICATE
|
|
|
|
$logmsg = "";
|
|
|
|
|
|
// IO-0 setup an Egwical object, and add a Calendar and a Infolog Resource
|
|
// these will do all the work
|
|
$ei =& CreateObject('egwical.egwical');
|
|
// for free an Horde_iCalendar object that we may use to collect or convert ical elements
|
|
$hIcal = $ei->hi;
|
|
$boc =& CreateObject('calendar.bocalupdate');
|
|
$binf =& CreateObject('infolog.boinfolog');
|
|
|
|
//calendar_vevents_handler: this will allow $ei to convert events<->vevents and
|
|
// store and retrieve them from the egw db
|
|
$cvehnd = $ei->addRsc($boc);
|
|
//infolog_vtodos_handler: this will allow $ei to convert tasks<->vtodos and
|
|
// store and retrieve them from the egw db
|
|
$ivthnd = $ei->addRsc($binf);
|
|
|
|
|
|
|
|
// oke now process the http request...
|
|
|
|
if ($_SERVER['REQUEST_METHOD'] == 'PUT') {
|
|
|
|
// *** PUT Request so do an Import *************
|
|
|
|
// I0 read the payload
|
|
$logmsg = 'IMPORTING in '. $importMode . ' mode';
|
|
$fpput = fopen("php://input", "r");
|
|
$putData = "";
|
|
while ($data = fread($fpput, 1024))
|
|
$putData .= $data;
|
|
fclose($fpput);
|
|
|
|
|
|
// I1: parse $putData using the egwical builtin ical parser
|
|
$hIcal =& $ei->parsevCalendar($putData);
|
|
|
|
if(!$hIcal){
|
|
$msg ="icalsrv.php: error parsing iCal import data";
|
|
fail_exit($msg);
|
|
}
|
|
$logmsg .= "\n parsed iCalendar data:" . count($hIcal->_components) . " components found";
|
|
|
|
|
|
// I2: now import possibly found VEVENTS into eGW calendar
|
|
$vcnt = $cvehnd->importVEventsFromIcal($hIcal, $importMode, $safeMode);
|
|
|
|
if($vcnt === false){
|
|
$msg = 'icalsrv.php: VEVENTS import: ERRORS';
|
|
fail_exit($msg);
|
|
} else{
|
|
$logmsg .= "\n imported " . $vcnt ." VEVENTS: OK";
|
|
}
|
|
|
|
// I3: now import possibly found VTODOS into eGW calendar
|
|
$tcnt = $ivthnd->importVTodosFromIcal($hIcal, $importMode);
|
|
if ($tcnt === false){
|
|
$msg = 'icalsrv.php: VTODOS import: ERRORS';
|
|
fail_exit($msg);
|
|
}
|
|
$logmsg .= "\n imported " . $tcnt . " VTODOS: OK ";
|
|
|
|
if($logdir) log_ical($logmsg,"import",$putData);
|
|
|
|
|
|
} else {
|
|
|
|
// *** GET (or POST?) Request
|
|
$logmsg = 'EXPORTING';
|
|
|
|
// Get events from 3 years (last year, current, next), rather silly.. */
|
|
$last_year = date("Y")-1;
|
|
$next_year = date("Y")+1;
|
|
|
|
// until it is configurable we do 1 month back and 1 year ahead
|
|
$evq_start = date('Ymd',time()-2678400);
|
|
$evq_end = date('Ymd',time()+65000000);
|
|
|
|
// E1.1: get period to be exported for events
|
|
// For productivity this should be user configurable e.g. to be set via some sort of user
|
|
// preferences to be set via eGW. (config remote-iCalendar...)
|
|
$events_query = array('start' => $evq_start,
|
|
'end' => $evq_end,
|
|
'filter' => 'all',
|
|
'enum_recuring' => false,
|
|
'daywise' => false,
|
|
'owner' => $GLOBALS['egw_info']['user']['account_id'],
|
|
// timestamp in server time for boical class
|
|
'date_format' => 'server'
|
|
);
|
|
|
|
$todos = array();
|
|
|
|
// filter == my: entries user is responsible for,
|
|
// filter == own: entries the user owns or is responsible for
|
|
// order == id_parent: ...
|
|
// order == info_datemodified: ...
|
|
// todo add a filter to limit how far back entries from the past are retrieved
|
|
$todos_query = array('col_filter' => array('type' => 'task'),
|
|
'filter' => 'my',
|
|
'order' => 'id_parent',
|
|
'sort' => 'DESC'
|
|
);
|
|
|
|
// E2.1: search eGW events based on the $events_query
|
|
$events = & $boc->search($events_query);
|
|
if (!$events){
|
|
$logmsg .="\n no eGW events found to export";
|
|
// nevertheless fall through to further ical components export
|
|
} else {
|
|
$logmsg .= "\n found " . count($events) . " eGW events to export";
|
|
|
|
//E2.2 convert the found eGW events and add them to the iCal container
|
|
$vcnt = $cvehnd->exportEventsOntoIcal($hIcal, $events, $euid_export);
|
|
if($vcnt === false){
|
|
$msg = 'icalsrv.php: eGW to VEVENTS conversion: ERRORS';
|
|
fail_exit($msg);
|
|
} else {
|
|
$logmsg .= "\n exported the eGW events as " . $vcnt . " VEvents: OK ";
|
|
}
|
|
$bove = null; //destroy object
|
|
}
|
|
|
|
// E3.1: search eGW todos based on the $todos_query
|
|
$todos =& $binf->search($todos_query);
|
|
if (!$todos){
|
|
$logmsg .="\n no eGW todos found to export";
|
|
// nevertheless fall through to further ical components export
|
|
} else {
|
|
$logmsg .= "\n found " . count($todos) . " eGW todos to export";
|
|
|
|
//E3.2 convert the found eGW todos and add them to the iCal container
|
|
$tcnt = $ivthnd->exportTodosOntoIcal($hIcal, $todos, $euid_export);
|
|
if ($tcnt === false){
|
|
$msg = 'icalsrv.php: eGW to VTODOS conversion: ERRORS';
|
|
fail_exit($msg);
|
|
} else {
|
|
$logmsg .= "\n exported the eGW todos as " . $tcnt . " VTODOS: OK ";
|
|
}
|
|
$bovt = null; //destroy object
|
|
}
|
|
|
|
|
|
// E4.1: add good vcal header info to iCal object
|
|
$hIcal->setAttribute('PRODID', '-//eGroupWare//NONSGML eGroupWare Calendar '
|
|
. $GLOBALS['egw_info']['apps']['calendar']['version'].'//'
|
|
. strtoupper($GLOBALS['egw_info']['user']['preferences']['common']['lang']));
|
|
$hIcal->setAttribute('VERSION','2.0');
|
|
$hIcal->setAttribute('METHOD','PUBLISH');
|
|
|
|
// now let Horde stringify it and deliver as result
|
|
$content = $hIcal->exportvCalendar();
|
|
echo $content;
|
|
// DONE exporting
|
|
if($logdir) log_ical($logmsg,"export",$content);
|
|
|
|
}
|
|
|
|
$GLOBALS['egw']->common->egw_exit();
|
|
|
|
|
|
|
|
// --- SOME UTILITY FUNCTIONS -------
|
|
|
|
/**
|
|
* Exit with an error message in html
|
|
* @param $msg string
|
|
* message that gets return as html error description
|
|
*/
|
|
function fail_exit($msg){
|
|
// log the error in the http server error logging files
|
|
error_log($msg);
|
|
// return http error 403 can this be done this way?
|
|
header('HTTP/1.1 403' . $msg);
|
|
$GLOBALS['egw']->common->egw_exit();
|
|
}
|
|
|
|
|
|
|
|
|
|
/*
|
|
* Log info and data to logfiles if logging is set
|
|
*
|
|
* @param $msg string with loginfo
|
|
* @param $data data to be logged
|
|
* @param $icalmethod $string value can be import or export
|
|
* @global $logdir string/boolean log directory. Set to false to disab logging
|
|
*/
|
|
function log_ical($msg,$icalmethod="data",$data){
|
|
|
|
global $logdir;
|
|
if (!$logdir)
|
|
return; // loggin seems off
|
|
|
|
// some info used for logging
|
|
$logstamp = date("U");
|
|
$loguser = $_SERVER['PHP_AUTH_USER'];
|
|
$logdate = date("Ymd:His");
|
|
// filename for log info, only used when logging is on
|
|
$fnloginfo = "$logdir/ical.log";
|
|
|
|
// log info
|
|
$fnlogdata = $logdir . "/ical." . $icalmethod . '.' . $logstamp . ".ics";
|
|
$fp = fopen("$fnloginfo",'a+');
|
|
fwrite($fp,"\n\n$loguser on $logdate : $msg, \n data in $fnlogdata ");
|
|
fclose($fp);
|
|
// log data
|
|
$fp = fopen("$fnlogdata", "w");
|
|
fputs($fp, $data);
|
|
fclose($fp);
|
|
}
|
|
|
|
|
|
|
|
|
|
?>
|