Collaboration diagram for ilICalParser:

Public Member Functions
	__construct ($a_ical, $a_type)
	Constructor. More...

	setCategoryId ($a_id)
	set category id More...

	parse ()
	Parse input. More...

Data Fields
const	INPUT_STRING = 1

const	INPUT_FILE = 2

Protected Member Functions
	getContainer ()
	get container More...

	setContainer ($a_container)
	set container More...

	dropContainer ()
	pop la More...

	pushContainer ($a_container)
	push container More...

	parseLine ($line)
	parse a line More...

	storeItems ($a_param_part, $a_value_part)
	store items More...

	splitLine ($a_line)
	parse parameters More...

	tokenize ($a_string, $a_tokenizer)
	tokenize string More...

	getTZ ($a_timezone)
	get timezone More...

	switchTZ (ilTimeZone $timezone)
	Switch timezone. More...

	restoreTZ ()
	restore time More...

	writeEvent ()
	write a new event More...

	purgeString ($a_string)
	purge string More...

Protected Attributes
	$log = null

	$category = null

	$ical = ''

	$file = ''

	$default_timezone = null

	$container = array()

Detailed Description

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

Version: $Id$

/

Definition at line 45 of file class.ilICalParser.php.

Constructor & Destructor Documentation

◆ __construct()

ilICalParser::__construct	(	$a_ical,
		$a_type
	)

Constructor.

@access public

Parameters

string ical string

Exceptions

ilICalParserException

Definition at line 69 of file class.ilICalParser.php.

        {
                global $ilLog;
                
                if($a_type == self::INPUT_STRING)
                {
                        $this->ical = $a_ical;
                }
                elseif($a_type == self::INPUT_FILE)
                {
                        $this->file = $a_ical;
                        $this->ical = file_get_contents($a_ical);
                        
                        if(!strlen($this->ical))
                        {
                                throw new ilICalParserException($GLOBALS['cal_err_no_input']);
                        }
                        #$GLOBALS['ilLog']->write(__METHOD__.': Ical content: '. $this->ical);
                }
                $this->log = $ilLog;
        }

References $GLOBALS, and $ilLog.

Member Function Documentation

◆ dropContainer()

ilICalParser::dropContainer ( )

protected

pop la

@access protected

Definition at line 168 of file class.ilICalParser.php.

        {
                return array_pop($this->container);
        }

Referenced by parseLine(), and storeItems().

Here is the caller graph for this function:

◆ getContainer()

ilICalParser::getContainer ( )

protected

get container

@access protected

Definition at line 147 of file class.ilICalParser.php.

        {
                return $this->container[count($this->container) - 1];
        }

Referenced by parseLine(), storeItems(), and writeEvent().

Here is the caller graph for this function:

◆ getTZ()

ilICalParser::getTZ ( $a_timezone )

protected

get timezone

@access protected

Definition at line 386 of file class.ilICalParser.php.

        {
                $parts = explode('/',$a_timezone);
                $tz = array_pop($parts);
                $continent = array_pop($parts);
                
                if(isset($continent) and $continent)
                {
                        $timezone = $continent.'/'.$tz;
                }
                else
                {
                        $timezone = $a_timezone;
                }
                
                try
                {
                        if($this->default_timezone->getIdentifier() == $timezone)
                        {
                                return $this->default_timezone;
                        }
                        else
                        {
                                $this->log->write(__METHOD__.': Found new timezone: '.$timezone);
                                return ilTimeZone::_getInstance(trim($timezone));
                        }
                }
                catch(ilTimeZoneException $e)
                {
                        $this->log->write(__METHOD__.': Found invalid timezone: '.$timezone);
                        return $this->default_timezone;
                }               
        
        }

References $default_timezone, $tz, and ilTimeZone\_getInstance().

Referenced by parseLine(), and writeEvent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parse()

ilICalParser::parse ( )

Parse input.

@access public

