@classDescription Export calendar(s) to ical format More...

Collaboration diagram for ilCalendarExport:

Public Member Functions
	__construct ($a_calendar_ids=array())

	getUserSettings ()
	Get user settings. More...

	setExportType ($a_type)

	setAppointments ($a_apps)

	getAppointments ()

	setCalendarIds ($a_cal_ids)

	getCalendarIds ()

	getExportType ()

	export ()

	getExportString ()

Data Fields
const	EXPORT_CALENDARS = 1

const	EXPORT_APPOINTMENTS = 2

Protected Member Functions
	addTimezone ()

	addCategories ()

	addAppointments ()

	addAppointment ($a_app_id)

	createVTODO ($app)

	createVEVENT ($app)
	Create VEVENT entry @global ilObjUser $ilUser. More...

	createRecurrences ($app)

	buildAppointmentUrl (ilCalendarEntry $entry)
	Build url from calendar entry. More...

Protected Attributes
	$export_type = self::EXPORT_CALENDARS

	$calendars = array()

	$user_settings = NULL

	$appointments = array()

	$writer = null

Private Attributes
	$logger = null

Detailed Description

@classDescription Export calendar(s) to ical format

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

Definition at line 37 of file class.ilCalendarExport.php.

Constructor & Destructor Documentation

◆ __construct()

ilCalendarExport::__construct ( $a_calendar_ids = array() )

Definition at line 55 of file class.ilCalendarExport.php.

        {
                $this->logger = $GLOBALS['DIC']->logger()->cal();
                
                
                $this->calendars = $a_calendar_ids;
                $this->writer = new ilICalWriter();
                
                $this->user_settings = ilCalendarUserSettings::_getInstanceByUserId($GLOBALS['ilUser']->getId());
        }

References $GLOBALS, and ilCalendarUserSettings\_getInstanceByUserId().

Here is the call graph for this function:

Member Function Documentation

◆ addAppointment()

ilCalendarExport::addAppointment ( $a_app_id )

protected

Definition at line 170 of file class.ilCalendarExport.php.

        {
                $app = new ilCalendarEntry($a_app_id);
                if($app->isMilestone())
                {
                        $this->createVTODO($app);
                }
                else
                {
                        $this->createVEVENT($app);
                }
        }

References createVEVENT(), and createVTODO().

Referenced by addAppointments(), and addCategories().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addAppointments()

ilCalendarExport::addAppointments ( )

protected

Definition at line 162 of file class.ilCalendarExport.php.

        {
                foreach($this->getAppointments() as $app)
                {
                        $this->addAppointment($app);
                }
        }

References addAppointment(), and getAppointments().

Referenced by export().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addCategories()

ilCalendarExport::addCategories ( )

protected

Definition at line 151 of file class.ilCalendarExport.php.

        {
                foreach($this->calendars as $category_id)
                {
                        foreach(ilCalendarCategoryAssignments::_getAssignedAppointments(array($category_id)) as $app_id)
                        {
                                $this->addAppointment($app_id);
                        }
                }
        }

References ilCalendarCategoryAssignments\_getAssignedAppointments(), and addAppointment().

Referenced by export().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addTimezone()

ilCalendarExport::addTimezone ( )

protected

Definition at line 128 of file class.ilCalendarExport.php.

        {
                if($this->getUserSettings()->getExportTimeZoneType() == ilCalendarUserSettings::CAL_EXPORT_TZ_UTC)
                {
                        return;
                }
                
                $this->writer->addLine('X-WR-TIMEZONE:'.$GLOBALS['ilUser']->getTimeZone());
                
                include_once './Services/Calendar/classes/class.ilCalendarUtil.php';
                $tzid_file = ilCalendarUtil::getZoneInfoFile($GLOBALS['ilUser']->getTimeZone());
                if(!is_file($tzid_file))
                {
                        $tzid_file = ilCalendarUtil::getZoneInfoFile('Europe/Berlin');
                }
                $reader = fopen($tzid_file,'r');
                while($line = fgets($reader))
                {
                        $line = str_replace("\n", '', $line);
                        $this->writer->addLine($line);
                }
        }

References $GLOBALS, $reader, ilCalendarUserSettings\CAL_EXPORT_TZ_UTC, getUserSettings(), and ilCalendarUtil\getZoneInfoFile().

Referenced by export().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildAppointmentUrl()

ilCalendarExport::buildAppointmentUrl ( ilCalendarEntry $entry )

