iCalcreator

require_once( 'iCalcreator.class.php' );
$config = array( 'unique_id' => 'kigkonsult.se' );
  // set Your unique id
$v = new vcalendar( $config );
  // create a new calendar instance

$v->setProperty( 'method', 'PUBLISH' );
  // required of some calendar software
$v->setProperty( "x-wr-calname", "Calendar Sample" );
  // required of some calendar software
$v->setProperty( "X-WR-CALDESC", "Calendar Description" );
  // required of some calendar software
$v->setProperty( "X-WR-TIMEZONE", "Europe/Stockholm" );
  // required of some calendar software
.. .
$vevent = & $v->newComponent( 'vevent' );
  // create an event calendar component
$start = array( 'year'=>2007, 'month'=>4, 'day'=>1, 'hour'=>19, 'min'=>0, 'sec'=>0 );
$vevent->setProperty( 'dtstart', $start );
$end = array( 'year'=>2007, 'month'=>4, 'day'=>1, 'hour'=>22, 'min'=>30, 'sec'=>0 );
$vevent->setProperty( 'dtend', $end );
$vevent->setProperty( 'LOCATION', 'Central Placa' );
  // property name - case independent
$vevent->setProperty( 'summary', 'PHP summit' );
$vevent->setProperty( 'description', 'This is a description' );
$vevent->setProperty( 'comment', 'This is a comment' );
$vevent->setProperty( 'attendee', 'attendee1@icaldomain.net' );
.. .
$vevent = & $v->newComponent( 'vevent' );
  // create next event calendar component
$vevent->setProperty( 'dtstart', '20070401', array('VALUE' => 'DATE'));
  // alt. date format, now for an all-day event
$vevent->setProperty( "organizer" , 'boss@icaldomain.com' );
$vevent->setProperty( 'summary', 'ALL-DAY event' );
$vevent->setProperty( 'description', 'This is a description for an all-day event' );
$vevent->setProperty( 'resources', 'COMPUTER PROJECTOR' );
$vevent->setProperty( 'rrule', array( 'FREQ' => 'WEEKLY', 'count' => 4));
  // weekly, four occasions
$vevent->parse( 'LOCATION:1CP Conference Room 4350' );
  // supporting parse of strict rfc2445 formatted text
.. .
  // all calendar components are described in rfc2445
  // a complete iCalcreator function list (ex. setProperty) in iCalcreator manual
.. .
$v->returnCalendar();
  // redirect calendar file to browser

require_once( 'iCalcreator.class.php' );
$config = array( 'unique_id' => 'kigkonsult.se' );
  // set Your unique id, required if any component UID is missing
$v = new vcalendar( $config );
  // create a new calendar instance

/* start parse of local file */
$config = array( 'directory' => 'calendar', 'filename' => 'file.ics' );
$v->setConfig( $config );
  // set directory and file name
$v->parse();

/* start parse of remote file */
$v->setConfig( 'url', 'http://www.aDomain.net/file.ics' );
  // iCalcreator also support remote files
$v->parse();

$v->setProperty( 'method', 'PUBLISH' );
  // required of some calendar software
$v->setProperty( "x-wr-calname", "Calendar Sample" );
  // required of some calendar software
$v->setProperty( "X-WR-CALDESC", "Calendar Description" );
// required of some calendar software
$v->setProperty( "X-WR-TIMEZONE", "Europe/Stockholm" );
  // required of some calendar software

.. .
$v->sort();
  // ensure start date order
.. .

require_once( 'iCalcreator.class.php' );
$config = array(
'unique_id'  => 'kigkonsult.se',
'directory'   => 'calendar',
'filename'   => 'file.ics' );
  // set Your unique id, import directory and file name
$v = new vcalendar( $config );
  // create a new calendar instance

$v->parse();

$v->setProperty( 'method', 'PUBLISH' );
  // required of some calendar software
$v->setProperty( "x-wr-calname", "Calendar Sample" );
  // required of some calendar software
$v->setProperty( "X-WR-CALDESC", "Calendar Description" );
// required of some calendar software
$v->setProperty( "X-WR-TIMEZONE", "Europe/Stockholm" );
  // required of some calendar software