Definition at line 110 of file class.ilICalParser.php.

        {
                $this->default_timezone = ilTimeZone::_getInstance();
                
                $lines = $this->tokenize($this->ical,ilICalUtils::ICAL_EOL);
                
                if(count(lines) == 1)
                {
                        $lines = $this->tokenize($this->ical, ilICalUtils::ICAL_EOL_FB);
                }
                
                for($i = 0; $i < count($lines); $i++)
                {
                        $line = $lines[$i];
 
                        // Check for next multilines (they start with a space)
                        $offset = 1;
                        while(isset($lines[$i + $offset]) and
                                (strpos($lines[$i + $offset],ilICalUtils::ICAL_SPACE) === 0) or
                                (strpos($lines[$i + $offset],ilICalUtils::ICAL_TAB) === 0))
                        {       
                                $lines[$i + $offset] = str_replace(ilICalUtils::ICAL_EOL,'',$lines[$i + $offset]);
                                $line = $line.substr($lines[$i + $offset],1);
                                $offset++;
                        }
                        $i += ($offset - 1);
 
                        // Parse this line
                        $this->parseLine($line);
                }
        }

References ilTimeZone\_getInstance(), ilICalUtils\ICAL_EOL, ilICalUtils\ICAL_EOL_FB, ilICalUtils\ICAL_SPACE, ilICalUtils\ICAL_TAB, parseLine(), and tokenize().

Here is the call graph for this function:

◆ parseLine()

ilICalParser::parseLine ( $line )

protected

parse a line

@access protected

Definition at line 190 of file class.ilICalParser.php.

        {
                switch(trim($line))
                {
                        case 'BEGIN:VCALENDAR':
                                $this->log->write(__METHOD__.': BEGIN VCALENDAR');
                                $this->setContainer(new ilICalComponent('VCALENDAR'));
                                break;
                                
                        case 'END:VCALENDAR':
                                $this->log->write(__METHOD__.': END VCALENDAR');
                                break;
                        
                        case 'BEGIN:VEVENT':
                                $this->log->write(__METHOD__.': BEGIN VEVENT');
                                $this->pushContainer(new ilICalComponent('VEVENT'));
                                break;
                        
                        case 'END:VEVENT':
                                $this->log->write(__METHOD__.': END VEVENT');
                                
                                $this->writeEvent();
                                
                                $this->dropContainer();
                                break;
 
                        case 'BEGIN:VTIMEZONE':
                                $this->log->write(__METHOD__.': BEGIN VTIMEZONE');
                                $container = new ilICalComponent('VTIMEZONE');
                                $this->pushContainer($container);
                                break;
                                
                        case 'END:VTIMEZONE':
                                $this->log->write(__METHOD__.': END VTIMEZONE');
                                
                                if($tzid = $this->getContainer()->getItemsByName('TZID'))
                                {
                                        $this->default_timezone = $this->getTZ($tzid[0]->getValue());
                                } 
                                $this->dropContainer();
                                break;
                        
                        default:
                                if(strpos(trim($line),'BEGIN') === 0)
                                {
                                        $this->log->write(__METHOD__.': Do not handling line:'.$line);
                                        continue;
                                }
                                if(strpos(trim($line),'X-WR-TIMEZONE') === 0)
                                {
                                        list($param,$value) = $this->splitLine($line);
                                        $this->default_timezone = $this->getTZ($value);
                                }
                                else
                                {
                                        list($params,$values) = $this->splitLine($line);
                                        $this->storeItems($params,$values);
                                }
                                break;
                }
        
        }

References $container, $params, dropContainer(), getContainer(), getTZ(), pushContainer(), setContainer(), splitLine(), storeItems(), and writeEvent().

Referenced by parse().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ purgeString()

ilICalParser::purgeString ( $a_string )

protected

purge string

@access protected

Definition at line 645 of file class.ilICalParser.php.

        {
                $a_string = str_replace("\;",";",$a_string);
                $a_string = str_replace("\,",",",$a_string);
                $a_string = str_replace("\:",":",$a_string);
                return ilUtil::stripSlashes($a_string);
                
        }

References ilUtil\stripSlashes().

Referenced by writeEvent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pushContainer()

ilICalParser::pushContainer ( $a_container )