protected

Build url from calendar entry.

Parameters

ilCalendarEntry $entry

Returns: string

Definition at line 328 of file class.ilCalendarExport.php.

        {
                $cat = ilCalendarCategory::getInstanceByCategoryId(
                        current((array) ilCalendarCategoryAssignments::_lookupCategories($entry->getEntryId()))
                );
 
                if($cat->getType() != ilCalendarCategory::TYPE_OBJ)
                {
                        $this->writer->addLine('URL;VALUE=URI:'.ILIAS_HTTP_PATH);
                }
                else
                {
                        $refs = ilObject::_getAllReferences($cat->getObjId());
 
                        include_once './Services/Link/classes/class.ilLink.php';
                        $this->writer->addLine(
                                'URL;VALUE=URI:'.ilLink::_getLink(current((array) $refs))
                        );
                }
        }

References ilObject\_getAllReferences(), ilLink\_getLink(), ilCalendarCategoryAssignments\_lookupCategories(), ilCalendarEntry\getEntryId(), ilCalendarCategory\getInstanceByCategoryId(), and ilCalendarCategory\TYPE_OBJ.

Referenced by createVEVENT().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createRecurrences()

ilCalendarExport::createRecurrences ( $app )

protected

Definition at line 302 of file class.ilCalendarExport.php.

        {
                global $ilUser;
 
                include_once './Services/Calendar/classes/class.ilCalendarRecurrences.php';
                foreach(ilCalendarRecurrences::_getRecurrences($app->getEntryId()) as $rec)
                {
                        foreach(ilCalendarRecurrenceExclusions::getExclusionDates($app->getEntryId()) as $excl)
                        {
                                $this->writer->addLine($excl->toICal());
                        }
                        $this->writer->addLine($rec->toICal($ilUser->getId()));
                }
        }

References $ilUser, ilCalendarRecurrences\_getRecurrences(), and ilCalendarRecurrenceExclusions\getExclusionDates().

Referenced by createVEVENT().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createVEVENT()

ilCalendarExport::createVEVENT ( $app )

protected

Create VEVENT entry @global ilObjUser $ilUser.

Parameters

ilCalendarEntry $app