while( $vevent = $v->getComponent( 'vevent' )) {
  // read events, one by one
  $uid = $vevent->getProperty( 'uid' );
  // uid required, one occurence (unique id/key for component)
  .. .
  $dtstart = $vevent->getProperty( 'dtstart' );
  // dtstart required, one occurence
  .. .
  if( $description = $vevent->getProperty( 'description', 1 )) {
    // description optional, first occurence
    .. .
    // edit the description
    .. .
    $vevent->setProperty( 'description', $description, FALSE, 1 );
    // update/replace the description
  }
  while( $comment = $vevent->getProperty( 'comment' )) {
    // comment optional, may occur more than once   .. .
    // manage comments
  }
  .. .
  while( $vevent->deleteProperty( 'attendee' ))
    continue;
    // remove all ATTENDEE properties .. .
  .. .
  $v->setComponent ( $vevent, $uid );
  // update/replace event in calendar with uid as key }
.. .
.. .
// a complete iCalcreator function list
// (ex. getProperty, deleteProperty) in iCalcreator manual
.. .

require_once( 'iCalcreator.class.php' );
$config = array( 'unique_id' => 'kigkonsult.se' );
  // set Your unique id
$v = new vcalendar( $config );
  // create a new calendar instance

$v->setConfig( 'url', 'http://www.aDomain.net/file.ics' );
  // iCalcreator also support remote files
$v->parse();
$v->sort();
  // ensure start date order

$v->setProperty( 'method', 'PUBLISH' );
  // required of some calendar software
$v->setProperty( "x-wr-calname", "Calendar Sample" );
  // required of some calendar software
$v->setProperty( "X-WR-CALDESC", "Calendar Description" );
// required of some calendar software
$v->setProperty( "X-WR-TIMEZONE", "Europe/Stockholm" );
  // required of some calendar software

$eventArray = $v->selectComponents();
  // select components occuring today
  // (including components with recurrence pattern)
foreach( $eventArray as $year => $yearArray) {
 foreach( $yearArray as $month => $monthArray ) {
  foreach( $monthArray as $day => $dailyEventsArray ) {
   foreach( $dailyEventsArray as $vevent ) {
    $currddate = $event->getProperty( 'x-current-dtstart' );
      // if member of a recurrence set,
      // returns array( 'x-current-dtstart', <DATE>)
      // <DATE> = (string) date("Y-m-d [H:i:s][timezone/UTC offset]")
    $dtstart = $vevent->getProperty( 'dtstart' );
      // dtstart required, one occurence, (orig. start date)
    $summary = $vevent->getProperty( 'summary' );
    $description = $vevent->getProperty( 'description' );
    .. .
    .. .
   }
  }
 }
}

$valueOccurr = $v->getProperty( 'CATEGORIES' );
      // fetch specific property (unique) values and number of occurrences
      // ATTENDEE, CATEGORIES, DTSTART, LOCATION, ORGANIZER,
      // PRIORITY, RESOURCES, STATUS, SUMMARY, UID

foreach( $valueOccurr as $uniqueValue => $occurr ) {
 .. .
}

$selectSpec = array( 'CATEGORIES' => 'course1' );
$specComps = $v->selectComponents( $selectSpec );
      // selects components based on specific property value(-s)
      // ATTENDEE, CATEGORIES, LOCATION, ORGANIZER,
      // PRIORITY, RESOURCES, STATUS, SUMMARY, UID
foreach( $specComps as $comp ) {
 .. .
}

require_once( 'iCalcreator.class.php' );
$config = array( 'unique_id' => 'kigkonsult.se' );
  // set Your unique id
$v = new vcalendar( $config );
  // create a new calendar instance

$v->setProperty( 'method', 'PUBLISH' );
  // required of some calendar software
$v->setProperty( "x-wr-calname", "Calendar Sample" );
  // required of some calendar software
$v->setProperty( "X-WR-CALDESC", "Calendar Description" );
  // required of some calendar software
$v->setProperty( "X-WR-TIMEZONE", "Europe/Stockholm" );
  // required of some calendar software
.. .
.. .// parse calendar file(s) and/or edit/create calendar components.. .
.. .
  // opt 1
$v->returnCalendar();
  // redirect calendar file to browser

  // opt 2
$config = array( 'directory' => 'depot', 'filename' => 'calendar.ics' );
$v->setConfig( $config );
  // set output directory and file name
$v->saveCalendar();
  // save calendar to (local) file

  // opt 3
$config = array( 'url' => 'http://www.aDomain.net/file.ics' );
$v->setConfig( $config );
  // set output url
$v->saveCalendar();
  // save calendar to remote url

• iCalcnv is reworked into a single class, using a simple configuration set method.
• the former main functions; iCal2csv, iCal2xls and cvs2iCal are now public methods in the class.
• an iCalcreator vcalendar instance can be used as input (iCal2csv, iCal2xls) or returned as output (cvs2iCal) to ease up integration with iCalcreator
• PEAR Log (or eClog) is supported

• new functionality
  Concatenating all class files into one file
• update of functions
  Changed 2nd argument to dbiCal select method: using iCalcreator vcalendar array config format
  admin interface (, when using compare) removing unnecessary parse, sort and save
  testing byte encoded class file(-s)
• fixed bugs in
  admin interface (config tab) when log file is defined but not created

• fixed bugs
  function selectComponents; RECURRENCE-ID management
• updated user guide
  UTC timezone usage
  relationship between getProperty/selectComponents functions
  other minor clarifications

tinycal v3.0, ported to jQuery JavaScript Library v1.4.4 for display and Axaj logics.

• update of functions
  xcal (xml) format update
  function setConfig (component level), setting 'nl' always before 'format'
• fixed bugs
  selectComponents with last arguments (false, true, false)
  iCalUtilityFunctions::_recur2date, FREQ=YEARLY + BYDAY - combination
  returnCalendar; removing Content-Length header
  
• updated user guide etc.

• new functionality
  Evaluate, test and use of ionCube php byte file encoder
• update of functions
  selectComponents, changed order of generating components
  setSequence, value 0 (zero) first value
  setConfig, force setting of Directory before Filename
  _size75, updated management of line folding (again.. .)
• fixed bugs
  _size75, typo error
  _makeDtstamp, typo error
  selectComponents, setting start/end-dates (x-prop) for events longer than 24h
• updated using manual
  missing links, STATUS etc

tinycal v3.0, ported to jQuery JavaScript Library v1.4.4 for display and Axaj logics.

Please feel free to take a look and test it here and use the contact page and communicate your opinion! Preliminary release date is late October.

A file locking mechanism is implemented to avoid parallel excutions.

Extended version supporting singleton pattern, simplified log calls etc.

• new functionality
  transform a datetime from a timezone to another using PHP DateTime and DateTimeZone class (PHP >= PHP 5.2.0)
• update of functions
  parse, ensure (vtimezone) standard/daylight component order
  iCalUtilityFunctions::createTimezone, creating RRULEs
  iCalUtilityFunctions::_setDate
  
• fixed bugs
  adaptation for PHP STRICT error_reporting
• updated using manual

• new functionality
  getProperty, sort, getComponent and selectComponents with new arguments: Attendee, Categories, DTSTAMP, Location, Organizer, Priority, Resources, Status, Summary properties
  simple create of timezone (including standard/daylight) component
  auto completion of (default) timezone when setting DTEND, DTSTART, DUE, RECURRENCE-ID
  new arguments for utf8 encoding and gzencode in function returnCalendar
• update of
  get- and setfunctions for properties with numeric (integer) content
  parse, management of line folding when parsing
  getProperty and deleteProperty, management of properties with multiple ocurrence
  parse on calendar level, set config when creating new component etc
  setfunctions for DTEND, DTSTART, DUE, RECURRENCE-ID
  update of getConfig and all config setting on calendar and component level
  calendar property VERSION always first in calendar
• fixed bugs in
  iCalUtilityFunctions::_duration2date
  selectComponents
  setFreebusy
  createAttendee
  TRIGGER with no duration
  iCalUtilityFunctions::_recur2date(, _setRexrule), BYSETPOS
• updated using manual

As usual, exhaustive regression tests has been executed to verify the release as well as external beta testing.

The iCalcreator 2.10 beta test period has started, if you are interested to have a look and squeeze on iCalcreator v2.10rc2 package, please use the contact page.

Planned official release date is mid July.

• updated management of line folding
• updated functions getProperty, sort, SelectComponents, works with Attendee, Categories, (dtstamp, ) Location, Organizer, Priority, Resources, Status and Summary properties
• simple create of timezone (including standard/daylight) component(-s)
• auto completion of (default) timezone when setting DTEND, DTSTART, DUE, RECURRENCE-ID
• management of properties with numeric (integer) content; PERCENT-COMPLETE, PRIORITY, REPEAT, SEQUENCE, X-PROP
  bug in function iCalUtilityFunctions::_duration2date
  bug in function selectComponents
  bug in function createAttendee
  bug when using TRIGGER with no duration
  bug in function SelectComponents regarding X-CURRENT-*-values
  bug in function setFreebusy, empty property
  bug in function setFreebusy if property is empty.. .

• Offer extended property parameter setting.

After a successfull beta release test period, the official release.

• supporting ALL calendar information; timezone, event, todo, journal and freebusy components with all properties, including x-properties.
• using pear MDB2 as database API and iCalcreator (2.8) as the calendar information API, opt pear Log
• simple interface functions; insert, select, delete and calendar information
• includes a web admin page, offering ability to upload, insert, examine (file), inspect (db), removal and compare of calendar files.
• changed licence to LGPL.

dbiCal has during the beta tests been extended to

• support storage of metadata, ex. calendar/user references (or preferences)
• include web administrator interface

Please contact if you would like to participarte!

• Test online
• Please contact if you would like to download and test!

• adapt for prototype 1.7 javascript framework
• time (date) display in component view
• includes alarms in non-total downloads

dbiCal is a PHP database backend solution storing (multiple) iCal calendar files in a database using pear MDB2 as database API and iCalcreator 2.8 as the API for calendar information.

Please contact if you would like to participarte!

• The 2.4 version is updated to use iCalcreator 2.8 and javascript adaptations.
• Supports en, fr, it and se languages.

• new factory-method for creating components
• simplified configuration
• utility (static) functions collected in support class
• refactored sort and selectComponents functions
• multibyte character support (opt. mb_string)
• value (protocol) prefix (Attendee, Organizer etc.)
• a major number of minor bugs fixed e.g. date (UTC), text properties, duration
• updated using manual

As usual, exhaustive regression tests has been executed to verify the release.