protected

push container

@access protected

Parameters

ilICalItem

Definition at line 179 of file class.ilICalParser.php.

        {
                $this->container[] = $a_container;
        }

Referenced by parseLine(), and storeItems().

Here is the caller graph for this function:

◆ restoreTZ()

ilICalParser::restoreTZ ( )

protected

restore time

@access protected

Definition at line 444 of file class.ilICalParser.php.

        {
                $this->default_timezone->restoreTZ();
        }

◆ setCategoryId()

ilICalParser::setCategoryId ( $a_id )

set category id

@access public

Parameters

int	category id

Returns

Definition at line 98 of file class.ilICalParser.php.

        {
                include_once('./Services/Calendar/classes/class.ilCalendarCategory.php');
                $this->category = new ilCalendarCategory($a_id);
        }

◆ setContainer()

ilICalParser::setContainer ( $a_container )

protected

set container

@access protected

Parameters

ilICalItem

Definition at line 158 of file class.ilICalParser.php.

        {
                $this->container = array($a_container);
        }

Referenced by parseLine().

Here is the caller graph for this function:

◆ splitLine()

ilICalParser::splitLine ( $a_line )

protected

parse parameters

@access protected

Parameters

string a line

Definition at line 355 of file class.ilICalParser.php.

        {
                $matches = array();
                
                if(preg_match('/([^:]+):(.*)/',$a_line,$matches))
                {
                        return array($matches[1],$matches[2]);
                }
                else
                {
                        $this->log->write(__METHOD__.': Found invalid parameter: '.$a_line);
                }
                
                return array('','');
        }

Referenced by parseLine().

Here is the caller graph for this function:

◆ storeItems()

ilICalParser::storeItems	(	$a_param_part,
		$a_value_part
	)

protected

store items

@access protected

Definition at line 258 of file class.ilICalParser.php.

        {
                // Check for a semicolon in param part and split it.
                
                $items = array();
                if($splitted_param = explode(';',$a_param_part))
                {
                        $counter = 0;
                        foreach($splitted_param as $param)
                        {
                                if(!$counter)
                                {
                                        $items[$counter]['param'] = $param;
                                        $items[$counter]['value'] = $a_value_part; 
                                }
                                else
                                {
                                        // Split by '='
                                        if($splitted_param_values = explode('=',$param))
                                        {
                                                $items[$counter]['param'] = $splitted_param_values[0];
                                                $items[$counter]['value'] = $splitted_param_values[1];
                                        }
                                }
                                ++$counter;
                        }
                }
                
                // Split value part
                $substituted_values = str_replace('\;','',$a_value_part);
                
                $values = array();
                if($splitted_values = explode(';',$substituted_values))
                {
                        $counter = 0;
                        foreach($splitted_values as $value)
                        {
                                // Split by '='
                                if($splitted_value_values = explode('=',$value))
                                {
                                        $values[$counter]['param'] = $splitted_value_values[0];
                                        $values[$counter]['value'] = $splitted_value_values[1];
                                }
                                ++$counter;
                        }
                }
 
                // Return if there are no values                
                if(!count($items))
                {
                        $this->log->write(__METHOD__.': Cannot parse parameter: '.$a_param_part.', value: '.$a_value_part);
                        return false;
                }
                
                
                $counter = 0;
                foreach($items as $item)
                {
                        if(!$counter)
                        {
                                // First is ical-Parameter
                                $parameter = new ilICalProperty($item['param'],$item['value']);
                                
                                if(!$this->getContainer() instanceof ilICalItem)
                                {
                                        continue;
                                }
                                
                                $this->getContainer()->addItem($parameter);
                                $this->pushContainer($parameter);
                                
                                if(count($values) > 1)
                                {
                                        foreach($values as $value)
                                        {
                                                $value = new ilICalValue($value['param'],$value['value']);
                                                $this->getContainer()->addItem($value);
                                        }
                                }
                        }
                        else
                        {
                                $value = new ilICalParameter($item['param'],$item['value']);
                                $this->getContainer()->addItem($value);
                        }
                        ++$counter;
                }
                $this->dropContainer();
        }