Definition at line 194 of file class.ilCalendarExport.php.

        {
                global $ilUser;
                
                if(!$app->getStart() instanceof ilDateTime)
                {
                        $this->logger->notice('Cannot create appointment for app_id: ' . $app->getEntryId());
                }
 
                $this->writer->addLine('BEGIN:VEVENT');
 
                $now = new ilDateTime(time(), IL_CAL_UNIX);
                $this->writer->addLine('DTSTAMP:'.$now->get(IL_CAL_FKT_DATE,'Ymd\THis\Z', ilTimeZone::UTC));
 
                $this->writer->addLine('UID:'.ilICalWriter::escapeText(
                        $app->getEntryId().'_'.CLIENT_ID.'@'.ILIAS_HTTP_PATH));
                
                        
                $last_mod = $app->getLastUpdate()->get(IL_CAL_FKT_DATE,'Ymd\THis\Z',ilTimeZone::UTC);
                #$last_mod = $app->getLastUpdate()->get(IL_CAL_FKT_DATE,'Ymd\THis\Z',$ilUser->getTimeZone());
                $this->writer->addLine('LAST-MODIFIED:'.$last_mod);
 
                // begin-patch aptar
                include_once './Services/Calendar/classes/class.ilCalendarRecurrences.php';
                if($rec = ilCalendarRecurrences::_getFirstRecurrence($app->getEntryId()))
                {
                        // Set starting time to first appointment that matches the recurrence rule
                        include_once './Services/Calendar/classes/class.ilCalendarRecurrenceCalculator.php';
                        $calc = new ilCalendarRecurrenceCalculator($app,$rec);
 
                        $pStart = $app->getStart();
                        $pEnd = clone $app->getStart();
                        $pEnd->increment(IL_CAL_YEAR,5);
                        $appDiff = $app->getEnd()->get(IL_CAL_UNIX) - $app->getStart()->get(IL_CAL_UNIX);
                        $recs = $calc->calculateDateList($pStart, $pEnd);
                        
                        // defaults
                        $startInit = $app->getStart();
                        $endInit = $app->getEnd();
                        foreach($recs as $dt)
                        {
                                $startInit = $dt;
                                $endInit = clone($dt);
                                $endInit->setDate($startInit->get(IL_CAL_UNIX) + $appDiff,IL_CAL_UNIX);
                                break;
                        }
 
                }
                else
                {
                        $startInit = $app->getStart();
                        $endInit = $app->getEnd();
                }
 
                
                if($app->isFullday())
                {
                        // According to RFC 5545 3.6.1 DTEND is not inklusive.
                        // But ILIAS stores inklusive dates in the database.
                        #$app->getEnd()->increment(IL_CAL_DAY,1);
                        $endInit->increment(IL_CAL_DATE,1);
 
                        #$start = $app->getStart()->get(IL_CAL_FKT_DATE,'Ymd\Z',ilTimeZone::UTC);
                        #$start = $app->getStart()->get(IL_CAL_FKT_DATE,'Ymd',$ilUser->getTimeZone());
                        $start = $startInit->get(IL_CAL_FKT_DATE,'Ymd',$ilUser->getTimeZone());
                        #$end = $app->getEnd()->get(IL_CAL_FKT_DATE,'Ymd\Z',ilTimeZone::UTC);
                        #$end = $app->getEnd()->get(IL_CAL_FKT_DATE,'Ymd',$ilUser->getTimeZone());
                        $endInit->increment(IL_CAL_DAY,1);
                        $end = $endInit->get(IL_CAL_FKT_DATE,'Ymd',$ilUser->getTimeZone());
                        
                        $this->writer->addLine('DTSTART;VALUE=DATE:' . $start);
                        $this->writer->addLine('DTEND;VALUE=DATE:'.$end);
                }
                else
                {
                        if($this->getUserSettings()->getExportTimeZoneType() == ilCalendarUserSettings::CAL_EXPORT_TZ_UTC)
                        {
                                $start = $app->getStart()->get(IL_CAL_FKT_DATE,'Ymd\THis\Z',ilTimeZone::UTC);
                                $end = $app->getEnd()->get(IL_CAL_FKT_DATE,'Ymd\THis\Z',ilTimeZone::UTC);
                                $this->writer->addLine('DTSTART:'. $start);
                                $this->writer->addLine('DTEND:'.$end);
                                
                        }
                        else
                        {
                                $start = $startInit->get(IL_CAL_FKT_DATE,'Ymd\THis',$ilUser->getTimeZone());
                                $end = $endInit->get(IL_CAL_FKT_DATE,'Ymd\THis',$ilUser->getTimeZone());
                                $this->writer->addLine('DTSTART;TZID='.$ilUser->getTimezone().':'. $start);
                                $this->writer->addLine('DTEND;TZID='.$ilUser->getTimezone().':'.$end);
                        }
                }
                // end-patch aptar
 
                $this->createRecurrences($app);
                
                $this->writer->addLine('SUMMARY:'.ilICalWriter::escapeText($app->getPresentationTitle(false)));
                if(strlen($app->getDescription()))
                        $this->writer->addLine('DESCRIPTION:'.ilICalWriter::escapeText($app->getDescription()));
                if(strlen($app->getLocation()))
                        $this->writer->addLine('LOCATION:'.ilICalWriter::escapeText($app->getLocation()));
 
                // TODO: URL
                $this->buildAppointmentUrl($app);
 
                $this->writer->addLine('END:VEVENT');
                
        }

References $ilUser, $start, ilCalendarRecurrences\_getFirstRecurrence(), buildAppointmentUrl(), ilCalendarUserSettings\CAL_EXPORT_TZ_UTC, createRecurrences(), ilICalWriter\escapeText(), getUserSettings(), IL_CAL_DATE, IL_CAL_DAY, IL_CAL_FKT_DATE, IL_CAL_UNIX, IL_CAL_YEAR, and ilTimeZone\UTC.

Referenced by addAppointment().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createVTODO()

ilCalendarExport::createVTODO ( $app )

protected

Definition at line 183 of file class.ilCalendarExport.php.

        {
                // TODO
                return true;
        }

Referenced by addAppointment().

Here is the caller graph for this function:

◆ export()

ilCalendarExport::export ( )

Definition at line 106 of file class.ilCalendarExport.php.

        {
                $this->writer->addLine('BEGIN:VCALENDAR');
                $this->writer->addLine('VERSION:2.0');
                $this->writer->addLine('METHOD:PUBLISH');
                $this->writer->addLine('PRODID:-//ilias.de/NONSGML ILIAS Calendar V4.4//EN');
                
                $this->addTimezone();
 
                switch($this->getExportType())
                {
                        case self::EXPORT_CALENDARS:
                                $this->addCategories();
                                break;
 
                        case self::EXPORT_APPOINTMENTS:
                                $this->addAppointments();
                                break;
                }
                $this->writer->addLine('END:VCALENDAR');
        }

