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 72 of file class.ilICalParser.php.

    {
        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['DIC']['cal_err_no_input']);
            }
            #$GLOBALS['DIC']['ilLog']->write(__METHOD__.': Ical content: '. $this->ical);
        }
        $this->log = $GLOBALS['DIC']->logger()->cal();
    }

References $GLOBALS.

Member Function Documentation

◆ dropContainer()

ilICalParser::dropContainer ( )

protected

pop la

@access protected

Definition at line 162 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 141 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 353 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, Vendor\Package\$e, 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 107 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 $i, 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 184 of file class.ilICalParser.php.

    {
        switch (trim($line)) {
            case 'BEGIN:VCALENDAR':
                $this->log->debug('BEGIN VCALENDAR');
                $this->setContainer(new ilICalComponent('VCALENDAR'));
                break;
                
            case 'END:VCALENDAR':
                $this->log->debug('END VCALENDAR');
                break;
            
            case 'BEGIN:VEVENT':
                $this->log->debug('BEGIN VEVENT');
                $this->pushContainer(new ilICalComponent('VEVENT'));
                break;
            
            case 'END:VEVENT':
                $this->log->debug('END VEVENT');
                
                $this->writeEvent();
                
                $this->dropContainer();
                break;
 
            case 'BEGIN:VTIMEZONE':
                $this->log->debug('BEGIN VTIMEZONE');
                $container = new ilICalComponent('VTIMEZONE');
                $this->pushContainer($container);
                break;
                
            case 'END:VTIMEZONE':
                $this->log->debug('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->info('Do not handling line:' . $line);
                    break;
                }
                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, $param, 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 588 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 173 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 398 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 95 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 152 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 325 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 245 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 $param, 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 383 of file class.ilICalParser.php.

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

References Vendor\Package\$e, and 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 343 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 408 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);
        }
        
        if (!$entry->getStart() instanceof ilDateTime) {
            $this->log->warning('Cannot find start date. Event ignored.');
            return false;
        }
 
        // check if end date is given otherwise replace with start
        if (
            !$entry->getEnd() instanceof ilDateTime &&
            $entry->getStart() instanceof ilDateTime
        ) {
            $entry->setEnd($entry->getStart());
        }
        
        
        // 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, $param, $type, 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 55 of file class.ilICalParser.php.

◆ $container

ilICalParser::$container = array()

protected

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

Referenced by parseLine().

◆ $default_timezone

ilICalParser::$default_timezone = null

protected

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

Referenced by getTZ(), and writeEvent().

◆ $file

ilICalParser::$file = ''

protected

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

◆ $ical

ilICalParser::$ical = ''

protected

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

◆ $log

ilICalParser::$log = null

protected

Definition at line 53 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