References dropContainer(), getContainer(), and pushContainer().

Referenced by parseLine().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ switchTZ()

ilICalParser::switchTZ ( ilTimeZone $timezone )

protected

Switch timezone.

@access protected

Definition at line 426 of file class.ilICalParser.php.

        {
                try
                {
                        $timezone->switchTZ();
                }
                catch(ilTimeZoneException $e)
                {
                        $this->log->write(__METHOD__.': Found invalid timezone: '.$timezone);
                        return false;
                }               
        }

References ilTimeZone\switchTZ().

Here is the call graph for this function:

◆ tokenize()

ilICalParser::tokenize	(	$a_string,
		$a_tokenizer
	)

protected

tokenize string

@access protected

Definition at line 376 of file class.ilICalParser.php.

        {
                return explode($a_tokenizer,$a_string); 
        }

Referenced by parse().

Here is the caller graph for this function:

◆ writeEvent()

ilICalParser::writeEvent ( )

protected

write a new event

@access protected

Definition at line 454 of file class.ilICalParser.php.

        {
                $entry = new ilCalendarEntry();
                
                // Search for summary
                foreach($this->getContainer()->getItemsByName('SUMMARY',false) as $item)
                {
                        if(is_a($item,'ilICalProperty'))
                        {
                                $entry->setTitle($this->purgeString($item->getValue()));
                                break;
                        }
                }
                // Search description
                foreach($this->getContainer()->getItemsByName('DESCRIPTION',false) as $item)
                {
                        if(is_a($item,'ilICalProperty'))
                        {
                                $entry->setDescription($this->purgeString($item->getValue()));
                                break;
                        }
                }
                
                // Search location
                foreach($this->getContainer()->getItemsByName('LOCATION',false) as $item)
                {
                        if(is_a($item,'ilICalProperty'))
                        {
                                $entry->setLocation($this->purgeString($item->getValue()));
                                break;
                        }
                }
                
                foreach($this->getContainer()->getItemsByName('DTSTART') as $start)
                {
                        $fullday = false;
                        foreach($start->getItemsByName('VALUE') as $type)
                        {
                                if($type->getValue() == 'DATE')
                                {
                                        $fullday = true;
                                }
                        }
                        $start_tz = $this->default_timezone;
                        foreach($start->getItemsByName('TZID') as $param)
                        {
                                $start_tz = $this->getTZ($param->getValue());
                        }
                        if($fullday)
                        {
                                $start = new ilDate($start->getValue(),
                                        IL_CAL_DATE);
                        }
                        else
                        {
                                $start = new ilDateTime($start->getValue(),
                                        IL_CAL_DATETIME,
                                        $start_tz->getIdentifier());
                        }
                        $entry->setStart($start);
                        $entry->setFullday($fullday);
                }
                
                foreach($this->getContainer()->getItemsByName('DTEND') as $end)
                {
                        $fullday = false;
                        foreach($end->getItemsByName('VALUE') as $type)
                        {
                                if($type->getValue() == 'DATE')
                                {
                                        $fullday = true;
                                }
                        }
                        $end_tz = $this->default_timezone;
                        foreach($end->getItemsByName('TZID') as $param)
                        {
                                $end_tz = $this->getTZ($param->getValue());
                        }
                        if($fullday)
                        {
                                $end = new ilDate($end->getValue(),
                                        IL_CAL_DATE);
                                $end->increment(IL_CAL_DAY,-1);
                        }
                        else
                        {
                                $end = new ilDateTime($end->getValue(),
                                        IL_CAL_DATETIME,
                                        $end_tz->getIdentifier());
                        }
                        $entry->setEnd($end);
                        $entry->setFullday($fullday);
                }
                // save calendar event
                if($this->category->getLocationType() == ilCalendarCategory::LTYPE_REMOTE)
                {
                        $entry->setAutoGenerated(true);
                }
                $entry->save();
                
                include_once('./Services/Calendar/classes/class.ilCalendarCategoryAssignments.php');
                $ass = new ilCalendarCategoryAssignments($entry->getEntryId());
                $ass->addAssignment($this->category->getCategoryID());
                
                
                // Recurrences
                foreach($this->getContainer()->getItemsByName('RRULE') as $recurrence)
                {
                        #var_dump("<pre>",$recurrence,"</pre>");
                        
                        
                        include_once('./Services/Calendar/classes/class.ilCalendarRecurrence.php');
                        $rec = new ilCalendarRecurrence();
                        $rec->setEntryId($entry->getEntryId());
                        
                        foreach($recurrence->getItemsByName('FREQ') as $freq)
                        {
                                switch($freq->getValue())
                                {
                                        case 'DAILY':
                                        case 'WEEKLY':
                                        case 'MONTHLY':
                                        case 'YEARLY':
                                                $rec->setFrequenceType((string) $freq->getValue());
                                                break;
                                                
                                        default:
                                                $this->log->write(__METHOD__.': Cannot handle recurring event of type: '.$freq->getValue());
                                                break 3;
                                }
                        }
                        
                        foreach($recurrence->getItemsByName('COUNT') as $value)
                        {
                                $rec->setFrequenceUntilCount((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('UNTIL') as $until)
                        {
                                $rec->setFrequenceUntilDate(new ilDate($until->getValue(),IL_CAL_DATE));
                                break;
                        }
                        foreach($recurrence->getItemsByName('INTERVAL') as $value)
                        {
                                $rec->setInterval((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('BYDAY') as $value)
                        {
                                $rec->setBYDAY((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('BYWEEKNO') as $value)
                        {
                                $rec->setBYWEEKNO((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('BYMONTH') as $value)
                        {
                                $rec->setBYMONTH((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('BYMONTHDAY') as $value)
                        {
                                $rec->setBYMONTHDAY((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('BYYEARDAY') as $value)
                        {
                                $rec->setBYYEARDAY((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('BYSETPOS') as $value)
                        {
                                $rec->setBYSETPOS((string) $value->getValue());
                                break;                                          
                        }
                        foreach($recurrence->getItemsByName('WKST') as $value)
                        {
                                $rec->setWeekstart((string) $value->getValue());
                                break;                                          
                        }
                        $rec->save();
                }
        }

References $default_timezone, getContainer(), getTZ(), IL_CAL_DATE, IL_CAL_DATETIME, IL_CAL_DAY, ilCalendarCategory\LTYPE_REMOTE, and purgeString().

Referenced by parseLine().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $category

ilICalParser::$category = null

protected

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

◆ $container

ilICalParser::$container = array()

protected

Definition at line 58 of file class.ilICalParser.php.

Referenced by parseLine().

◆ $default_timezone

ilICalParser::$default_timezone = null

protected

Definition at line 56 of file class.ilICalParser.php.

Referenced by getTZ(), and writeEvent().

◆ $file

ilICalParser::$file = ''

protected

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

◆ $ical

ilICalParser::$ical = ''

protected

Definition at line 54 of file class.ilICalParser.php.

◆ $log

ilICalParser::$log = null

protected

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

◆ INPUT_FILE

const ilICalParser::INPUT_FILE = 2

Definition at line 48 of file class.ilICalParser.php.

Referenced by ilCalendarCategoryGUI\doImportFile().

◆ INPUT_STRING

const ilICalParser::INPUT_STRING = 1

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

Referenced by ilCalendarRemoteReader\importIcal().

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

Services/Calendar/classes/iCal/class.ilICalParser.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ dropContainer()

◆ getContainer()

◆ getTZ()

◆ parse()

◆ parseLine()

◆ purgeString()

◆ pushContainer()

◆ restoreTZ()

◆ setCategoryId()

◆ setContainer()

◆ splitLine()

◆ storeItems()

◆ switchTZ()

◆ tokenize()

◆ writeEvent()

Field Documentation

◆ $category

◆ $container

◆ $default_timezone

◆ $file

◆ $ical

◆ $log

◆ INPUT_FILE

◆ INPUT_STRING