References addAppointments(), addCategories(), addTimezone(), EXPORT_APPOINTMENTS, EXPORT_CALENDARS, and getExportType().

Here is the call graph for this function:

◆ getAppointments()

ilCalendarExport::getAppointments ( )

Definition at line 86 of file class.ilCalendarExport.php.

        {
                return $this->appointments;
        }

References $appointments.

Referenced by addAppointments().

Here is the caller graph for this function:

◆ getCalendarIds()

ilCalendarExport::getCalendarIds ( )

Definition at line 96 of file class.ilCalendarExport.php.

        {
                return (array) $this->calendars;
        }

References $calendars.

◆ getExportString()

ilCalendarExport::getExportString ( )

Definition at line 318 of file class.ilCalendarExport.php.

        {
                return $this->writer->__toString();
        }

◆ getExportType()

ilCalendarExport::getExportType ( )

Definition at line 101 of file class.ilCalendarExport.php.

        {
                return $this->export_type;
        }

References $export_type.

Referenced by export().

Here is the caller graph for this function:

◆ getUserSettings()

ilCalendarExport::getUserSettings ( )

Get user settings.

Returns: ilCalendarUserSettings

Definition at line 70 of file class.ilCalendarExport.php.

        {
                return $this->user_settings;
        }

References $user_settings.

Referenced by addTimezone(), and createVEVENT().

Here is the caller graph for this function:

◆ setAppointments()

ilCalendarExport::setAppointments ( $a_apps )

Definition at line 81 of file class.ilCalendarExport.php.

        {
                $this->appointments = $a_apps;
        }

◆ setCalendarIds()

ilCalendarExport::setCalendarIds ( $a_cal_ids )

Definition at line 91 of file class.ilCalendarExport.php.

        {
                $this->calendars = $a_cal_ids;
        }

◆ setExportType()

ilCalendarExport::setExportType ( $a_type )

Definition at line 76 of file class.ilCalendarExport.php.

        {
                $this->export_type = $a_type;
        }

References $a_type.

Field Documentation

◆ $appointments

ilCalendarExport::$appointments = array()

protected

Definition at line 52 of file class.ilCalendarExport.php.

Referenced by getAppointments().

◆ $calendars

ilCalendarExport::$calendars = array()

protected

Definition at line 50 of file class.ilCalendarExport.php.

Referenced by getCalendarIds().

◆ $export_type

ilCalendarExport::$export_type = self::EXPORT_CALENDARS

protected

Definition at line 42 of file class.ilCalendarExport.php.

Referenced by getExportType().

◆ $logger

ilCalendarExport::$logger = null

private

Definition at line 47 of file class.ilCalendarExport.php.

◆ $user_settings

ilCalendarExport::$user_settings = NULL

protected

Definition at line 51 of file class.ilCalendarExport.php.

Referenced by getUserSettings().

◆ $writer

ilCalendarExport::$writer = null

protected

Definition at line 53 of file class.ilCalendarExport.php.

◆ EXPORT_APPOINTMENTS

const ilCalendarExport::EXPORT_APPOINTMENTS = 2

Definition at line 40 of file class.ilCalendarExport.php.

Referenced by ilCalendarMailNotification\addAttachment(), and export().

◆ EXPORT_CALENDARS

const ilCalendarExport::EXPORT_CALENDARS = 1

Definition at line 39 of file class.ilCalendarExport.php.

Referenced by export().

The documentation for this class was generated from the following file:

Services/Calendar/classes/Export/class.ilCalendarExport.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAppointment()

◆ addAppointments()

◆ addCategories()

◆ addTimezone()

◆ buildAppointmentUrl()

◆ createRecurrences()

◆ createVEVENT()

◆ createVTODO()

◆ export()

◆ getAppointments()

◆ getCalendarIds()

◆ getExportString()

◆ getExportType()

◆ getUserSettings()

◆ setAppointments()

◆ setCalendarIds()

◆ setExportType()

Field Documentation

◆ $appointments

◆ $calendars

◆ $export_type

◆ $logger

◆ $user_settings

◆ $writer

◆ EXPORT_APPOINTMENTS

◆ EXPORT_CALENDARS