All-in-One Event Calendar - Version 1.2.3

Version Description

Download this release

Release Info

Developer theseed
Plugin Icon 128x128 All-in-One Event Calendar
Version 1.2.3
Comparing to
See all releases

Code changes from version 1.2.2 to 1.2.3

Files changed (24) hide show
  1. all-in-one-event-calendar.php +1 -1
  2. app/controller/class-ai1ec-calendar-controller.php +4 -2
  3. app/controller/class-ai1ec-settings-controller.php +1 -3
  4. app/helper/class-ai1ec-app-helper.php +7 -2
  5. app/helper/class-ai1ec-calendar-helper.php +2 -2
  6. app/helper/class-ai1ec-events-helper.php +42 -3
  7. app/view/agenda-widget-form.php +10 -40
  8. app/view/calendar.php +1 -1
  9. app/view/class-ai1ec-agenda-widget.php +38 -8
  10. app/view/row_monthly.php +20 -4
  11. css/add_new_event.css +12 -0
  12. css/jquery.bsmselect.css +0 -64
  13. css/widget.css +4 -0
  14. js/add_new_event.js +13 -2
  15. js/calendar.js +34 -13
  16. js/jquery.bsmselect.js +0 -381
  17. js/modernizr.custom.78720.js +4 -0
  18. language/all-in-one-event-calendar.pot +681 -629
  19. lib/iCalUtilityFunctions.class.php +127 -54
  20. lib/iCalcreator.class.php +302 -211
  21. lib/releaseNotes-2.10.23.txt +8 -0
  22. lib/summary.html +323 -0
  23. lib/using.html +5810 -0
  24. readme.txt +12 -2
all-in-one-event-calendar.php CHANGED
@@ -5,7 +5,7 @@
5
  * Description: An event calendar system with month, week, agenda views, upcoming events widget, color-coded categories, recurrence, and import/export of .ics feeds.
6
  * Author: The Seed Studio
7
  * Author URI: http://theseednetwork.com/
8
- * Version: 1.2.2
9
  */ // NOTE: When updating version number also update first line of app/view/calendar.php
10
  @set_time_limit( 0 );
11
  @ini_set( "memory_limit", "256M" );
5
  * Description: An event calendar system with month, week, agenda views, upcoming events widget, color-coded categories, recurrence, and import/export of .ics feeds.
6
  * Author: The Seed Studio
7
  * Author URI: http://theseednetwork.com/
8
+ * Version: 1.2.3
9
  */ // NOTE: When updating version number also update first line of app/view/calendar.php
10
  @set_time_limit( 0 );
11
  @ini_set( "memory_limit", "256M" );
app/controller/class-ai1ec-calendar-controller.php CHANGED
@@ -573,13 +573,15 @@ class Ai1ec_Calendar_Controller {
573
  {
574
  global $ai1ec_settings;
575
 
576
- // Include dependent jQuery plugins
577
  wp_enqueue_script( 'jquery.scrollTo', AI1EC_JS_URL . '/jquery.scrollTo-min.js', array( 'jquery' ), 1 );
578
  wp_enqueue_script( 'jquery.tableScroll', AI1EC_JS_URL . '/jquery.tablescroll.js', array( 'jquery' ), 1 );
 
579
  // Include element selector function
580
  wp_enqueue_script( 'ai1ec-element-selector', AI1EC_JS_URL . '/element-selector.js', array( 'jquery', 'jquery.scrollTo' ), 1 );
581
  // Include custom script
582
- wp_enqueue_script( 'ai1ec-calendar', AI1EC_JS_URL . '/calendar.js', array( 'jquery', 'jquery.scrollTo', 'jquery.tableScroll' ), 1 );
 
583
 
584
  $data = array(
585
  // Point script to AJAX URL
573
  {
574
  global $ai1ec_settings;
575
 
576
+ // Include dependent scripts (jQuery plugins, modernizr)
577
  wp_enqueue_script( 'jquery.scrollTo', AI1EC_JS_URL . '/jquery.scrollTo-min.js', array( 'jquery' ), 1 );
578
  wp_enqueue_script( 'jquery.tableScroll', AI1EC_JS_URL . '/jquery.tablescroll.js', array( 'jquery' ), 1 );
579
+ wp_enqueue_script( 'modernizr.custom.78720', AI1EC_JS_URL . '/modernizr.custom.78720.js', array(), 1 );
580
  // Include element selector function
581
  wp_enqueue_script( 'ai1ec-element-selector', AI1EC_JS_URL . '/element-selector.js', array( 'jquery', 'jquery.scrollTo' ), 1 );
582
  // Include custom script
583
+ wp_enqueue_script( 'ai1ec-calendar', AI1EC_JS_URL . '/calendar.js',
584
+ array( 'jquery', 'jquery.scrollTo', 'jquery.tableScroll', 'modernizr.custom.78720' ), 1 );
585
 
586
  $data = array(
587
  // Point script to AJAX URL
app/controller/class-ai1ec-settings-controller.php CHANGED
@@ -306,11 +306,9 @@ class Ai1ec_Settings_Controller {
306
 
307
  if( $hook_suffix == 'widgets.php' ) {
308
  // Scripts
309
- wp_enqueue_script( 'jquery-bsmselect', AI1EC_JS_URL . '/jquery.bsmselect.js', array( 'jquery' ) );
310
- wp_enqueue_script( 'ai1ec-widget', AI1EC_JS_URL . '/widget.js', array( 'jquery', 'jquery-bsmselect' ) );
311
  // Styles
312
  wp_enqueue_style( 'ai1ec-widget', AI1EC_CSS_URL . '/widget.css' );
313
- wp_enqueue_style( 'bsmselect', AI1EC_CSS_URL . '/jquery.bsmselect.css' );
314
  }
315
 
316
  if( isset( $ai1ec_settings->settings_page ) && $hook_suffix == $ai1ec_settings->settings_page ) {
306
 
307
  if( $hook_suffix == 'widgets.php' ) {
308
  // Scripts
309
+ wp_enqueue_script( 'ai1ec-widget', AI1EC_JS_URL . '/widget.js', array( 'jquery' ) );
 
310
  // Styles
311
  wp_enqueue_style( 'ai1ec-widget', AI1EC_CSS_URL . '/widget.css' );
 
312
  }
313
 
314
  if( isset( $ai1ec_settings->settings_page ) && $hook_suffix == $ai1ec_settings->settings_page ) {
app/helper/class-ai1ec-app-helper.php CHANGED
@@ -441,8 +441,13 @@ class Ai1ec_App_Helper {
441
  global $ai1ec_events_helper;
442
  switch( $column ) {
443
  case 'ai1ec_event_date':
444
- $e = new Ai1ec_Event( $post_id );
445
- echo $e->short_start_date . ' ' . $e->short_start_time . " - " . $e->short_end_date . ' ' .$e->short_end_time;
 
 
 
 
 
446
  break;
447
  }
448
  }
441
  global $ai1ec_events_helper;
442
  switch( $column ) {
443
  case 'ai1ec_event_date':
444
+ try {
445
+ $e = new Ai1ec_Event( $post_id );
446
+ echo $e->short_start_date . ' ' . $e->short_start_time . " - " . $e->short_end_date . ' ' .$e->short_end_time;
447
+ } catch( Exception $e ) {
448
+ // event wasn't found, output empty string
449
+ echo "";
450
+ }
451
  break;
452
  }
453
  }
app/helper/class-ai1ec-calendar-helper.php CHANGED
@@ -790,7 +790,7 @@ class Ai1ec_Calendar_Helper {
790
  // Query the correct post status
791
  if( current_user_can( 'administrator' ) || current_user_can( 'editor' ) )
792
  {
793
- // User has privilege of seeing all published and private posts
794
 
795
  $post_status_where = "AND ( post_status = %s OR post_status = %s ) ";
796
  $args[] = 'publish';
@@ -806,7 +806,7 @@ class Ai1ec_Calendar_Helper {
806
 
807
  // include post_status = published
808
  // OR
809
- // post_status = private AND author = logged-in user
810
  $post_status_where =
811
  "AND ( " .
812
  "post_status = %s " .
790
  // Query the correct post status
791
  if( current_user_can( 'administrator' ) || current_user_can( 'editor' ) )
792
  {
793
+ // User has privilege of seeing all published and private
794
 
795
  $post_status_where = "AND ( post_status = %s OR post_status = %s ) ";
796
  $args[] = 'publish';
806
 
807
  // include post_status = published
808
  // OR
809
+ // post_status = private AND post_author = userID
810
  $post_status_where =
811
  "AND ( " .
812
  "post_status = %s " .
app/helper/class-ai1ec-events-helper.php CHANGED
@@ -672,7 +672,25 @@ class Ai1ec_Events_Helper {
672
  * @return void
673
  **/
674
  function row_monthly( $visible = false, $count = 1, $ai1ec_monthly_each = 0, $ai1ec_monthly_on_the = 0, $month = array(), $first = false, $second = false ) {
675
- global $ai1ec_view_helper;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
676
 
677
  $args = array(
678
  'visible' => $visible,
@@ -680,7 +698,9 @@ class Ai1ec_Events_Helper {
680
  'ai1ec_monthly_each' => $ai1ec_monthly_each,
681
  'ai1ec_monthly_on_the' => $ai1ec_monthly_on_the,
682
  'month' => $this->create_montly_date_select( $month ),
683
- 'on_the_select' => $this->create_on_the_select( $first, $second )
 
 
684
  );
685
  return $ai1ec_view_helper->get_view( 'row_monthly.php', $args );
686
  }
@@ -983,9 +1003,18 @@ class Ai1ec_Events_Helper {
983
  $origin_dtz = new DateTimeZone( $origin_tz );
984
  $remote_dtz = new DateTimeZone( $remote_tz );
985
 
 
 
 
 
986
  $origin_dt = new DateTime( gmdate( 'Y-m-d H:i:s', $timestamp ), $origin_dtz );
987
  $remote_dt = new DateTime( gmdate( 'Y-m-d H:i:s', $timestamp ), $remote_dtz );
988
- $offset = $origin_dtz->getOffset( $origin_dt ) - $remote_dtz->getOffset( $remote_dt );
 
 
 
 
 
989
  } catch( Exception $e ) {
990
  return false;
991
  }
@@ -1394,6 +1423,16 @@ class Ai1ec_Events_Helper {
1394
  }
1395
  $txt .= ' ' . _x( 'on', 'Recurrence editor - monthly tab', AI1EC_PLUGIN_NAME ) . $_days . ' ' . __( 'of the month', AI1EC_PLUGIN_NAME );
1396
  }
 
 
 
 
 
 
 
 
 
 
1397
  }
1398
  break;
1399
  case 'yearly':
672
  * @return void
673
  **/
674
  function row_monthly( $visible = false, $count = 1, $ai1ec_monthly_each = 0, $ai1ec_monthly_on_the = 0, $month = array(), $first = false, $second = false ) {
675
+ global $ai1ec_view_helper, $wp_locale;
676
+ $start_of_week = get_option( 'start_of_week', 1 );
677
+
678
+ $options_wd = array();
679
+ // get days from start_of_week until the last day
680
+ for( $i = $start_of_week; $i <= 6; ++$i )
681
+ $options_wd[$this->get_weekday_by_id( $i )] = $wp_locale->weekday[$i];
682
+
683
+ // get days from 0 until start_of_week
684
+ if( $start_of_week > 0 ) {
685
+ for( $i = 0; $i < $start_of_week; $i++ )
686
+ $options_wd[$this->get_weekday_by_id( $i )] = $wp_locale->weekday[$i];
687
+ }
688
+
689
+ // get options like 1st/2nd/3rd for "day number"
690
+ $options_dn = array( 1 => 1, 2 => 2, 3 => 3, 4 => 4, 5 => 5 );
691
+ foreach( $options_dn as $_dn ) {
692
+ $options_dn[ $_dn ] = date_i18n( "jS", strtotime( $_dn . "-01-1998 12:00:00" ) );
693
+ }
694
 
695
  $args = array(
696
  'visible' => $visible,
698
  'ai1ec_monthly_each' => $ai1ec_monthly_each,
699
  'ai1ec_monthly_on_the' => $ai1ec_monthly_on_the,
700
  'month' => $this->create_montly_date_select( $month ),
701
+ 'on_the_select' => $this->create_on_the_select( $first, $second ),
702
+ 'day_nums' => $this->create_select_element( 'ai1ec_monthly_byday_num', $options_dn ),
703
+ 'week_days' => $this->create_select_element( 'ai1ec_monthly_byday_weekday', $options_wd )
704
  );
705
  return $ai1ec_view_helper->get_view( 'row_monthly.php', $args );
706
  }
1003
  $origin_dtz = new DateTimeZone( $origin_tz );
1004
  $remote_dtz = new DateTimeZone( $remote_tz );
1005
 
1006
+ // if DateTimeZone fails, throw exception
1007
+ if( $origin_dtz === false || $remote_dtz === false )
1008
+ throw new Exception( 'DateTimeZone class failed' );
1009
+
1010
  $origin_dt = new DateTime( gmdate( 'Y-m-d H:i:s', $timestamp ), $origin_dtz );
1011
  $remote_dt = new DateTime( gmdate( 'Y-m-d H:i:s', $timestamp ), $remote_dtz );
1012
+
1013
+ // if DateTime fails, throw exception
1014
+ if( $origin_dt === false || $remote_dt === false )
1015
+ throw new Exception( 'DateTime class failed' );
1016
+
1017
+ $offset = $origin_dtz->getOffset( $origin_dt ) - $remote_dtz->getOffset( $remote_dt );
1018
  } catch( Exception $e ) {
1019
  return false;
1020
  }
1423
  }
1424
  $txt .= ' ' . _x( 'on', 'Recurrence editor - monthly tab', AI1EC_PLUGIN_NAME ) . $_days . ' ' . __( 'of the month', AI1EC_PLUGIN_NAME );
1425
  }
1426
+ } elseif( $rc->getByDay() ) {
1427
+ $_days = '';
1428
+ foreach( $rc->getByDay() as $d ) {
1429
+ $_dnum = substr( $d, 0, 1);
1430
+ $_day = substr( $d, 1, 3 );
1431
+ $dnum = ' ' . date_i18n( "jS", strtotime( $_dnum . '-01-1998 12:00:00' ) );
1432
+ $day = $this->get_weekday_by_id( $_day, true );
1433
+ $_days .= ' ' . $wp_locale->weekday[$day];
1434
+ }
1435
+ $txt .= ' ' . _x( 'on', 'Recurrence editor - monthly tab', AI1EC_PLUGIN_NAME ) . $dnum . $_days;
1436
  }
1437
  break;
1438
  case 'yearly':
app/view/agenda-widget-form.php CHANGED
@@ -19,6 +19,9 @@
19
  <?php foreach( $event_cat_ids['options'] as $event_cat ): ?>
20
  <option value="<?php echo $event_cat->term_id; ?>"<?php if( in_array( $event_cat->term_id, $event_cat_ids['value'] ) ) { ?> selected="selected"<?php } ?>><?php echo $event_cat->name; ?></option>
21
  <?php endforeach ?>
 
 
 
22
  </select>
23
  </div>
24
  <p class="ai1ec-limit-by-container">
@@ -32,6 +35,9 @@
32
  <?php foreach( $event_tag_ids['options'] as $event_tag ): ?>
33
  <option value="<?php echo $event_tag->term_id; ?>"<?php if( in_array( $event_tag->term_id, $event_tag_ids['value'] ) ) { ?> selected="selected"<?php } ?>><?php echo $event_tag->name; ?></option>
34
  <?php endforeach ?>
 
 
 
35
  </select>
36
  </div>
37
  <p class="ai1ec-limit-by-container">
@@ -45,6 +51,9 @@
45
  <?php foreach( $event_post_ids['options'] as $event_post ): ?>
46
  <option value="<?php echo $event_post->ID; ?>"<?php if( in_array( $event_post->ID, $event_post_ids['value'] ) ) { ?> selected="selected"<?php } ?>><?php echo $event_post->post_title; ?></option>
47
  <?php endforeach ?>
 
 
 
48
  </select>
49
  </div>
50
  <br />
@@ -57,43 +66,4 @@
57
  <br />
58
  <input id="<?php echo $hide_on_calendar_page['id'] ?>" name="<?php echo $hide_on_calendar_page['name'] ?>" type="checkbox" value="1" <?php if( $hide_on_calendar_page['value'] ) echo 'checked="checked"' ?> />
59
  <label for="<?php echo $hide_on_calendar_page['id'] ?>"><?php _e( 'Hide this widget on calendar page', AI1EC_PLUGIN_NAME ) ?></label>
60
- </p>
61
- <script type="text/javascript">
62
- /* <![CDATA[ */
63
- // To be run every time the widget form is rendered, sets up the Multi-select boxes with bsmSelect
64
- jQuery( function( $ ) {
65
- $( 'select.ai1ec-widget-cat-ids' ).bsmSelect( {
66
- title: '<?php _e( "Categories", AI1EC_PLUGIN_NAME ) ?>:',
67
- highlight: 'highlight',
68
- removeLabel: '<img src="<?php echo AI1EC_IMAGE_URL ?>/icon-close.png" alt="x" />',
69
- selectClass: 'ai1ec-widget-option-ids',
70
- listClass: 'ai1ec-category-selected-items',
71
- listItemClass: 'ai1ec-category-selected-item',
72
- listItemLabelClass: 'ai1ec-category-selected-item-label',
73
- removeClass: 'ai1ec-category-selected-item-remove',
74
- } );
75
-
76
- $( 'select.ai1ec-widget-tag-ids' ).bsmSelect( {
77
- title: '<?php _e( "Tags", AI1EC_PLUGIN_NAME ) ?>:',
78
- highlight: 'highlight',
79
- removeLabel: '<img src="<?php echo AI1EC_IMAGE_URL ?>/icon-close.png" alt="x" />',
80
- selectClass: 'ai1ec-widget-option-ids',
81
- listClass: 'ai1ec-category-selected-items',
82
- listItemClass: 'ai1ec-category-selected-item',
83
- listItemLabelClass: 'ai1ec-category-selected-item-label',
84
- removeClass: 'ai1ec-category-selected-item-remove',
85
- } );
86
-
87
- $( 'select.ai1ec-widget-event-ids' ).bsmSelect( {
88
- title: '<?php _e( "Events", AI1EC_PLUGIN_NAME ) ?>:',
89
- highlight: 'highlight',
90
- removeLabel: '<img src="<?php echo AI1EC_IMAGE_URL ?>/icon-close.png" alt="x" />',
91
- selectClass: 'ai1ec-widget-option-ids',
92
- listClass: 'ai1ec-category-selected-items',
93
- listItemClass: 'ai1ec-category-selected-item',
94
- listItemLabelClass: 'ai1ec-category-selected-item-label',
95
- removeClass: 'ai1ec-category-selected-item-remove',
96
- } );
97
- } );
98
- /* ]]> */
99
- </script>
19
  <?php foreach( $event_cat_ids['options'] as $event_cat ): ?>
20
  <option value="<?php echo $event_cat->term_id; ?>"<?php if( in_array( $event_cat->term_id, $event_cat_ids['value'] ) ) { ?> selected="selected"<?php } ?>><?php echo $event_cat->name; ?></option>
21
  <?php endforeach ?>
22
+ <?php if( count( $event_cat_ids['options'] ) == 0 ) : ?>
23
+ <option disabled="disabled"><?php _e( 'No categories found.', AI1EC_PLUGIN_NAME ) ?></option>
24
+ <?php endif ?>
25
  </select>
26
  </div>
27
  <p class="ai1ec-limit-by-container">
35
  <?php foreach( $event_tag_ids['options'] as $event_tag ): ?>
36
  <option value="<?php echo $event_tag->term_id; ?>"<?php if( in_array( $event_tag->term_id, $event_tag_ids['value'] ) ) { ?> selected="selected"<?php } ?>><?php echo $event_tag->name; ?></option>
37
  <?php endforeach ?>
38
+ <?php if( count( $event_tag_ids['options'] ) == 0 ) : ?>
39
+ <option disabled="disabled"><?php _e( 'No tags found.', AI1EC_PLUGIN_NAME ) ?></option>
40
+ <?php endif ?>
41
  </select>
42
  </div>
43
  <p class="ai1ec-limit-by-container">
51
  <?php foreach( $event_post_ids['options'] as $event_post ): ?>
52
  <option value="<?php echo $event_post->ID; ?>"<?php if( in_array( $event_post->ID, $event_post_ids['value'] ) ) { ?> selected="selected"<?php } ?>><?php echo $event_post->post_title; ?></option>
53
  <?php endforeach ?>
54
+ <?php if( count( $event_post_ids['options'] ) == 0 ) : ?>
55
+ <option disabled="disabled"><?php _e( 'No events found.', AI1EC_PLUGIN_NAME ) ?></option>
56
+ <?php endif ?>
57
  </select>
58
  </div>
59
  <br />
66
  <br />
67
  <input id="<?php echo $hide_on_calendar_page['id'] ?>" name="<?php echo $hide_on_calendar_page['name'] ?>" type="checkbox" value="1" <?php if( $hide_on_calendar_page['value'] ) echo 'checked="checked"' ?> />
68
  <label for="<?php echo $hide_on_calendar_page['id'] ?>"><?php _e( 'Hide this widget on calendar page', AI1EC_PLUGIN_NAME ) ?></label>
69
+ </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
app/view/calendar.php CHANGED
@@ -1,4 +1,4 @@
1
- <!-- START All-in-One Event Calendar Plugin - Version 1.2.2 -->
2
  <table class="ai1ec-calendar-toolbar">
3
  <tbody>
4
  <tr>
1
+ <!-- START All-in-One Event Calendar Plugin - Version 1.2.3 -->
2
  <table class="ai1ec-calendar-toolbar">
3
  <tbody>
4
  <tr>
app/view/class-ai1ec-agenda-widget.php CHANGED
@@ -53,8 +53,8 @@ class Ai1ec_Agenda_Widget extends WP_Widget
53
  // Get available cats, tags, events to allow user to limit widget to certain categories
54
  $events_categories = get_terms( 'events_categories', array( 'orderby' => 'name', "hide_empty" => false ) );
55
  $events_tags = get_terms( 'events_tags', array( 'orderby' => 'name', "hide_empty" => false ) );
56
- $get_events = new WP_Query( array ( 'post_type' => AI1EC_POST_TYPE, 'posts_per_page' => -1 ) );
57
- $events_options = $get_events->posts;
58
 
59
  // Generate unique IDs and NAMEs of all needed form fields
60
  $fields = array(
@@ -111,13 +111,43 @@ class Ai1ec_Agenda_Widget extends WP_Widget
111
  $instance['show_subscribe_buttons'] = $new_instance['show_subscribe_buttons'] ? true : false;
112
  $instance['show_calendar_button'] = $new_instance['show_calendar_button'] ? true : false;
113
  $instance['hide_on_calendar_page'] = $new_instance['hide_on_calendar_page'] ? true : false;
 
114
  // For limits, set the limit to False if no IDs were selected, or set the respective IDs to empty if "limit by" was unchecked
115
- $instance['limit_by_cat'] = ( ! $new_instance['event_cat_ids'] || ! $new_instance['limit_by_cat'] ) ? false : true;
116
- $instance['event_cat_ids'] = ! $new_instance['limit_by_cat'] ? array() : $new_instance['event_cat_ids'] ;
117
- $instance['limit_by_tag'] = ( ! $new_instance['event_tag_ids'] || ! $new_instance['limit_by_tag'] ) ? false : true;
118
- $instance['event_tag_ids'] = ! $new_instance['limit_by_tag'] ? array() : $new_instance['event_tag_ids'] ;
119
- $instance['limit_by_post'] = ( ! $new_instance['event_post_ids'] || ! $new_instance['limit_by_post'] ) ? false : true;
120
- $instance['event_post_ids'] = ! $new_instance['limit_by_post'] ? array() : $new_instance['event_post_ids'] ;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
121
 
122
  return $instance;
123
  }
53
  // Get available cats, tags, events to allow user to limit widget to certain categories
54
  $events_categories = get_terms( 'events_categories', array( 'orderby' => 'name', "hide_empty" => false ) );
55
  $events_tags = get_terms( 'events_tags', array( 'orderby' => 'name', "hide_empty" => false ) );
56
+ $get_events = new WP_Query( array ( 'post_type' => AI1EC_POST_TYPE, 'posts_per_page' => -1 ) );
57
+ $events_options = $get_events->posts;
58
 
59
  // Generate unique IDs and NAMEs of all needed form fields
60
  $fields = array(
111
  $instance['show_subscribe_buttons'] = $new_instance['show_subscribe_buttons'] ? true : false;
112
  $instance['show_calendar_button'] = $new_instance['show_calendar_button'] ? true : false;
113
  $instance['hide_on_calendar_page'] = $new_instance['hide_on_calendar_page'] ? true : false;
114
+
115
  // For limits, set the limit to False if no IDs were selected, or set the respective IDs to empty if "limit by" was unchecked
116
+ $instance['limit_by_cat'] = false;
117
+ $instance['event_cat_ids'] = array();
118
+ if( isset( $new_instance['event_cat_ids'] ) && $new_instance['event_cat_ids'] != false ) {
119
+ $instance['limit_by_cat'] = true;
120
+ }
121
+ if( isset( $new_instance['limit_by_cat'] ) && $new_instance['limit_by_cat'] != false ) {
122
+ $instance['limit_by_cat'] = true;
123
+ }
124
+ if( isset( $new_instance['event_cat_ids'] ) && $instance['limit_by_cat'] === true ) {
125
+ $instance['event_cat_ids'] = $new_instance['event_cat_ids'];
126
+ }
127
+
128
+ $instance['limit_by_tag'] = false;
129
+ $instance['event_tag_ids'] = array();
130
+ if( isset( $new_instance['event_tag_ids'] ) && $new_instance['event_tag_ids'] != false ) {
131
+ $instance['limit_by_tag'] = true;
132
+ }
133
+ if( isset( $new_instance['limit_by_tag'] ) && $new_instance['limit_by_tag'] != false ) {
134
+ $instance['limit_by_tag'] = true;
135
+ }
136
+ if( isset( $new_instance['event_tag_ids'] ) && $instance['limit_by_tag'] === true ) {
137
+ $instance['event_tag_ids'] = $new_instance['event_tag_ids'];
138
+ }
139
+
140
+ $instance['limit_by_post'] = false;
141
+ $instance['event_post_ids'] = array();
142
+ if( isset( $new_instance['event_post_ids'] ) && $new_instance['event_post_ids'] != false ) {
143
+ $instance['limit_by_post'] = true;
144
+ }
145
+ if( isset( $new_instance['limit_by_post'] ) && $new_instance['limit_by_post'] != false ) {
146
+ $instance['limit_by_post'] = true;
147
+ }
148
+ if( isset( $new_instance['event_post_ids'] ) && $instance['limit_by_post'] === true ) {
149
+ $instance['event_post_ids'] = $new_instance['event_post_ids'];
150
+ }
151
 
152
  return $instance;
153
  }
app/view/row_monthly.php CHANGED
@@ -3,9 +3,25 @@
3
  <?php _e( 'Every', AI1EC_PLUGIN_NAME ) ?>:
4
  </label>
5
  <?php echo $count ?>
6
- <label for="ai1ec_monthly_each">
7
- <?php _e( 'Each', AI1EC_PLUGIN_NAME ) ?>:
8
- </label>
 
 
 
 
 
 
 
9
  <div style="clear:both;"></div>
10
- <?php echo $month ?>
 
 
 
 
 
 
 
 
 
11
  </div>
3
  <?php _e( 'Every', AI1EC_PLUGIN_NAME ) ?>:
4
  </label>
5
  <?php echo $count ?>
6
+ <div class="ai1ec_repeat_monthly_type">
7
+ <input type="radio" name="ai1ec_monthly_type" id="ai1ec_monthly_type_bymonthday" value="bymonthday" checked="1" />
8
+ <label for="ai1ec_monthly_type_bymonthday">
9
+ <?php _e( 'On day of the month', AI1EC_PLUGIN_NAME ) ?>
10
+ </label>
11
+ <input type="radio" name="ai1ec_monthly_type" id="ai1ec_monthly_type_byday" value="byday" />
12
+ <label for="ai1ec_monthly_type_byday">
13
+ <?php _e( 'On day of the week', AI1EC_PLUGIN_NAME ) ?>
14
+ </label>
15
+ </div>
16
  <div style="clear:both;"></div>
17
+ <div id="ai1c_repeat_monthly_bymonthday">
18
+ <?php echo $month ?>
19
+ </div>
20
+ <div id="ai1c_repeat_monthly_byday">
21
+ <label for="ai1ec_monthly_type_byday">
22
+ <?php _e( 'Every', AI1EC_PLUGIN_NAME ) ?>
23
+ </label>
24
+ <?php echo $day_nums ?>
25
+ <?php echo $week_days ?>
26
+ </div>
27
  </div>
css/add_new_event.css CHANGED
@@ -392,6 +392,18 @@ ul.ai1ec_repeat_tabs li a.ai1ec_active {
392
  width: 61px;
393
  text-align: left;
394
  }
 
 
 
 
 
 
 
 
 
 
 
 
395
  #ai1ec_ending_box, #ai1ec_end_holder, #ai1ec_repeat_text {
396
  float: left;
397
  }
392
  width: 61px;
393
  text-align: left;
394
  }
395
+ #ai1c_repeat_monthly_byday {
396
+ display: none;
397
+ float: left;
398
+ }
399
+ .ai1ec_repeat_monthly_type {
400
+ float: left;
401
+ clear: both;
402
+ margin: 0.4em 0;
403
+ }
404
+ .ai1ec_repeat_monthly_type label {
405
+ float: none;
406
+ }
407
  #ai1ec_ending_box, #ai1ec_end_holder, #ai1ec_repeat_text {
408
  float: left;
409
  }
css/jquery.bsmselect.css DELETED
@@ -1,64 +0,0 @@
1
- .bsmContainer {
2
- /* container that surrounds entire bsmSelect widget */
3
- }
4
-
5
- .bsmSelect {
6
- /* the newly created regular 'select' */
7
- display: inline;
8
- }
9
-
10
- .bsmOptionDisabled {
11
- /* disabled options in new select */
12
- color: #999;
13
- }
14
-
15
- .bsmHighlight {
16
- /* the highlight span */
17
- float: right;
18
- padding: 0;
19
- margin: 0 0 0 1em;
20
- }
21
-
22
- .bsmList {
23
- /* html list that contains selected items */
24
- margin: 0.25em 0 1em 0;
25
- position: relative;
26
- display: block;
27
- padding-left: 0;
28
- list-style: none;
29
- }
30
-
31
- .bsmListItem {
32
- /* li item from the html list above */
33
- position: relative;
34
- margin-left: 0;
35
- padding-left: 0;
36
- list-style: none;
37
- background: #ddd;
38
- border: 1px solid #bbb;
39
- width: 100%;
40
- margin: 0 0 -1px 0;
41
- line-height: 1em;
42
- }
43
-
44
- .bsmListItem:hover {
45
- background-color: #e5e5e5;
46
- }
47
-
48
- .bsmListItemLabel {
49
- /* this is a span that surrounds the text in the item, except for the remove link */
50
- padding: 5px;
51
- display: block;
52
- }
53
-
54
- .bsmListSortable .bsmListItemLabel {
55
- cursor: move;
56
- }
57
-
58
- .bsmListItemRemove {
59
- /* the remove link in each list item */
60
- position: absolute;
61
- right: 0;
62
- top: 0;
63
- padding: 5px;
64
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
css/widget.css CHANGED
@@ -49,3 +49,7 @@
49
  .ai1ec-category-selected-item-remove img {
50
  vertical-align: bottom;
51
  }
 
 
 
 
49
  .ai1ec-category-selected-item-remove img {
50
  vertical-align: bottom;
51
  }
52
+
53
+ .ai1ec-widget-cat-ids, .ai1ec-widget-tag-ids, .ai1ec-widget-event-ids {
54
+ width: 99%;
55
+ }
js/add_new_event.js CHANGED
@@ -315,12 +315,18 @@ jQuery( function( $ ){
315
  break;
316
  case 'monthly':
317
  rule += 'FREQ=MONTHLY;';
318
- var interval = $( '#ai1ec_monthly_count' ).val();
 
319
  if( interval > 1 )
320
  rule += 'INTERVAL=' + interval + ';';
321
  var month_days = $( 'input[name="ai1ec_montly_date_select"]:first' ).val();
322
- if( month_days.length > 0 )
323
  rule += 'BYMONTHDAY=' + month_days + ';';
 
 
 
 
 
324
  break;
325
  case 'yearly':
326
  rule += 'FREQ=YEARLY;';
@@ -431,6 +437,11 @@ jQuery( function( $ ){
431
  $.unblockUI();
432
  return false;
433
  });
 
 
 
 
 
434
 
435
  var ai1ec_show_repeat_tabs = function() {
436
  $.blockUI( {
315
  break;
316
  case 'monthly':
317
  rule += 'FREQ=MONTHLY;';
318
+ var interval = $( '#ai1ec_monthly_count' ).val();
319
+ var monthtype = $( 'input[name="ai1ec_monthly_type"]:checked' ).val();
320
  if( interval > 1 )
321
  rule += 'INTERVAL=' + interval + ';';
322
  var month_days = $( 'input[name="ai1ec_montly_date_select"]:first' ).val();
323
+ if( month_days.length > 0 && monthtype == 'bymonthday' ) {
324
  rule += 'BYMONTHDAY=' + month_days + ';';
325
+ } else if ( monthtype == 'byday' ) {
326
+ byday_num = $( '#ai1ec_monthly_byday_num' ).val();
327
+ byday_weekday = $( '#ai1ec_monthly_byday_weekday' ).val();
328
+ rule += 'BYDAY=' + byday_num + byday_weekday + ';';
329
+ }
330
  break;
331
  case 'yearly':
332
  rule += 'FREQ=YEARLY;';
437
  $.unblockUI();
438
  return false;
439
  });
440
+
441
+ $( '#ai1ec_monthly_type_bymonthday, #ai1ec_monthly_type_byday' ).change( function() {
442
+ $( '#ai1c_repeat_monthly_bymonthday' ).toggle();
443
+ $( '#ai1c_repeat_monthly_byday' ).toggle();
444
+ })
445
 
446
  var ai1ec_show_repeat_tabs = function() {
447
  $.blockUI( {
js/calendar.js CHANGED
@@ -185,11 +185,27 @@ jQuery( document ).ready( function( $ ) {
185
 
186
  // Display popup
187
  $popup
188
- .fadeIn( 100, function() {
189
- // Special case - check if the mouse cursor is still in the pop-up.
190
- if( ! $(this).data( 'ai1ec_mouseinside' ) )
191
- $(this).each( hide_popup );
192
- } );
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
193
  }
194
  function hide_popup() {
195
  $(this)
@@ -197,15 +213,20 @@ jQuery( document ).ready( function( $ ) {
197
  .data( 'ai1ec_mouseinside', false );
198
  }
199
 
200
- // Register popup hover handlers for month/week views
 
201
  $('.ai1ec-month-view .ai1ec-event, .ai1ec-week-view .ai1ec-event')
202
- .live( 'mouseenter', show_popup );
203
- $('.ai1ec-month-view .ai1ec-event-popup, .ai1ec-week-view .ai1ec-event-popup')
204
- .live( 'mouseleave', hide_popup )
205
- .live( 'mousemove', function() {
206
- // Track whether popup contains mouse cursor
207
- $(this).data( 'ai1ec_mouseinside', true );
208
- } );
 
 
 
 
209
  // Hide any popups that were visible when the window lost focus
210
  if( $('.ai1ec-month-view, .ai1ec-week-view').length ) {
211
  $(window).blur( function() {
185
 
186
  // Display popup
187
  $popup
188
+ .fadeIn( 100,
189
+ // Don't handle special case in touch environment (unneeded, interferes)
190
+ Modernizr.touch
191
+ ? null
192
+ : function() {
193
+ // Special case - check if the mouse cursor is still in the pop-up.
194
+ if( ! $(this).data( 'ai1ec_mouseinside' ) ) {
195
+ $(this).each( hide_popup );
196
+ }
197
+ }
198
+ );
199
+
200
+ // If in touch environment, hide any previously popped up events (required
201
+ // since we don't use mouseleave event for this in touch environments) and
202
+ // then return false from "click" handler to prevent following of link.
203
+ if( Modernizr.touch ) {
204
+ $('.ai1ec-month-view .ai1ec-event-popup, .ai1ec-week-view .ai1ec-event-popup')
205
+ .not( $popup )
206
+ .fadeOut( 100, function() { $(this).parent().css( { zIndex: 'auto' } ); } );
207
+ return false;
208
+ }
209
  }
210
  function hide_popup() {
211
  $(this)
213
  .data( 'ai1ec_mouseinside', false );
214
  }
215
 
216
+ // Register popup click (for touch devices) or hover (for non-touch devices)
217
+ // handlers for month/week views
218
  $('.ai1ec-month-view .ai1ec-event, .ai1ec-week-view .ai1ec-event')
219
+ .live( Modernizr.touch ? 'click' : 'mouseenter', show_popup );
220
+ // Only hide popups on mouseleave for mouse-based devices (doesn't work
221
+ // properly in touch-based devices for some reason).
222
+ if( ! Modernizr.touch ) {
223
+ $('.ai1ec-month-view .ai1ec-event-popup, .ai1ec-week-view .ai1ec-event-popup')
224
+ .live( 'mouseleave', hide_popup )
225
+ .live( 'mousemove', function() {
226
+ // Track whether popup contains mouse cursor
227
+ $(this).data( 'ai1ec_mouseinside', true );
228
+ } );
229
+ }
230
  // Hide any popups that were visible when the window lost focus
231
  if( $('.ai1ec-month-view, .ai1ec-week-view').length ) {
232
  $(window).blur( function() {
js/jquery.bsmselect.js DELETED
@@ -1,381 +0,0 @@
1
- /*
2
- * Better Select Multiple - jQuery Plugin
3
- *
4
- * based on Alternate Select Multiple (asmSelect) 1.0.4a beta (http://www.ryancramer.com/projects/asmselect/)
5
- *
6
- * Copyright (c) 2009 by Ryan Cramer - http://www.ryancramer.com
7
- * Copyright (c) 2010 by Victor Berchet - http://www.github.com/vicb
8
- *
9
- * Dual licensed under the MIT (MIT-LICENSE.txt) and GPL (GPL-LICENSE.txt) licenses.
10
- *
11
- * bsmSelect version: v1.4.3 - 2011-05-05
12
- */
13
-
14
- (function($) {
15
-
16
- function BsmSelect(target, options)
17
- {
18
- this.$original = $(target); // the original select multiple
19
- this.buildingSelect = false; // is the new select being constructed right now?
20
- this.ieClick = false; // in IE, has a click event occurred? ignore if not
21
- this.ignoreOriginalChangeEvent = false; // originalChangeEvent bypassed when this is true
22
- this.options = options;
23
- this.buildDom();
24
- }
25
-
26
- BsmSelect.prototype = {
27
- /**
28
- * Generate an UID
29
- */
30
- generateUid: function(index) {
31
- return (this.uid = this.options.containerClass + index);
32
- },
33
-
34
- /**
35
- * Build the DOM for bsmSelect
36
- */
37
- buildDom: function() {
38
- var self = this, o = this.options;
39
-
40
- if (o.addItemTarget === 'original') {
41
- $('option', this.$original).each(function(i, o) {
42
- if ($(o).data('bsm-order') === null) { $(o).data('bsm-order', i); }
43
- });
44
- }
45
-
46
- for (var index = 0; $('#' + this.generateUid(index)).size(); index++) {}
47
-
48
- this.$select = $('<select>', {
49
- 'class': o.selectClass,
50
- name: o.selectClass + this.uid,
51
- id: o.selectClass + this.uid,
52
- change: $.proxy(this.selectChangeEvent, this),
53
- click: $.proxy(this.selectClickEvent, this)
54
- });
55
-
56
- this.$list = $.isFunction(o.listType)
57
- ? o.listType(this.$original)
58
- : $('<' + o.listType + '>', { id: o.listClass + this.uid });
59
-
60
- this.$list.addClass(o.listClass);
61
-
62
- this.$container = $('<div>', { 'class': o.containerClass, id: this.uid });
63
-
64
- this.buildSelect();
65
-
66
- this.$original.change($.proxy(this.originalChangeEvent, this)).wrap(this.$container).before(this.$select);
67
-
68
- // if the list isn't already in the document, add it (it might be inserted by a custom callback)
69
- if (!this.$list.parent().length) { this.$original.before(this.$list); }
70
-
71
- if (this.$original.attr('id')) {
72
- $('label[for=' + this.$original.attr('id') + ']').attr('for', this.$select.attr('id'));
73
- }
74
-
75
- // set up remove event (may be a link, or the list item itself)
76
- this.$list.delegate('.' + o.removeClass, 'click', function() {
77
- self.dropListItem($(this).closest('li'));
78
- return false;
79
- });
80
-
81
- $.each(o.plugins, function() { this.init(self); });
82
- },
83
-
84
- /**
85
- * Triggered when an item has been selected
86
- * Check to make sure it's not an IE screwup, and add it to the list
87
- */
88
- selectChangeEvent: function() {
89
- if ($.browser.msie && $.browser.version < 7 && !this.ieClick) { return; }
90
- var bsmOpt = $('option:selected:eq(0)', this.$select);
91
- if (bsmOpt.data('orig-option')) {
92
- this.addListItem(bsmOpt);
93
- this.triggerOriginalChange(bsmOpt.data('orig-option'), 'add');
94
- }
95
- this.ieClick = false;
96
- },
97
-
98
- /**
99
- * IE6 lets you scroll around in a select without it being pulled down
100
- * making sure a click preceded the change() event reduces the chance
101
- * if unintended items being added. there may be a better solution?
102
- */
103
- selectClickEvent: function() {
104
- this.ieClick = true;
105
- },
106
-
107
- /**
108
- * Rebuild bsmSelect when the 'change' event is triggered on the original select
109
- */
110
- originalChangeEvent: function() {
111
- if (this.ignoreOriginalChangeEvent) {
112
- // We don't want to rebuild everything when an item is added / droped
113
- this.ignoreOriginalChangeEvent = false;
114
- } else {
115
- this.buildSelect();
116
- // opera has an issue where it needs a force redraw, otherwise
117
- // the items won't appear until something else forces a redraw
118
- if ($.browser.opera) { this.$list.hide().show(); }
119
- }
120
- },
121
-
122
- /**
123
- * Build the DOM for the new select
124
- */
125
- buildSelect: function() {
126
- var self = this;
127
-
128
- this.buildingSelect = true;
129
-
130
- // add a first option to be the home option / default selectLabel
131
- this.$select.empty().prepend($('<option value=""></option>').text(this.$original.attr('title') || this.options.title));
132
- this.$list.empty();
133
-
134
- this.$original.children().each(function() {
135
- if ($(this).is('option')) {
136
- self.addSelectOption(self.$select, $(this));
137
- } else if ($(this).is('optgroup')) {
138
- self.addSelectOptionGroup(self.$select, $(this));
139
- }
140
- });
141
-
142
- if (!this.options.debugMode) { this.$original.hide(); }
143
- this.selectFirstItem();
144
- this.buildingSelect = false;
145
- },
146
-
147
- /**
148
- * Append an option to the new select
149
- *
150
- * @param {jQuery} $parent Where to append the option
151
- * @param {jQuery} $origOpt Option from the original select
152
- */
153
- addSelectOption: function ($parent, $origOpt) {
154
- var $bsmOpt = $('<option>', {
155
- text: $origOpt.text(),
156
- val: $origOpt.val() }).appendTo($parent).data('orig-option', $origOpt),
157
- isSelected = $origOpt.is(':selected'),
158
- isDisabled = $origOpt.is(':disabled');
159
- $origOpt.data('bsm-option', $bsmOpt);
160
- if (isSelected && !isDisabled) {
161
- this.addListItem($bsmOpt);
162
- this.disableSelectOption($bsmOpt);
163
- } else if (!isSelected && isDisabled) {
164
- this.disableSelectOption($bsmOpt);
165
- }
166
- },
167
-
168
- /**
169
- * Append an option group to the new select
170
- *
171
- * @param {jQuery} $parent Where to append the group
172
- * @param {jQuery} $group Model group from the original select
173
- */
174
- addSelectOptionGroup: function($parent, $group)
175
- {
176
- var self = this,
177
- $G = $('<optgroup>', { label: $group.attr('label')} ).appendTo($parent);
178
- if ($group.is(':disabled')) { $G.attr('disabled', 'disabled'); }
179
- $('option', $group).each(function() { self.addSelectOption($G, $(this)); });
180
- },
181
-
182
- /**
183
- * Select the first item of the new select
184
- */
185
- selectFirstItem: function() {
186
- $('option:eq(0)', this.$select).attr('selected', 'selected');
187
- },
188
-
189
- /**
190
- * Make an option disabled, indicating that it's already been selected
191
- * because safari is the only browser that makes disabled items look 'disabled'
192
- * we apply a class that reproduces the disabled look in other browsers
193
- *
194
- * @param {jQuery} $bsmOpt Option from the new select
195
- */
196
- disableSelectOption: function($bsmOpt) {
197
- $bsmOpt.addClass(this.options.optionDisabledClass)
198
- .removeAttr('selected')
199
- .attr('disabled', 'disabled')
200
- .toggle(!this.options.hideWhenAdded);
201
- if ($.browser.msie && $.browser.version < 8) { this.$select.hide().show(); } // this forces IE to update display
202
- },
203
-
204
- /**
205
- * Enable a select option
206
- *
207
- * @param {jQuery} $bsmOpt Option from the new select
208
- */
209
- enableSelectOption: function($bsmOpt) {
210
- $bsmOpt.removeClass(this.options.optionDisabledClass)
211
- .removeAttr('disabled')
212
- .toggle(!this.options.hideWhenAdded);
213
- if ($.browser.msie && $.browser.version < 8) { this.$select.hide().show(); } // this forces IE to update display
214
- },
215
-
216
- /**
217
- * Append an item corresponding to the option to the list
218
- *
219
- * @param {jQuery} $bsmOpt Option from the new select
220
- */
221
- addListItem: function($bsmOpt) {
222
- var $item,
223
- $origOpt = $bsmOpt.data('orig-option'),
224
- o = this.options;
225
-
226
- if (!$origOpt) { return; } // this is the first item, selectLabel
227
-
228
- if (!this.buildingSelect) {
229
- if ($origOpt.is(':selected')) { return; } // already have it
230
- $origOpt.attr('selected', 'selected');
231
- }
232
-
233
- $item = $('<li>', { 'class': o.listItemClass })
234
- .append($('<span>', { 'class': o.listItemLabelClass, html: o.extractLabel($bsmOpt, o)}))
235
- .append($('<a>', { href: '#', 'class': o.removeClass, html: o.removeLabel }))
236
- .data('bsm-option', $bsmOpt);
237
-
238
- this.disableSelectOption($bsmOpt.data('item', $item));
239
-
240
- switch (o.addItemTarget) {
241
- case 'bottom':
242
- this.$list.append($item.hide());
243
- break;
244
- case 'original':
245
- var order = $origOpt.data('bsm-order'), inserted = false;
246
- $('.' + o.listItemClass, this.$list).each(function() {
247
- if (order < $(this).data('bsm-option').data('orig-option').data('bsm-order')) {
248
- $item.hide().insertBefore(this);
249
- inserted = true;
250
- return false;
251
- }
252
- });
253
- if (!inserted) { this.$list.append($item.hide()); }
254
- break;
255
- default:
256
- this.$list.prepend($item.hide());
257
- }
258
-
259
- if (this.buildingSelect) {
260
- $.bsmSelect.effects.show($item);
261
- } else {
262
- o.showEffect($item);
263
- o.highlightEffect(this.$select, $item, o.highlightAddedLabel, this.options);
264
- this.selectFirstItem();
265
- }
266
- },
267
-
268
- /**
269
- * Remove an item from the list of selection
270
- *
271
- * @param {jQuey} $item A list item
272
- */
273
- dropListItem: function($item) {
274
- var $bsmOpt = $item.data('bsm-option'), o = this.options;
275
- $bsmOpt.removeData('item').data('orig-option').removeAttr('selected');
276
- (this.buildingSelect ? $.bsmSelect.effects.remove : o.hideEffect)($item);
277
- this.enableSelectOption($bsmOpt);
278
- o.highlightEffect(this.$select, $item, o.highlightRemovedLabel, o);
279
- this.triggerOriginalChange($bsmOpt.data('orig-option'), 'drop');
280
- },
281
-
282
- /**
283
- * Trigger a change event on the original select multiple
284
- * so that other scripts can pick them up
285
- *
286
- * @param {jQuery} $origOpt The option from the original select
287
- * @param {String} type Event type
288
- */
289
- triggerOriginalChange: function($origOpt, type) {
290
- this.ignoreOriginalChangeEvent = true;
291
- this.$original.trigger('change', [{
292
- option: $origOpt,
293
- value: $origOpt.val(),
294
- item: $origOpt.data('bsm-option').data('item'),
295
- type: type
296
- }]);
297
- }
298
- };
299
-
300
- $.fn.bsmSelect = function(customOptions) {
301
- var options = $.extend({}, $.bsmSelect.conf, customOptions);
302
- return this.each(function() {
303
- var bsm = $(this).data("bsmSelect");
304
- if (!bsm) {
305
- bsm = new BsmSelect($(this), options);
306
- $(this).data("bsmSelect", bsm);
307
- }
308
- });
309
- };
310
-
311
- $.bsmSelect = {};
312
- $.extend($.bsmSelect, {
313
- effects: {
314
- show: function($el) { $el.show(); },
315
-
316
- remove: function($el) { $el.remove(); },
317
-
318
- highlight: function ($select, $item, label, conf) {
319
- var $highlight,
320
- id = $select.attr('id') + conf.highlightClass;
321
- $('#' + id).remove();
322
- $highlight = $('<span>', {
323
- 'class': conf.highlightClass,
324
- id: id,
325
- html: label + $item.children('.' + conf.listItemLabelClass).first().text()
326
- }).hide();
327
- $select.after($highlight.fadeIn('fast').delay(50).fadeOut('slow', function() { $(this).remove(); }));
328
- },
329
-
330
- verticalListAdd: function ($el) {
331
- $el.animate({ opacity: 'show', height: 'show' }, 100, function() {
332
- $(this).animate({ height: '+=2px' }, 100, function() {
333
- $(this).animate({ height: '-=2px' }, 100);
334
- });
335
- });
336
- },
337
-
338
- verticalListRemove: function($el) {
339
- $el.animate({ opacity: 'hide', height: 'hide' }, 100, function() {
340
- $(this).prev('li').animate({ height: '-=2px' }, 100, function() {
341
- $(this).animate({ height: '+=2px' }, 100);
342
- });
343
- $(this).remove();
344
- });
345
- }
346
- },
347
- plugins: {
348
- }
349
- });
350
-
351
- // Default configuration
352
- $.bsmSelect.conf = {
353
- listType: 'ol', // Ordered list 'ol', or unordered list 'ul'
354
-
355
- showEffect: $.bsmSelect.effects.show,
356
- hideEffect: $.bsmSelect.effects.remove,
357
- highlightEffect: $.noop,
358
-
359
- addItemTarget: 'bottom', // Where to place new selected items in list: top or bottom
360
- hideWhenAdded: false, // Hide the option when added to the list? works only in FF
361
- debugMode: false, // Debug mode keeps original select visible
362
-
363
- title: 'Select...', // Text used for the default select label
364
- removeLabel: 'remove', // HTML used for the 'remove' link
365
- highlightAddedLabel: 'Added: ', // Text that precedes highlight of added item
366
- highlightRemovedLabel: 'Removed: ', // Text that precedes highlight of removed item
367
- extractLabel: function($o) { return $o.html(); },
368
-
369
- plugins: [], // An array of plugin objects to enable
370
-
371
- containerClass: 'bsmContainer', // Class for container that wraps this widget
372
- selectClass: 'bsmSelect', // Class for the newly created <select>
373
- optionDisabledClass: 'bsmOptionDisabled', // Class for items that are already selected / disabled
374
- listClass: 'bsmList', // Class for the list ($list)
375
- listItemClass: 'bsmListItem', // Class for the <li> list items
376
- listItemLabelClass: 'bsmListItemLabel', // Class for the label text that appears in list items
377
- removeClass: 'bsmListItemRemove', // Class given to the 'remove' link
378
- highlightClass: 'bsmHighlight' // Class given to the highlight <span>
379
- };
380
-
381
- })(jQuery);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
js/modernizr.custom.78720.js ADDED
@@ -0,0 +1,4 @@
 
 
 
 
1
+ /* Modernizr 2.0.6 (Custom Build) | MIT & BSD
2
+ * Build: http://www.modernizr.com/download/#-touch-iepp-cssclasses-teststyles-prefixes-load
3
+ */
4
+ ;window.Modernizr=function(a,b,c){function z(a,b){return!!~(""+a).indexOf(b)}function y(a,b){return typeof a===b}function x(a,b){return w(n.join(a+";")+(b||""))}function w(a){k.cssText=a}var d="2.0.6",e={},f=!0,g=b.documentElement,h=b.head||b.getElementsByTagName("head")[0],i="modernizr",j=b.createElement(i),k=j.style,l,m=Object.prototype.toString,n=" -webkit- -moz- -o- -ms- -khtml- ".split(" "),o={},p={},q={},r=[],s=function(a,c,d,e){var f,h,j,k=b.createElement("div");if(parseInt(d,10))while(d--)j=b.createElement("div"),j.id=e?e[d]:i+(d+1),k.appendChild(j);f=["&shy;","<style>",a,"</style>"].join(""),k.id=i,k.innerHTML+=f,g.appendChild(k),h=c(k,a),k.parentNode.removeChild(k);return!!h},t,u={}.hasOwnProperty,v;!y(u,c)&&!y(u.call,c)?v=function(a,b){return u.call(a,b)}:v=function(a,b){return b in a&&y(a.constructor.prototype[b],c)};var A=function(c,d){var f=c.join(""),g=d.length;s(f,function(c,d){var f=b.styleSheets[b.styleSheets.length-1],h=f.cssRules&&f.cssRules[0]?f.cssRules[0].cssText:f.cssText||"",i=c.childNodes,j={};while(g--)j[i[g].id]=i[g];e.touch="ontouchstart"in a||j.touch.offsetTop===9},g,d)}([,["@media (",n.join("touch-enabled),("),i,")","{#touch{top:9px;position:absolute}}"].join("")],[,"touch"]);o.touch=function(){return e.touch};for(var B in o)v(o,B)&&(t=B.toLowerCase(),e[t]=o[B](),r.push((e[t]?"":"no-")+t));w(""),j=l=null,a.attachEvent&&function(){var a=b.createElement("div");a.innerHTML="<elem></elem>";return a.childNodes.length!==1}()&&function(a,b){function s(a){var b=-1;while(++b<g)a.createElement(f[b])}a.iepp=a.iepp||{};var d=a.iepp,e=d.html5elements||"abbr|article|aside|audio|canvas|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",f=e.split("|"),g=f.length,h=new RegExp("(^|\\s)("+e+")","gi"),i=new RegExp("<(/*)("+e+")","gi"),j=/^\s*[\{\}]\s*$/,k=new RegExp("(^|[^\\n]*?\\s)("+e+")([^\\n]*)({[\\n\\w\\W]*?})","gi"),l=b.createDocumentFragment(),m=b.documentElement,n=m.firstChild,o=b.createElement("body"),p=b.createElement("style"),q=/print|all/,r;d.getCSS=function(a,b){if(a+""===c)return"";var e=-1,f=a.length,g,h=[];while(++e<f){g=a[e];if(g.disabled)continue;b=g.media||b,q.test(b)&&h.push(d.getCSS(g.imports,b),g.cssText),b="all"}return h.join("")},d.parseCSS=function(a){var b=[],c;while((c=k.exec(a))!=null)b.push(((j.exec(c[1])?"\n":c[1])+c[2]+c[3]).replace(h,"$1.iepp_$2")+c[4]);return b.join("\n")},d.writeHTML=function(){var a=-1;r=r||b.body;while(++a<g){var c=b.getElementsByTagName(f[a]),d=c.length,e=-1;while(++e<d)c[e].className.indexOf("iepp_")<0&&(c[e].className+=" iepp_"+f[a])}l.appendChild(r),m.appendChild(o),o.className=r.className,o.id=r.id,o.innerHTML=r.innerHTML.replace(i,"<$1font")},d._beforePrint=function(){p.styleSheet.cssText=d.parseCSS(d.getCSS(b.styleSheets,"all")),d.writeHTML()},d.restoreHTML=function(){o.innerHTML="",m.removeChild(o),m.appendChild(r)},d._afterPrint=function(){d.restoreHTML(),p.styleSheet.cssText=""},s(b),s(l);d.disablePP||(n.insertBefore(p,n.firstChild),p.media="print",p.className="iepp-printshim",a.attachEvent("onbeforeprint",d._beforePrint),a.attachEvent("onafterprint",d._afterPrint))}(a,b),e._version=d,e._prefixes=n,e.testStyles=s,g.className=g.className.replace(/\bno-js\b/,"")+(f?" js "+r.join(" "):"");return e}(this,this.document),function(a,b,c){function k(a){return!a||a=="loaded"||a=="complete"}function j(){var a=1,b=-1;while(p.length- ++b)if(p[b].s&&!(a=p[b].r))break;a&&g()}function i(a){var c=b.createElement("script"),d;c.src=a.s,c.onreadystatechange=c.onload=function(){!d&&k(c.readyState)&&(d=1,j(),c.onload=c.onreadystatechange=null)},m(function(){d||(d=1,j())},H.errorTimeout),a.e?c.onload():n.parentNode.insertBefore(c,n)}function h(a){var c=b.createElement("link"),d;c.href=a.s,c.rel="stylesheet",c.type="text/css";if(!a.e&&(w||r)){var e=function(a){m(function(){if(!d)try{a.sheet.cssRules.length?(d=1,j()):e(a)}catch(b){b.code==1e3||b.message=="security"||b.message=="denied"?(d=1,m(function(){j()},0)):e(a)}},0)};e(c)}else c.onload=function(){d||(d=1,m(function(){j()},0))},a.e&&c.onload();m(function(){d||(d=1,j())},H.errorTimeout),!a.e&&n.parentNode.insertBefore(c,n)}function g(){var a=p.shift();q=1,a?a.t?m(function(){a.t=="c"?h(a):i(a)},0):(a(),j()):q=0}function f(a,c,d,e,f,h){function i(){!o&&k(l.readyState)&&(r.r=o=1,!q&&j(),l.onload=l.onreadystatechange=null,m(function(){u.removeChild(l)},0))}var l=b.createElement(a),o=0,r={t:d,s:c,e:h};l.src=l.data=c,!s&&(l.style.display="none"),l.width=l.height="0",a!="object"&&(l.type=d),l.onload=l.onreadystatechange=i,a=="img"?l.onerror=i:a=="script"&&(l.onerror=function(){r.e=r.r=1,g()}),p.splice(e,0,r),u.insertBefore(l,s?null:n),m(function(){o||(u.removeChild(l),r.r=r.e=o=1,j())},H.errorTimeout)}function e(a,b,c){var d=b=="c"?z:y;q=0,b=b||"j",C(a)?f(d,a,b,this.i++,l,c):(p.splice(this.i++,0,a),p.length==1&&g());return this}function d(){var a=H;a.loader={load:e,i:0};return a}var l=b.documentElement,m=a.setTimeout,n=b.getElementsByTagName("script")[0],o={}.toString,p=[],q=0,r="MozAppearance"in l.style,s=r&&!!b.createRange().compareNode,t=r&&!s,u=s?l:n.parentNode,v=a.opera&&o.call(a.opera)=="[object Opera]",w="webkitAppearance"in l.style,x=w&&"async"in b.createElement("script"),y=r?"object":v||x?"img":"script",z=w?"img":y,A=Array.isArray||function(a){return o.call(a)=="[object Array]"},B=function(a){return Object(a)===a},C=function(a){return typeof a=="string"},D=function(a){return o.call(a)=="[object Function]"},E=[],F={},G,H;H=function(a){function f(a){var b=a.split("!"),c=E.length,d=b.pop(),e=b.length,f={url:d,origUrl:d,prefixes:b},g,h;for(h=0;h<e;h++)g=F[b[h]],g&&(f=g(f));for(h=0;h<c;h++)f=E[h](f);return f}function e(a,b,e,g,h){var i=f(a),j=i.autoCallback;if(!i.bypass){b&&(b=D(b)?b:b[a]||b[g]||b[a.split("/").pop().split("?")[0]]);if(i.instead)return i.instead(a,b,e,g,h);e.load(i.url,i.forceCSS||!i.forceJS&&/css$/.test(i.url)?"c":c,i.noexec),(D(b)||D(j))&&e.load(function(){d(),b&&b(i.origUrl,h,g),j&&j(i.origUrl,h,g)})}}function b(a,b){function c(a){if(C(a))e(a,h,b,0,d);else if(B(a))for(i in a)a.hasOwnProperty(i)&&e(a[i],h,b,i,d)}var d=!!a.test,f=d?a.yep:a.nope,g=a.load||a.both,h=a.callback,i;c(f),c(g),a.complete&&b.load(a.complete)}var g,h,i=this.yepnope.loader;if(C(a))e(a,0,i,0);else if(A(a))for(g=0;g<a.length;g++)h=a[g],C(h)?e(h,0,i,0):A(h)?H(h):B(h)&&b(h,i);else B(a)&&b(a,i)},H.addPrefix=function(a,b){F[a]=b},H.addFilter=function(a){E.push(a)},H.errorTimeout=1e4,b.readyState==null&&b.addEventListener&&(b.readyState="loading",b.addEventListener("DOMContentLoaded",G=function(){b.removeEventListener("DOMContentLoaded",G,0),b.readyState="complete"},0)),a.yepnope=d()}(this,this.document),Modernizr.load=function(){yepnope.apply(window,[].slice.call(arguments,0))};
language/all-in-one-event-calendar.pot CHANGED
@@ -1,581 +1,505 @@
1
- # Copyright (C) 2010 All-in-One Event Calendar Plugin
2
- # This file is distributed under the same license as the All-in-One Event Calendar Plugin package.
3
  msgid ""
4
  msgstr ""
5
- "Project-Id-Version: All-in-One Event Calendar Plugin 1.1\n"
6
  "Report-Msgid-Bugs-To: http://wordpress.org/tag/all-in-one-event-calendar\n"
7
- "POT-Creation-Date: 2011-11-18 01:32:36+00:00\n"
8
  "MIME-Version: 1.0\n"
9
  "Content-Type: text/plain; charset=UTF-8\n"
10
  "Content-Transfer-Encoding: 8bit\n"
11
- "PO-Revision-Date: 2010-MO-DA HO:MI+ZONE\n"
12
  "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13
  "Language-Team: LANGUAGE <LL@li.org>\n"
14
 
15
- #: app/model/class-ai1ec-event.php:459
16
- msgid " (all-day)"
17
- msgstr ""
18
-
19
- #: app/helper/class-ai1ec-settings-helper.php:85
20
- msgid "- Auto-Create New Page -"
21
- msgstr ""
22
-
23
- #: app/helper/class-ai1ec-settings-helper.php:106
24
- msgid "View \"%s\" »"
25
- msgstr ""
26
-
27
- #: app/helper/class-ai1ec-settings-helper.php:148 app/view/calendar.php:10
28
- #: app/view/calendar.php:11 app/view/calendar.php:17
29
- msgid "Month"
30
- msgstr ""
31
-
32
- #: app/helper/class-ai1ec-settings-helper.php:151
33
- #: app/controller/class-ai1ec-calendar-controller.php:288
34
- #: app/view/calendar.php:18
35
- msgid "Agenda"
36
- msgstr ""
37
-
38
- #: app/helper/class-ai1ec-settings-helper.php:200
39
- msgid "Default (d/m/y)"
40
  msgstr ""
41
 
42
- #: app/helper/class-ai1ec-settings-helper.php:203
43
- msgid "US (m/d/y)"
 
44
  msgstr ""
45
 
46
- #: app/helper/class-ai1ec-settings-helper.php:206
47
- msgid "ISO 8601 (y-m-d)"
48
  msgstr ""
49
 
50
- #: app/helper/class-ai1ec-settings-helper.php:209
51
- msgid "Dotted (m.d.y)"
52
  msgstr ""
53
 
54
- #: app/helper/class-ai1ec-settings-helper.php:227
55
- msgid "Hourly"
56
  msgstr ""
57
 
58
- #: app/helper/class-ai1ec-settings-helper.php:230
59
- msgid "Twice Daily"
60
  msgstr ""
61
 
62
- #: app/helper/class-ai1ec-settings-helper.php:233
63
- #: app/helper/class-ai1ec-events-helper.php:554
64
- #: app/helper/class-ai1ec-events-helper.php:573
65
- #: app/helper/class-ai1ec-events-helper.php:1457
66
- #: app/view/box_time_and_date.php:58
67
- msgid "Daily"
68
  msgstr ""
69
 
70
- #: app/helper/class-ai1ec-settings-helper.php:317
71
- msgid "Calendar"
 
 
72
  msgstr ""
73
 
74
- #: app/helper/class-ai1ec-app-helper.php:147
75
- msgctxt "Custom post type name"
76
- msgid "Events"
77
  msgstr ""
78
 
79
- #: app/helper/class-ai1ec-app-helper.php:148
80
- msgctxt "Custom post type name (singular)"
81
- msgid "Event"
82
  msgstr ""
83
 
84
- #: app/helper/class-ai1ec-app-helper.php:149
85
- msgid "Add New"
86
  msgstr ""
87
 
88
- #: app/helper/class-ai1ec-app-helper.php:150
89
- msgid "Add New Event"
90
  msgstr ""
91
 
92
- #: app/helper/class-ai1ec-app-helper.php:151
93
- msgid "Edit Event"
94
  msgstr ""
95
 
96
- #: app/helper/class-ai1ec-app-helper.php:152
97
- msgid "New Event"
 
 
98
  msgstr ""
99
 
100
- #: app/helper/class-ai1ec-app-helper.php:153
101
- msgid "View Event"
102
  msgstr ""
103
 
104
- #: app/helper/class-ai1ec-app-helper.php:154
105
- msgid "Search Events"
106
  msgstr ""
107
 
108
- #: app/helper/class-ai1ec-app-helper.php:155
109
- msgid "No Events found"
110
  msgstr ""
111
 
112
- #: app/helper/class-ai1ec-app-helper.php:156
113
- msgid "No Events found in Trash"
114
  msgstr ""
115
 
116
- #: app/helper/class-ai1ec-app-helper.php:157
117
- msgid "Parent Event"
118
  msgstr ""
119
 
120
- #: app/helper/class-ai1ec-app-helper.php:158
121
- #: app/view/agenda-widget-form.php:88
122
- msgid "Events"
123
  msgstr ""
124
 
125
- #: app/helper/class-ai1ec-app-helper.php:205
126
- msgctxt "Event categories taxonomy"
127
- msgid "Event Categories"
128
  msgstr ""
129
 
130
- #: app/helper/class-ai1ec-app-helper.php:206
131
- msgctxt "Event categories taxonomy (singular)"
132
- msgid "Event Category"
133
  msgstr ""
134
 
135
- #: app/helper/class-ai1ec-app-helper.php:213
136
- msgctxt "Event tags taxonomy"
137
- msgid "Event Tags"
138
  msgstr ""
139
 
140
- #: app/helper/class-ai1ec-app-helper.php:214
141
- msgctxt "Event tags taxonomy (singular)"
142
- msgid "Event Tag"
143
  msgstr ""
144
 
145
- #: app/helper/class-ai1ec-app-helper.php:313
146
  msgid ""
147
- "All Events <span class=\"update-plugins count-%d\" title=\"%d Pending Events"
148
- "\"><span class=\"update-count\">%d</span></span>"
149
  msgstr ""
150
 
151
- #: app/helper/class-ai1ec-app-helper.php:319
152
- msgid "All Events"
153
  msgstr ""
154
 
155
- #: app/helper/class-ai1ec-app-helper.php:395
156
- msgid "Event Details"
157
  msgstr ""
158
 
159
- #: app/helper/class-ai1ec-app-helper.php:428
160
- msgid "Post Date"
161
  msgstr ""
162
 
163
- #: app/helper/class-ai1ec-app-helper.php:429
164
- msgid "Event date/time"
165
  msgstr ""
166
 
167
- #: app/helper/class-ai1ec-app-helper.php:646
168
- msgid ""
169
- "%sTo set up the plugin: %s 1. Select an option in the <strong>Calendar page</"
170
- "strong> dropdown list. %s 2. Select an option in the <strong>Timezone</"
171
- "strong> dropdown list. %s 3. Click <strong>Update Settings</strong>. %s"
172
  msgstr ""
173
 
174
- #: app/helper/class-ai1ec-app-helper.php:648
175
- msgid ""
176
- "To set up the plugin: Select an option in the <strong>Calendar page</strong> "
177
- "dropdown list, the click <strong>Update Settings</strong>."
178
  msgstr ""
179
 
180
- #: app/helper/class-ai1ec-app-helper.php:650
181
- msgid ""
182
- "To set up the plugin: Select an option in the <strong>Timezone</strong> "
183
- "dropdown list, the click <strong>Update Settings</strong>."
184
  msgstr ""
185
 
186
- #: app/helper/class-ai1ec-app-helper.php:654
187
- msgid ""
188
- "The plugin is installed, but has not been configured. <a href=\"%s\">Click "
189
- "here to set it up now »</a>"
190
  msgstr ""
191
 
192
- #: app/helper/class-ai1ec-app-helper.php:660
193
  msgid ""
194
- "The plugin is installed, but has not been configured. Please log in as a "
195
- "WordPress Administrator to set it up."
196
- msgstr ""
197
-
198
- #: app/helper/class-ai1ec-calendar-helper.php:615
199
- msgid "« Previous Events"
200
- msgstr ""
201
-
202
- #: app/helper/class-ai1ec-calendar-helper.php:622
203
- msgid "Next Events »"
204
- msgstr ""
205
-
206
- #: app/helper/class-ai1ec-events-helper.php:319
207
- #: app/helper/class-ai1ec-events-helper.php:341
208
- msgid "No repeat"
209
- msgstr ""
210
-
211
- #: app/helper/class-ai1ec-events-helper.php:320
212
- #: app/helper/class-ai1ec-events-helper.php:342
213
- msgid "Every day"
214
  msgstr ""
215
 
216
- #: app/helper/class-ai1ec-events-helper.php:321
217
- #: app/helper/class-ai1ec-events-helper.php:343
218
- msgid "Every week"
219
  msgstr ""
220
 
221
- #: app/helper/class-ai1ec-events-helper.php:322
222
- #: app/helper/class-ai1ec-events-helper.php:344
223
- msgid "Every month"
224
  msgstr ""
225
 
226
- #: app/helper/class-ai1ec-events-helper.php:323
227
- #: app/helper/class-ai1ec-events-helper.php:345
228
- msgid "Every year"
229
  msgstr ""
230
 
231
- #: app/helper/class-ai1ec-events-helper.php:324
232
- #: app/helper/class-ai1ec-events-helper.php:346
233
- msgid "-----------"
234
  msgstr ""
235
 
236
- #: app/helper/class-ai1ec-events-helper.php:325
237
- #: app/helper/class-ai1ec-events-helper.php:347
238
- msgid "Custom..."
 
 
239
  msgstr ""
240
 
241
- #: app/helper/class-ai1ec-events-helper.php:468
242
- msgid "first"
 
 
243
  msgstr ""
244
 
245
- #: app/helper/class-ai1ec-events-helper.php:469
246
- msgid "second"
247
  msgstr ""
248
 
249
- #: app/helper/class-ai1ec-events-helper.php:470
250
- msgid "third"
 
 
251
  msgstr ""
252
 
253
- #: app/helper/class-ai1ec-events-helper.php:471
254
- msgid "fourth"
 
 
 
255
  msgstr ""
256
 
257
- #: app/helper/class-ai1ec-events-helper.php:472
258
- msgid "------"
259
  msgstr ""
260
 
261
- #: app/helper/class-ai1ec-events-helper.php:473
262
- msgid "last"
263
  msgstr ""
264
 
265
- #: app/helper/class-ai1ec-events-helper.php:478
266
- msgid "Sunday"
267
  msgstr ""
268
 
269
- #: app/helper/class-ai1ec-events-helper.php:479
270
- msgid "Monday"
271
  msgstr ""
272
 
273
- #: app/helper/class-ai1ec-events-helper.php:480
274
- msgid "Tuesday"
 
275
  msgstr ""
276
 
277
- #: app/helper/class-ai1ec-events-helper.php:481
278
- msgid "Wednesday"
 
279
  msgstr ""
280
 
281
- #: app/helper/class-ai1ec-events-helper.php:482
282
- msgid "Thursday"
 
283
  msgstr ""
284
 
285
- #: app/helper/class-ai1ec-events-helper.php:483
286
- msgid "Friday"
287
  msgstr ""
288
 
289
- #: app/helper/class-ai1ec-events-helper.php:484
290
- msgid "Saturday"
291
  msgstr ""
292
 
293
- #: app/helper/class-ai1ec-events-helper.php:485
294
- msgid "--------"
 
295
  msgstr ""
296
 
297
- #: app/helper/class-ai1ec-events-helper.php:486
298
- msgid "day"
299
  msgstr ""
300
 
301
- #: app/helper/class-ai1ec-events-helper.php:487
302
- msgid "weekday"
303
  msgstr ""
304
 
305
- #: app/helper/class-ai1ec-events-helper.php:488
306
- msgid "weekend day"
307
  msgstr ""
308
 
309
- #: app/helper/class-ai1ec-events-helper.php:555
310
- #: app/helper/class-ai1ec-events-helper.php:574
311
- #: app/helper/class-ai1ec-events-helper.php:1469
312
- #: app/view/box_time_and_date.php:59
313
- msgid "Weekly"
314
  msgstr ""
315
 
316
- #: app/helper/class-ai1ec-events-helper.php:556
317
- #: app/helper/class-ai1ec-events-helper.php:575
318
- #: app/helper/class-ai1ec-events-helper.php:1481
319
- #: app/view/box_time_and_date.php:60
320
- msgid "Monthly"
321
  msgstr ""
322
 
323
- #: app/helper/class-ai1ec-events-helper.php:557
324
- #: app/helper/class-ai1ec-events-helper.php:576
325
- #: app/helper/class-ai1ec-events-helper.php:1493
326
- #: app/view/box_time_and_date.php:61
327
- msgid "Yearly"
328
  msgstr ""
329
 
330
- #: app/helper/class-ai1ec-events-helper.php:598
331
- msgid "day(s)"
332
  msgstr ""
333
 
334
- #: app/helper/class-ai1ec-events-helper.php:627
335
- msgid "week(s)"
 
336
  msgstr ""
337
 
338
- #: app/helper/class-ai1ec-events-helper.php:679
339
- msgid "month(s)"
340
  msgstr ""
341
 
342
- #: app/helper/class-ai1ec-events-helper.php:700
343
- msgid "year(s)"
344
  msgstr ""
345
 
346
- #: app/helper/class-ai1ec-events-helper.php:1270
347
- msgid "Never"
348
  msgstr ""
349
 
350
- #: app/helper/class-ai1ec-events-helper.php:1271
351
- msgid "After"
352
  msgstr ""
353
 
354
- #: app/helper/class-ai1ec-events-helper.php:1272
355
- #: app/view/box_time_and_date.php:84
356
- msgid "On date"
357
  msgstr ""
358
 
359
- #: app/helper/class-ai1ec-events-helper.php:1351
360
- #: app/helper/class-ai1ec-events-helper.php:1360
361
- #: app/helper/class-ai1ec-events-helper.php:1368
362
- #: app/helper/class-ai1ec-events-helper.php:1381
363
- #: app/helper/class-ai1ec-events-helper.php:1388
364
- #: app/helper/class-ai1ec-events-helper.php:1394
365
- #: app/helper/class-ai1ec-events-helper.php:1408
366
- #: app/helper/class-ai1ec-events-helper.php:1416
367
- #: app/helper/class-ai1ec-events-helper.php:1423
368
- msgid "on"
369
  msgstr ""
370
 
371
- #: app/helper/class-ai1ec-events-helper.php:1356
372
- #: app/helper/class-ai1ec-events-helper.php:1385
373
- #: app/helper/class-ai1ec-events-helper.php:1413
374
- msgid "and"
375
  msgstr ""
376
 
377
- #: app/helper/class-ai1ec-events-helper.php:1381
378
- #: app/helper/class-ai1ec-events-helper.php:1388
379
- #: app/helper/class-ai1ec-events-helper.php:1394
380
- msgid "of the month"
381
  msgstr ""
382
 
383
- #: app/helper/class-ai1ec-events-helper.php:1460
384
- msgid "Every other day"
385
  msgstr ""
386
 
387
- #: app/helper/class-ai1ec-events-helper.php:1462
388
- msgid "Every %d days"
389
  msgstr ""
390
 
391
- #: app/helper/class-ai1ec-events-helper.php:1472
392
- msgid "Every other week"
393
  msgstr ""
394
 
395
- #: app/helper/class-ai1ec-events-helper.php:1474
396
- msgid "Every %d weeks"
397
  msgstr ""
398
 
399
- #: app/helper/class-ai1ec-events-helper.php:1484
400
- msgid "Every other month"
401
  msgstr ""
402
 
403
- #: app/helper/class-ai1ec-events-helper.php:1486
404
- msgid "Every %d months"
405
  msgstr ""
406
 
407
- #: app/helper/class-ai1ec-events-helper.php:1496
408
- msgid "Every other year"
 
 
 
 
409
  msgstr ""
410
 
411
- #: app/helper/class-ai1ec-events-helper.php:1498
412
- msgid "Every %d years"
 
 
 
413
  msgstr ""
414
 
415
- #: app/helper/class-ai1ec-events-helper.php:1518
416
- msgid "until %s"
 
 
 
417
  msgstr ""
418
 
419
- #: app/helper/class-ai1ec-events-helper.php:1521
420
- msgid "for %d occurrences"
 
 
 
421
  msgstr ""
422
 
423
- #: app/helper/class-ai1ec-events-helper.php:1523
424
- msgid "forever"
425
  msgstr ""
426
 
427
- #: app/controller/class-ai1ec-settings-controller.php:82
428
- msgid "Settings Updated."
429
  msgstr ""
430
 
431
- #: app/controller/class-ai1ec-settings-controller.php:173
432
- msgid "Flushed %d events"
 
433
  msgstr ""
434
 
435
- #: app/controller/class-ai1ec-settings-controller.php:215
436
- msgid "Imported %d events"
437
  msgstr ""
438
 
439
- #: app/controller/class-ai1ec-settings-controller.php:216
440
- #: app/view/feed_row.php:22
441
- msgid "Flush 1 event"
442
- msgid_plural "Flush %s events"
443
- msgstr[0] ""
444
- msgstr[1] ""
445
-
446
- #: app/controller/class-ai1ec-settings-controller.php:267
447
- msgctxt "meta box"
448
- msgid "General Settings"
449
  msgstr ""
450
 
451
- #: app/controller/class-ai1ec-settings-controller.php:275
452
- msgctxt "meta box"
453
- msgid "The Seed Studio Support"
454
  msgstr ""
455
 
456
- #: app/controller/class-ai1ec-settings-controller.php:282
457
- msgctxt "meta box"
458
- msgid "ICS Import Settings"
459
  msgstr ""
460
 
461
- #: app/controller/class-ai1ec-settings-controller.php:334
462
- msgid "<a href=\"%s\">Settings</a>"
463
  msgstr ""
464
 
465
- #: app/controller/class-ai1ec-settings-controller.php:348
466
- msgid "<a href=\"%s\" target=\"_blank\">Donate</a>"
467
  msgstr ""
468
 
469
- #: app/controller/class-ai1ec-settings-controller.php:349
470
- msgid "<a href=\"%s\" target=\"_blank\">Get Support</a>"
471
  msgstr ""
472
 
473
- #: app/controller/class-ai1ec-events-controller.php:147
474
- msgid "This feed is already being imported."
475
  msgstr ""
476
 
477
- #: app/controller/class-ai1ec-events-controller.php:148
478
- msgid "Please enter a valid iCalendar URL."
479
  msgstr ""
480
 
481
- #: app/controller/class-ai1ec-events-controller.php:276
482
- msgid "times"
483
  msgstr ""
484
 
485
- #: app/controller/class-ai1ec-events-controller.php:325
486
- msgid "Publish"
487
  msgstr ""
488
 
489
- #: app/controller/class-ai1ec-events-controller.php:325
490
- #: app/view/feed_row.php:20
491
- msgid "Update"
492
  msgstr ""
493
 
494
- #: app/controller/class-ai1ec-events-controller.php:327
495
- msgid "Submit for Review"
 
496
  msgstr ""
497
 
498
- #: app/controller/class-ai1ec-events-controller.php:440
499
- msgid "Event updated. <a href=\"%s\">View event</a>"
 
500
  msgstr ""
501
 
502
- #: app/controller/class-ai1ec-events-controller.php:441
503
- msgid "Custom field updated."
 
 
504
  msgstr ""
505
 
506
- #: app/controller/class-ai1ec-events-controller.php:442
507
- msgid "Custom field deleted."
508
  msgstr ""
509
 
510
- #: app/controller/class-ai1ec-events-controller.php:443
511
- msgid "Event updated."
512
  msgstr ""
513
 
514
- #. translators: %s: date and time of the revision
515
- #: app/controller/class-ai1ec-events-controller.php:445
516
- msgid "Event restored to revision from %s"
517
  msgstr ""
518
 
519
- #: app/controller/class-ai1ec-events-controller.php:446
520
- msgid "Event published. <a href=\"%s\">View event</a>"
521
  msgstr ""
522
 
523
- #: app/controller/class-ai1ec-events-controller.php:447
524
- msgid "Event saved."
525
  msgstr ""
526
 
527
- #: app/controller/class-ai1ec-events-controller.php:448
528
- msgid "Event submitted. <a target=\"_blank\" href=\"%s\">Preview event</a>"
529
  msgstr ""
530
 
531
- #: app/controller/class-ai1ec-events-controller.php:449
532
  msgid ""
533
- "Event scheduled for: <strong>%1$s</strong>. <a target=\"_blank\" href=\"%2$s"
534
- "\">Preview event</a>"
535
- msgstr ""
536
-
537
- #. translators: Publish box date format, see http:php.net/date
538
- #: app/controller/class-ai1ec-events-controller.php:451
539
- msgid "M j, Y @ G:i"
540
- msgstr ""
541
-
542
- #: app/controller/class-ai1ec-events-controller.php:452
543
- msgid "Event draft updated. <a target=\"_blank\" href=\"%s\">Preview event</a>"
544
  msgstr ""
545
 
546
- #: app/controller/class-ai1ec-app-controller.php:354
547
- #: app/controller/class-ai1ec-app-controller.php:355
548
- msgid "Settings"
549
  msgstr ""
550
 
551
- #: app/controller/class-ai1ec-importer-controller.php:91
552
- msgid "The Events Calendar → All-in-One Event Calendar"
553
  msgstr ""
554
 
555
- #: app/controller/class-ai1ec-importer-controller.php:92
556
- msgid ""
557
- "Imports events created using The Events Calendar plugin into the All-in-One "
558
- "Event Calendar"
559
  msgstr ""
560
 
561
- #: app/view/event-single.php:5 app/view/event-multi.php:4
562
- #: app/view/event-excerpt.php:2
563
- msgid "When:"
564
  msgstr ""
565
 
566
  #: app/view/event-single.php:8
567
  msgid "Back to Calendar »"
568
  msgstr ""
569
 
570
- #: app/view/event-single.php:15 app/view/event-multi.php:14
571
- msgid "Repeats:"
572
- msgstr ""
573
-
574
- #: app/view/event-single.php:20 app/view/event-multi.php:20
575
- #: app/view/event-excerpt.php:4
576
- msgid "Where:"
577
- msgstr ""
578
-
579
  #: app/view/event-single.php:27
580
  msgid "Add this event to your favourite calendar program (iCal, Outlook, etc.)"
581
  msgstr ""
@@ -592,128 +516,97 @@ msgstr ""
592
  msgid "Add to Google Calendar"
593
  msgstr ""
594
 
595
- #: app/view/event-single.php:40 app/view/event-multi.php:33
596
- msgid "Cost:"
597
- msgstr ""
598
-
599
- #: app/view/event-single.php:46 app/view/event-multi.php:39
600
- msgid "Contact:"
601
- msgstr ""
602
-
603
- #: app/view/event-single.php:52 app/view/event-multi.php:45
604
- #: app/view/agenda.php:80
605
- msgid "Categories:"
606
- msgstr ""
607
-
608
- #: app/view/event-single.php:59 app/view/event-multi.php:51
609
- #: app/view/agenda.php:86
610
- msgid "Tags:"
611
- msgstr ""
612
-
613
- #: app/view/event-map.php:2
614
- msgid "Click to view map"
615
- msgstr ""
616
-
617
- #: app/view/event-map.php:9
618
- msgid "View Full-Size Map »"
619
- msgstr ""
620
-
621
- #: app/view/box_event_cost.php:1
622
- msgid "Event cost"
623
- msgstr ""
624
-
625
- #: app/view/box_event_cost.php:7
626
- msgid "Cost"
627
  msgstr ""
628
 
629
- #: app/view/event-multi.php:7
630
- msgid "View in Calendar »"
631
  msgstr ""
632
 
633
- #: app/view/event-multi.php:24
634
- msgid "View Map »"
635
  msgstr ""
636
 
637
- #: app/view/admin_notices.php:2
638
- msgid "All-in-One Event Calendar Notice:"
639
  msgstr ""
640
 
641
- #: app/view/row_daily.php:3 app/view/row_yearly.php:3
642
- #: app/view/row_weekly.php:3 app/view/row_monthly.php:3
643
- msgid "Every"
644
  msgstr ""
645
 
646
- #: app/view/event_categories-color_picker.php:5
647
- #: app/view/event_categories-color_picker.php:19
648
- msgid "Category Color"
649
  msgstr ""
650
 
651
- #: app/view/event_categories-color_picker.php:13
652
- #: app/view/event_categories-color_picker.php:25
653
- msgid "Events in this category will be identified by this color"
654
  msgstr ""
655
 
656
- #: app/view/agenda-widget.php:11
657
- msgid "There are no upcoming events."
658
  msgstr ""
659
 
660
- #: app/view/agenda-widget.php:59
661
- msgid "View Calendar »"
662
  msgstr ""
663
 
664
- #: app/view/agenda-widget.php:67 app/view/calendar.php:101
665
- msgid ""
666
- "Subscribe to this calendar using your favourite calendar program (iCal, "
667
- "Outlook, etc.)"
668
  msgstr ""
669
 
670
- #: app/view/agenda-widget.php:68 app/view/calendar.php:102
671
- msgid "✔ Subscribe"
672
  msgstr ""
673
 
674
- #: app/view/agenda-widget.php:72 app/view/calendar.php:107
675
- msgid "Subscribe to this calendar in your Google Calendar"
676
  msgstr ""
677
 
678
- #: app/view/agenda-widget.php:74
679
- msgid "Add to Google"
680
  msgstr ""
681
 
682
- #: app/view/box_event_contact.php:1
683
- msgid "Organizer contact info"
684
  msgstr ""
685
 
686
- #: app/view/box_event_contact.php:7
687
- msgid "Contact name:"
688
  msgstr ""
689
 
690
- #: app/view/box_event_contact.php:17
691
- msgid "Phone:"
692
  msgstr ""
693
 
694
- #: app/view/box_event_contact.php:27
695
- msgid "E-mail:"
696
  msgstr ""
697
 
698
- #: app/view/box_ics_import_settings.php:2
699
- msgid "Auto-refresh"
700
  msgstr ""
701
 
702
- #: app/view/box_ics_import_settings.php:8 app/view/feed_row.php:3
703
- msgid "iCalendar/.ics Feed URL:"
704
  msgstr ""
705
 
706
- #: app/view/box_ics_import_settings.php:12
707
- msgid "Event category"
708
  msgstr ""
709
 
710
- #: app/view/box_ics_import_settings.php:18 app/view/feed_row.php:15
711
- msgid "Tag with"
 
712
  msgstr ""
713
 
714
- #: app/view/box_ics_import_settings.php:22
715
- msgid "+ Add new subscription"
716
- msgstr ""
 
 
 
717
 
718
  #: app/view/box_general_settings.php:1
719
  msgid "Viewing Events"
@@ -780,400 +673,559 @@ msgid "Hide <strong>Google Maps</strong> until clicked"
780
  msgstr ""
781
 
782
  #: app/view/box_general_settings.php:61
 
 
 
 
 
 
783
  msgid "Include <strong>event categories</strong> in post category lists"
784
  msgstr ""
785
 
786
- #: app/view/box_general_settings.php:65
787
  msgid "Adding/Editing Events"
788
  msgstr ""
789
 
790
- #: app/view/box_general_settings.php:67
791
  msgid "Input dates in this format:"
792
  msgstr ""
793
 
794
- #: app/view/box_general_settings.php:73
795
  msgid "Use <strong>24h time</strong> in time pickers"
796
  msgstr ""
797
 
798
- #: app/view/box_general_settings.php:79
799
  msgid "Display <strong>Publish</strong> at bottom of Edit Event form"
800
  msgstr ""
801
 
802
- #: app/view/row_yearly.php:7
803
- msgid "In"
804
  msgstr ""
805
 
806
- #: app/view/feed_row.php:9
807
- msgid "Event category:"
808
  msgstr ""
809
 
810
- #: app/view/feed_row.php:19
811
- msgid "× Delete"
812
  msgstr ""
813
 
814
- #: app/view/agenda-widget-form.php:2
815
- msgid "Title:"
816
  msgstr ""
817
 
818
- #: app/view/agenda-widget-form.php:6
819
- msgid "Number of events to show:"
820
  msgstr ""
821
 
822
- #: app/view/agenda-widget-form.php:14
823
- msgid "Events with these <strong>Categories</strong>"
824
  msgstr ""
825
 
826
- #: app/view/agenda-widget-form.php:27
827
- msgid "<strong>Or</strong> events with these <strong>Tags</strong>"
828
  msgstr ""
829
 
830
- #: app/view/agenda-widget-form.php:40
831
- msgid "<strong>Or</strong> any of these <strong>Events</strong>"
832
  msgstr ""
833
 
834
- #: app/view/agenda-widget-form.php:53
835
- msgid "Show <strong>View Calendar</strong> button"
836
  msgstr ""
837
 
838
- #: app/view/agenda-widget-form.php:56
839
- msgid "Show <strong>Subscribe</strong> buttons"
840
  msgstr ""
841
 
842
- #: app/view/agenda-widget-form.php:59
843
- msgid "Hide this widget on calendar page"
844
  msgstr ""
845
 
846
- #: app/view/agenda-widget-form.php:66
847
- msgid "Categories"
848
  msgstr ""
849
 
850
- #: app/view/agenda-widget-form.php:77
851
- msgid "Tags"
 
852
  msgstr ""
853
 
854
- #: app/view/calendar.php:27
855
- msgid "+ Post Your Event"
856
  msgstr ""
857
 
858
- #: app/view/calendar.php:36
859
- msgid "Clear Filters"
860
  msgstr ""
861
 
862
- #: app/view/calendar.php:36
863
- msgid "✘"
864
  msgstr ""
865
 
866
- #: app/view/calendar.php:37
867
- msgid "Filter:"
 
 
868
  msgstr ""
869
 
870
- #: app/view/calendar.php:42
871
- msgid "Categories ▾"
 
872
  msgstr ""
873
 
874
- #: app/view/calendar.php:64
875
- msgid "Tags ▾"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
876
  msgstr ""
877
 
878
- #: app/view/calendar.php:103
879
- msgid "to this filtered calendar"
880
  msgstr ""
881
 
882
- #: app/view/calendar.php:109
883
- msgid "Subscribe in Google Calendar"
884
  msgstr ""
885
 
886
- #: app/view/agenda.php:5
887
- msgid "+ Expand All"
888
  msgstr ""
889
 
890
- #: app/view/agenda.php:8
891
- msgid "− Collapse All"
892
  msgstr ""
893
 
894
- #: app/view/agenda.php:12 app/view/month.php:4
895
- msgid "Today"
896
  msgstr ""
897
 
898
- #: app/view/agenda.php:28
899
- msgid "There are no upcoming events to display at this time."
900
  msgstr ""
901
 
902
- #: app/view/agenda.php:58 app/view/agenda.php:108 app/view/month.php:68
903
- msgid "(all-day)"
904
  msgstr ""
905
 
906
- #: app/view/agenda.php:76
907
- msgid "Read more »"
908
  msgstr ""
909
 
910
- #: app/view/class-ai1ec-agenda-widget.php:18
911
- #: app/view/class-ai1ec-agenda-widget.php:39
912
- msgid "Upcoming Events"
913
  msgstr ""
914
 
915
- #: app/view/class-ai1ec-agenda-widget.php:20
916
- msgid "All-in-One Event Calendar: Lists upcoming events in Agenda view"
917
  msgstr ""
918
 
919
- #. #-#-#-#-# plugin.pot (All-in-One Event Calendar Plugin 1.1) #-#-#-#-#
920
- #. Author of the plugin/theme
921
- #: app/view/box_the_seed_studio.php:3
922
- msgid "The Seed Studio"
923
  msgstr ""
924
 
925
- #: app/view/box_the_seed_studio.php:5
926
- msgid ""
927
- "The Seed Studio provides web development and support services for clients "
928
- "and web developers."
929
  msgstr ""
930
 
931
- #: app/view/box_the_seed_studio.php:11
932
- msgid "Follow @the_seed_studio"
933
  msgstr ""
934
 
935
- #: app/view/box_the_seed_studio.php:16
936
- msgid "Get Support<span> from one of our experienced pros</span>"
937
  msgstr ""
938
 
939
- #: app/view/box_the_seed_studio.php:18
940
- msgid "Support"
 
 
 
941
  msgstr ""
942
 
943
- #: app/view/box_the_seed_studio.php:20
944
- msgid "View plugin documentation"
 
 
945
  msgstr ""
946
 
947
- #: app/view/box_the_seed_studio.php:23
948
- msgid ""
949
- "You can also hire The Seed for support on a contract or per-hour basis for "
950
- "this plugin, for your website or for any of your Internet marketing needs "
951
- "(we can really help!)."
 
952
  msgstr ""
953
 
954
- #: app/view/box_the_seed_studio.php:26
955
- msgid ""
956
- "Plugin users: The Seed gives support priority to clients. For free support "
957
- "from other WordPress users, visit the plugin's forum."
958
  msgstr ""
959
 
960
- #: app/view/box_the_seed_studio.php:29
961
- msgid "Vote and Share"
 
 
 
962
  msgstr ""
963
 
964
- #: app/view/box_the_seed_studio.php:32
965
- msgid ""
966
- "This plugin is offered free to the Wordpress Community under the GPL3 "
967
- "license. All we ask is that you:"
968
  msgstr ""
969
 
970
- #: app/view/box_the_seed_studio.php:34
971
- msgid ""
972
- "<a href=\"http://wordpress.org/extend/plugins/all-in-one-event-calendar/\" "
973
- "target=\"_blank\">Give it a five-star rating on wordpress.org</a> (if you "
974
- "think it deserves it!)"
975
  msgstr ""
976
 
977
- #: app/view/box_the_seed_studio.php:35
978
- msgid "Link to the plugin page on our website"
979
  msgstr ""
980
 
981
- #: app/view/box_the_seed_studio.php:36
982
- msgid "Become a Fan on Facebook"
983
  msgstr ""
984
 
985
- #: app/view/box_the_seed_studio.php:37
986
- msgid "Follow us on Twitter"
987
  msgstr ""
988
 
989
- #: app/view/box_the_seed_studio.php:41
990
- msgid "Latest from the Seed Network"
991
  msgstr ""
992
 
993
- #: app/view/box_eventbrite.php:1
994
- msgid "Eventbrite Ticketing"
995
  msgstr ""
996
 
997
- #: app/view/box_eventbrite.php:7
998
- msgid "Register this event with Eventbrite.com?"
999
  msgstr ""
1000
 
1001
- #: app/view/box_eventbrite.php:12
1002
- msgid "Yes"
1003
  msgstr ""
1004
 
1005
- #: app/view/box_eventbrite.php:14
1006
- msgid "No"
1007
  msgstr ""
1008
 
1009
- #: app/view/box_eventbrite.php:22
1010
- msgid "Set up your first ticket"
1011
  msgstr ""
1012
 
1013
- #: app/view/box_eventbrite.php:24
1014
- msgid ""
1015
- "To create multiple tickets per event, submit this form, then follow the link "
1016
- "to Eventbrite."
1017
  msgstr ""
1018
 
1019
- #: app/view/box_eventbrite.php:32
1020
- msgid "Name"
1021
  msgstr ""
1022
 
1023
- #: app/view/box_eventbrite.php:42
1024
- msgid "Description"
1025
  msgstr ""
1026
 
1027
- #: app/view/box_eventbrite.php:53
1028
- msgid "Type"
1029
  msgstr ""
1030
 
1031
- #: app/view/box_eventbrite.php:58
1032
- msgid "Set Price"
1033
  msgstr ""
1034
 
1035
- #: app/view/box_eventbrite.php:60
1036
- msgid "Donation Based"
1037
  msgstr ""
1038
 
1039
- #: app/view/box_eventbrite.php:68
1040
- msgid ""
1041
- "The price for this event's first ticket will be taken from the Cost field "
1042
- "above."
1043
  msgstr ""
1044
 
1045
- #: app/view/box_eventbrite.php:75
1046
- msgid "Quantity"
1047
  msgstr ""
1048
 
1049
- #: app/view/box_eventbrite.php:85
1050
- msgid "Include Fee in Price"
1051
  msgstr ""
1052
 
1053
- #: app/view/box_eventbrite.php:90
1054
- msgid "Add Service Fee on top of price"
1055
  msgstr ""
1056
 
1057
- #: app/view/box_eventbrite.php:92
1058
- msgid "Include Service fee in price"
1059
  msgstr ""
1060
 
1061
- #: app/view/box_eventbrite.php:98
1062
- msgid "Payment Options"
1063
  msgstr ""
1064
 
1065
- #: app/view/box_eventbrite.php:103
1066
- msgid "Paypal"
 
1067
  msgstr ""
1068
 
1069
- #: app/view/box_eventbrite.php:105
1070
- msgid "Google Checkout"
 
1071
  msgstr ""
1072
 
1073
- #: app/view/box_eventbrite.php:107
1074
- msgid "Check"
1075
  msgstr ""
1076
 
1077
- #: app/view/box_eventbrite.php:109
1078
- msgid "Cash"
1079
  msgstr ""
1080
 
1081
- #: app/view/box_eventbrite.php:111
1082
- msgid "Send an Invoice"
1083
  msgstr ""
1084
 
1085
- #: app/view/event-single-footer.php:4
1086
- msgid ""
1087
- "This post was replicated from another site's <a class=\"ai1ec-ics-icon\" "
1088
- "href=\"%s\" title=\"iCalendar feed\">calendar feed</a>."
1089
  msgstr ""
1090
 
1091
- #: app/view/event-single-footer.php:8
1092
- msgid "View original post »"
1093
  msgstr ""
1094
 
1095
- #: app/view/box_time_and_date.php:2
1096
- msgid "Event date and time"
1097
  msgstr ""
1098
 
1099
- #: app/view/box_time_and_date.php:8
1100
- msgid "All-day event"
1101
  msgstr ""
1102
 
1103
- #: app/view/box_time_and_date.php:18
1104
- msgid "Start date / time"
1105
  msgstr ""
1106
 
1107
- #: app/view/box_time_and_date.php:31
1108
- msgid "End date / time"
1109
  msgstr ""
1110
 
1111
- #: app/view/box_time_and_date.php:46
1112
- msgid "Repeat"
1113
  msgstr ""
1114
 
1115
- #: app/view/box_time_and_date.php:70
1116
- msgid "End"
 
1117
  msgstr ""
1118
 
1119
- #: app/view/box_time_and_date.php:77
1120
- msgid "Ending after"
 
1121
  msgstr ""
1122
 
1123
- #: app/view/box_time_and_date.php:92
1124
- msgid "Apply"
 
1125
  msgstr ""
1126
 
1127
- #: app/view/box_time_and_date.php:93
1128
- msgid "Cancel"
 
1129
  msgstr ""
1130
 
1131
- #: app/view/row_weekly.php:6
1132
- msgid "On"
1133
  msgstr ""
1134
 
1135
- #: app/view/row_monthly.php:7
1136
- msgid "Each"
 
 
1137
  msgstr ""
1138
 
1139
- #: app/view/settings.php:5
1140
- msgid "All-in-one Event Calendar"
1141
  msgstr ""
1142
 
1143
- #: app/view/settings.php:17
1144
- msgid "Update Settings"
1145
  msgstr ""
1146
 
1147
- #: app/view/box_event_location.php:1
1148
- msgid "Event location details"
1149
  msgstr ""
1150
 
1151
- #: app/view/box_event_location.php:7
1152
- msgid "Venue name:"
1153
  msgstr ""
1154
 
1155
- #: app/view/box_event_location.php:17
1156
- msgid "Address:"
 
 
 
1157
  msgstr ""
1158
 
1159
- #: app/view/box_event_location.php:27
1160
- msgid "Show Google Map:"
 
 
1161
  msgstr ""
1162
 
1163
- #: app/view/month.php:50
1164
- msgid "Summary:"
 
 
1165
  msgstr ""
1166
 
1167
- #: app/view/month.php:53
1168
- msgid "click anywhere for details"
 
 
1169
  msgstr ""
1170
 
1171
- #: app/view/import.php:6
1172
- msgid "Successfully imported events:"
 
 
1173
  msgstr ""
1174
 
1175
  #. Plugin Name of the plugin/theme
1176
- msgid "All-in-One Event Calendar Plugin"
1177
  msgstr ""
1178
 
1179
  #. Plugin URI of the plugin/theme
@@ -1182,7 +1234,7 @@ msgstr ""
1182
 
1183
  #. Description of the plugin/theme
1184
  msgid ""
1185
- "An event calendar system with month and agenda views, upcoming events "
1186
  "widget, color-coded categories, recurrence, and import/export of .ics feeds."
1187
  msgstr ""
1188
 
1
+ # Copyright (C) 2012 All-in-One Event Calendar
2
+ # This file is distributed under the same license as the All-in-One Event Calendar package.
3
  msgid ""
4
  msgstr ""
5
+ "Project-Id-Version: All-in-One Event Calendar 1.2.3\n"
6
  "Report-Msgid-Bugs-To: http://wordpress.org/tag/all-in-one-event-calendar\n"
7
+ "POT-Creation-Date: 2012-01-17 01:27:50+00:00\n"
8
  "MIME-Version: 1.0\n"
9
  "Content-Type: text/plain; charset=UTF-8\n"
10
  "Content-Transfer-Encoding: 8bit\n"
11
+ "PO-Revision-Date: 2012-MO-DA HO:MI+ZONE\n"
12
  "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13
  "Language-Team: LANGUAGE <LL@li.org>\n"
14
 
15
+ #: app/view/row_yearly.php:3 app/view/row_monthly.php:3
16
+ #: app/view/row_monthly.php:22 app/view/row_daily.php:3
17
+ #: app/view/row_weekly.php:3
18
+ msgid "Every"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
19
  msgstr ""
20
 
21
+ #: app/view/row_yearly.php:7
22
+ msgctxt "Recurrence editor - yearly tab"
23
+ msgid "In"
24
  msgstr ""
25
 
26
+ #: app/view/box_eventbrite.php:1
27
+ msgid "Eventbrite Ticketing"
28
  msgstr ""
29
 
30
+ #: app/view/box_eventbrite.php:7
31
+ msgid "Register this event with Eventbrite.com?"
32
  msgstr ""
33
 
34
+ #: app/view/box_eventbrite.php:12
35
+ msgid "Yes"
36
  msgstr ""
37
 
38
+ #: app/view/box_eventbrite.php:14
39
+ msgid "No"
40
  msgstr ""
41
 
42
+ #: app/view/box_eventbrite.php:22
43
+ msgid "Set up your first ticket"
 
 
 
 
44
  msgstr ""
45
 
46
+ #: app/view/box_eventbrite.php:24
47
+ msgid ""
48
+ "To create multiple tickets per event, submit this form, then follow the link "
49
+ "to Eventbrite."
50
  msgstr ""
51
 
52
+ #: app/view/box_eventbrite.php:32
53
+ msgid "Name"
 
54
  msgstr ""
55
 
56
+ #: app/view/box_eventbrite.php:42
57
+ msgid "Description"
 
58
  msgstr ""
59
 
60
+ #: app/view/box_eventbrite.php:53
61
+ msgid "Type"
62
  msgstr ""
63
 
64
+ #: app/view/box_eventbrite.php:58
65
+ msgid "Set Price"
66
  msgstr ""
67
 
68
+ #: app/view/box_eventbrite.php:60
69
+ msgid "Donation Based"
70
  msgstr ""
71
 
72
+ #: app/view/box_eventbrite.php:68
73
+ msgid ""
74
+ "The price for this event's first ticket will be taken from the Cost field "
75
+ "above."
76
  msgstr ""
77
 
78
+ #: app/view/box_eventbrite.php:75
79
+ msgid "Quantity"
80
  msgstr ""
81
 
82
+ #: app/view/box_eventbrite.php:85
83
+ msgid "Include Fee in Price"
84
  msgstr ""
85
 
86
+ #: app/view/box_eventbrite.php:90
87
+ msgid "Add Service Fee on top of price"
88
  msgstr ""
89
 
90
+ #: app/view/box_eventbrite.php:92
91
+ msgid "Include Service fee in price"
92
  msgstr ""
93
 
94
+ #: app/view/box_eventbrite.php:98
95
+ msgid "Payment Options"
96
  msgstr ""
97
 
98
+ #: app/view/box_eventbrite.php:103
99
+ msgid "Paypal"
 
100
  msgstr ""
101
 
102
+ #: app/view/box_eventbrite.php:105
103
+ msgid "Google Checkout"
 
104
  msgstr ""
105
 
106
+ #: app/view/box_eventbrite.php:107
107
+ msgid "Check"
 
108
  msgstr ""
109
 
110
+ #: app/view/box_eventbrite.php:109
111
+ msgid "Cash"
 
112
  msgstr ""
113
 
114
+ #: app/view/box_eventbrite.php:111
115
+ msgid "Send an Invoice"
 
116
  msgstr ""
117
 
118
+ #: app/view/event-single-footer.php:4
119
  msgid ""
120
+ "This post was replicated from another site's <a class=\"ai1ec-ics-icon\" "
121
+ "href=\"%s\" title=\"iCalendar feed\">calendar feed</a>."
122
  msgstr ""
123
 
124
+ #: app/view/event-single-footer.php:8
125
+ msgid "View original post »"
126
  msgstr ""
127
 
128
+ #: app/view/row_monthly.php:9
129
+ msgid "On day of the month"
130
  msgstr ""
131
 
132
+ #: app/view/row_monthly.php:13
133
+ msgid "On day of the week"
134
  msgstr ""
135
 
136
+ #: app/view/box_event_location.php:1
137
+ msgid "Event location details"
138
  msgstr ""
139
 
140
+ #: app/view/box_event_location.php:7
141
+ msgid "Venue name:"
 
 
 
142
  msgstr ""
143
 
144
+ #: app/view/box_event_location.php:17
145
+ msgid "Address:"
 
 
146
  msgstr ""
147
 
148
+ #: app/view/box_event_location.php:27
149
+ msgid "Show Google Map:"
 
 
150
  msgstr ""
151
 
152
+ #. #-#-#-#-# plugin.pot (All-in-One Event Calendar 1.2.3) #-#-#-#-#
153
+ #. Author of the plugin/theme
154
+ #: app/view/box_the_seed_studio.php:4
155
+ msgid "The Seed Studio"
156
  msgstr ""
157
 
158
+ #: app/view/box_the_seed_studio.php:7
159
  msgid ""
160
+ "The Seed Studio provides web development and support services for clients "
161
+ "and web developers."
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
162
  msgstr ""
163
 
164
+ #: app/view/box_the_seed_studio.php:14
165
+ msgid "Follow @theseednet"
 
166
  msgstr ""
167
 
168
+ #: app/view/box_the_seed_studio.php:20
169
+ msgid "Get Support<span> from one of our experienced pros</span>"
 
170
  msgstr ""
171
 
172
+ #: app/view/box_the_seed_studio.php:23
173
+ msgid "Support"
 
174
  msgstr ""
175
 
176
+ #: app/view/box_the_seed_studio.php:25
177
+ msgid "View plugin documentation"
 
178
  msgstr ""
179
 
180
+ #: app/view/box_the_seed_studio.php:28
181
+ msgid ""
182
+ "You can also hire The Seed for support on a contract or per-hour basis for "
183
+ "this plugin, for your website or for any of your Internet marketing needs "
184
+ "(we can really help!)."
185
  msgstr ""
186
 
187
+ #: app/view/box_the_seed_studio.php:31
188
+ msgid ""
189
+ "Plugin users: The Seed gives support priority to clients. For free support "
190
+ "from other WordPress users, visit the plugin's forum."
191
  msgstr ""
192
 
193
+ #: app/view/box_the_seed_studio.php:34
194
+ msgid "Vote and Share"
195
  msgstr ""
196
 
197
+ #: app/view/box_the_seed_studio.php:36
198
+ msgid ""
199
+ "This plugin is offered free to the Wordpress Community under the GPL3 "
200
+ "license. All we ask is that you:"
201
  msgstr ""
202
 
203
+ #: app/view/box_the_seed_studio.php:38
204
+ msgid ""
205
+ "<a href=\"http://wordpress.org/extend/plugins/all-in-one-event-calendar/\" "
206
+ "target=\"_blank\">Give it a five-star rating on wordpress.org</a> (if you "
207
+ "think it deserves it!)"
208
  msgstr ""
209
 
210
+ #: app/view/box_the_seed_studio.php:39
211
+ msgid "Link to the plugin page on our website"
212
  msgstr ""
213
 
214
+ #: app/view/box_the_seed_studio.php:40
215
+ msgid "Become a Fan on Facebook"
216
  msgstr ""
217
 
218
+ #: app/view/box_the_seed_studio.php:41
219
+ msgid "Follow us on Twitter"
220
  msgstr ""
221
 
222
+ #: app/view/box_the_seed_studio.php:46
223
+ msgid "Latest from the Seed Network"
224
  msgstr ""
225
 
226
+ #: app/view/event_categories-color_picker.php:5
227
+ #: app/view/event_categories-color_picker.php:19
228
+ msgid "Category Color"
229
  msgstr ""
230
 
231
+ #: app/view/event_categories-color_picker.php:13
232
+ #: app/view/event_categories-color_picker.php:25
233
+ msgid "Events in this category will be identified by this color"
234
  msgstr ""
235
 
236
+ #: app/view/event-multi.php:4 app/view/event-excerpt.php:2
237
+ #: app/view/event-single.php:5
238
+ msgid "When:"
239
  msgstr ""
240
 
241
+ #: app/view/event-multi.php:7
242
+ msgid "View in Calendar »"
243
  msgstr ""
244
 
245
+ #: app/view/event-multi.php:14 app/view/event-single.php:15
246
+ msgid "Repeats:"
247
  msgstr ""
248
 
249
+ #: app/view/event-multi.php:20 app/view/event-excerpt.php:4
250
+ #: app/view/event-single.php:20
251
+ msgid "Where:"
252
  msgstr ""
253
 
254
+ #: app/view/event-multi.php:24
255
+ msgid "View Map »"
256
  msgstr ""
257
 
258
+ #: app/view/event-multi.php:33 app/view/event-single.php:40
259
+ msgid "Cost:"
260
  msgstr ""
261
 
262
+ #: app/view/event-multi.php:39 app/view/event-single.php:46
263
+ msgid "Contact:"
264
  msgstr ""
265
 
266
+ #: app/view/event-multi.php:45 app/view/agenda.php:81
267
+ #: app/view/event-single.php:52
268
+ msgid "Categories:"
 
 
269
  msgstr ""
270
 
271
+ #: app/view/event-multi.php:51 app/view/agenda.php:87
272
+ #: app/view/event-single.php:59
273
+ msgid "Tags:"
 
 
274
  msgstr ""
275
 
276
+ #: app/view/class-ai1ec-agenda-widget.php:18
277
+ #: app/view/class-ai1ec-agenda-widget.php:39
278
+ msgid "Upcoming Events"
 
 
279
  msgstr ""
280
 
281
+ #: app/view/class-ai1ec-agenda-widget.php:20
282
+ msgid "All-in-One Event Calendar: Lists upcoming events in Agenda view"
283
  msgstr ""
284
 
285
+ #: app/view/row_weekly.php:6
286
+ msgctxt "Recurrence editor - weekly tab"
287
+ msgid "On"
288
  msgstr ""
289
 
290
+ #: app/view/agenda.php:5
291
+ msgid "+ Expand All"
292
  msgstr ""
293
 
294
+ #: app/view/agenda.php:8
295
+ msgid "− Collapse All"
296
  msgstr ""
297
 
298
+ #: app/view/agenda.php:12 app/view/week.php:4 app/view/month.php:4
299
+ msgid "Today"
300
  msgstr ""
301
 
302
+ #: app/view/agenda.php:29
303
+ msgid "There are no upcoming events to display at this time."
304
  msgstr ""
305
 
306
+ #: app/view/agenda.php:59 app/view/agenda.php:109 app/view/week.php:69
307
+ #: app/view/month.php:68
308
+ msgid "(all-day)"
309
  msgstr ""
310
 
311
+ #: app/view/agenda.php:77
312
+ msgid "Read more »"
 
 
 
 
 
 
 
 
313
  msgstr ""
314
 
315
+ #: app/view/box_event_cost.php:1
316
+ msgid "Event cost"
 
 
317
  msgstr ""
318
 
319
+ #: app/view/box_event_cost.php:7
320
+ msgid "Cost"
 
 
321
  msgstr ""
322
 
323
+ #: app/view/admin_notices.php:2
324
+ msgid "All-in-One Event Calendar Notice:"
325
  msgstr ""
326
 
327
+ #: app/view/box_time_and_date.php:2
328
+ msgid "Event date and time"
329
  msgstr ""
330
 
331
+ #: app/view/box_time_and_date.php:8
332
+ msgid "All-day event"
333
  msgstr ""
334
 
335
+ #: app/view/box_time_and_date.php:18
336
+ msgid "Start date / time"
337
  msgstr ""
338
 
339
+ #: app/view/box_time_and_date.php:31
340
+ msgid "End date / time"
341
  msgstr ""
342
 
343
+ #: app/view/box_time_and_date.php:46
344
+ msgid "Repeat"
345
  msgstr ""
346
 
347
+ #: app/view/box_time_and_date.php:58
348
+ #: app/helper/class-ai1ec-events-helper.php:554
349
+ #: app/helper/class-ai1ec-events-helper.php:573
350
+ #: app/helper/class-ai1ec-events-helper.php:1502
351
+ #: app/helper/class-ai1ec-settings-helper.php:237
352
+ msgid "Daily"
353
  msgstr ""
354
 
355
+ #: app/view/box_time_and_date.php:59
356
+ #: app/helper/class-ai1ec-events-helper.php:555
357
+ #: app/helper/class-ai1ec-events-helper.php:574
358
+ #: app/helper/class-ai1ec-events-helper.php:1514
359
+ msgid "Weekly"
360
  msgstr ""
361
 
362
+ #: app/view/box_time_and_date.php:60
363
+ #: app/helper/class-ai1ec-events-helper.php:556
364
+ #: app/helper/class-ai1ec-events-helper.php:575
365
+ #: app/helper/class-ai1ec-events-helper.php:1526
366
+ msgid "Monthly"
367
  msgstr ""
368
 
369
+ #: app/view/box_time_and_date.php:61
370
+ #: app/helper/class-ai1ec-events-helper.php:557
371
+ #: app/helper/class-ai1ec-events-helper.php:576
372
+ #: app/helper/class-ai1ec-events-helper.php:1538
373
+ msgid "Yearly"
374
  msgstr ""
375
 
376
+ #: app/view/box_time_and_date.php:70
377
+ msgid "End"
378
  msgstr ""
379
 
380
+ #: app/view/box_time_and_date.php:77
381
+ msgid "Ending after"
382
  msgstr ""
383
 
384
+ #: app/view/box_time_and_date.php:84
385
+ #: app/helper/class-ai1ec-events-helper.php:1302
386
+ msgid "On date"
387
  msgstr ""
388
 
389
+ #: app/view/box_time_and_date.php:92
390
+ msgid "Apply"
391
  msgstr ""
392
 
393
+ #: app/view/box_time_and_date.php:93
394
+ msgid "Cancel"
 
 
 
 
 
 
 
 
395
  msgstr ""
396
 
397
+ #: app/view/box_event_contact.php:1
398
+ msgid "Organizer contact info"
 
399
  msgstr ""
400
 
401
+ #: app/view/box_event_contact.php:7
402
+ msgid "Contact name:"
 
403
  msgstr ""
404
 
405
+ #: app/view/box_event_contact.php:17
406
+ msgid "Phone:"
407
  msgstr ""
408
 
409
+ #: app/view/box_event_contact.php:27
410
+ msgid "E-mail:"
411
  msgstr ""
412
 
413
+ #: app/view/week.php:33
414
+ msgid "All-day"
415
  msgstr ""
416
 
417
+ #: app/view/week.php:55 app/view/week.php:127 app/view/month.php:50
418
+ msgid "Summary:"
419
  msgstr ""
420
 
421
+ #: app/view/week.php:58 app/view/week.php:130 app/view/month.php:53
422
+ msgid "click anywhere for details"
423
  msgstr ""
424
 
425
+ #: app/view/settings.php:5
426
+ msgid "All-in-one Event Calendar"
427
  msgstr ""
428
 
429
+ #: app/view/settings.php:16
430
+ msgid "Update Settings"
431
  msgstr ""
432
 
433
+ #: app/view/import.php:6
434
+ msgid "Successfully imported events:"
 
435
  msgstr ""
436
 
437
+ #: app/view/calendar.php:11 app/view/calendar.php:12 app/view/calendar.php:25
438
+ #: app/helper/class-ai1ec-settings-helper.php:149
439
+ msgid "Month"
440
  msgstr ""
441
 
442
+ #: app/view/calendar.php:18 app/view/calendar.php:19
443
+ #: app/helper/class-ai1ec-settings-helper.php:152
444
+ msgid "Week"
445
  msgstr ""
446
 
447
+ #: app/view/calendar.php:26
448
+ #: app/controller/class-ai1ec-calendar-controller.php:383
449
+ #: app/helper/class-ai1ec-settings-helper.php:155
450
+ msgid "Agenda"
451
  msgstr ""
452
 
453
+ #: app/view/calendar.php:35
454
+ msgid "+ Post Your Event"
455
  msgstr ""
456
 
457
+ #: app/view/calendar.php:44
458
+ msgid "Clear Filters"
459
  msgstr ""
460
 
461
+ #: app/view/calendar.php:44
462
+ msgid "✘"
 
463
  msgstr ""
464
 
465
+ #: app/view/calendar.php:45
466
+ msgid "Filter:"
467
  msgstr ""
468
 
469
+ #: app/view/calendar.php:50
470
+ msgid "Categories ▾"
471
  msgstr ""
472
 
473
+ #: app/view/calendar.php:72
474
+ msgid "Tags ▾"
475
  msgstr ""
476
 
477
+ #: app/view/calendar.php:110 app/view/agenda-widget.php:67
478
  msgid ""
479
+ "Subscribe to this calendar using your favourite calendar program (iCal, "
480
+ "Outlook, etc.)"
 
 
 
 
 
 
 
 
 
481
  msgstr ""
482
 
483
+ #: app/view/calendar.php:111 app/view/agenda-widget.php:68
484
+ msgid "✔ Subscribe"
 
485
  msgstr ""
486
 
487
+ #: app/view/calendar.php:112
488
+ msgid "to this filtered calendar"
489
  msgstr ""
490
 
491
+ #: app/view/calendar.php:116 app/view/agenda-widget.php:72
492
+ msgid "Subscribe to this calendar in your Google Calendar"
 
 
493
  msgstr ""
494
 
495
+ #: app/view/calendar.php:118
496
+ msgid "Subscribe in Google Calendar"
 
497
  msgstr ""
498
 
499
  #: app/view/event-single.php:8
500
  msgid "Back to Calendar »"
501
  msgstr ""
502
 
 
 
 
 
 
 
 
 
 
503
  #: app/view/event-single.php:27
504
  msgid "Add this event to your favourite calendar program (iCal, Outlook, etc.)"
505
  msgstr ""
516
  msgid "Add to Google Calendar"
517
  msgstr ""
518
 
519
+ #: app/view/box_ics_import_settings.php:2
520
+ msgid "Auto-refresh"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
521
  msgstr ""
522
 
523
+ #: app/view/box_ics_import_settings.php:8 app/view/feed_row.php:3
524
+ msgid "iCalendar/.ics Feed URL:"
525
  msgstr ""
526
 
527
+ #: app/view/box_ics_import_settings.php:12
528
+ msgid "Event category"
529
  msgstr ""
530
 
531
+ #: app/view/box_ics_import_settings.php:18 app/view/feed_row.php:15
532
+ msgid "Tag with"
533
  msgstr ""
534
 
535
+ #: app/view/box_ics_import_settings.php:22
536
+ msgid "+ Add new subscription"
 
537
  msgstr ""
538
 
539
+ #: app/view/event-map.php:2
540
+ msgid "Click to view map"
 
541
  msgstr ""
542
 
543
+ #: app/view/event-map.php:9
544
+ msgid "View Full-Size Map »"
 
545
  msgstr ""
546
 
547
+ #: app/view/agenda-widget-form.php:2
548
+ msgid "Title:"
549
  msgstr ""
550
 
551
+ #: app/view/agenda-widget-form.php:6
552
+ msgid "Number of events to show:"
553
  msgstr ""
554
 
555
+ #: app/view/agenda-widget-form.php:14
556
+ msgid "Events with these <strong>Categories</strong>"
 
 
557
  msgstr ""
558
 
559
+ #: app/view/agenda-widget-form.php:23
560
+ msgid "No categories found."
561
  msgstr ""
562
 
563
+ #: app/view/agenda-widget-form.php:30
564
+ msgid "<strong>Or</strong> events with these <strong>Tags</strong>"
565
  msgstr ""
566
 
567
+ #: app/view/agenda-widget-form.php:39
568
+ msgid "No tags found."
569
  msgstr ""
570
 
571
+ #: app/view/agenda-widget-form.php:46
572
+ msgid "<strong>Or</strong> any of these <strong>Events</strong>"
573
  msgstr ""
574
 
575
+ #: app/view/agenda-widget-form.php:55
576
+ msgid "No events found."
577
  msgstr ""
578
 
579
+ #: app/view/agenda-widget-form.php:62
580
+ msgid "Show <strong>View Calendar</strong> button"
581
  msgstr ""
582
 
583
+ #: app/view/agenda-widget-form.php:65
584
+ msgid "Show <strong>Subscribe</strong> buttons"
585
  msgstr ""
586
 
587
+ #: app/view/agenda-widget-form.php:68
588
+ msgid "Hide this widget on calendar page"
589
  msgstr ""
590
 
591
+ #: app/view/feed_row.php:9
592
+ msgid "Event category:"
593
  msgstr ""
594
 
595
+ #: app/view/feed_row.php:19
596
+ msgid "× Delete"
597
  msgstr ""
598
 
599
+ #: app/view/feed_row.php:20
600
+ #: app/controller/class-ai1ec-events-controller.php:334
601
+ msgid "Update"
602
  msgstr ""
603
 
604
+ #: app/view/feed_row.php:22
605
+ #: app/controller/class-ai1ec-settings-controller.php:222
606
+ msgid "Flush 1 event"
607
+ msgid_plural "Flush %s events"
608
+ msgstr[0] ""
609
+ msgstr[1] ""
610
 
611
  #: app/view/box_general_settings.php:1
612
  msgid "Viewing Events"
673
  msgstr ""
674
 
675
  #: app/view/box_general_settings.php:61
676
+ msgid ""
677
+ "Use the configured <strong>region</strong> (WordPress locale) to bias the "
678
+ "address autocomplete function"
679
+ msgstr ""
680
+
681
+ #: app/view/box_general_settings.php:67
682
  msgid "Include <strong>event categories</strong> in post category lists"
683
  msgstr ""
684
 
685
+ #: app/view/box_general_settings.php:71
686
  msgid "Adding/Editing Events"
687
  msgstr ""
688
 
689
+ #: app/view/box_general_settings.php:73
690
  msgid "Input dates in this format:"
691
  msgstr ""
692
 
693
+ #: app/view/box_general_settings.php:79
694
  msgid "Use <strong>24h time</strong> in time pickers"
695
  msgstr ""
696
 
697
+ #: app/view/box_general_settings.php:85
698
  msgid "Display <strong>Publish</strong> at bottom of Edit Event form"
699
  msgstr ""
700
 
701
+ #: app/view/agenda-widget.php:11
702
+ msgid "There are no upcoming events."
703
  msgstr ""
704
 
705
+ #: app/view/agenda-widget.php:59
706
+ msgid "View Calendar »"
707
  msgstr ""
708
 
709
+ #: app/view/agenda-widget.php:74
710
+ msgid "Add to Google"
711
  msgstr ""
712
 
713
+ #: app/controller/class-ai1ec-events-controller.php:149
714
+ msgid "This feed is already being imported."
715
  msgstr ""
716
 
717
+ #: app/controller/class-ai1ec-events-controller.php:150
718
+ msgid "Please enter a valid iCalendar URL."
719
  msgstr ""
720
 
721
+ #: app/controller/class-ai1ec-events-controller.php:285
722
+ msgid "times"
723
  msgstr ""
724
 
725
+ #: app/controller/class-ai1ec-events-controller.php:334
726
+ msgid "Publish"
727
  msgstr ""
728
 
729
+ #: app/controller/class-ai1ec-events-controller.php:336
730
+ msgid "Submit for Review"
731
  msgstr ""
732
 
733
+ #: app/controller/class-ai1ec-events-controller.php:449
734
+ msgid "Event updated. <a href=\"%s\">View event</a>"
735
  msgstr ""
736
 
737
+ #: app/controller/class-ai1ec-events-controller.php:450
738
+ msgid "Custom field updated."
739
  msgstr ""
740
 
741
+ #: app/controller/class-ai1ec-events-controller.php:451
742
+ msgid "Custom field deleted."
743
  msgstr ""
744
 
745
+ #: app/controller/class-ai1ec-events-controller.php:452
746
+ msgid "Event updated."
747
  msgstr ""
748
 
749
+ #. translators: %s: date and time of the revision
750
+ #: app/controller/class-ai1ec-events-controller.php:454
751
+ msgid "Event restored to revision from %s"
752
  msgstr ""
753
 
754
+ #: app/controller/class-ai1ec-events-controller.php:455
755
+ msgid "Event published. <a href=\"%s\">View event</a>"
756
  msgstr ""
757
 
758
+ #: app/controller/class-ai1ec-events-controller.php:456
759
+ msgid "Event saved."
760
  msgstr ""
761
 
762
+ #: app/controller/class-ai1ec-events-controller.php:457
763
+ msgid "Event submitted. <a target=\"_blank\" href=\"%s\">Preview event</a>"
764
  msgstr ""
765
 
766
+ #: app/controller/class-ai1ec-events-controller.php:458
767
+ msgid ""
768
+ "Event scheduled for: <strong>%1$s</strong>. <a target=\"_blank\" href=\"%2$s"
769
+ "\">Preview event</a>"
770
  msgstr ""
771
 
772
+ #. translators: Publish box date format, see http:php.net/date
773
+ #: app/controller/class-ai1ec-events-controller.php:460
774
+ msgid "M j, Y @ G:i"
775
  msgstr ""
776
 
777
+ #: app/controller/class-ai1ec-events-controller.php:461
778
+ msgid "Event draft updated. <a target=\"_blank\" href=\"%s\">Preview event</a>"
779
+ msgstr ""
780
+
781
+ #: app/controller/class-ai1ec-importer-controller.php:91
782
+ msgid "The Events Calendar → All-in-One Event Calendar"
783
+ msgstr ""
784
+
785
+ #: app/controller/class-ai1ec-importer-controller.php:92
786
+ msgid ""
787
+ "Imports events created using The Events Calendar plugin into the All-in-One "
788
+ "Event Calendar"
789
+ msgstr ""
790
+
791
+ #: app/controller/class-ai1ec-app-controller.php:354
792
+ #: app/controller/class-ai1ec-app-controller.php:355
793
+ msgid "Settings"
794
+ msgstr ""
795
+
796
+ #. translators: "%s" represents the week's starting date
797
+ #: app/controller/class-ai1ec-calendar-controller.php:326
798
+ #: app/helper/class-ai1ec-calendar-helper.php:717
799
+ #: app/helper/class-ai1ec-calendar-helper.php:726
800
+ msgid "Week of %s"
801
+ msgstr ""
802
+
803
+ #: app/controller/class-ai1ec-calendar-controller.php:326
804
+ msgid "F j"
805
+ msgstr ""
806
+
807
+ #: app/controller/class-ai1ec-settings-controller.php:82
808
+ msgid "Settings Updated."
809
+ msgstr ""
810
+
811
+ #: app/controller/class-ai1ec-settings-controller.php:173
812
+ msgid "Flushed %d events"
813
+ msgstr ""
814
+
815
+ #: app/controller/class-ai1ec-settings-controller.php:181
816
+ #: app/controller/class-ai1ec-settings-controller.php:231
817
+ msgid "Invalid ICS feed ID"
818
+ msgstr ""
819
+
820
+ #: app/controller/class-ai1ec-settings-controller.php:216
821
+ msgid "No events were found"
822
+ msgstr ""
823
+
824
+ #: app/controller/class-ai1ec-settings-controller.php:221
825
+ msgid "Imported %d events"
826
+ msgstr ""
827
+
828
+ #: app/controller/class-ai1ec-settings-controller.php:274
829
+ msgctxt "meta box"
830
+ msgid "General Settings"
831
+ msgstr ""
832
+
833
+ #: app/controller/class-ai1ec-settings-controller.php:282
834
+ msgctxt "meta box"
835
+ msgid "The Seed Studio Support"
836
+ msgstr ""
837
+
838
+ #: app/controller/class-ai1ec-settings-controller.php:289
839
+ msgctxt "meta box"
840
+ msgid "ICS Import Settings"
841
+ msgstr ""
842
+
843
+ #: app/controller/class-ai1ec-settings-controller.php:338
844
+ msgid "<a href=\"%s\">Settings</a>"
845
+ msgstr ""
846
+
847
+ #: app/controller/class-ai1ec-settings-controller.php:352
848
+ msgid "<a href=\"%s\" target=\"_blank\">Donate</a>"
849
+ msgstr ""
850
+
851
+ #: app/controller/class-ai1ec-settings-controller.php:353
852
+ msgid "<a href=\"%s\" target=\"_blank\">Get Support</a>"
853
+ msgstr ""
854
+
855
+ #: app/model/class-ai1ec-event.php:486
856
+ msgid " (all-day)"
857
+ msgstr ""
858
+
859
+ #: app/helper/class-ai1ec-events-helper.php:319
860
+ #: app/helper/class-ai1ec-events-helper.php:341
861
+ msgid "No repeat"
862
+ msgstr ""
863
+
864
+ #: app/helper/class-ai1ec-events-helper.php:320
865
+ #: app/helper/class-ai1ec-events-helper.php:342
866
+ msgid "Every day"
867
+ msgstr ""
868
+
869
+ #: app/helper/class-ai1ec-events-helper.php:321
870
+ #: app/helper/class-ai1ec-events-helper.php:343
871
+ msgid "Every week"
872
+ msgstr ""
873
+
874
+ #: app/helper/class-ai1ec-events-helper.php:322
875
+ #: app/helper/class-ai1ec-events-helper.php:344
876
+ msgid "Every month"
877
+ msgstr ""
878
+
879
+ #: app/helper/class-ai1ec-events-helper.php:323
880
+ #: app/helper/class-ai1ec-events-helper.php:345
881
+ msgid "Every year"
882
+ msgstr ""
883
+
884
+ #: app/helper/class-ai1ec-events-helper.php:325
885
+ #: app/helper/class-ai1ec-events-helper.php:347
886
+ msgid "Custom..."
887
+ msgstr ""
888
+
889
+ #: app/helper/class-ai1ec-events-helper.php:468
890
+ msgid "first"
891
+ msgstr ""
892
+
893
+ #: app/helper/class-ai1ec-events-helper.php:469
894
+ msgid "second"
895
+ msgstr ""
896
+
897
+ #: app/helper/class-ai1ec-events-helper.php:470
898
+ msgid "third"
899
+ msgstr ""
900
+
901
+ #: app/helper/class-ai1ec-events-helper.php:471
902
+ msgid "fourth"
903
+ msgstr ""
904
+
905
+ #: app/helper/class-ai1ec-events-helper.php:473
906
+ msgid "last"
907
+ msgstr ""
908
+
909
+ #: app/helper/class-ai1ec-events-helper.php:478
910
+ msgid "Sunday"
911
+ msgstr ""
912
+
913
+ #: app/helper/class-ai1ec-events-helper.php:479
914
+ msgid "Monday"
915
  msgstr ""
916
 
917
+ #: app/helper/class-ai1ec-events-helper.php:480
918
+ msgid "Tuesday"
919
  msgstr ""
920
 
921
+ #: app/helper/class-ai1ec-events-helper.php:481
922
+ msgid "Wednesday"
923
  msgstr ""
924
 
925
+ #: app/helper/class-ai1ec-events-helper.php:482
926
+ msgid "Thursday"
927
  msgstr ""
928
 
929
+ #: app/helper/class-ai1ec-events-helper.php:483
930
+ msgid "Friday"
931
  msgstr ""
932
 
933
+ #: app/helper/class-ai1ec-events-helper.php:484
934
+ msgid "Saturday"
935
  msgstr ""
936
 
937
+ #: app/helper/class-ai1ec-events-helper.php:486
938
+ msgid "day"
939
  msgstr ""
940
 
941
+ #: app/helper/class-ai1ec-events-helper.php:487
942
+ msgid "weekday"
943
  msgstr ""
944
 
945
+ #: app/helper/class-ai1ec-events-helper.php:488
946
+ msgid "weekend day"
947
  msgstr ""
948
 
949
+ #: app/helper/class-ai1ec-events-helper.php:598
950
+ msgid "day(s)"
 
951
  msgstr ""
952
 
953
+ #: app/helper/class-ai1ec-events-helper.php:627
954
+ msgid "week(s)"
955
  msgstr ""
956
 
957
+ #: app/helper/class-ai1ec-events-helper.php:697
958
+ msgid "month(s)"
 
 
959
  msgstr ""
960
 
961
+ #: app/helper/class-ai1ec-events-helper.php:720
962
+ msgid "year(s)"
 
 
963
  msgstr ""
964
 
965
+ #: app/helper/class-ai1ec-events-helper.php:1300
966
+ msgid "Never"
967
  msgstr ""
968
 
969
+ #: app/helper/class-ai1ec-events-helper.php:1301
970
+ msgid "After"
971
  msgstr ""
972
 
973
+ #: app/helper/class-ai1ec-events-helper.php:1381
974
+ #: app/helper/class-ai1ec-events-helper.php:1390
975
+ #: app/helper/class-ai1ec-events-helper.php:1398
976
+ msgctxt "Recurrence editor - weekly tab"
977
+ msgid "on"
978
  msgstr ""
979
 
980
+ #: app/helper/class-ai1ec-events-helper.php:1386
981
+ #: app/helper/class-ai1ec-events-helper.php:1415
982
+ #: app/helper/class-ai1ec-events-helper.php:1453
983
+ msgid "and"
984
  msgstr ""
985
 
986
+ #: app/helper/class-ai1ec-events-helper.php:1411
987
+ #: app/helper/class-ai1ec-events-helper.php:1418
988
+ #: app/helper/class-ai1ec-events-helper.php:1424
989
+ #: app/helper/class-ai1ec-events-helper.php:1435
990
+ msgctxt "Recurrence editor - monthly tab"
991
+ msgid "on"
992
  msgstr ""
993
 
994
+ #: app/helper/class-ai1ec-events-helper.php:1411
995
+ #: app/helper/class-ai1ec-events-helper.php:1418
996
+ #: app/helper/class-ai1ec-events-helper.php:1424
997
+ msgid "of the month"
998
  msgstr ""
999
 
1000
+ #: app/helper/class-ai1ec-events-helper.php:1448
1001
+ #: app/helper/class-ai1ec-events-helper.php:1456
1002
+ #: app/helper/class-ai1ec-events-helper.php:1463
1003
+ msgctxt "Recurrence editor - yearly tab"
1004
+ msgid "on"
1005
  msgstr ""
1006
 
1007
+ #: app/helper/class-ai1ec-events-helper.php:1505
1008
+ msgid "Every other day"
 
 
1009
  msgstr ""
1010
 
1011
+ #: app/helper/class-ai1ec-events-helper.php:1507
1012
+ msgid "Every %d days"
 
 
 
1013
  msgstr ""
1014
 
1015
+ #: app/helper/class-ai1ec-events-helper.php:1517
1016
+ msgid "Every other week"
1017
  msgstr ""
1018
 
1019
+ #: app/helper/class-ai1ec-events-helper.php:1519
1020
+ msgid "Every %d weeks"
1021
  msgstr ""
1022
 
1023
+ #: app/helper/class-ai1ec-events-helper.php:1529
1024
+ msgid "Every other month"
1025
  msgstr ""
1026
 
1027
+ #: app/helper/class-ai1ec-events-helper.php:1531
1028
+ msgid "Every %d months"
1029
  msgstr ""
1030
 
1031
+ #: app/helper/class-ai1ec-events-helper.php:1541
1032
+ msgid "Every other year"
1033
  msgstr ""
1034
 
1035
+ #: app/helper/class-ai1ec-events-helper.php:1543
1036
+ msgid "Every %d years"
1037
  msgstr ""
1038
 
1039
+ #: app/helper/class-ai1ec-events-helper.php:1563
1040
+ msgid "until %s"
1041
  msgstr ""
1042
 
1043
+ #: app/helper/class-ai1ec-events-helper.php:1566
1044
+ msgid "for %d occurrences"
1045
  msgstr ""
1046
 
1047
+ #: app/helper/class-ai1ec-events-helper.php:1568
1048
+ msgid "forever"
1049
  msgstr ""
1050
 
1051
+ #: app/helper/class-ai1ec-calendar-helper.php:718
1052
+ #: app/helper/class-ai1ec-calendar-helper.php:727
1053
+ msgid "M j"
 
1054
  msgstr ""
1055
 
1056
+ #: app/helper/class-ai1ec-calendar-helper.php:759
1057
+ msgid "« Previous Events"
1058
  msgstr ""
1059
 
1060
+ #: app/helper/class-ai1ec-calendar-helper.php:766
1061
+ msgid "Next Events »"
1062
  msgstr ""
1063
 
1064
+ #: app/helper/class-ai1ec-settings-helper.php:85
1065
+ msgid "- Auto-Create New Page -"
1066
  msgstr ""
1067
 
1068
+ #: app/helper/class-ai1ec-settings-helper.php:107
1069
+ msgid "View \"%s\" »"
1070
  msgstr ""
1071
 
1072
+ #: app/helper/class-ai1ec-settings-helper.php:204
1073
+ msgid "Default (d/m/y)"
1074
  msgstr ""
1075
 
1076
+ #: app/helper/class-ai1ec-settings-helper.php:207
1077
+ msgid "US (m/d/y)"
 
 
1078
  msgstr ""
1079
 
1080
+ #: app/helper/class-ai1ec-settings-helper.php:210
1081
+ msgid "ISO 8601 (y-m-d)"
1082
  msgstr ""
1083
 
1084
+ #: app/helper/class-ai1ec-settings-helper.php:213
1085
+ msgid "Dotted (m.d.y)"
1086
  msgstr ""
1087
 
1088
+ #: app/helper/class-ai1ec-settings-helper.php:231
1089
+ msgid "Hourly"
1090
  msgstr ""
1091
 
1092
+ #: app/helper/class-ai1ec-settings-helper.php:234
1093
+ msgid "Twice Daily"
1094
  msgstr ""
1095
 
1096
+ #: app/helper/class-ai1ec-settings-helper.php:321
1097
+ msgid "Calendar"
1098
  msgstr ""
1099
 
1100
+ #: app/helper/class-ai1ec-app-helper.php:147
1101
+ msgctxt "Custom post type name"
1102
+ msgid "Events"
1103
  msgstr ""
1104
 
1105
+ #: app/helper/class-ai1ec-app-helper.php:148
1106
+ msgctxt "Custom post type name (singular)"
1107
+ msgid "Event"
1108
  msgstr ""
1109
 
1110
+ #: app/helper/class-ai1ec-app-helper.php:149
1111
+ msgid "Add New"
1112
  msgstr ""
1113
 
1114
+ #: app/helper/class-ai1ec-app-helper.php:150
1115
+ msgid "Add New Event"
1116
  msgstr ""
1117
 
1118
+ #: app/helper/class-ai1ec-app-helper.php:151
1119
+ msgid "Edit Event"
1120
  msgstr ""
1121
 
1122
+ #: app/helper/class-ai1ec-app-helper.php:152
1123
+ msgid "New Event"
 
 
1124
  msgstr ""
1125
 
1126
+ #: app/helper/class-ai1ec-app-helper.php:153
1127
+ msgid "View Event"
1128
  msgstr ""
1129
 
1130
+ #: app/helper/class-ai1ec-app-helper.php:154
1131
+ msgid "Search Events"
1132
  msgstr ""
1133
 
1134
+ #: app/helper/class-ai1ec-app-helper.php:155
1135
+ msgid "No Events found"
1136
  msgstr ""
1137
 
1138
+ #: app/helper/class-ai1ec-app-helper.php:156
1139
+ msgid "No Events found in Trash"
1140
  msgstr ""
1141
 
1142
+ #: app/helper/class-ai1ec-app-helper.php:157
1143
+ msgid "Parent Event"
1144
  msgstr ""
1145
 
1146
+ #: app/helper/class-ai1ec-app-helper.php:158
1147
+ msgid "Events"
1148
  msgstr ""
1149
 
1150
+ #: app/helper/class-ai1ec-app-helper.php:205
1151
+ msgctxt "Event categories taxonomy"
1152
+ msgid "Event Categories"
1153
  msgstr ""
1154
 
1155
+ #: app/helper/class-ai1ec-app-helper.php:206
1156
+ msgctxt "Event categories taxonomy (singular)"
1157
+ msgid "Event Category"
1158
  msgstr ""
1159
 
1160
+ #: app/helper/class-ai1ec-app-helper.php:213
1161
+ msgctxt "Event tags taxonomy"
1162
+ msgid "Event Tags"
1163
  msgstr ""
1164
 
1165
+ #: app/helper/class-ai1ec-app-helper.php:214
1166
+ msgctxt "Event tags taxonomy (singular)"
1167
+ msgid "Event Tag"
1168
  msgstr ""
1169
 
1170
+ #: app/helper/class-ai1ec-app-helper.php:281
1171
+ msgid "Show All "
1172
  msgstr ""
1173
 
1174
+ #: app/helper/class-ai1ec-app-helper.php:313
1175
+ msgid ""
1176
+ "All Events <span class=\"update-plugins count-%d\" title=\"%d Pending Events"
1177
+ "\"><span class=\"update-count\">%d</span></span>"
1178
  msgstr ""
1179
 
1180
+ #: app/helper/class-ai1ec-app-helper.php:319
1181
+ msgid "All Events"
1182
  msgstr ""
1183
 
1184
+ #: app/helper/class-ai1ec-app-helper.php:395
1185
+ msgid "Event Details"
1186
  msgstr ""
1187
 
1188
+ #: app/helper/class-ai1ec-app-helper.php:428
1189
+ msgid "Post Date"
1190
  msgstr ""
1191
 
1192
+ #: app/helper/class-ai1ec-app-helper.php:429
1193
+ msgid "Event date/time"
1194
  msgstr ""
1195
 
1196
+ #: app/helper/class-ai1ec-app-helper.php:653
1197
+ msgid ""
1198
+ "%sTo set up the plugin: %s 1. Select an option in the <strong>Calendar page</"
1199
+ "strong> dropdown list. %s 2. Select an option in the <strong>Timezone</"
1200
+ "strong> dropdown list. %s 3. Click <strong>Update Settings</strong>. %s"
1201
  msgstr ""
1202
 
1203
+ #: app/helper/class-ai1ec-app-helper.php:655
1204
+ msgid ""
1205
+ "To set up the plugin: Select an option in the <strong>Calendar page</strong> "
1206
+ "dropdown list, the click <strong>Update Settings</strong>."
1207
  msgstr ""
1208
 
1209
+ #: app/helper/class-ai1ec-app-helper.php:657
1210
+ msgid ""
1211
+ "To set up the plugin: Select an option in the <strong>Timezone</strong> "
1212
+ "dropdown list, the click <strong>Update Settings</strong>."
1213
  msgstr ""
1214
 
1215
+ #: app/helper/class-ai1ec-app-helper.php:661
1216
+ msgid ""
1217
+ "The plugin is installed, but has not been configured. <a href=\"%s\">Click "
1218
+ "here to set it up now »</a>"
1219
  msgstr ""
1220
 
1221
+ #: app/helper/class-ai1ec-app-helper.php:667
1222
+ msgid ""
1223
+ "The plugin is installed, but has not been configured. Please log in as a "
1224
+ "WordPress Administrator to set it up."
1225
  msgstr ""
1226
 
1227
  #. Plugin Name of the plugin/theme
1228
+ msgid "All-in-One Event Calendar"
1229
  msgstr ""
1230
 
1231
  #. Plugin URI of the plugin/theme
1234
 
1235
  #. Description of the plugin/theme
1236
  msgid ""
1237
+ "An event calendar system with month, week, agenda views, upcoming events "
1238
  "widget, color-coded categories, recurrence, and import/export of .ics feeds."
1239
  msgstr ""
1240
 
lib/iCalUtilityFunctions.class.php CHANGED
@@ -1,8 +1,8 @@
1
  <?php
2
  /**
3
- * iCalcreator class v2.10
4
  * copyright (c) 2007-2011 Kjell-Inge Gustafsson kigkonsult
5
- * www.kigkonsult.se/iCalcreator/index.php
6
  * ical@kigkonsult.se
7
  *
8
  * This library is free software; you can redistribute it and/or
@@ -23,7 +23,7 @@
23
  * moving all utility (static) functions to a utility class
24
  *
25
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
26
- * @since 2.6.22 - 2010-09-25
27
  *
28
  */
29
  class iCalUtilityFunctions {
@@ -119,7 +119,7 @@ class iCalUtilityFunctions {
119
  * END:VTIMEZONE
120
  *
121
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
122
- * @since 2.9.2 - 2011-05-30
123
  * @param object $calendar, reference to an iCalcreator calendar instance
124
  * @param string $timezone, a PHP5 (DateTimeZone) valid timezone
125
  * @param array $xProp, *[x-propName => x-propValue], optional
@@ -132,47 +132,56 @@ class iCalUtilityFunctions {
132
  return FALSE;
133
  try {
134
  $dtz = new DateTimeZone( $timezone );
135
- $transitions = $dtz->getTransitions();
136
- $stdDTSTART = $stdTZOFFSETTO = $stdTZOFFSETFROM = $stdTZNAME = $dlghtDTSTART = $dlghtTZOFFSETTO = $dlghtTZOFFSETFROM = $dlghtTZNAME = FALSE;
137
- foreach( $transitions as $trans ) {
138
- if( substr( $trans['time'], 0, 4 ) > ( date( 'Y' ) - 1 ))
139
- break;
140
- if( $trans['isdst'] !== TRUE ) {
141
- $stdDTSTART = $trans['time'];
142
- $stdTZOFFSETTO = $dlghtTZOFFSETFROM = iCalUtilityFunctions::offsetSec2His( $trans['offset'] );
143
- $stdTZNAME = $trans['abbr'];
144
- }
145
- else {
146
- $dlghtDTSTART = $trans['time'];
147
- $dlghtTZOFFSETTO = $stdTZOFFSETFROM = iCalUtilityFunctions::offsetSec2His( $trans['offset'] );
148
- $dlghtTZNAME = $trans['abbr'];
149
- }
 
150
  }
151
- if( $stdDTSTART && $stdTZOFFSETTO && $stdTZOFFSETFROM && $stdTZNAME && $dlghtDTSTART && $dlghtTZOFFSETTO && $dlghtTZOFFSETFROM && $dlghtTZNAME ) {
152
- $tz = & $calendar->newComponent( 'vtimezone' );
153
- $tz->setproperty( 'tzid', $timezone );
154
- if( !empty( $xProp )) {
155
- foreach( $xProp as $xPropName => $xPropValue )
156
- if( 'x-' == strtolower( substr( $xPropName, 0, 2 )))
157
- $tz->setproperty( $xPropName, $xPropValue );
158
- }
159
- $std = & $tz->newComponent( 'standard' );
160
- $std->setProperty( 'dtstart', $stdDTSTART );
161
- $std->setProperty( 'tzname', $stdTZNAME );
162
- $std->setProperty( 'tzoffsetto', $stdTZOFFSETTO );
163
- $std->setProperty( 'tzoffsetfrom', $stdTZOFFSETFROM );
164
- $std->setProperty( 'RRULE', array( 'FREQ' => 'YEARLY', 'BYDAY' => array( '-1', 'DAY' => 'SU' ), 'BYMONTH' => 10 ));
165
- $dlght = & $tz->newComponent( 'daylight' );
166
- $dlght->setProperty( 'dtstart', $dlghtDTSTART );
167
- $dlght->setProperty( 'tzname', $dlghtTZNAME );
168
- $dlght->setProperty( 'tzoffsetto', $dlghtTZOFFSETTO );
169
- $dlght->setProperty( 'tzoffsetfrom', $dlghtTZOFFSETFROM );
170
- $dlght->setProperty( 'RRULE', array( 'FREQ' => 'YEARLY', 'BYDAY' => array( '-1', 'DAY' => 'SU' ), 'BYMONTH' => 3 ));
171
  }
172
  }
173
- catch( Exception $e ) {
174
  return FALSE;
 
 
 
 
 
 
175
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
176
  return TRUE;
177
  }
178
  /**
@@ -343,7 +352,7 @@ class iCalUtilityFunctions {
343
  * @param array $duration
344
  * @return array duration
345
  */
346
- function _date2duration( $startdate, $enddate ) {
347
  $startWdate = mktime( 0, 0, 0, $startdate['month'], $startdate['day'], $startdate['year'] );
348
  $endWdate = mktime( 0, 0, 0, $enddate['month'], $enddate['day'], $enddate['year'] );
349
  $wduration = $endWdate - $startWdate;
@@ -471,7 +480,7 @@ class iCalUtilityFunctions {
471
  * @param array $duration
472
  * @return array, date format
473
  */
474
- function _duration2date( $startdate=null, $duration=null ) {
475
  if( empty( $startdate )) return FALSE;
476
  if( empty( $duration )) return FALSE;
477
  $dateOnly = ( isset( $startdate['hour'] ) || isset( $startdate['min'] ) || isset( $startdate['sec'] )) ? FALSE : TRUE;
@@ -723,14 +732,14 @@ class iCalUtilityFunctions {
723
  * if missing, UNTIL is set 1 year from startdate (emergency break)
724
  *
725
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
726
- * @since 2.9.10 - 2011-07-07
727
  * @param array $result, array to update, array([timestamp] => timestamp)
728
  * @param array $recur, pattern for recurrency (only value part, params ignored)
729
  * @param array $wdate, component start date
730
  * @param array $startdate, start date
731
  * @param array $enddate, optional
732
  * @return array of recurrence (start-)dates as index
733
- * @todo BYHOUR, BYMINUTE, BYSECOND, ev. BYSETPOS due to ambiguity, WEEKLY at year end/start
734
  */
735
  public static function _recur2date( & $result, $recur, $wdate, $startdate, $enddate=FALSE ) {
736
  foreach( $wdate as $k => $v ) if( ctype_digit( $v )) $wdate[$k] = (int) $v;
@@ -755,7 +764,7 @@ class iCalUtilityFunctions {
755
  $recur['UNTIL'] = iCalUtilityFunctions::_timestamp2date( $endDatets, 6 );
756
  }
757
  if( $wdatets > $endDatets ) {
758
- // echo "recur out of date ".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$wdatets),6))."<br />\n";//test
759
  return array(); // nothing to do.. .
760
  }
761
  if( !isset( $recur['FREQ'] )) // "MUST be specified.. ."
@@ -829,11 +838,13 @@ class iCalUtilityFunctions {
829
  $daycnts = array();
830
  $yeardays = $weekno = 0;
831
  $yeardaycnt = array();
 
 
832
  for( $m = 1; $m <= 12; $m++ ) { // count up and update up-counters
833
  $daycnts[$m] = array();
834
  $weekdaycnt = array();
835
  foreach( $daynames as $dn )
836
- $yeardaycnt[$dn] = $weekdaycnt[$dn] = 0;
837
  $mcnt = date( 't', mktime( 0, 0, 0, $m, 1, $wdate['year'] ));
838
  for( $d = 1; $d <= $mcnt; $d++ ) {
839
  $daycnts[$m][$d] = array();
@@ -954,8 +965,9 @@ class iCalUtilityFunctions {
954
  if(( $daynoexists && $daynosw && $daynamesw ) ||
955
  ( !$daynoexists && !$daynosw && $daynamesw )) {
956
  $updateOK = TRUE;
 
957
  }
958
- // echo "daynoexists:$daynoexists daynosw:$daynosw daynamesw:$daynamesw<br />\n"; // test ###
959
  }
960
  else {
961
  foreach( $recur['BYDAY'] as $bydayvalue ) {
@@ -1005,11 +1017,11 @@ class iCalUtilityFunctions {
1005
  (( $bysetposYold == $wdate['year'] ) &&
1006
  ( $bysetposMold == $wdate['month']) &&
1007
  ( $bysetposDold == $wdate['day'] )))) {
1008
- // echo "bysetposymd1[]=".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$wdatets),6))."<br />\n";//test
1009
  $bysetposymd1[] = $wdatets;
1010
  }
1011
  else {
1012
- // echo "bysetposymd2[]=".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$wdatets),6))."<br />\n";//test
1013
  $bysetposymd2[] = $wdatets;
1014
  }
1015
  }
@@ -1019,9 +1031,9 @@ class iCalUtilityFunctions {
1019
  $countcnt++;
1020
  if( $startdatets <= $wdatets ) { // only output within period
1021
  $result[$wdatets] = TRUE;
1022
- // echo "recur ".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$wdatets),6))."<br />\n";//test
1023
  }
1024
- // echo "recur undate ".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$wdatets),6))." okdatstart ".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$startdatets),6))."<br />\n";//test
1025
  $updateOK = FALSE;
1026
  }
1027
  }
@@ -1077,7 +1089,7 @@ class iCalUtilityFunctions {
1077
  // $testweekno = (int) date( 'W', mktime( 0, 0, $wkst, $testdate['month'], $testdate['day'], $testdate['year'] )); // test ###
1078
  // echo " testYMD (weekno)=".$testdate['year'].':'.$testdate['month'].':'.$testdate['day']." ($testweekno)"; // test ###
1079
  $result[$bysetposarr1[$ix]] = TRUE;
1080
- // echo " recur ".implode('-',iCalUtilityFunctions::_date_time_string(date('Y-m-d H:i:s',$bysetposarr1[$ix]),6)); // test ###
1081
  }
1082
  $countcnt++;
1083
  }
@@ -1202,7 +1214,7 @@ class iCalUtilityFunctions {
1202
  * convert format for input date to internal date with parameters
1203
  *
1204
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1205
- * @since 2.9.6 - 2011-05-14
1206
  * @param mixed $year
1207
  * @param mixed $month optional
1208
  * @param int $day optional
@@ -1250,6 +1262,15 @@ class iCalUtilityFunctions {
1250
  $input['params']['VALUE'] = 'DATE-TIME';
1251
  $parno = 6;
1252
  }
 
 
 
 
 
 
 
 
 
1253
  $parno = iCalUtilityFunctions::_existRem( $input['params'], 'VALUE', 'DATE-TIME', 7, $parno );
1254
  $parno = iCalUtilityFunctions::_existRem( $input['params'], 'VALUE', 'DATE', 3, $parno, $parno );
1255
  $input['value'] = iCalUtilityFunctions::_date_time_string( $year, $parno );
@@ -1411,6 +1432,32 @@ class iCalUtilityFunctions {
1411
  }
1412
  return (0 < count( $input )) ? $input : null;
1413
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1414
  /**
1415
  * step date, return updated date, array and timpstamp
1416
  *
@@ -1466,7 +1513,7 @@ class iCalUtilityFunctions {
1466
  * @param int $timestamp
1467
  * @return array, duration format
1468
  */
1469
- function _timestamp2duration( $timestamp ) {
1470
  $dur = array();
1471
  $dur['week'] = (int) floor( $timestamp / ( 7 * 24 * 60 * 60 ));
1472
  $timestamp = $timestamp % ( 7 * 24 * 60 * 60 );
@@ -1478,6 +1525,32 @@ class iCalUtilityFunctions {
1478
  $dur['sec'] = (int) $timestamp % ( 60 );
1479
  return $dur;
1480
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1481
  /**
1482
  * convert (numeric) local time offset to seconds correcting localtime to GMT
1483
  *
1
  <?php
2
  /**
3
+ * iCalcreator v2.10.23
4
  * copyright (c) 2007-2011 Kjell-Inge Gustafsson kigkonsult
5
+ * kigkonsult.se/iCalcreator/index.php
6
  * ical@kigkonsult.se
7
  *
8
  * This library is free software; you can redistribute it and/or
23
  * moving all utility (static) functions to a utility class
24
  *
25
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
26
+ * @since 2.10.1 - 2011-07-16
27
  *
28
  */
29
  class iCalUtilityFunctions {
119
  * END:VTIMEZONE
120
  *
121
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
122
+ * @since 2.10.3 - 2011-08-01
123
  * @param object $calendar, reference to an iCalcreator calendar instance
124
  * @param string $timezone, a PHP5 (DateTimeZone) valid timezone
125
  * @param array $xProp, *[x-propName => x-propValue], optional
132
  return FALSE;
133
  try {
134
  $dtz = new DateTimeZone( $timezone );
135
+ }
136
+ catch( Exception $e ) {
137
+ return FALSE;
138
+ }
139
+ $stdDTSTART = $stdTZOFFSETTO = $stdTZOFFSETFROM = $stdTZNAME = $dlghtDTSTART = $dlghtTZOFFSETTO = $dlghtTZOFFSETFROM = $dlghtTZNAME = FALSE;
140
+ $dateNow = new DateTime();
141
+ $transitions = $dtz->getTransitions();
142
+ foreach( $transitions as $trans ) {
143
+ if( FALSE === ( $date = DateTime::createFromFormat( 'Y-m-d', substr( $trans['time'], 0, 10 ))))
144
+ continue;
145
+ if( $date > $dateNow )
146
+ break;
147
+ if( TRUE !== $trans['isdst'] ) {
148
+ $stdDTSTART = $trans['time'];
149
+ $stdTZOFFSETTO = $dlghtTZOFFSETFROM = iCalUtilityFunctions::offsetSec2His( $trans['offset'] );
150
+ $stdTZNAME = $trans['abbr'];
151
  }
152
+ else {
153
+ $dlghtDTSTART = $trans['time'];
154
+ $dlghtTZOFFSETTO = $stdTZOFFSETFROM = iCalUtilityFunctions::offsetSec2His( $trans['offset'] );
155
+ $dlghtTZNAME = $trans['abbr'];
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
156
  }
157
  }
158
+ if( !$stdDTSTART || !$stdTZOFFSETTO || !$stdTZOFFSETFROM )
159
  return FALSE;
160
+ $tz = & $calendar->newComponent( 'vtimezone' );
161
+ $tz->setproperty( 'tzid', $timezone );
162
+ if( !empty( $xProp )) {
163
+ foreach( $xProp as $xPropName => $xPropValue )
164
+ if( 'x-' == strtolower( substr( $xPropName, 0, 2 )))
165
+ $tz->setproperty( $xPropName, $xPropValue );
166
  }
167
+ $std = & $tz->newComponent( 'standard' );
168
+ $std->setProperty( 'dtstart', $stdDTSTART );
169
+ if( $stdTZNAME )
170
+ $std->setProperty( 'tzname', $stdTZNAME );
171
+ $std->setProperty( 'tzoffsetto', $stdTZOFFSETTO );
172
+ $std->setProperty( 'tzoffsetfrom', $stdTZOFFSETFROM );
173
+ if(( $stdTZOFFSETTO != $stdTZOFFSETFROM ) && ( FALSE === iCalUtilityFunctions::_setTZrrule( $std )))
174
+ $std->setProperty( 'RRULE', array( 'FREQ' => 'YEARLY', 'BYDAY' => array( '-1', 'DAY' => 'SU' ), 'BYMONTH' => 10 ));
175
+ if(( !$dlghtDTSTART || !$dlghtTZOFFSETTO || !$dlghtTZOFFSETFROM ) || ( $dlghtTZOFFSETTO == $dlghtTZOFFSETFROM ))
176
+ return TRUE;
177
+ $dlght = & $tz->newComponent( 'daylight' );
178
+ $dlght->setProperty( 'dtstart', $dlghtDTSTART );
179
+ if( $dlghtTZNAME )
180
+ $dlght->setProperty( 'tzname', $dlghtTZNAME );
181
+ $dlght->setProperty( 'tzoffsetto', $dlghtTZOFFSETTO );
182
+ $dlght->setProperty( 'tzoffsetfrom', $dlghtTZOFFSETFROM );
183
+ if( FALSE === iCalUtilityFunctions::_setTZrrule( $dlght ))
184
+ $dlght->setProperty( 'RRULE', array( 'FREQ' => 'YEARLY', 'BYDAY' => array( '-1', 'DAY' => 'SU' ), 'BYMONTH' => 3 ));
185
  return TRUE;
186
  }
187
  /**
352
  * @param array $duration
353
  * @return array duration
354
  */
355
+ public static function _date2duration( $startdate, $enddate ) {
356
  $startWdate = mktime( 0, 0, 0, $startdate['month'], $startdate['day'], $startdate['year'] );
357
  $endWdate = mktime( 0, 0, 0, $enddate['month'], $enddate['day'], $enddate['year'] );
358
  $wduration = $endWdate - $startWdate;
480
  * @param array $duration
481
  * @return array, date format
482
  */
483
+ public static function _duration2date( $startdate=null, $duration=null ) {
484
  if( empty( $startdate )) return FALSE;
485
  if( empty( $duration )) return FALSE;
486
  $dateOnly = ( isset( $startdate['hour'] ) || isset( $startdate['min'] ) || isset( $startdate['sec'] )) ? FALSE : TRUE;
732
  * if missing, UNTIL is set 1 year from startdate (emergency break)
733
  *
734
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
735
+ * @since 2.10.19 - 2011-10-31
736
  * @param array $result, array to update, array([timestamp] => timestamp)
737
  * @param array $recur, pattern for recurrency (only value part, params ignored)
738
  * @param array $wdate, component start date
739
  * @param array $startdate, start date
740
  * @param array $enddate, optional
741
  * @return array of recurrence (start-)dates as index
742
+ * @todo BYHOUR, BYMINUTE, BYSECOND, WEEKLY at year end/start
743
  */
744
  public static function _recur2date( & $result, $recur, $wdate, $startdate, $enddate=FALSE ) {
745
  foreach( $wdate as $k => $v ) if( ctype_digit( $v )) $wdate[$k] = (int) $v;
764
  $recur['UNTIL'] = iCalUtilityFunctions::_timestamp2date( $endDatets, 6 );
765
  }
766
  if( $wdatets > $endDatets ) {
767
+ // echo "recur out of date ".date('Y-m-d H:i:s',$wdatets)."<br />\n";//test
768
  return array(); // nothing to do.. .
769
  }
770
  if( !isset( $recur['FREQ'] )) // "MUST be specified.. ."
838
  $daycnts = array();
839
  $yeardays = $weekno = 0;
840
  $yeardaycnt = array();
841
+ foreach( $daynames as $dn )
842
+ $yeardaycnt[$dn] = 0;
843
  for( $m = 1; $m <= 12; $m++ ) { // count up and update up-counters
844
  $daycnts[$m] = array();
845
  $weekdaycnt = array();
846
  foreach( $daynames as $dn )
847
+ $weekdaycnt[$dn] = 0;
848
  $mcnt = date( 't', mktime( 0, 0, 0, $m, 1, $wdate['year'] ));
849
  for( $d = 1; $d <= $mcnt; $d++ ) {
850
  $daycnts[$m][$d] = array();
965
  if(( $daynoexists && $daynosw && $daynamesw ) ||
966
  ( !$daynoexists && !$daynosw && $daynamesw )) {
967
  $updateOK = TRUE;
968
+ // echo "m=$m d=$d day=".$daycnts[$m][$d]['DAY']." yeardayno_up=".$daycnts[$m][$d]['yeardayno_up']." daynoexists:$daynoexists daynosw:$daynosw daynamesw:$daynamesw updateOK:$updateOK<br />\n"; // test ###
969
  }
970
+ //echo "m=$m d=$d day=".$daycnts[$m][$d]['DAY']." yeardayno_up=".$daycnts[$m][$d]['yeardayno_up']." daynoexists:$daynoexists daynosw:$daynosw daynamesw:$daynamesw updateOK:$updateOK<br />\n"; // test ###
971
  }
972
  else {
973
  foreach( $recur['BYDAY'] as $bydayvalue ) {
1017
  (( $bysetposYold == $wdate['year'] ) &&
1018
  ( $bysetposMold == $wdate['month']) &&
1019
  ( $bysetposDold == $wdate['day'] )))) {
1020
+ // echo "bysetposymd1[]=".date('Y-m-d H:i:s',$wdatets)."<br />\n";//test
1021
  $bysetposymd1[] = $wdatets;
1022
  }
1023
  else {
1024
+ // echo "bysetposymd2[]=".date('Y-m-d H:i:s',$wdatets)."<br />\n";//test
1025
  $bysetposymd2[] = $wdatets;
1026
  }
1027
  }
1031
  $countcnt++;
1032
  if( $startdatets <= $wdatets ) { // only output within period
1033
  $result[$wdatets] = TRUE;
1034
+ // echo "recur ".date('Y-m-d H:i:s',$wdatets)."<br />\n";//test
1035
  }
1036
+ // echo "recur undate ".date('Y-m-d H:i:s',$wdatets)." okdatstart ".date('Y-m-d H:i:s',$startdatets)."<br />\n";//test
1037
  $updateOK = FALSE;
1038
  }
1039
  }
1089
  // $testweekno = (int) date( 'W', mktime( 0, 0, $wkst, $testdate['month'], $testdate['day'], $testdate['year'] )); // test ###
1090
  // echo " testYMD (weekno)=".$testdate['year'].':'.$testdate['month'].':'.$testdate['day']." ($testweekno)"; // test ###
1091
  $result[$bysetposarr1[$ix]] = TRUE;
1092
+ // echo " recur ".date('Y-m-d H:i:s',$bysetposarr1[$ix]); // test ###
1093
  }
1094
  $countcnt++;
1095
  }
1214
  * convert format for input date to internal date with parameters
1215
  *
1216
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1217
+ * @since 2.10.4 - 2011-08-03
1218
  * @param mixed $year
1219
  * @param mixed $month optional
1220
  * @param int $day optional
1262
  $input['params']['VALUE'] = 'DATE-TIME';
1263
  $parno = 6;
1264
  }
1265
+ elseif( $tzid && iCalUtilityFunctions::_isOffset( substr( $year, -7 ))) {
1266
+ if(( in_array( substr( $year, -5, 1 ), array( '+', '-' ))) &&
1267
+ ( '0000' < substr( $year, -4 )) && ( '9999' >= substr( $year, -4 )))
1268
+ $year = substr( $year, 0, ( strlen( $year ) - 5 ));
1269
+ elseif(( in_array( substr( $input, -7, 1 ), array( '+', '-' ))) &&
1270
+ ( '000000' < substr( $input, -6 )) && ( '999999' >= substr( $input, -6 )))
1271
+ $year = substr( $year, 0, ( strlen( $year ) - 7 ));
1272
+ $parno = 6;
1273
+ }
1274
  $parno = iCalUtilityFunctions::_existRem( $input['params'], 'VALUE', 'DATE-TIME', 7, $parno );
1275
  $parno = iCalUtilityFunctions::_existRem( $input['params'], 'VALUE', 'DATE', 3, $parno, $parno );
1276
  $input['value'] = iCalUtilityFunctions::_date_time_string( $year, $parno );
1432
  }
1433
  return (0 < count( $input )) ? $input : null;
1434
  }
1435
+ /**
1436
+ * set RRULE in vtimezone standard/daylight components based on component dtstart
1437
+ *
1438
+ * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1439
+ * @since 2.10.3 - 2011-08-01
1440
+ * @param object $obj, reference to an iCalcreator vtimezone standard/daylight instance
1441
+ * @return bool
1442
+ */
1443
+ public static function _setTZrrule( & $obj ) {
1444
+ if( FALSE === ( $date = $obj->getProperty( 'dtstart' )))
1445
+ return FALSE;
1446
+ $ts = mktime( (int) $date['hour'], (int) $date['min'], (int) $date['sec'], (int) $date['month'], (int) $date['day'], (int) $date['year'] );
1447
+ $daysNm = array( 'SU', 'MO', 'TU', 'WE', 'TH', 'FR', 'SA', 'SU' );
1448
+ $day = $daysNm[date( 'N', $ts )];
1449
+ $daycnt = date( 't', $ts ) - $date['day'];
1450
+ if( 8 > $daycnt )
1451
+ $ordwk = -1;
1452
+ elseif( 15 > $daycnt)
1453
+ $ordwk = -2;
1454
+ elseif( 8 > $date['day'] )
1455
+ $ordwk = 1;
1456
+ else
1457
+ $ordwk = 2;
1458
+ $obj->setProperty( 'RRULE', array( 'FREQ' => 'YEARLY', 'BYDAY' => array( (string) $ordwk, 'DAY' => $day ), 'BYMONTH' => (int) $date['month'] ));
1459
+ return TRUE;
1460
+ }
1461
  /**
1462
  * step date, return updated date, array and timpstamp
1463
  *
1513
  * @param int $timestamp
1514
  * @return array, duration format
1515
  */
1516
+ public static function _timestamp2duration( $timestamp ) {
1517
  $dur = array();
1518
  $dur['week'] = (int) floor( $timestamp / ( 7 * 24 * 60 * 60 ));
1519
  $timestamp = $timestamp % ( 7 * 24 * 60 * 60 );
1525
  $dur['sec'] = (int) $timestamp % ( 60 );
1526
  return $dur;
1527
  }
1528
+ /**
1529
+ * transforms a dateTime from a timezone to another using PHP DateTime and DateTimeZone class (PHP >= PHP 5.2.0)
1530
+ *
1531
+ * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1532
+ * @since 2.10.5 - 2011-08-03
1533
+ * @param string $date (date to alter)
1534
+ * @param string $tzFrom, PHP valid old timezone
1535
+ * @param string $tzTo, PHP valid new timezone, default 'UTC'
1536
+ * @param string $format, (opt) date output format, default 'Ymd\THis'
1537
+ * @return bool
1538
+ */
1539
+ public static function transformDateTime( & $date, $tzFrom, $tzTo='UTC', $format = 'Ymd\THis' ) {
1540
+ if( !class_exists( 'DateTime' ) || !class_exists( 'DateTimeZone' ))
1541
+ return FALSE;
1542
+ if( FALSE === ( $timestamp = strtotime( $date )))
1543
+ return FALSE;
1544
+ try {
1545
+ $d = new DateTime( date( 'Y-m-d H:i:s', $timestamp ), new DateTimeZone( $tzFrom ));
1546
+ $d->setTimezone( new DateTimeZone( $tzTo ));
1547
+ }
1548
+ catch (Exception $e) {
1549
+ return FALSE;
1550
+ }
1551
+ $date = $d->format( $format );
1552
+ return TRUE;
1553
+ }
1554
  /**
1555
  * convert (numeric) local time offset to seconds correcting localtime to GMT
1556
  *
lib/iCalcreator.class.php CHANGED
@@ -1,9 +1,9 @@
1
  <?php
2
  /*********************************************************************************/
3
  /**
4
- * iCalcreator class v2.10
5
  * copyright (c) 2007-2011 Kjell-Inge Gustafsson kigkonsult
6
- * www.kigkonsult.se/iCalcreator/index.php
7
  * ical@kigkonsult.se
8
  *
9
  * Description:
@@ -44,11 +44,18 @@ if ($pos !== false) {
44
  }
45
  */
46
  /*********************************************************************************/
 
 
 
 
 
 
 
47
  /* since 2.6.22 - 2010-09-25, do NOT remove!! */
48
- require_once ( 'iCalUtilityFunctions.class.php' );
49
  /*********************************************************************************/
50
  /* version, do NOT remove!! */
51
- define( 'ICALCREATOR_VERSION', 'iCalcreator 2.10' );
52
  /*********************************************************************************/
53
  /*********************************************************************************/
54
  /**
@@ -124,14 +131,14 @@ class vcalendar {
124
  * creates formatted output for calendar property calscale
125
  *
126
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
127
- * @since 2.4.8 - 2008-10-21
128
  * @return string
129
  */
130
  function createCalscale() {
131
  if( empty( $this->calscale )) return FALSE;
132
  switch( $this->format ) {
133
  case 'xcal':
134
- return ' calscale="'.$this->calscale.'"'.$this->nl;
135
  break;
136
  default:
137
  return 'CALSCALE:'.$this->calscale.$this->nl;
@@ -158,14 +165,14 @@ class vcalendar {
158
  * creates formatted output for calendar property method
159
  *
160
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
161
- * @since 0.9.7 - 2006-11-20
162
  * @return string
163
  */
164
  function createMethod() {
165
  if( empty( $this->method )) return FALSE;
166
  switch( $this->format ) {
167
  case 'xcal':
168
- return ' method="'.$this->method.'"'.$this->nl;
169
  break;
170
  default:
171
  return 'METHOD:'.$this->method.$this->nl;
@@ -197,7 +204,7 @@ class vcalendar {
197
  * creates formatted output for calendar property prodid
198
  *
199
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
200
- * @since 0.9.7 - 2006-11-20
201
  * @return string
202
  */
203
  function createProdid() {
@@ -205,7 +212,7 @@ class vcalendar {
205
  $this->_makeProdid();
206
  switch( $this->format ) {
207
  case 'xcal':
208
- return ' prodid="'.$this->prodid.'"'.$this->nl;
209
  break;
210
  default:
211
  return 'PRODID:'.$this->prodid.$this->nl;
@@ -249,7 +256,7 @@ class vcalendar {
249
 
250
  *
251
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
252
- * @since 0.9.7 - 2006-11-20
253
  * @return string
254
  */
255
  function createVersion() {
@@ -257,7 +264,7 @@ class vcalendar {
257
  $this->_makeVersion();
258
  switch( $this->format ) {
259
  case 'xcal':
260
- return ' version="'.$this->version.'"'.$this->nl;
261
  break;
262
  default:
263
  return 'VERSION:'.$this->version.$this->nl;
@@ -295,12 +302,10 @@ class vcalendar {
295
  * creates formatted output for calendar property x-prop, iCal format only
296
  *
297
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
298
- * @since 2.9.3 - 2011-05-14
299
  * @return string
300
  */
301
  function createXprop() {
302
- if( 'xcal' == $this->format )
303
- return false;
304
  if( empty( $this->xprop ) || !is_array( $this->xprop )) return FALSE;
305
  $output = null;
306
  $toolbox = new calendarComponent();
@@ -319,6 +324,10 @@ class vcalendar {
319
  else
320
  $xpropPart['value'] = $toolbox->_strrep( $xpropPart['value'] );
321
  $output .= $toolbox->_createElement( $label, $attributes, $xpropPart['value'] );
 
 
 
 
322
  }
323
  return $output;
324
  }
@@ -645,13 +654,26 @@ class vcalendar {
645
  * general vcalendar config setting
646
  *
647
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
648
- * @since 2.9.6 - 2011-05-14
649
  * @param mixed $config
650
  * @param string $value
651
  * @return void
652
  */
653
  function setConfig( $config, $value = FALSE) {
654
  if( is_array( $config )) {
 
 
 
 
 
 
 
 
 
 
 
 
 
655
  foreach( $config as $cKey => $cValue ) {
656
  if( FALSE === $this->setConfig( $cKey, $cValue ))
657
  return FALSE;
@@ -735,6 +757,14 @@ class vcalendar {
735
  case 'NL':
736
  case 'NEWLINECHAR':
737
  $this->nl = $value;
 
 
 
 
 
 
 
 
738
  $subcfg = array( 'NL' => $value );
739
  $res = TRUE;
740
  break;
@@ -995,21 +1025,21 @@ class vcalendar {
995
  * No date controls occurs.
996
  *
997
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
998
- * @since 2.9.7 - 2011-06-04
999
  * @param mixed $startY optional, start Year, default current Year ALT. array selecOptions
1000
- * @param int $startM optional, start Month, default current Month
1001
- * @param int $startD optional, start Day, default current Day
1002
- * @param int $endY optional, end Year, default $startY
1003
- * @param int $endY optional, end Month, default $startM
1004
- * @param int $endY optional, end Day, default $startD
1005
- * @param mixed $cType optional, calendar component type(-s), default FALSE=all else string/array type(-s)
1006
- * @param bool $flat optional, FALSE (default) => output : array[Year][Month][Day][]
1007
- * TRUE => output : array[] (ignores split)
1008
- * @param bool $any optional, TRUE (default) - select component that take place within period
1009
- * FALSE - only components that starts within period
1010
- * @param bool $split optional, TRUE (default) - one component copy every day it take place during the
1011
  * period (implies flat=FALSE)
1012
- * FALSE - one occurance of component only in output array
1013
  * @return array or FALSE
1014
  */
1015
  function selectComponents( $startY=FALSE, $startM=FALSE, $startD=FALSE, $endY=FALSE, $endM=FALSE, $endD=FALSE, $cType=FALSE, $flat=FALSE, $any=TRUE, $split=TRUE ) {
@@ -1048,6 +1078,8 @@ class vcalendar {
1048
  $cType = $validTypes;
1049
  if( 0 >= count( $cType ))
1050
  $cType = $validTypes;
 
 
1051
  if(( TRUE === $flat ) && ( TRUE === $split )) // invalid combination
1052
  $split = FALSE;
1053
  /* iterate components */
@@ -1061,7 +1093,7 @@ class vcalendar {
1061
  /* select due when dtstart is missing */
1062
  if( empty( $start ) && ( $component->objName == 'vtodo' ) && ( FALSE === ( $start = $component->getProperty( 'due' ))))
1063
  continue;
1064
- $dtendExist = $dueExist = $durationExist = $endAllDayEvent = FALSE;
1065
  unset( $end, $startWdate, $endWdate, $rdurWsecs, $rdur, $exdatelist, $workstart, $workend, $endDateFormat ); // clean up
1066
  $startWdate = iCalUtilityFunctions::_date2timestamp( $start );
1067
  $startDateFormat = ( isset( $start['hour'] )) ? 'Y-m-d H:i:s' : 'Y-m-d';
@@ -1105,7 +1137,7 @@ class vcalendar {
1105
  $end = array( 'year' => $start['year'], 'month' => $start['month'], 'day' => $start['day'], 'hour' => 23, 'min' => 59, 'sec' => 59 );
1106
  $endWdate = iCalUtilityFunctions::_date2timestamp( $end );
1107
  }
1108
- $rdurWsecs = $endWdate - $startWdate; // compute component duration in seconds
1109
  /* make a list of optional exclude dates for component occurence from exrule and exdate */
1110
  $exdatelist = array();
1111
  $workstart = iCalUtilityFunctions::_timestamp2date(( $startDate - $rdurWsecs ), 6);
@@ -1115,12 +1147,87 @@ class vcalendar {
1115
  while( FALSE !== ( $exdate = $component->getProperty( 'exdate' ))) { // check exdate
1116
  foreach( $exdate as $theExdate ) {
1117
  $exWdate = iCalUtilityFunctions::_date2timestamp( $theExdate );
1118
- $exWdate = mktime( 0, 0, 0, date( 'm', $exWdate ), date( 'd', $exWdate ), date( 'Y', $exWdate ) ); // on a day-basis !!!
1119
  if((( $startDate - $rdurWsecs ) <= $exWdate ) && ( $endDate >= $exWdate ))
1120
  $exdatelist[$exWdate] = TRUE;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1121
  }
1122
- }
1123
- /* if 'any' components, check repeating components, removing all excluding dates */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1124
  if( TRUE === $any ) {
1125
  /* make a list of optional repeating dates for component occurence, rrule, rdate */
1126
  $recurlist = array();
@@ -1152,10 +1259,12 @@ class vcalendar {
1152
  $recurlist[$theRdate] = $rdurWsecs; // set start date for recurrence instance + event duration in seconds
1153
  }
1154
  }
1155
- }
1156
  if( 0 < count( $recurlist )) {
1157
  ksort( $recurlist );
1158
  $xRecurrence = 1;
 
 
1159
  foreach( $recurlist as $recurkey => $durvalue ) {
1160
  // echo "recurKey=".date( 'Y-m-d H:i:s', $recurkey ).' dur='.iCalUtilityFunctions::offsetSec2His( $durvalue )."<br />\n"; // test ###;
1161
  if((( $startDate - $rdurWsecs ) > $recurkey ) || ( $endDate < $recurkey )) // not within period
@@ -1165,25 +1274,12 @@ class vcalendar {
1165
  continue;
1166
  if( $startWdate >= $recurkey ) // exclude component start date
1167
  continue;
1168
- $component2 = $component->copy();
1169
  $rstart = $recurkey;
1170
  $rend = $recurkey + $durvalue;
1171
  /* add repeating components within valid dates to output array, only start date set */
1172
  if( $flat ) {
1173
- $datestring = date( $startDateFormat, $recurkey );
1174
- if( isset( $start['tz'] ))
1175
- $datestring .= ' '.$start['tz'];
1176
- // echo "X-CURRENT-DTSTART 0 =$datestring tcnt =".++$tcnt."<br />";$component2->setProperty( 'X-CNT', $tcnt ); // test ###
1177
- $component2->setProperty( 'X-CURRENT-DTSTART', $datestring );
1178
- if( $dtendExist || $dueExist || $durationExist ) {
1179
- $datestring = date( $endDateFormat, $recurkey + $durvalue ); // fixa korrekt sluttid
1180
- if( isset( $end['tz'] ))
1181
- $datestring .= ' '.$end['tz'];
1182
- $propName = ( !$dueExist ) ? 'X-CURRENT-DTEND' : 'X-CURRENT-DUE';
1183
- $component2->setProperty( $propName, $datestring );
1184
- } // end if( $dtendExist || $dueExist || $durationExist )
1185
- $component2->setProperty( 'X-RECURRENCE', ++$xRecurrence );
1186
- $result[$component2->getProperty( 'UID' )] = $component2->copy(); // copy to output
1187
  }
1188
  /* add repeating components within valid dates to output array, one each day */
1189
  elseif( $split ) {
@@ -1219,13 +1315,13 @@ class vcalendar {
1219
  } // end if( $dtendExist || $dueExist || $durationExist )
1220
  $component2->setProperty( 'X-RECURRENCE', $xRecurrence );
1221
  $wd = getdate( $rstart );
1222
- $result[$wd['year']][$wd['mon']][$wd['mday']][$component2->getProperty( 'UID' )] = $component2->copy(); // copy to output
1223
  } // end if( $checkDate > $startYMD ) { // date after dtstart
1224
  $rstart = mktime( date( 'H', $rstart ), date( 'i', $rstart ), date( 's', $rstart ), date( 'm', $rstart ), date( 'd', $rstart ) + 1, date( 'Y', $rstart ) ); // step one day
1225
  } // end while( $rstart <= $rend )
1226
  $xRecurrence += 1;
1227
  } // end elseif( $split )
1228
- elseif( $rstart >= $startDate ) { // date within period //* flat=FALSE && split=FALSE *//
1229
  $checkDate = mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1230
  if( !isset( $exdatelist[$checkDate] )) { // exclude any recurrence START date, found in exdatelist
1231
  $xRecurrence += 1;
@@ -1235,11 +1331,11 @@ class vcalendar {
1235
  //echo "X-CURRENT-DTSTART 2 = $datestring xRecurrence=$xRecurrence tcnt =".++$tcnt."<br />";$component2->setProperty( 'X-CNT', $tcnt ); // test ###
1236
  $component2->setProperty( 'X-CURRENT-DTSTART', $datestring );
1237
  if( $dtendExist || $dueExist || $durationExist ) {
1238
- $rstart += $rdurWsecs;
1239
- if( date( 'Ymd', $rstart ) < date( 'Ymd', $endWdate ))
1240
- $tend = mktime( 23, 59, 59, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ));
1241
  else
1242
- $tend = mktime( date( 'H', $endWdate ), date( 'i', $endWdate ), date( 's', $endWdate ), date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1243
  $datestring = date( $endDateFormat, $tend );
1244
  if( isset( $end['tz'] ))
1245
  $datestring .= ' '.$end['tz'];
@@ -1248,7 +1344,7 @@ class vcalendar {
1248
  } // end if( $dtendExist || $dueExist || $durationExist )
1249
  $component2->setProperty( 'X-RECURRENCE', $xRecurrence );
1250
  $wd = getdate( $rstart );
1251
- $result[$wd['year']][$wd['mon']][$wd['mday']][$component2->getProperty( 'UID' )] = $component2->copy(); // copy to output
1252
  } // end if( !isset( $exdatelist[$checkDate] ))
1253
  } // end elseif( $rstart >= $startDate )
1254
  } // end foreach( $recurlist as $recurkey => $durvalue )
@@ -1257,69 +1353,34 @@ class vcalendar {
1257
  if(( $endWdate < $startDate ) || ( $startWdate > $endDate ))
1258
  continue;
1259
  } // end if( TRUE === $any )
1260
- /* deselect components with startdate not within period */
1261
- elseif(( $startWdate < $startDate ) || ( $startWdate > $endDate ))
1262
- continue;
1263
- /* add the selected component (WITHIN valid dates) to output array */
1264
- if( $flat )
1265
- $result[$component->getProperty( 'UID' )] = $component->copy(); // copy to output;
1266
- elseif( $split ) { // split the original component
1267
- if( $endWdate > $endDate )
1268
- $endWdate = $endDate; // use period end date
1269
- $rstart = $startWdate;
1270
- if( $rstart < $startDate )
1271
- $rstart = $startDate; // use period start date
1272
- $checkDate = mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1273
- if( !isset( $exdatelist[$checkDate] )) { // exclude any recurrence START date, found in exdatelist
1274
- foreach( array( 'X-CURRENT-DTSTART','X-CURRENT-DTEND','X-CURRENT-DUE','X-RECURRENCE' ) as $propName )
1275
- $component->deleteProperty( $propName ); // remove any x-props, if set
1276
- while( $rstart <= $endWdate ) { // iterate
1277
- if( $rstart > $startWdate ) { // if NOT startdate, set X-properties
1278
- $datestring = date( $startDateFormat, mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart )));
1279
- if( isset( $start['tz'] ))
1280
- $datestring .= ' '.$start['tz'];
1281
- // echo "X-CURRENT-DTSTART 3 = $datestring xRecurrence=$xRecurrence tcnt =".++$tcnt."<br />";$component->setProperty( 'X-CNT', $tcnt ); // test ###
1282
- $component->setProperty( 'X-CURRENT-DTSTART', $datestring );
1283
- if( $dtendExist || $dueExist || $durationExist ) {
1284
- if( date( 'Ymd', $rstart ) < date( 'Ymd', $endWdate ))
1285
- $tend = mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ));
1286
- else
1287
- $tend = mktime( date( 'H', $endWdate ), date( 'i', $endWdate ), date( 's', $endWdate ), date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1288
- $datestring = date( $endDateFormat, $tend );
1289
- if( isset( $end['tz'] ))
1290
- $datestring .= ' '.$end['tz'];
1291
- $propName = ( !$dueExist ) ? 'X-CURRENT-DTEND' : 'X-CURRENT-DUE';
1292
- $component->setProperty( $propName, $datestring );
1293
- } // end if( $dtendExist || $dueExist || $durationExist )
1294
- } // end if( $rstart > $startWdate )
1295
- $wd = getdate( $rstart );
1296
- $result[$wd['year']][$wd['mon']][$wd['mday']][$component->getProperty( 'UID' )] = $component->copy(); // copy to output
1297
- $rstart = mktime( date( 'H', $rstart ), date( 'i', $rstart ), date( 's', $rstart ), date( 'm', $rstart ), date( 'd', $rstart ) + 1, date( 'Y', $rstart ) ); // step one day
1298
- } // end while( $rstart <= $endWdate )
1299
- } // end if( !isset( $exdatelist[$checkDate] ))
1300
- } // end if( $split ) - else use component date
1301
- elseif( $startWdate >= $startDate ) { // within period
1302
- $checkDate = mktime( 0, 0, 0, date( 'm', $startWdate ), date( 'd', $startWdate ), date( 'Y', $startWdate ) ); // on a day-basis !!!
1303
- if( !isset( $exdatelist[$checkDate] )) { // exclude any recurrence START date, found in exdatelist
1304
- foreach( array( 'X-CURRENT-DTSTART','X-CURRENT-DTEND','X-CURRENT-DUE','X-RECURRENCE' ) as $propName )
1305
- $component->deleteProperty( $propName ); // remove any x-props, if set
1306
- $wd = getdate( $startWdate );
1307
- $result[$wd['year']][$wd['mon']][$wd['mday']][$component->getProperty( 'UID' )] = $component->copy(); // copy to output
1308
- }
1309
- }
1310
  } // end foreach ( $this->components as $cix => $component )
1311
  if( 0 >= count( $result )) return FALSE;
1312
  elseif( !$flat ) {
1313
  foreach( $result as $y => $yeararr ) {
1314
  foreach( $yeararr as $m => $montharr ) {
1315
- foreach( $montharr as $d => $dayarr )
1316
- $result[$y][$m][$d] = array_values( $dayarr ); // skip tricky UID-index
1317
- ksort( $result[$y][$m] );
 
 
 
 
 
 
 
1318
  }
1319
- ksort( $result[$y] );
 
 
 
1320
  }
1321
- ksort( $result );
 
 
 
1322
  } // end elseif( !$flat )
 
 
1323
  return $result;
1324
  }
1325
  /**
@@ -1751,18 +1812,17 @@ class vcalendar {
1751
  * creates formatted output for calendar object instance
1752
  *
1753
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1754
- * @since 2.8.1 - 2011-03-12
1755
  * @return string
1756
  */
1757
  function createCalendar() {
1758
- $calendarInit1 = $calendarInit2 = $calendarxCaldecl = $calendarStart = $calendar = null;
1759
  switch( $this->format ) {
1760
  case 'xcal':
1761
- $calendarInit1 = '<?xml version="1.0" encoding="UTF-8"?>'.$this->nl.
1762
- '<!DOCTYPE iCalendar PUBLIC "-//IETF//DTD XCAL/iCalendar XML//EN"'.$this->nl.
1763
  '"http://www.ietf.org/internet-drafts/draft-ietf-calsch-many-xcal-01.txt"';
1764
- $calendarInit2 = '>'.$this->nl;
1765
- $calendarStart = '<vcalendar';
1766
  break;
1767
  default:
1768
  $calendarStart = 'BEGIN:VCALENDAR'.$this->nl;
@@ -1772,31 +1832,31 @@ class vcalendar {
1772
  $calendarStart .= $this->createProdid();
1773
  $calendarStart .= $this->createCalscale();
1774
  $calendarStart .= $this->createMethod();
1775
- switch( $this->format ) {
1776
- case 'xcal':
1777
- $nlstrlen = strlen( $this->nl );
1778
- if( $this->nl == substr( $calendarStart, ( 0 - $nlstrlen )))
1779
- $calendarStart = substr( $calendarStart, 0, ( strlen( $calendarStart ) - $nlstrlen ));
1780
- $calendarStart .= '>'.$this->nl;
1781
- break;
1782
- default:
1783
- break;
1784
- }
1785
  $calendar .= $this->createXprop();
 
1786
  foreach( $this->components as $component ) {
1787
  if( empty( $component )) continue;
1788
  $component->setConfig( $this->getConfig(), FALSE, TRUE );
1789
  $calendar .= $component->createComponent( $this->xcaldecl );
1790
  }
1791
- if(( 0 < count( $this->xcaldecl )) && ( 'xcal' == $this->format )) { // xCal only
1792
- $calendarInit1 .= $this->nl.'['.$this->nl;
1793
- $old_xcaldecl = array();
1794
  foreach( $this->xcaldecl as $declix => $declPart ) {
1795
- if(( 0 < count( $old_xcaldecl)) &&
1796
- ( in_array( $declPart['uri'], $old_xcaldecl['uri'] )) &&
 
 
1797
  ( in_array( $declPart['external'], $old_xcaldecl['external'] )))
1798
  continue; // no duplicate uri and ext. references
1799
- $calendarxCaldecl .= '<!';
 
 
 
 
 
1800
  foreach( $declPart as $declKey => $declValue ) {
1801
  switch( $declKey ) { // index
1802
  case 'xmldecl': // no 1
@@ -1808,6 +1868,7 @@ class vcalendar {
1808
  break;
1809
  case 'ref': // no 3
1810
  $calendarxCaldecl .= $declValue.' ';
 
1811
  break;
1812
  case 'external': // no 4
1813
  $calendarxCaldecl .= '"'.$declValue.'" ';
@@ -1821,9 +1882,9 @@ class vcalendar {
1821
  break;
1822
  }
1823
  }
1824
- $calendarxCaldecl .= '>'.$this->nl;
1825
  }
1826
- $calendarInit2 = ']'.$calendarInit2;
1827
  }
1828
  switch( $this->format ) {
1829
  case 'xcal':
@@ -1833,37 +1894,38 @@ class vcalendar {
1833
  $calendar .= 'END:VCALENDAR'.$this->nl;
1834
  break;
1835
  }
1836
- return $calendarInit1.$calendarxCaldecl.$calendarInit2.$calendarStart.$calendar;
1837
  }
1838
  /**
1839
  * a HTTP redirect header is sent with created, updated and/or parsed calendar
1840
  *
1841
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1842
- * @since 2.9.12 - 2011-07-13
1843
  * @param bool $utf8Encode
1844
  * @param bool $gzip
1845
  * @return redirect
1846
  */
1847
  function returnCalendar( $utf8Encode=FALSE, $gzip=FALSE ) {
1848
  $filename = $this->getConfig( 'filename' );
1849
- $output = $this->createCalendar();
 
1850
  if( $utf8Encode )
1851
  $output = utf8_encode( $output );
1852
  if( $gzip ) {
1853
  $output = gzencode( $output, 9 );
1854
- header( 'Content-Encoding: gzip');
1855
- header( 'Vary: *');
1856
  }
1857
- $filesize = strlen( $output );
1858
  if( 'xcal' == $this->format )
1859
- header( 'Content-Type: application/calendar+xml; charset=utf-8' );
1860
  else
1861
- header( 'Content-Type: text/calendar; charset=utf-8' );
1862
- header( 'Content-Length: '.$filesize );
1863
- header( 'Content-Disposition: attachment; filename="'.$filename.'"' );
1864
- header( 'Cache-Control: max-age=10' );
1865
- echo $output;
1866
- die();
 
1867
  }
1868
  /**
1869
  * save content in a file
@@ -2596,11 +2658,11 @@ class calendarComponent {
2596
  * computes datestamp for calendar component object instance dtstamp
2597
  *
2598
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
2599
- * @since 2.6.25 - 2010-11-09
2600
  * @return void
2601
  */
2602
  function _makeDtstamp() {
2603
- $d = mktime( date('H'), date('m'), (date('s') - date( 'Z' )), date('m'), date('d'), date('Y'));
2604
  $this->dtstamp['value'] = array( 'year' => date( 'Y', $d )
2605
  , 'month' => date( 'm', $d )
2606
  , 'day' => date( 'd', $d )
@@ -3735,14 +3797,14 @@ class calendarComponent {
3735
  /**
3736
  * set calendar component property sequence
3737
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
3738
- * @since 2.9.3 - 2011-05-14
3739
  * @param int $value optional
3740
  * @param array $params optional
3741
  * @return bool
3742
  */
3743
  function setSequence( $value=FALSE, $params=FALSE ) {
3744
  if(( empty( $value ) && !is_numeric( $value )) && ( '0' != $value ))
3745
- $value = ( isset( $this->sequence['value'] ) && ( 0 < $this->sequence['value'] )) ? $this->sequence['value'] + 1 : 1;
3746
  $this->sequence = array( 'value' => $value, 'params' => iCalUtilityFunctions::_setParams( $params ));
3747
  return TRUE;
3748
  }
@@ -4331,7 +4393,7 @@ class calendarComponent {
4331
  * creates formatted output for calendar component property
4332
  *
4333
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
4334
- * @since 2.6.22 - 2010-12-06
4335
  * @param string $label property name
4336
  * @param string $attributes property attributes
4337
  * @param string $content property content (optional)
@@ -4350,18 +4412,23 @@ class calendarComponent {
4350
  $categoriesAttrLang = null;
4351
  $attachInlineBinary = FALSE;
4352
  $attachfmttype = null;
 
 
 
 
 
4353
  if( !empty( $attributes )) {
4354
  $attributes = trim( $attributes );
4355
- if ( 'xcal' == $this->format) {
4356
  $attributes2 = explode( $this->intAttrDelimiter, $attributes );
4357
  $attributes = null;
4358
- foreach( $attributes2 as $attribute ) {
4359
  $attrKVarr = explode( '=', $attribute );
4360
  if( empty( $attrKVarr[0] ))
4361
  continue;
4362
  if( !isset( $attrKVarr[1] )) {
4363
  $attrValue = $attrKVarr[0];
4364
- $attrKey = null;
4365
  }
4366
  elseif( 2 == count( $attrKVarr)) {
4367
  $attrKey = strtolower( $attrKVarr[0] );
@@ -4395,8 +4462,8 @@ class calendarComponent {
4395
  $attributes = str_replace( $this->intAttrDelimiter, $this->attributeDelimiter, $attributes );
4396
  }
4397
  }
4398
- if(((( 'attach' == $label ) && !$attachInlineBinary ) ||
4399
- ( in_array( $label, array( 'tzurl', 'url' )))) && ( 'xcal' == $this->format)) {
4400
  $pos = strrpos($content, "/");
4401
  $docname = ( $pos !== false) ? substr( $content, (1 - strlen( $content ) + $pos )) : $content;
4402
  $this->xcaldecl[] = array( 'xmldecl' => 'ENTITY'
@@ -4410,11 +4477,11 @@ class calendarComponent {
4410
  $content = null;
4411
  if( 'attach' == $label ) {
4412
  $attributes = str_replace( $this->attributeDelimiter, $this->intAttrDelimiter, $attributes );
4413
- $content = $this->_createElement( 'extref', $attributes, null );
4414
  $attributes = null;
4415
  }
4416
  }
4417
- elseif(( 'attach' == $label ) && $attachInlineBinary && ( 'xcal' == $this->format)) {
4418
  $content = $this->nl.$this->_createElement( 'b64bin', $attachfmttype, $content ); // max one attribute
4419
  }
4420
  $output .= $attributes;
@@ -4422,7 +4489,7 @@ class calendarComponent {
4422
  switch( $this->format ) {
4423
  case 'xcal':
4424
  $output .= ' /';
4425
- $output .= $this->elementStart2;
4426
  return $output;
4427
  break;
4428
  default:
@@ -4747,7 +4814,7 @@ class calendarComponent {
4747
  * general component config setting
4748
  *
4749
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
4750
- * @since 2.9.6 - 2011-05-14
4751
  * @param mixed $config
4752
  * @param string $value
4753
  * @param bool $softUpdate
@@ -4755,6 +4822,15 @@ class calendarComponent {
4755
  */
4756
  function setConfig( $config, $value = FALSE, $softUpdate = FALSE ) {
4757
  if( is_array( $config )) {
 
 
 
 
 
 
 
 
 
4758
  foreach( $config as $cKey => $cValue ) {
4759
  if( FALSE === $this->setConfig( $cKey, $cValue, $softUpdate ))
4760
  return FALSE;
@@ -4786,6 +4862,7 @@ class calendarComponent {
4786
  case 'NL':
4787
  case 'NEWLINECHAR':
4788
  $this->nl = $value;
 
4789
  $subcfg = array( 'NL' => $value );
4790
  $res = TRUE;
4791
  break;
@@ -5108,7 +5185,7 @@ class calendarComponent {
5108
  * if property has multiply values, consequtive function calls are needed
5109
  *
5110
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
5111
- * @since 2.9.3 - 2011-05-18
5112
  * @param string $propName, optional
5113
  * @param int @propix, optional, if specific property is wanted in case of multiply occurences
5114
  * @param bool $inclParam=FALSE
@@ -5129,19 +5206,22 @@ class calendarComponent {
5129
  if( !empty( $this->action['value'] )) return ( $inclParam ) ? $this->action : $this->action['value'];
5130
  break;
5131
  case 'ATTACH':
5132
- while( is_array( $this->attach ) && !isset( $this->attach[$propix] ) && ( 0 < count( $this->attach )) && ( $propix < end( array_keys( $this->attach ))))
 
5133
  $propix++;
5134
  if( !isset( $this->attach[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5135
  return ( $inclParam ) ? $this->attach[$propix] : $this->attach[$propix]['value'];
5136
  break;
5137
  case 'ATTENDEE':
5138
- while( is_array( $this->attendee ) && !isset( $this->attendee[$propix] ) && ( 0 < count( $this->attendee )) && ( $propix < end( array_keys( $this->attendee ))))
 
5139
  $propix++;
5140
  if( !isset( $this->attendee[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5141
  return ( $inclParam ) ? $this->attendee[$propix] : $this->attendee[$propix]['value'];
5142
  break;
5143
  case 'CATEGORIES':
5144
- while( is_array( $this->categories ) && !isset( $this->categories[$propix] ) && ( 0 < count( $this->categories )) && ( $propix < end( array_keys( $this->categories ))))
 
5145
  $propix++;
5146
  if( !isset( $this->categories[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5147
  return ( $inclParam ) ? $this->categories[$propix] : $this->categories[$propix]['value'];
@@ -5150,7 +5230,8 @@ class calendarComponent {
5150
  if( !empty( $this->class['value'] )) return ( $inclParam ) ? $this->class : $this->class['value'];
5151
  break;
5152
  case 'COMMENT':
5153
- while( is_array( $this->comment ) && !isset( $this->comment[$propix] ) && ( 0 < count( $this->comment )) && ( $propix < end( array_keys( $this->comment ))))
 
5154
  $propix++;
5155
  if( !isset( $this->comment[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5156
  return ( $inclParam ) ? $this->comment[$propix] : $this->comment[$propix]['value'];
@@ -5159,7 +5240,8 @@ class calendarComponent {
5159
  if( !empty( $this->completed['value'] )) return ( $inclParam ) ? $this->completed : $this->completed['value'];
5160
  break;
5161
  case 'CONTACT':
5162
- while( is_array( $this->contact ) && !isset( $this->contact[$propix] ) && ( 0 < count( $this->contact )) && ( $propix < end( array_keys( $this->contact ))))
 
5163
  $propix++;
5164
  if( !isset( $this->contact[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5165
  return ( $inclParam ) ? $this->contact[$propix] : $this->contact[$propix]['value'];
@@ -5168,7 +5250,8 @@ class calendarComponent {
5168
  if( !empty( $this->created['value'] )) return ( $inclParam ) ? $this->created : $this->created['value'];
5169
  break;
5170
  case 'DESCRIPTION':
5171
- while( is_array( $this->description ) && !isset( $this->description[$propix] ) && ( 0 < count( $this->description )) && ( $propix < end( array_keys( $this->description ))))
 
5172
  $propix++;
5173
  if( !isset( $this->description[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5174
  return ( $inclParam ) ? $this->description[$propix] : $this->description[$propix]['value'];
@@ -5195,19 +5278,22 @@ class calendarComponent {
5195
  return ( $inclParam ) ? array( 'value' => $value, 'params' => $this->duration['params'] ) : $value;
5196
  break;
5197
  case 'EXDATE':
5198
- while( is_array( $this->exdate ) && !isset( $this->exdate[$propix] ) && ( 0 < count( $this->exdate )) && ( $propix < end( array_keys( $this->exdate ))))
 
5199
  $propix++;
5200
  if( !isset( $this->exdate[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5201
  return ( $inclParam ) ? $this->exdate[$propix] : $this->exdate[$propix]['value'];
5202
  break;
5203
  case 'EXRULE':
5204
- while( is_array( $this->exrule ) && !isset( $this->exrule[$propix] ) && ( 0 < count( $this->exrule )) && ( $propix < end( array_keys( $this->exrule ))))
 
5205
  $propix++;
5206
  if( !isset( $this->exrule[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5207
  return ( $inclParam ) ? $this->exrule[$propix] : $this->exrule[$propix]['value'];
5208
  break;
5209
  case 'FREEBUSY':
5210
- while( is_array( $this->freebusy ) && !isset( $this->freebusy[$propix] ) && ( 0 < count( $this->freebusy )) && ( $propix < end( array_keys( $this->freebusy ))))
 
5211
  $propix++;
5212
  if( !isset( $this->freebusy[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5213
  return ( $inclParam ) ? $this->freebusy[$propix] : $this->freebusy[$propix]['value'];
@@ -5231,7 +5317,8 @@ class calendarComponent {
5231
  if( !empty( $this->priority['value'] ) || ( isset( $this->priority['value'] ) && ('0' == $this->priority['value'] ))) return ( $inclParam ) ? $this->priority : $this->priority['value'];
5232
  break;
5233
  case 'RDATE':
5234
- while( is_array( $this->rdate ) && !isset( $this->rdate[$propix] ) && ( 0 < count( $this->rdate )) && ( $propix < end( array_keys( $this->rdate ))))
 
5235
  $propix++;
5236
  if( !isset( $this->rdate[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5237
  return ( $inclParam ) ? $this->rdate[$propix] : $this->rdate[$propix]['value'];
@@ -5240,7 +5327,8 @@ class calendarComponent {
5240
  if( !empty( $this->recurrenceid['value'] )) return ( $inclParam ) ? $this->recurrenceid : $this->recurrenceid['value'];
5241
  break;
5242
  case 'RELATED-TO':
5243
- while( is_array( $this->relatedto ) && !isset( $this->relatedto[$propix] ) && ( 0 < count( $this->relatedto )) && ( $propix < end( array_keys( $this->relatedto ))))
 
5244
  $propix++;
5245
  if( !isset( $this->relatedto[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5246
  return ( $inclParam ) ? $this->relatedto[$propix] : $this->relatedto[$propix]['value'];
@@ -5249,19 +5337,22 @@ class calendarComponent {
5249
  if( !empty( $this->repeat['value'] ) || ( isset( $this->repeat['value'] ) && ( '0' == $this->repeat['value'] ))) return ( $inclParam ) ? $this->repeat : $this->repeat['value'];
5250
  break;
5251
  case 'REQUEST-STATUS':
5252
- while( is_array( $this->requeststatus ) && !isset( $this->requeststatus[$propix] ) && ( 0 < count( $this->requeststatus )) && ( $propix < end( array_keys( $this->requeststatus ))))
 
5253
  $propix++;
5254
  if( !isset( $this->requeststatus[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5255
  return ( $inclParam ) ? $this->requeststatus[$propix] : $this->requeststatus[$propix]['value'];
5256
  break;
5257
  case 'RESOURCES':
5258
- while( is_array( $this->resources ) && !isset( $this->resources[$propix] ) && ( 0 < count( $this->resources )) && ( $propix < end( array_keys( $this->resources ))))
 
5259
  $propix++;
5260
  if( !isset( $this->resources[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5261
  return ( $inclParam ) ? $this->resources[$propix] : $this->resources[$propix]['value'];
5262
  break;
5263
  case 'RRULE':
5264
- while( is_array( $this->rrule ) && !isset( $this->rrule[$propix] ) && ( 0 < count( $this->rrule )) && ( $propix < end( array_keys( $this->rrule ))))
 
5265
  $propix++;
5266
  if( !isset( $this->rrule[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5267
  return ( $inclParam ) ? $this->rrule[$propix] : $this->rrule[$propix]['value'];
@@ -5285,7 +5376,8 @@ class calendarComponent {
5285
  if( !empty( $this->tzid['value'] )) return ( $inclParam ) ? $this->tzid : $this->tzid['value'];
5286
  break;
5287
  case 'TZNAME':
5288
- while( is_array( $this->tzname ) && !isset( $this->tzname[$propix] ) && ( 0 < count( $this->tzname )) && ( $propix < end( array_keys( $this->tzname ))))
 
5289
  $propix++;
5290
  if( !isset( $this->tzname[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5291
  return ( $inclParam ) ? $this->tzname[$propix] : $this->tzname[$propix]['value'];
@@ -5509,7 +5601,7 @@ class calendarComponent {
5509
  * parse component unparsed data into properties
5510
  *
5511
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
5512
- * @since 2.8.2 - 2011-05-21
5513
  * @param mixed $unparsedtext, optional, strict rfc2445 formatted, single property string or array of strings
5514
  * @return bool FALSE if error occurs during parsing
5515
  *
@@ -5546,8 +5638,10 @@ class calendarComponent {
5546
  $config = $this->getConfig();
5547
  foreach ( $unparsedtext as $line ) {
5548
  // echo $comp->objName.": $line<br />"; // test ###
5549
- if( in_array( strtoupper( substr( $line, 0, 6 )), array( 'END:VA', 'END:ST', 'END:DA' )))
5550
  $this->components[] = $comp->copy();
 
 
5551
  elseif( 'END:' == strtoupper( substr( $line, 0, 4 )))
5552
  break;
5553
  elseif( 'BEGIN:VALARM' == strtoupper( substr( $line, 0, 12 )))
@@ -6039,6 +6133,7 @@ class calendarComponent {
6039
  *
6040
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
6041
  * @since 2.6.27 - 2010-12-12
 
6042
  * @return string
6043
  */
6044
  function createSubComponent() {
@@ -6069,49 +6164,49 @@ class calendarComponent {
6069
  * Fix uses var $breakAtChar=75 and breaks the line at $breakAtChar-1 if need be.
6070
  *
6071
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
6072
- * @since 2.6.13 - 2010-12-06
6073
  * @param string $value
6074
  * @return string
6075
  */
6076
  function _size75( $string ) {
6077
- $tmp = $string;
6078
- $string = null;
6079
- /* if PHP is config with mb_string.. . */
6080
- if( defined( MB_OVERLOAD_STRING )) {
 
6081
  $strlen = mb_strlen( $tmp );
6082
  while( $strlen > 75 ) {
6083
- $breakAtChar = 75;
6084
- if( substr( $tmp, ( $breakAtChar - 1 ), strlen( '\n' )) == '\n' )
6085
- $breakAtChar = $breakAtChar - 1;
 
6086
  $string .= mb_substr( $tmp, 0, $breakAtChar );
6087
- if( '\n' == substr( $string, ( 0 - strlen( '\n' ))))
6088
- $string = substr( $string, 0, ( strlen( $string ) - strlen( '\n' )));
6089
- if( $this->nl != mb_substr( $string, ( 0 - strlen( $this->nl ))))
6090
  $string .= $this->nl;
6091
- $tmp = ' '.mb_substr( $tmp, $breakAtChar );
 
 
6092
  $strlen = mb_strlen( $tmp );
6093
  } // end while
6094
  if( 0 < $strlen ) {
6095
  $string .= $tmp; // the rest
6096
- if( '\n' == substr( $string, ( 0 - strlen( '\n' ))))
6097
- $string = substr( $string, 0, ( strlen( $string ) - strlen( '\n' )));
6098
- if( $this->nl != mb_substr( $string, ( 0 - strlen( $this->nl ))))
6099
  $string .= $this->nl;
6100
  }
6101
  return $string;
6102
  }
6103
  /* if PHP is not config with mb_string.. . */
6104
- $eolcharlen = strlen( '\n' );
6105
  while( TRUE ) {
6106
  $bytecnt = strlen( $tmp );
6107
  $charCnt = $ix = 0;
6108
  for( $ix = 0; $ix < $bytecnt; $ix++ ) {
6109
- if(( 73 < $charCnt ) && ( '\n' == substr( $tmp, $ix, $eolcharlen ))) {
6110
- $ix += $eolcharlen;
6111
- break; // break when '\n' and eol
 
 
 
6112
  }
6113
- elseif( 74 < $charCnt )
6114
- break; // always break for-loop here
6115
  else {
6116
  $byte = ord( $tmp[$ix] );
6117
  if ($byte <= 127) { // add a one byte character
@@ -6132,8 +6227,6 @@ class calendarComponent {
6132
  }
6133
  }
6134
  } // end for
6135
- if( '\n' == substr( $string, ( 0 - strlen( '\n' ))))
6136
- $string = substr( $string, 0, ( strlen( $string ) - strlen( '\n' )));
6137
  if( $this->nl != substr( $string, ( 0 - strlen( $this->nl ))))
6138
  $string .= $this->nl;
6139
  $tmp = substr( $tmp, $ix );
@@ -6142,12 +6235,6 @@ class calendarComponent {
6142
  else
6143
  $tmp = ' '.$tmp;
6144
  } // end while
6145
- if( !empty( $tmp )) {
6146
- if( '\n' == substr( $string, ( 0 - strlen( '\n' ))))
6147
- $string = substr( $string, 0, ( strlen( $string ) - strlen( '\n' ))).$this->nl;
6148
- if( $this->nl != substr( $string, ( 0 - strlen( $this->nl ))))
6149
- $string .= $this->nl;
6150
- }
6151
  return $string;
6152
  }
6153
  /**
@@ -6314,7 +6401,7 @@ class vevent extends calendarComponent {
6314
  * create formatted output for calendar component VEVENT object instance
6315
  *
6316
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
6317
- * @since 2.5.1 - 2008-11-07
6318
  * @param array $xcaldecl
6319
  * @return string
6320
  */
@@ -6786,6 +6873,10 @@ class valarm extends calendarComponent {
6786
  $component .= $this->createTrigger();
6787
  $component .= $this->createXprop();
6788
  $component .= $this->componentEnd1.$objectname.$this->componentEnd2;
 
 
 
 
6789
  return $component;
6790
  }
6791
  }
1
  <?php
2
  /*********************************************************************************/
3
  /**
4
+ * iCalcreator v2.10.23
5
  * copyright (c) 2007-2011 Kjell-Inge Gustafsson kigkonsult
6
+ * kigkonsult.se/iCalcreator/index.php
7
  * ical@kigkonsult.se
8
  *
9
  * Description:
44
  }
45
  */
46
  /*********************************************************************************/
47
+ /* only for phpversion 5.1 and later, */
48
+ /* date management, default timezone setting */
49
+ /* since 2.6.36 - 2010-12-31 */
50
+ if( substr( phpversion(), 0, 3 ) >= '5.1' )
51
+ // && ( 'UTC' == date_default_timezone_get()))
52
+ date_default_timezone_set( 'Europe/Stockholm' );
53
+ /*********************************************************************************/
54
  /* since 2.6.22 - 2010-09-25, do NOT remove!! */
55
+ require_once 'iCalUtilityFunctions.class.php';
56
  /*********************************************************************************/
57
  /* version, do NOT remove!! */
58
+ define( 'ICALCREATOR_VERSION', 'iCalcreator 2.10.23' );
59
  /*********************************************************************************/
60
  /*********************************************************************************/
61
  /**
131
  * creates formatted output for calendar property calscale
132
  *
133
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
134
+ * @since 2.10.16 - 2011-10-28
135
  * @return string
136
  */
137
  function createCalscale() {
138
  if( empty( $this->calscale )) return FALSE;
139
  switch( $this->format ) {
140
  case 'xcal':
141
+ return $this->nl.' calscale="'.$this->calscale.'"';
142
  break;
143
  default:
144
  return 'CALSCALE:'.$this->calscale.$this->nl;
165
  * creates formatted output for calendar property method
166
  *
167
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
168
+ * @since 2.10.16 - 2011-10-28
169
  * @return string
170
  */
171
  function createMethod() {
172
  if( empty( $this->method )) return FALSE;
173
  switch( $this->format ) {
174
  case 'xcal':
175
+ return $this->nl.' method="'.$this->method.'"';
176
  break;
177
  default:
178
  return 'METHOD:'.$this->method.$this->nl;
204
  * creates formatted output for calendar property prodid
205
  *
206
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
207
+ * @since 2.10.16 - 2011-10-28
208
  * @return string
209
  */
210
  function createProdid() {
212
  $this->_makeProdid();
213
  switch( $this->format ) {
214
  case 'xcal':
215
+ return $this->nl.' prodid="'.$this->prodid.'"';
216
  break;
217
  default:
218
  return 'PRODID:'.$this->prodid.$this->nl;
256
 
257
  *
258
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
259
+ * @since 2.10.16 - 2011-10-28
260
  * @return string
261
  */
262
  function createVersion() {
264
  $this->_makeVersion();
265
  switch( $this->format ) {
266
  case 'xcal':
267
+ return $this->nl.' version="'.$this->version.'"';
268
  break;
269
  default:
270
  return 'VERSION:'.$this->version.$this->nl;
302
  * creates formatted output for calendar property x-prop, iCal format only
303
  *
304
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
305
+ * @since 2.10.16 - 2011-11-01
306
  * @return string
307
  */
308
  function createXprop() {
 
 
309
  if( empty( $this->xprop ) || !is_array( $this->xprop )) return FALSE;
310
  $output = null;
311
  $toolbox = new calendarComponent();
324
  else
325
  $xpropPart['value'] = $toolbox->_strrep( $xpropPart['value'] );
326
  $output .= $toolbox->_createElement( $label, $attributes, $xpropPart['value'] );
327
+ if( is_array( $toolbox->xcaldecl ) && ( 0 < count( $toolbox->xcaldecl ))) {
328
+ foreach( $toolbox->xcaldecl as $localxcaldecl )
329
+ $this->xcaldecl[] = $localxcaldecl;
330
+ }
331
  }
332
  return $output;
333
  }
654
  * general vcalendar config setting
655
  *
656
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
657
+ * @since 2.10.18 - 2011-10-28
658
  * @param mixed $config
659
  * @param string $value
660
  * @return void
661
  */
662
  function setConfig( $config, $value = FALSE) {
663
  if( is_array( $config )) {
664
+ $ak = array_keys( $config );
665
+ foreach( $ak as $k ) {
666
+ if( 'DIRECTORY' == strtoupper( $k )) {
667
+ if( FALSE === $this->setConfig( 'DIRECTORY', $config[$k] ))
668
+ return FALSE;
669
+ unset( $config[$k] );
670
+ }
671
+ elseif( 'NEWLINECHAR' == strtoupper( $k )) {
672
+ if( FALSE === $this->setConfig( 'NEWLINECHAR', $config[$k] ))
673
+ return FALSE;
674
+ unset( $config[$k] );
675
+ }
676
+ }
677
  foreach( $config as $cKey => $cValue ) {
678
  if( FALSE === $this->setConfig( $cKey, $cValue ))
679
  return FALSE;
757
  case 'NL':
758
  case 'NEWLINECHAR':
759
  $this->nl = $value;
760
+ if( 'xcal' == $value ) {
761
+ $this->attributeDelimiter = $this->nl;
762
+ $this->valueInit = null;
763
+ }
764
+ else {
765
+ $this->attributeDelimiter = ';';
766
+ $this->valueInit = ':';
767
+ }
768
  $subcfg = array( 'NL' => $value );
769
  $res = TRUE;
770
  break;
1025
  * No date controls occurs.
1026
  *
1027
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1028
+ * @since 2.10.22 - 2011-11-19
1029
  * @param mixed $startY optional, start Year, default current Year ALT. array selecOptions
1030
+ * @param int $startM optional, start Month, default current Month
1031
+ * @param int $startD optional, start Day, default current Day
1032
+ * @param int $endY optional, end Year, default $startY
1033
+ * @param int $endY optional, end Month, default $startM
1034
+ * @param int $endY optional, end Day, default $startD
1035
+ * @param mixed $cType optional, calendar component type(-s), default FALSE=all else string/array type(-s)
1036
+ * @param bool $flat optional, FALSE (default) => output : array[Year][Month][Day][]
1037
+ * TRUE => output : array[] (ignores split)
1038
+ * @param bool $any optional, TRUE (default) - select component that take place within period
1039
+ * FALSE - only components that starts within period
1040
+ * @param bool $split optional, TRUE (default) - one component copy every day it take place during the
1041
  * period (implies flat=FALSE)
1042
+ * FALSE - one occurance of component only in output array
1043
  * @return array or FALSE
1044
  */
1045
  function selectComponents( $startY=FALSE, $startM=FALSE, $startD=FALSE, $endY=FALSE, $endM=FALSE, $endD=FALSE, $cType=FALSE, $flat=FALSE, $any=TRUE, $split=TRUE ) {
1078
  $cType = $validTypes;
1079
  if( 0 >= count( $cType ))
1080
  $cType = $validTypes;
1081
+ if(( FALSE === $flat ) && ( FALSE === $any )) // invalid combination
1082
+ $split = FALSE;
1083
  if(( TRUE === $flat ) && ( TRUE === $split )) // invalid combination
1084
  $split = FALSE;
1085
  /* iterate components */
1093
  /* select due when dtstart is missing */
1094
  if( empty( $start ) && ( $component->objName == 'vtodo' ) && ( FALSE === ( $start = $component->getProperty( 'due' ))))
1095
  continue;
1096
+ $dtendExist = $dueExist = $durationExist = $endAllDayEvent = $recurrid = FALSE;
1097
  unset( $end, $startWdate, $endWdate, $rdurWsecs, $rdur, $exdatelist, $workstart, $workend, $endDateFormat ); // clean up
1098
  $startWdate = iCalUtilityFunctions::_date2timestamp( $start );
1099
  $startDateFormat = ( isset( $start['hour'] )) ? 'Y-m-d H:i:s' : 'Y-m-d';
1137
  $end = array( 'year' => $start['year'], 'month' => $start['month'], 'day' => $start['day'], 'hour' => 23, 'min' => 59, 'sec' => 59 );
1138
  $endWdate = iCalUtilityFunctions::_date2timestamp( $end );
1139
  }
1140
+ $rdurWsecs = $endWdate - $startWdate; // compute event (component) duration in seconds
1141
  /* make a list of optional exclude dates for component occurence from exrule and exdate */
1142
  $exdatelist = array();
1143
  $workstart = iCalUtilityFunctions::_timestamp2date(( $startDate - $rdurWsecs ), 6);
1147
  while( FALSE !== ( $exdate = $component->getProperty( 'exdate' ))) { // check exdate
1148
  foreach( $exdate as $theExdate ) {
1149
  $exWdate = iCalUtilityFunctions::_date2timestamp( $theExdate );
1150
+ $exWdate = mktime( 0, 0, 0, date( 'm', $exWdate ), date( 'd', $exWdate ), date( 'Y', $exWdate )); // on a day-basis !!!
1151
  if((( $startDate - $rdurWsecs ) <= $exWdate ) && ( $endDate >= $exWdate ))
1152
  $exdatelist[$exWdate] = TRUE;
1153
+ } // end - foreach( $exdate as $theExdate )
1154
+ } // end - check exdate
1155
+ $compUID = $component->getProperty( 'UID' );
1156
+ /* check reccurrence-id (with sequence), remove hit with reccurr-id date */
1157
+ if(( FALSE !== ( $recurrid = $component->getProperty( 'recurrence-id' ))) &&
1158
+ ( FALSE !== ( $sequence = $component->getProperty( 'sequence' ))) ) {
1159
+ $recurrid = iCalUtilityFunctions::_date2timestamp( $recurrid );
1160
+ $recurrid = mktime( 0, 0, 0, date( 'm', $recurrid ), date( 'd', $recurrid ), date( 'Y', $recurrid )); // on a day-basis !!!
1161
+ $endD = $recurrid + $rdurWsecs;
1162
+ do {
1163
+ if( date( 'Ymd', $startWdate ) != date( 'Ymd', $recurrid ))
1164
+ $exdatelist[$recurrid] = TRUE; // exclude all other days than startdate
1165
+ $wd = getdate( $recurrid );
1166
+ if( isset( $result[$wd['year']][$wd['mon']][$wd['mday']][$compUID] ))
1167
+ unset( $result[$wd['year']][$wd['mon']][$wd['mday']][$compUID] ); // remove from output, dtstart etc added below
1168
+ if( $split && ( $recurrid <= $endD ))
1169
+ $recurrid = mktime( 0, 0, 0, date( 'm', $recurrid ), date( 'd', $recurrid ) + 1, date( 'Y', $recurrid )); // step one day
1170
+ else
1171
+ break;
1172
+ } while( TRUE );
1173
+ } // end recurrence-id test
1174
+ /* select only components with startdate within period */
1175
+ if(( $startWdate >= $startDate ) && ( $startWdate <= $endDate )) {
1176
+ /* add the selected component (WITHIN valid dates) to output array */
1177
+ if( $flat ) { // any=true/false, ignores split
1178
+ if( !$recurrid )
1179
+ $result[$compUID] = $component->copy(); // copy original to output (but not anyone with recurrence-id)
1180
  }
1181
+ elseif( $split ) { // split the original component
1182
+ if( $endWdate > $endDate )
1183
+ $endWdate = $endDate; // use period end date
1184
+ $rstart = $startWdate;
1185
+ if( $rstart < $startDate )
1186
+ $rstart = $startDate; // use period start date
1187
+ $startYMD = date( 'Ymd', $rstart );
1188
+ $endYMD = date( 'Ymd', $endWdate );
1189
+ $checkDate = mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1190
+ while( date( 'Ymd', $rstart ) <= $endYMD ) { // iterate
1191
+ $checkDate = mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1192
+ if( isset( $exdatelist[$checkDate] )) { // exclude any recurrence date, found in exdatelist
1193
+ $rstart = mktime( date( 'H', $rstart ), date( 'i', $rstart ), date( 's', $rstart ), date( 'm', $rstart ), date( 'd', $rstart ) + 1, date( 'Y', $rstart ) ); // step one day
1194
+ continue;
1195
+ }
1196
+ if( date( 'Ymd', $rstart ) > $startYMD ) // date after dtstart
1197
+ $datestring = date( $startDateFormat, mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart )));
1198
+ else
1199
+ $datestring = date( $startDateFormat, $rstart );
1200
+ if( isset( $start['tz'] ))
1201
+ $datestring .= ' '.$start['tz'];
1202
+ // echo "X-CURRENT-DTSTART 3 = $datestring xRecurrence=$xRecurrence tcnt =".++$tcnt."<br />";$component->setProperty( 'X-CNT', $tcnt ); // test ###
1203
+ $component->setProperty( 'X-CURRENT-DTSTART', $datestring );
1204
+ if( $dtendExist || $dueExist || $durationExist ) {
1205
+ if( date( 'Ymd', $rstart ) < $endYMD ) // not the last day
1206
+ $tend = mktime( 23, 59, 59, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ));
1207
+ else
1208
+ $tend = mktime( date( 'H', $endWdate ), date( 'i', $endWdate ), date( 's', $endWdate ), date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1209
+ $datestring = date( $endDateFormat, $tend );
1210
+ if( isset( $end['tz'] ))
1211
+ $datestring .= ' '.$end['tz'];
1212
+ $propName = ( !$dueExist ) ? 'X-CURRENT-DTEND' : 'X-CURRENT-DUE';
1213
+ $component->setProperty( $propName, $datestring );
1214
+ } // end if( $dtendExist || $dueExist || $durationExist )
1215
+ $wd = getdate( $rstart );
1216
+ $result[$wd['year']][$wd['mon']][$wd['mday']][$compUID] = $component->copy(); // copy to output
1217
+ $rstart = mktime( date( 'H', $rstart ), date( 'i', $rstart ), date( 's', $rstart ), date( 'm', $rstart ), date( 'd', $rstart ) + 1, date( 'Y', $rstart ) ); // step one day
1218
+ } // end while( $rstart <= $endWdate )
1219
+ } // end if( $split ) - else use component date
1220
+ elseif( $recurrid && !$flat && !$any && !$split )
1221
+ $continue = TRUE;
1222
+ else { // !$flat && !$split, i.e. no flat array and DTSTART within period
1223
+ $checkDate = mktime( 0, 0, 0, date( 'm', $startWdate ), date( 'd', $startWdate ), date( 'Y', $startWdate ) ); // on a day-basis !!!
1224
+ if( !$any || !isset( $exdatelist[$checkDate] )) { // exclude any recurrence date, found in exdatelist
1225
+ $wd = getdate( $startWdate );
1226
+ $result[$wd['year']][$wd['mon']][$wd['mday']][$compUID] = $component->copy(); // copy to output
1227
+ }
1228
+ }
1229
+ } // end if(( $startWdate >= $startDate ) && ( $startWdate <= $endDate ))
1230
+ /* if 'any' components, check components with reccurrence rules, removing all excluding dates */
1231
  if( TRUE === $any ) {
1232
  /* make a list of optional repeating dates for component occurence, rrule, rdate */
1233
  $recurlist = array();
1259
  $recurlist[$theRdate] = $rdurWsecs; // set start date for recurrence instance + event duration in seconds
1260
  }
1261
  }
1262
+ } // end - check rdate
1263
  if( 0 < count( $recurlist )) {
1264
  ksort( $recurlist );
1265
  $xRecurrence = 1;
1266
+ $component2 = $component->copy();
1267
+ $compUID = $component2->getProperty( 'UID' );
1268
  foreach( $recurlist as $recurkey => $durvalue ) {
1269
  // echo "recurKey=".date( 'Y-m-d H:i:s', $recurkey ).' dur='.iCalUtilityFunctions::offsetSec2His( $durvalue )."<br />\n"; // test ###;
1270
  if((( $startDate - $rdurWsecs ) > $recurkey ) || ( $endDate < $recurkey )) // not within period
1274
  continue;
1275
  if( $startWdate >= $recurkey ) // exclude component start date
1276
  continue;
 
1277
  $rstart = $recurkey;
1278
  $rend = $recurkey + $durvalue;
1279
  /* add repeating components within valid dates to output array, only start date set */
1280
  if( $flat ) {
1281
+ if( !isset( $result[$compUID] )) // only one comp
1282
+ $result[$compUID] = $component2->copy(); // copy to output
 
 
 
 
 
 
 
 
 
 
 
 
1283
  }
1284
  /* add repeating components within valid dates to output array, one each day */
1285
  elseif( $split ) {
1315
  } // end if( $dtendExist || $dueExist || $durationExist )
1316
  $component2->setProperty( 'X-RECURRENCE', $xRecurrence );
1317
  $wd = getdate( $rstart );
1318
+ $result[$wd['year']][$wd['mon']][$wd['mday']][$compUID] = $component2->copy(); // copy to output
1319
  } // end if( $checkDate > $startYMD ) { // date after dtstart
1320
  $rstart = mktime( date( 'H', $rstart ), date( 'i', $rstart ), date( 's', $rstart ), date( 'm', $rstart ), date( 'd', $rstart ) + 1, date( 'Y', $rstart ) ); // step one day
1321
  } // end while( $rstart <= $rend )
1322
  $xRecurrence += 1;
1323
  } // end elseif( $split )
1324
+ elseif( $rstart >= $startDate ) { // date within period //* flat=FALSE && split=FALSE => one comp every recur startdate *//
1325
  $checkDate = mktime( 0, 0, 0, date( 'm', $rstart ), date( 'd', $rstart ), date( 'Y', $rstart ) ); // on a day-basis !!!
1326
  if( !isset( $exdatelist[$checkDate] )) { // exclude any recurrence START date, found in exdatelist
1327
  $xRecurrence += 1;
1331
  //echo "X-CURRENT-DTSTART 2 = $datestring xRecurrence=$xRecurrence tcnt =".++$tcnt."<br />";$component2->setProperty( 'X-CNT', $tcnt ); // test ###
1332
  $component2->setProperty( 'X-CURRENT-DTSTART', $datestring );
1333
  if( $dtendExist || $dueExist || $durationExist ) {
1334
+ $tend = $rstart + $rdurWsecs;
1335
+ if( date( 'Ymd', $tend ) < date( 'Ymd', $endWdate ))
1336
+ $tend = mktime( 23, 59, 59, date( 'm', $tend ), date( 'd', $tend ), date( 'Y', $tend ));
1337
  else
1338
+ $tend = mktime( date( 'H', $endWdate ), date( 'i', $endWdate ), date( 's', $endWdate ), date( 'm', $tend ), date( 'd', $tend ), date( 'Y', $tend ) ); // on a day-basis !!!
1339
  $datestring = date( $endDateFormat, $tend );
1340
  if( isset( $end['tz'] ))
1341
  $datestring .= ' '.$end['tz'];
1344
  } // end if( $dtendExist || $dueExist || $durationExist )
1345
  $component2->setProperty( 'X-RECURRENCE', $xRecurrence );
1346
  $wd = getdate( $rstart );
1347
+ $result[$wd['year']][$wd['mon']][$wd['mday']][$compUID] = $component2->copy(); // copy to output
1348
  } // end if( !isset( $exdatelist[$checkDate] ))
1349
  } // end elseif( $rstart >= $startDate )
1350
  } // end foreach( $recurlist as $recurkey => $durvalue )
1353
  if(( $endWdate < $startDate ) || ( $startWdate > $endDate ))
1354
  continue;
1355
  } // end if( TRUE === $any )
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1356
  } // end foreach ( $this->components as $cix => $component )
1357
  if( 0 >= count( $result )) return FALSE;
1358
  elseif( !$flat ) {
1359
  foreach( $result as $y => $yeararr ) {
1360
  foreach( $yeararr as $m => $montharr ) {
1361
+ foreach( $montharr as $d => $dayarr ) {
1362
+ if( empty( $result[$y][$m][$d] ))
1363
+ unset( $result[$y][$m][$d] );
1364
+ else
1365
+ $result[$y][$m][$d] = array_values( $dayarr ); // skip tricky UID-index, hoping they are in hour order.. .
1366
+ }
1367
+ if( empty( $result[$y][$m] ))
1368
+ unset( $result[$y][$m] );
1369
+ else
1370
+ ksort( $result[$y][$m] );
1371
  }
1372
+ if( empty( $result[$y] ))
1373
+ unset( $result[$y] );
1374
+ else
1375
+ ksort( $result[$y] );
1376
  }
1377
+ if( empty( $result ))
1378
+ unset( $result );
1379
+ else
1380
+ ksort( $result );
1381
  } // end elseif( !$flat )
1382
+ if( 0 >= count( $result ))
1383
+ return FALSE;
1384
  return $result;
1385
  }
1386
  /**
1812
  * creates formatted output for calendar object instance
1813
  *
1814
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1815
+ * @since 2.10.16 - 2011-10-28
1816
  * @return string
1817
  */
1818
  function createCalendar() {
1819
+ $calendarInit = $calendarxCaldecl = $calendarStart = $calendar = '';
1820
  switch( $this->format ) {
1821
  case 'xcal':
1822
+ $calendarInit = '<?xml version="1.0" encoding="UTF-8"?>'.$this->nl.
1823
+ '<!DOCTYPE vcalendar PUBLIC "-//IETF//DTD XCAL/iCalendar XML//EN"'.$this->nl.
1824
  '"http://www.ietf.org/internet-drafts/draft-ietf-calsch-many-xcal-01.txt"';
1825
+ $calendarStart = '>'.$this->nl.'<vcalendar';
 
1826
  break;
1827
  default:
1828
  $calendarStart = 'BEGIN:VCALENDAR'.$this->nl;
1832
  $calendarStart .= $this->createProdid();
1833
  $calendarStart .= $this->createCalscale();
1834
  $calendarStart .= $this->createMethod();
1835
+ if( 'xcal' == $this->format )
1836
+ $calendarStart .= '>'.$this->nl;
 
 
 
 
 
 
 
 
1837
  $calendar .= $this->createXprop();
1838
+
1839
  foreach( $this->components as $component ) {
1840
  if( empty( $component )) continue;
1841
  $component->setConfig( $this->getConfig(), FALSE, TRUE );
1842
  $calendar .= $component->createComponent( $this->xcaldecl );
1843
  }
1844
+ if(( 'xcal' == $this->format ) && ( 0 < count( $this->xcaldecl ))) { // xCal only
1845
+ $calendarInit .= ' [';
1846
+ $old_xcaldecl = array();
1847
  foreach( $this->xcaldecl as $declix => $declPart ) {
1848
+ if(( 0 < count( $old_xcaldecl)) &&
1849
+ isset( $declPart['uri'] ) && isset( $declPart['external'] ) &&
1850
+ isset( $old_xcaldecl['uri'] ) && isset( $old_xcaldecl['external'] ) &&
1851
+ ( in_array( $declPart['uri'], $old_xcaldecl['uri'] )) &&
1852
  ( in_array( $declPart['external'], $old_xcaldecl['external'] )))
1853
  continue; // no duplicate uri and ext. references
1854
+ if(( 0 < count( $old_xcaldecl)) &&
1855
+ !isset( $declPart['uri'] ) && !isset( $declPart['uri'] ) &&
1856
+ isset( $declPart['ref'] ) && isset( $old_xcaldecl['ref'] ) &&
1857
+ ( in_array( $declPart['ref'], $old_xcaldecl['ref'] )))
1858
+ continue; // no duplicate element declarations
1859
+ $calendarxCaldecl .= $this->nl.'<!';
1860
  foreach( $declPart as $declKey => $declValue ) {
1861
  switch( $declKey ) { // index
1862
  case 'xmldecl': // no 1
1868
  break;
1869
  case 'ref': // no 3
1870
  $calendarxCaldecl .= $declValue.' ';
1871
+ $old_xcaldecl['ref'][] = $declValue;
1872
  break;
1873
  case 'external': // no 4
1874
  $calendarxCaldecl .= '"'.$declValue.'" ';
1882
  break;
1883
  }
1884
  }
1885
+ $calendarxCaldecl .= '>';
1886
  }
1887
+ $calendarxCaldecl .= $this->nl.']';
1888
  }
1889
  switch( $this->format ) {
1890
  case 'xcal':
1894
  $calendar .= 'END:VCALENDAR'.$this->nl;
1895
  break;
1896
  }
1897
+ return $calendarInit.$calendarxCaldecl.$calendarStart.$calendar;
1898
  }
1899
  /**
1900
  * a HTTP redirect header is sent with created, updated and/or parsed calendar
1901
  *
1902
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
1903
+ * @since 2.10.20 - 2011-11-14
1904
  * @param bool $utf8Encode
1905
  * @param bool $gzip
1906
  * @return redirect
1907
  */
1908
  function returnCalendar( $utf8Encode=FALSE, $gzip=FALSE ) {
1909
  $filename = $this->getConfig( 'filename' );
1910
+ $output = $this->createCalendar();
1911
+ $headers = array();
1912
  if( $utf8Encode )
1913
  $output = utf8_encode( $output );
1914
  if( $gzip ) {
1915
  $output = gzencode( $output, 9 );
1916
+ $headers[] = 'Content-Encoding: gzip';
1917
+ $headers[] = 'Vary: *';
1918
  }
 
1919
  if( 'xcal' == $this->format )
1920
+ $headers[] = 'Content-Type: application/calendar+xml; charset=utf-8';
1921
  else
1922
+ $headers[] = 'Content-Type: text/calendar; charset=utf-8';
1923
+ // $headers[] = 'Content-Length: '.$octets;
1924
+ $headers[] = 'Content-Disposition: attachment; filename="'.$filename.'"';
1925
+ $headers[] = 'Cache-Control: max-age=10';
1926
+ foreach( $headers as $header )
1927
+ header( $header );
1928
+ die( $output );
1929
  }
1930
  /**
1931
  * save content in a file
2658
  * computes datestamp for calendar component object instance dtstamp
2659
  *
2660
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
2661
+ * @since 2.10.9 - 2011-08-10
2662
  * @return void
2663
  */
2664
  function _makeDtstamp() {
2665
+ $d = mktime( date('H'), date('i'), (date('s') - date( 'Z' )), date('m'), date('d'), date('Y'));
2666
  $this->dtstamp['value'] = array( 'year' => date( 'Y', $d )
2667
  , 'month' => date( 'm', $d )
2668
  , 'day' => date( 'd', $d )
3797
  /**
3798
  * set calendar component property sequence
3799
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
3800
+ * @since 2.10.8 - 2011-09-19
3801
  * @param int $value optional
3802
  * @param array $params optional
3803
  * @return bool
3804
  */
3805
  function setSequence( $value=FALSE, $params=FALSE ) {
3806
  if(( empty( $value ) && !is_numeric( $value )) && ( '0' != $value ))
3807
+ $value = ( isset( $this->sequence['value'] ) && ( -1 < $this->sequence['value'] )) ? $this->sequence['value'] + 1 : '0';
3808
  $this->sequence = array( 'value' => $value, 'params' => iCalUtilityFunctions::_setParams( $params ));
3809
  return TRUE;
3810
  }
4393
  * creates formatted output for calendar component property
4394
  *
4395
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
4396
+ * @since 2.10.16 - 2011-10-28
4397
  * @param string $label property name
4398
  * @param string $attributes property attributes
4399
  * @param string $content property content (optional)
4412
  $categoriesAttrLang = null;
4413
  $attachInlineBinary = FALSE;
4414
  $attachfmttype = null;
4415
+ if (( 'xcal' == $this->format) && ( 'x-' == substr( $label, 0, 2 ))) {
4416
+ $this->xcaldecl[] = array( 'xmldecl' => 'ELEMENT'
4417
+ , 'ref' => $label
4418
+ , 'type2' => '(#PCDATA)' );
4419
+ }
4420
  if( !empty( $attributes )) {
4421
  $attributes = trim( $attributes );
4422
+ if ( 'xcal' == $this->format ) {
4423
  $attributes2 = explode( $this->intAttrDelimiter, $attributes );
4424
  $attributes = null;
4425
+ foreach( $attributes2 as $aix => $attribute ) {
4426
  $attrKVarr = explode( '=', $attribute );
4427
  if( empty( $attrKVarr[0] ))
4428
  continue;
4429
  if( !isset( $attrKVarr[1] )) {
4430
  $attrValue = $attrKVarr[0];
4431
+ $attrKey = $aix;
4432
  }
4433
  elseif( 2 == count( $attrKVarr)) {
4434
  $attrKey = strtolower( $attrKVarr[0] );
4462
  $attributes = str_replace( $this->intAttrDelimiter, $this->attributeDelimiter, $attributes );
4463
  }
4464
  }
4465
+ if(( 'xcal' == $this->format) &&
4466
+ ((( 'attach' == $label ) && !$attachInlineBinary ) || ( in_array( $label, array( 'tzurl', 'url' ))))) {
4467
  $pos = strrpos($content, "/");
4468
  $docname = ( $pos !== false) ? substr( $content, (1 - strlen( $content ) + $pos )) : $content;
4469
  $this->xcaldecl[] = array( 'xmldecl' => 'ENTITY'
4477
  $content = null;
4478
  if( 'attach' == $label ) {
4479
  $attributes = str_replace( $this->attributeDelimiter, $this->intAttrDelimiter, $attributes );
4480
+ $content = $this->nl.$this->_createElement( 'extref', $attributes, null );
4481
  $attributes = null;
4482
  }
4483
  }
4484
+ elseif(( 'xcal' == $this->format) && ( 'attach' == $label ) && $attachInlineBinary ) {
4485
  $content = $this->nl.$this->_createElement( 'b64bin', $attachfmttype, $content ); // max one attribute
4486
  }
4487
  $output .= $attributes;
4489
  switch( $this->format ) {
4490
  case 'xcal':
4491
  $output .= ' /';
4492
+ $output .= $this->elementStart2.$this->nl;
4493
  return $output;
4494
  break;
4495
  default:
4814
  * general component config setting
4815
  *
4816
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
4817
+ * @since 2.10.18 - 2011-10-28
4818
  * @param mixed $config
4819
  * @param string $value
4820
  * @param bool $softUpdate
4822
  */
4823
  function setConfig( $config, $value = FALSE, $softUpdate = FALSE ) {
4824
  if( is_array( $config )) {
4825
+ $ak = array_keys( $config );
4826
+ foreach( $ak as $k ) {
4827
+ if( 'NEWLINECHAR' == strtoupper( $k )) {
4828
+ if( FALSE === $this->setConfig( 'NEWLINECHAR', $config[$k] ))
4829
+ return FALSE;
4830
+ unset( $config[$k] );
4831
+ break;
4832
+ }
4833
+ }
4834
  foreach( $config as $cKey => $cValue ) {
4835
  if( FALSE === $this->setConfig( $cKey, $cValue, $softUpdate ))
4836
  return FALSE;
4862
  case 'NL':
4863
  case 'NEWLINECHAR':
4864
  $this->nl = $value;
4865
+ $this->_createFormat();
4866
  $subcfg = array( 'NL' => $value );
4867
  $res = TRUE;
4868
  break;
5185
  * if property has multiply values, consequtive function calls are needed
5186
  *
5187
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
5188
+ * @since 2.10.1 - 2011-07-16
5189
  * @param string $propName, optional
5190
  * @param int @propix, optional, if specific property is wanted in case of multiply occurences
5191
  * @param bool $inclParam=FALSE
5206
  if( !empty( $this->action['value'] )) return ( $inclParam ) ? $this->action : $this->action['value'];
5207
  break;
5208
  case 'ATTACH':
5209
+ $ak = ( is_array( $this->attach )) ? array_keys( $this->attach ) : array();
5210
+ while( is_array( $this->attach ) && !isset( $this->attach[$propix] ) && ( 0 < count( $this->attach )) && ( $propix < end( $ak )))
5211
  $propix++;
5212
  if( !isset( $this->attach[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5213
  return ( $inclParam ) ? $this->attach[$propix] : $this->attach[$propix]['value'];
5214
  break;
5215
  case 'ATTENDEE':
5216
+ $ak = ( is_array( $this->attendee )) ? array_keys( $this->attendee ) : array();
5217
+ while( is_array( $this->attendee ) && !isset( $this->attendee[$propix] ) && ( 0 < count( $this->attendee )) && ( $propix < end( $ak )))
5218
  $propix++;
5219
  if( !isset( $this->attendee[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5220
  return ( $inclParam ) ? $this->attendee[$propix] : $this->attendee[$propix]['value'];
5221
  break;
5222
  case 'CATEGORIES':
5223
+ $ak = ( is_array( $this->categories )) ? array_keys( $this->categories ) : array();
5224
+ while( is_array( $this->categories ) && !isset( $this->categories[$propix] ) && ( 0 < count( $this->categories )) && ( $propix < end( $ak )))
5225
  $propix++;
5226
  if( !isset( $this->categories[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5227
  return ( $inclParam ) ? $this->categories[$propix] : $this->categories[$propix]['value'];
5230
  if( !empty( $this->class['value'] )) return ( $inclParam ) ? $this->class : $this->class['value'];
5231
  break;
5232
  case 'COMMENT':
5233
+ $ak = ( is_array( $this->comment )) ? array_keys( $this->comment ) : array();
5234
+ while( is_array( $this->comment ) && !isset( $this->comment[$propix] ) && ( 0 < count( $this->comment )) && ( $propix < end( $ak )))
5235
  $propix++;
5236
  if( !isset( $this->comment[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5237
  return ( $inclParam ) ? $this->comment[$propix] : $this->comment[$propix]['value'];
5240
  if( !empty( $this->completed['value'] )) return ( $inclParam ) ? $this->completed : $this->completed['value'];
5241
  break;
5242
  case 'CONTACT':
5243
+ $ak = ( is_array( $this->contact )) ? array_keys( $this->contact ) : array();
5244
+ while( is_array( $this->contact ) && !isset( $this->contact[$propix] ) && ( 0 < count( $this->contact )) && ( $propix < end( $ak )))
5245
  $propix++;
5246
  if( !isset( $this->contact[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5247
  return ( $inclParam ) ? $this->contact[$propix] : $this->contact[$propix]['value'];
5250
  if( !empty( $this->created['value'] )) return ( $inclParam ) ? $this->created : $this->created['value'];
5251
  break;
5252
  case 'DESCRIPTION':
5253
+ $ak = ( is_array( $this->description )) ? array_keys( $this->description ) : array();
5254
+ while( is_array( $this->description ) && !isset( $this->description[$propix] ) && ( 0 < count( $this->description )) && ( $propix < end( $ak )))
5255
  $propix++;
5256
  if( !isset( $this->description[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5257
  return ( $inclParam ) ? $this->description[$propix] : $this->description[$propix]['value'];
5278
  return ( $inclParam ) ? array( 'value' => $value, 'params' => $this->duration['params'] ) : $value;
5279
  break;
5280
  case 'EXDATE':
5281
+ $ak = ( is_array( $this->exdate )) ? array_keys( $this->exdate ) : array();
5282
+ while( is_array( $this->exdate ) && !isset( $this->exdate[$propix] ) && ( 0 < count( $this->exdate )) && ( $propix < end( $ak )))
5283
  $propix++;
5284
  if( !isset( $this->exdate[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5285
  return ( $inclParam ) ? $this->exdate[$propix] : $this->exdate[$propix]['value'];
5286
  break;
5287
  case 'EXRULE':
5288
+ $ak = ( is_array( $this->exrule )) ? array_keys( $this->exrule ) : array();
5289
+ while( is_array( $this->exrule ) && !isset( $this->exrule[$propix] ) && ( 0 < count( $this->exrule )) && ( $propix < end( $ak )))
5290
  $propix++;
5291
  if( !isset( $this->exrule[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5292
  return ( $inclParam ) ? $this->exrule[$propix] : $this->exrule[$propix]['value'];
5293
  break;
5294
  case 'FREEBUSY':
5295
+ $ak = ( is_array( $this->freebusy )) ? array_keys( $this->freebusy ) : array();
5296
+ while( is_array( $this->freebusy ) && !isset( $this->freebusy[$propix] ) && ( 0 < count( $this->freebusy )) && ( $propix < end( $ak )))
5297
  $propix++;
5298
  if( !isset( $this->freebusy[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5299
  return ( $inclParam ) ? $this->freebusy[$propix] : $this->freebusy[$propix]['value'];
5317
  if( !empty( $this->priority['value'] ) || ( isset( $this->priority['value'] ) && ('0' == $this->priority['value'] ))) return ( $inclParam ) ? $this->priority : $this->priority['value'];
5318
  break;
5319
  case 'RDATE':
5320
+ $ak = ( is_array( $this->rdate )) ? array_keys( $this->rdate ) : array();
5321
+ while( is_array( $this->rdate ) && !isset( $this->rdate[$propix] ) && ( 0 < count( $this->rdate )) && ( $propix < end( $ak )))
5322
  $propix++;
5323
  if( !isset( $this->rdate[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5324
  return ( $inclParam ) ? $this->rdate[$propix] : $this->rdate[$propix]['value'];
5327
  if( !empty( $this->recurrenceid['value'] )) return ( $inclParam ) ? $this->recurrenceid : $this->recurrenceid['value'];
5328
  break;
5329
  case 'RELATED-TO':
5330
+ $ak = ( is_array( $this->relatedto )) ? array_keys( $this->relatedto ) : array();
5331
+ while( is_array( $this->relatedto ) && !isset( $this->relatedto[$propix] ) && ( 0 < count( $this->relatedto )) && ( $propix < end( $ak )))
5332
  $propix++;
5333
  if( !isset( $this->relatedto[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5334
  return ( $inclParam ) ? $this->relatedto[$propix] : $this->relatedto[$propix]['value'];
5337
  if( !empty( $this->repeat['value'] ) || ( isset( $this->repeat['value'] ) && ( '0' == $this->repeat['value'] ))) return ( $inclParam ) ? $this->repeat : $this->repeat['value'];
5338
  break;
5339
  case 'REQUEST-STATUS':
5340
+ $ak = ( is_array( $this->requeststatus )) ? array_keys( $this->requeststatus ) : array();
5341
+ while( is_array( $this->requeststatus ) && !isset( $this->requeststatus[$propix] ) && ( 0 < count( $this->requeststatus )) && ( $propix < end( $ak )))
5342
  $propix++;
5343
  if( !isset( $this->requeststatus[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5344
  return ( $inclParam ) ? $this->requeststatus[$propix] : $this->requeststatus[$propix]['value'];
5345
  break;
5346
  case 'RESOURCES':
5347
+ $ak = ( is_array( $this->resources )) ? array_keys( $this->resources ) : array();
5348
+ while( is_array( $this->resources ) && !isset( $this->resources[$propix] ) && ( 0 < count( $this->resources )) && ( $propix < end( $ak )))
5349
  $propix++;
5350
  if( !isset( $this->resources[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5351
  return ( $inclParam ) ? $this->resources[$propix] : $this->resources[$propix]['value'];
5352
  break;
5353
  case 'RRULE':
5354
+ $ak = ( is_array( $this->rrule )) ? array_keys( $this->rrule ) : array();
5355
+ while( is_array( $this->rrule ) && !isset( $this->rrule[$propix] ) && ( 0 < count( $this->rrule )) && ( $propix < end( $ak )))
5356
  $propix++;
5357
  if( !isset( $this->rrule[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5358
  return ( $inclParam ) ? $this->rrule[$propix] : $this->rrule[$propix]['value'];
5376
  if( !empty( $this->tzid['value'] )) return ( $inclParam ) ? $this->tzid : $this->tzid['value'];
5377
  break;
5378
  case 'TZNAME':
5379
+ $ak = ( is_array( $this->tzname )) ? array_keys( $this->tzname ) : array();
5380
+ while( is_array( $this->tzname ) && !isset( $this->tzname[$propix] ) && ( 0 < count( $this->tzname )) && ( $propix < end( $ak )))
5381
  $propix++;
5382
  if( !isset( $this->tzname[$propix] )) { unset( $this->propix[$propName] ); return FALSE; }
5383
  return ( $inclParam ) ? $this->tzname[$propix] : $this->tzname[$propix]['value'];
5601
  * parse component unparsed data into properties
5602
  *
5603
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
5604
+ * @since 2.10.2 - 2011-07-17
5605
  * @param mixed $unparsedtext, optional, strict rfc2445 formatted, single property string or array of strings
5606
  * @return bool FALSE if error occurs during parsing
5607
  *
5638
  $config = $this->getConfig();
5639
  foreach ( $unparsedtext as $line ) {
5640
  // echo $comp->objName.": $line<br />"; // test ###
5641
+ if( in_array( strtoupper( substr( $line, 0, 6 )), array( 'END:VA', 'END:DA' )))
5642
  $this->components[] = $comp->copy();
5643
+ elseif( 'END:ST' == strtoupper( substr( $line, 0, 6 )))
5644
+ array_unshift( $this->components, $comp->copy());
5645
  elseif( 'END:' == strtoupper( substr( $line, 0, 4 )))
5646
  break;
5647
  elseif( 'BEGIN:VALARM' == strtoupper( substr( $line, 0, 12 )))
6133
  *
6134
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
6135
  * @since 2.6.27 - 2010-12-12
6136
+ * @param array $xcaldecl
6137
  * @return string
6138
  */
6139
  function createSubComponent() {
6164
  * Fix uses var $breakAtChar=75 and breaks the line at $breakAtChar-1 if need be.
6165
  *
6166
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
6167
+ * @since 2.10.11 - 2011-09-01
6168
  * @param string $value
6169
  * @return string
6170
  */
6171
  function _size75( $string ) {
6172
+ $tmp = $string;
6173
+ $string = '';
6174
+ $eolcharlen = strlen( '\n' );
6175
+ /* if PHP is config with mb_string and conf overload.. . */
6176
+ if( defined( 'MB_OVERLOAD_STRING' ) && ( 1 < ini_get( 'mbstring.func_overload' ))) {
6177
  $strlen = mb_strlen( $tmp );
6178
  while( $strlen > 75 ) {
6179
+ if( '\n' == mb_substr( $tmp, 75, $eolcharlen ))
6180
+ $breakAtChar = 74;
6181
+ else
6182
+ $breakAtChar = 75;
6183
  $string .= mb_substr( $tmp, 0, $breakAtChar );
6184
+ if( $this->nl != mb_substr( $string, ( 0 - mb_strlen( $this->nl ))))
 
 
6185
  $string .= $this->nl;
6186
+ $tmp = mb_substr( $tmp, $breakAtChar );
6187
+ if( !empty( $tmp ))
6188
+ $tmp = ' '.$tmp;
6189
  $strlen = mb_strlen( $tmp );
6190
  } // end while
6191
  if( 0 < $strlen ) {
6192
  $string .= $tmp; // the rest
6193
+ if( $this->nl != mb_substr( $string, ( 0 - mb_strlen( $this->nl ))))
 
 
6194
  $string .= $this->nl;
6195
  }
6196
  return $string;
6197
  }
6198
  /* if PHP is not config with mb_string.. . */
 
6199
  while( TRUE ) {
6200
  $bytecnt = strlen( $tmp );
6201
  $charCnt = $ix = 0;
6202
  for( $ix = 0; $ix < $bytecnt; $ix++ ) {
6203
+ if(( 73 < $charCnt ) && ( '\n' == substr( $tmp, $ix, $eolcharlen )))
6204
+ break; // break before '\n'
6205
+ elseif( 74 < $charCnt ) {
6206
+ if( '\n' == substr( $tmp, $ix, $eolcharlen ))
6207
+ $ix -= 1; // don't break inside '\n'
6208
+ break; // always break while-loop here
6209
  }
 
 
6210
  else {
6211
  $byte = ord( $tmp[$ix] );
6212
  if ($byte <= 127) { // add a one byte character
6227
  }
6228
  }
6229
  } // end for
 
 
6230
  if( $this->nl != substr( $string, ( 0 - strlen( $this->nl ))))
6231
  $string .= $this->nl;
6232
  $tmp = substr( $tmp, $ix );
6235
  else
6236
  $tmp = ' '.$tmp;
6237
  } // end while
 
 
 
 
 
 
6238
  return $string;
6239
  }
6240
  /**
6401
  * create formatted output for calendar component VEVENT object instance
6402
  *
6403
  * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
6404
+ * @since 2.10.16 - 2011-10-28
6405
  * @param array $xcaldecl
6406
  * @return string
6407
  */
6873
  $component .= $this->createTrigger();
6874
  $component .= $this->createXprop();
6875
  $component .= $this->componentEnd1.$objectname.$this->componentEnd2;
6876
+ if( is_array( $this->xcaldecl ) && ( 0 < count( $this->xcaldecl ))) {
6877
+ foreach( $this->xcaldecl as $localxcaldecl )
6878
+ $xcaldecl[] = $localxcaldecl;
6879
+ }
6880
  return $component;
6881
  }
6882
  }
lib/releaseNotes-2.10.23.txt ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
1
+ 2.10.21 ###################### Thanks Pasi
2
+ updated user guide, clarification about UTC timezone usage
3
+
4
+ 2.10.22 ###################### Thanks johns
5
+ bug in function selectComponents; RECURRENCE-ID management
6
+
7
+ 2.10.23 ######################
8
+ updated user guide, relationship between getProperty/selectComponents functions, other minor clarifications
lib/summary.html ADDED
@@ -0,0 +1,323 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
2
+ "http://www.w3.org/TR/html4/frameset.dtd">
3
+ <html>
4
+ <head>
5
+ <title>iCalcreator 2.10.23 summary</title>
6
+ <meta name="author" content="Kjell-Inge Gustafsson - kigkonsult" />
7
+ <meta name="copyright" content="2007-2011 Kjell-Inge Gustafsson - kigkonsult" />
8
+ <meta name="keywords" content="ical, calendar, calender, xcal, xml, icalender, rfc2445, rfc5545, vcalender, php, create" />
9
+ <meta name="description" content="iCalcreator summary" />
10
+ <style type="text/css">
11
+ body {
12
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
13
+ FONT-SIZE : small;
14
+ MARGIN : 10px;
15
+ WIDTH : 800px;
16
+ }
17
+ h1 {
18
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
19
+ FONT-SIZE : large;
20
+ }
21
+ h2 {
22
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
23
+ FONT-SIZE : large;
24
+ }
25
+ h4 {
26
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
27
+ FONT-SIZE : small;
28
+ FONT-WEIGHT : bold;
29
+ }
30
+ .code {
31
+ FONT-FAMILY : monospace;
32
+ FONT-SIZE : medium;
33
+ WHITE-SPACE : pre;
34
+ }
35
+ .comment {
36
+ FONT-FAMILY : arial;
37
+ FONT-SIZE : small;
38
+ FONT-STYLE : italic;
39
+ }
40
+ </style>
41
+ </head>
42
+ <body>
43
+ <h1>iCalcreator v2.10.23</h1>
44
+ iCalcreator class v2.10.23<br />
45
+ copyright (c) 2007-2011 Kjell-Inge Gustafsson, kigkonsult<br />
46
+ <a href="http://kigkonsult.se/iCalcreator/index.php" title="kigkonsult.se/iCalcreator" target="_blank">kigkonsult.se/iCalcreator</a><br />
47
+ ical@kigkonsult.se<br />
48
+ <br />
49
+ iCalcreator is a PHP class managing iCal formatted files for non-calendar
50
+ systems like CMS, project management systems and other applications able
51
+ to process calendar information like agendas, tasks, reports, totos,
52
+ journaling data and for communication with calendar systems and applications.
53
+ <br /><br />
54
+ This is a <b>short summary</b> how to use iCalcreator; create, parse, edit, select and output functionality.
55
+ <br /><br />
56
+ iCalcreator is built of a class file with support of a function class file and are calendar component property oriented.
57
+ Development environment is PHP version 5.x but coding is done to meet 4.x backward compatibility and may work.
58
+ <h4>iCal</h4>
59
+ A short iCal description is found at <a href="http://en.wikipedia.org/wiki/ICalendar#Core_object" title="iCalendar From Wikipedia, the free encyclopedia" target="_blank">Wikipedia</a>. If You are not familiar with iCal, read this first!<br />
60
+ Knowledge of calendar protocol rfc5545/rfc5546 is to recommend;<br />
61
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc5545" title="RFC5545" target="_blank">rfc5545</a>
62
+ - Internet Calendaring and Scheduling Core Object Specification (iCalendar)<br />
63
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc5546" title="RFC5546" target="_blank">rfc5546</a>
64
+ - iCalendar Transport-Independent Interoperability Protocol (iTIP) Scheduling Events, BusyTime, To-dos and Journal Entries <br />
65
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc5545" title="Download RFC5545 in text format">rfc5545</a> and
66
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc5546" title="Download RFC5546 in text format">rfc5546</a>
67
+ obsoletes, respectively,
68
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="Download RFC2445 in text format">rfc2445</a> and
69
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2446" title="Download RFC2446 in text format">rfc2446</a>.<br />
70
+ All functions calls are made as simple as possible BUT (, !!!,) read these rfc's properly!<br />
71
+
72
+
73
+ <h4>SUPPORT</h4>
74
+ The main support channel is using iCalcreator
75
+ <a title="Sourceforge" href="http://sourceforge.net/projects/icalcreator/forums/" target="_blank">Sourceforge</a> forum.
76
+ <br />
77
+ <br />
78
+ Our services are available for support and designing and developing customizations,
79
+ adaptations and other <i>PHP</i>/MySQL solutions with a special focus on software utility and reliability,
80
+ supported through our iterative acquire/design/transition process modell.
81
+
82
+ <h4>DONATE</h4>
83
+ You can show your appreciation for our free software,
84
+ and can support future development by making a donation to the kigkonsult GPL/LGPL projects.
85
+ <br />
86
+ <br />
87
+ Make a donation of any size by clicking <a href="http://kigkonsult.se/contact/index.php#Donate" title="Donate" target="_blank">here</a>.
88
+ Thanks in advance!
89
+
90
+ <h4>Contact</h4>
91
+ Use the contact <a href="http://kigkonsult.se/contact/index.php" title="kigkonsult.se/contact" target="_blank">page</a>
92
+ for queries, improvement/development issues or professional support and development.
93
+ Please note that paid support or consulting service has the highest priority.
94
+
95
+ <h4>Downloads</h4>
96
+ Download
97
+ <a href="http://kigkonsult.se/downloads/index.php#iCalcreator" title="iCalcreator complete manual" target="_blank"><b>complete manual</b></a>
98
+ and
99
+ <a href="http://kigkonsult.se/downloads/index.php#iCalcreator" title="iCalcreator coding samples" target="_blank"><b>coding samples</b></a>.
100
+ from <a href="http://kigkonsult.se/index.php" title="kigkonsult" target="_blank">kigkonsult.se</a>.
101
+
102
+ <h4>INSTALL</h4>
103
+ Unpack to any folder<br />
104
+ - add this folder to your include-path<br />
105
+ - or unpack to your application-(include)-folder<br />
106
+ Add &quot;require_once '[folder/]iCalcreator.class.php';&quot; to your php-script.
107
+ <br />
108
+ <br />
109
+ If using php version 5.1 or higher, the default timezone need to be set/altered, now &quot;Europe/Stockholm&quot;,
110
+ line 50 in the iCalcreator.class.php file.
111
+ <br />
112
+ When creating a new calendar/component instance, review config settings.
113
+ <br />
114
+ <br />
115
+ To really boost performance, visit kigkonsult.se contact <a href="http://kigkonsult.se/contact/index.php"><u>page</u></a> for information.
116
+ <br />
117
+
118
+ <h2>CREATE</h2>
119
+
120
+ <p class="code">require_once( &quot;iCalcreator.class.php&quot; );
121
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; ); // <span class="comment">set Your unique id</span>
122
+ $v = new vcalendar( $config ); // <span class="comment">create a new calendar instance</span>
123
+
124
+ $v->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; ); // <span class="comment">required of some calendar software</span>
125
+ $v->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; ); // <span class="comment">required of some calendar software</span>
126
+ $v->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; ); // <span class="comment">required of some calendar software</span>
127
+ $tz = &quot;Europe/Stockholm&quot;;
128
+ $v->setProperty( &quot;X-WR-TIMEZONE&quot;, $tz ); // <span class="comment">required of some calendar software</span>
129
+ .. .
130
+ iCalUtilityFunctions::createTimezone( $v, $tz ) // <span class="comment">creates (very simple) timezone component(-s)</span>
131
+ .. .
132
+ $vevent = & $v->newComponent( &quot;vevent&quot; ); // <span class="comment">create an event calendar component</span>
133
+ $vevent->setProperty( &quot;dtstart&quot;, array( &quot;year&quot;=&gt;2007, &quot;month&quot;=&gt;4, &quot;day&quot;=&gt;1, &quot;hour&quot;=&gt;19, &quot;min&quot;=&gt;0, &quot;sec&quot;=&gt;0 ));
134
+ $vevent->setProperty( &quot;dtend&quot;, array( &quot;year&quot;=&gt;2007, &quot;month&quot;=&gt;4, &quot;day&quot;=&gt;1, &quot;hour&quot;=&gt;22, &quot;min&quot;=&gt;30, &quot;sec&quot;=&gt;0 ));
135
+ $vevent->setProperty( &quot;LOCATION&quot;, &quot;Central Placa&quot; ); // <span class="comment">property name - case independent</span>
136
+ $vevent->setProperty( &quot;summary&quot;, &quot;PHP summit&quot; );
137
+ $vevent->setProperty( &quot;description&quot;, &quot;This is a description&quot; );
138
+ $vevent->setProperty( &quot;comment&quot;, &quot;This is a comment&quot; );
139
+ $vevent->setProperty( &quot;attendee&quot;, &quot;attendee1@icaldomain.net&quot; );
140
+ .. .
141
+ $vevent = & $v->newComponent( &quot;vevent&quot; ); // <span class="comment">create next event calendar component</span>
142
+ $vevent->setProperty( &quot;dtstart&quot;, &quot;20070401&quot;, array(&quot;VALUE&quot; =&gt; &quot;DATE&quot;));// <span class="comment">alt. date format, now for an all-day event</span>
143
+ $vevent->setProperty( &quot;organizer&quot; , &quot;boss@icaldomain.com&quot; );
144
+ $vevent->setProperty( &quot;summary&quot;, &quot;ALL-DAY event&quot; );
145
+ $vevent->setProperty( &quot;description&quot;, &quot;This is a description for an all-day event&quot; );
146
+ $vevent->setProperty( &quot;resources&quot;, &quot;COMPUTER PROJECTOR&quot; );
147
+ $vevent->setProperty( &quot;rrule&quot;, array( &quot;FREQ&quot; =&gt; &quot;WEEKLY&quot;, &quot;count&quot; =&gt; 4));// <span class="comment">weekly, four occasions</span>
148
+ $vevent->parse( &quot;LOCATION:1CP Conference Room 4350&quot; ); // <span class="comment">supporting parse of strict rfc5545 formatted text</span>
149
+ .. .
150
+ .. .// <span class="comment">all calendar components are described in <a href="http://kigkonsult.se/downloads/dl.php?f=rfc5545" title="RFC5545" target="_blank">rfc5545</a></span>
151
+ .. .// <span class="comment">a complete iCalcreator function list (ex. setProperty) in <a href="http://kigkonsult.se/downloads/index.php#iCalcreator" title="iCalcreator complete manual" target="_blank">iCalcreator manual</a></span>
152
+ .. .
153
+ $v->returnCalendar(); // <span class="comment">redirect calendar file to browser</span>
154
+ </p>
155
+ <h2>PARSE</h2>
156
+ <p class="code">require_once( &quot;iCalcreator.class.php&quot; );
157
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; ); // <span class="comment">set Your unique id, required if any component UID is missing</span>
158
+ $v = new vcalendar( $config ); // <span class="comment">create a new calendar instance</span>
159
+
160
+ /* start parse of local file */
161
+ $config = array( &quot;directory&quot; =&gt; &quot;calendar&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot; );
162
+ $v->setConfig( $config ); // <span class="comment">set directory and file name</span>
163
+ $v->parse();
164
+
165
+ /* start parse of remote file */
166
+ $v->setConfig( &quot;url&quot;, &quot;http://www.aDomain.net/file.ics&quot; ); // <span class="comment">iCalcreator also support parse from or write to remote files</span>
167
+ $v->parse();
168
+
169
+ $v->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; ); // <span class="comment">required of some calendar software</span>
170
+ $v->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; ); // <span class="comment">required of some calendar software</span>
171
+ $v->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; ); // <span class="comment">required of some calendar software</span>
172
+ $v->setProperty( &quot;X-WR-TIMEZONE&quot;, &quot;Europe/Stockholm&quot; ); // <span class="comment">required of some calendar software</span>
173
+
174
+ .. .
175
+ $v->sort(); // <span class="comment">ensure start date order</span>
176
+ .. .
177
+ </p>
178
+ <h2>EDIT</h2>
179
+ <p class="code">require_once( &quot;iCalcreator.class.php&quot; );
180
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;directory&quot; =&gt; &quot;calendar&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot; );
181
+ // <span class="comment">set Your unique id, import directory and file name</span>
182
+ $v = new vcalendar( $config ); // <span class="comment">create a new calendar instance</span>
183
+
184
+ $v->parse();
185
+
186
+ $v->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; ); // <span class="comment">required of some calendar software</span>
187
+ $v->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; ); // <span class="comment">required of some calendar software</span>
188
+ $v->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; ); // <span class="comment">required of some calendar software</span>
189
+ $v->setProperty( &quot;X-WR-TIMEZONE&quot;, &quot;Europe/Stockholm&quot; ); // <span class="comment">required of some calendar software</span>
190
+
191
+ while( $vevent = $v->getComponent( &quot;vevent&quot; )) { // <span class="comment">read events, one by one</span>
192
+ $uid = $vevent->getProperty( &quot;uid&quot; ); // <span class="comment">uid required, one occurence (unique id/key for component)</span>
193
+ .. .
194
+ $dtstart = $vevent->getProperty( &quot;dtstart&quot; ); // <span class="comment">dtstart required, one occurence</span>
195
+ .. .
196
+ if( $description = $vevent->getProperty( &quot;description&quot;, 1 )) { // <span class="comment">description optional, first occurence</span>
197
+ .. . // <span class="comment">edit the description</span>
198
+ $vevent->setProperty( &quot;description&quot;, $description, FALSE, 1 ); // <span class="comment">update/replace the description</span>
199
+ }
200
+ while( $comment = $vevent->getProperty( &quot;comment&quot; )) { // <span class="comment">comment optional, may occur more than once </span>
201
+ .. . // <span class="comment">manage comments</span>
202
+ }
203
+ .. .
204
+ while( $vevent->deleteProperty( &quot;attendee&quot; ))
205
+ continue; // <span class="comment">remove all ATTENDEE properties .. .</span>
206
+ .. .
207
+ $v->setComponent ( $vevent, $uid ); // <span class="comment">update/replace event in calendar with <b>uid</b> as key </span>
208
+ }
209
+ .. .
210
+ .. .// <span class="comment">a complete iCalcreator function list (ex. getProperty, deleteProperty) in <a href="http://kigkonsult.se/downloads/index.php#iCalcreator" title="iCalcreator complete manual" target="_blank">iCalcreator manual</a></span>
211
+ .. .
212
+ </p>
213
+ <h2>SELECT</h2>
214
+ <p class="code">require_once( &quot;iCalcreator.class.php&quot; );
215
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; ); // <span class="comment">set Your unique id</span>
216
+ $v = new vcalendar( $config ); // <span class="comment">create a new calendar instance</span>
217
+
218
+ $v->setConfig( &quot;url&quot;, &quot;http://www.aDomain.net/file.ics&quot; ); // <span class="comment">iCalcreator also support remote files</span>
219
+ $v->parse();
220
+ $v->sort(); // <span class="comment">ensure start date order</span>
221
+
222
+ $v->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; ); // <span class="comment">required of some calendar software</span>
223
+ $v->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; ); // <span class="comment">required of some calendar software</span>
224
+ $v->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; ); // <span class="comment">required of some calendar software</span>
225
+ $v->setProperty( &quot;X-WR-TIMEZONE&quot;, &quot;Europe/Stockholm&quot; ); // <span class="comment">required of some calendar software</span>
226
+ </p>
227
+ <h4>Date based select</h4>
228
+ <p class="code">$eventArray = $v->selectComponents(); // <span class="comment">select components occuring <b>today</b></span>
229
+ // <span class="comment">(including components with recurrence pattern)</span>
230
+ foreach( $eventArray as $year =&gt; $yearArray) {
231
+ foreach( $yearArray as $month =&gt; $monthArray ) {
232
+ foreach( $monthArray as $day =&gt; $dailyEventsArray ) {
233
+ foreach( $dailyEventsArray as $vevent ) {
234
+ $currddate = $event->getProperty( &quot;x-current-dtstart&quot; );
235
+ // <span class="comment">if member of a recurrence set (2nd occurence etc)</span>
236
+ // <span class="comment">returns array( &quot;x-current-dtstart&quot;</span>
237
+ // <span class="comment"> , &lt;(string) date(&quot;Y-m-d [H:i:s][timezone/UTC offset]&quot;)&gt;)</span>
238
+ $dtstart = $vevent->getProperty( &quot;dtstart&quot; ); // <span class="comment">dtstart required, one occurence, (orig. start date)</span>
239
+ $summary = $vevent->getProperty( &quot;summary&quot; );
240
+ $description = $vevent->getProperty( &quot;description&quot; );
241
+ .. .
242
+ .. .
243
+ }
244
+ }
245
+ }
246
+ }
247
+ </p>
248
+ <h4>Select specific property values</h4>
249
+ <p class="code">$valueOccurr = $v->getProperty( &quot;CATEGORIES&quot; ); // <span class="comment">fetch specific property (unique) values and ocurrences</span>
250
+ // <span class="comment">ATTENDEE, CATEGORIES, DTSTART, LOCATION,</span>
251
+ // <span class="comment">ORGANIZER, PRIORITY, RESOURCES, STATUS,</span>
252
+ // <span class="comment">SUMMARY, UID</span>
253
+ foreach( $valueOccurr as $uniqueValue =&gt; $occurr ) {
254
+ .. .
255
+ }
256
+ </p>
257
+ <h4>Specific property value select</h4>
258
+ <p class="code">$selectSpec = array( &quot;CATEGORIES&quot; =&gt; &quot;course1&quot; );
259
+ $specComps = $v->selectComponents( $selectSpec ); // <span class="comment">selects components based on specific property value(-s)</span>
260
+ // <span class="comment">ATTENDEE, CATEGORIES, LOCATION, ORGANIZER,</span>
261
+ // <span class="comment">PRIORITY, RESOURCES, STATUS, SUMMARY, UID</span>
262
+ foreach( $specComps as $comp ) {
263
+ .. .
264
+ }
265
+ </p>
266
+ <h2>OUTPUT</h2>
267
+ <p class="code">require_once( &quot;iCalcreator.class.php&quot; );
268
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; ); // <span class="comment">set Your unique id</span>
269
+ $v = new vcalendar( $config ); // <span class="comment">create a new calendar instance</span>
270
+
271
+ $v->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; ); // <span class="comment">required of some calendar software</span>
272
+ $v->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; ); // <span class="comment">required of some calendar software</span>
273
+ $v->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; ); // <span class="comment">required of some calendar software</span>
274
+ $v->setProperty( &quot;X-WR-TIMEZONE&quot;, &quot;Europe/Stockholm&quot; ); // <span class="comment">required of some calendar software</span>
275
+ .. .
276
+ .. .// <span class="comment">parse calendar file(s) and/or edit/create calendar components.. .</span>
277
+ .. .
278
+ </p>
279
+ <h4> // opt 1</h4>
280
+ <p class="code">.. .
281
+ $v->returnCalendar(); // <span class="comment">redirect calendar file to browser</span>
282
+ </p>
283
+ <h4> // opt 2</h4>
284
+ <p class="code">.. .
285
+ $config = array( &quot;directory&quot; =&gt; &quot;depot&quot;, &quot;filename&quot; =&gt; &quot;calendar.ics&quot; );
286
+ $v->setConfig( $config ); // <span class="comment">set output directory and file name</span>
287
+ $v->saveCalendar(); // <span class="comment">save calendar to (local) file</span>
288
+ </p>
289
+ <h4> // opt 3</h4>
290
+ <p class="code">.. .
291
+ $config = array( &quot;url&quot; =&gt; &quot;http://www.aDomain.net/file.ics&quot; );
292
+ $v->setConfig( $config ); // <span class="comment">set output url</span>
293
+ $v->saveCalendar(); // <span class="comment">save calendar to remote url</span>
294
+ </p>
295
+
296
+ <h2>COPYRIGHT AND LICENSE</h2>
297
+
298
+ <h4>Copyright</h4>
299
+ iCalcreator v2.10.23<br />
300
+ copyright (c) 2007-2011 Kjell-Inge Gustafsson, kigkonsult<br />
301
+ <a href="http://kigkonsult.se/iCalcreator/index.php" title="kigkonsult.se/iCalcreator" target="_blank">kigkonsult.se/iCalcreator</a><br />
302
+ ical@kigkonsult.se<br />
303
+
304
+ <h4>License</h4>
305
+
306
+ This library is free software; you can redistribute it and/or
307
+ modify it under the terms of the GNU Lesser General Public
308
+ License as published by the Free Software Foundation; either
309
+ version 2.1 of the License, or (at your option) any later version.
310
+ <br /><br />
311
+ This library is distributed in the hope that it will be useful,
312
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
313
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
314
+ Lesser General Public License for more details.
315
+ <br /><br />
316
+ You should have received a copy of the GNU Lesser General Public
317
+ License along with this library; if not, write to the Free Software
318
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
319
+ or download it <a href="http://kigkonsult.se/downloads/dl.php?f=LGPL" target="_blank">here</a>.
320
+ <br />
321
+ <br />
322
+ </body>
323
+ </html>
lib/using.html ADDED
@@ -0,0 +1,5810 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
2
+ "http://www.w3.org/TR/html4/frameset.dtd">
3
+ <html>
4
+ <head>
5
+ <title>iCalcreator 2.10.23 manual</title>
6
+ <meta name="author" content="Kjell-Inge Gustafsson - kigkonsult">
7
+ <meta name="copyright" content="2007-2011 Kjell-Inge Gustafsson - kigkonsult">
8
+ <meta name="keywords" content="ical, calendar, calender, xcal, xml, icalender, rfc2445, vcalender, php, create">
9
+ <meta name="description" content="using iCalcreator v2.10.23">
10
+ <style type="text/css">
11
+ * {
12
+ BACKGROUND-COLOR: white;
13
+ COLOR : black;
14
+ }
15
+ a {
16
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
17
+ FONT-SIZE : small;
18
+ }
19
+ a.ref {
20
+ xbackground-color: transparent;
21
+ background-color: inherit;
22
+ FONT-FAMILY : monospace, arial;
23
+ FONT-SIZE : small;
24
+ FONT-STYLE : normal;
25
+ TEXT-DECORATION : none;
26
+ }
27
+ body {
28
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
29
+ FONT-SIZE : small;
30
+ MARGIN-LEFT : 10px;
31
+ WIDTH : 600px;
32
+ }
33
+ h1 {
34
+ BACKGROUND-COLOR: silver;
35
+ BORDER : thin solid black;
36
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
37
+ FONT-SIZE : x-large;
38
+ FONT-WEIGHT : bold;
39
+ DISPLAY : block;
40
+ }
41
+ h2 {
42
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
43
+ FONT-SIZE : large;
44
+ }
45
+ h3 {
46
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
47
+ FONT-SIZE : medium;
48
+ }
49
+ h4 {
50
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
51
+ FONT-SIZE : small;
52
+ FONT-WEIGHT : bold;
53
+ }
54
+ h5 {
55
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
56
+ FONT-SIZE : small;
57
+ FONT-WEIGHT : normal;
58
+ TEXT-DECORATION : underline;
59
+ }
60
+ p {
61
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
62
+ FONT-SIZE : small;
63
+ }
64
+ .bb {
65
+ BORDER-BOTTOM : gray dotted thin;
66
+ }
67
+ .blb {
68
+ BORDER-LEFT : gray dotted thin;
69
+ BORDER-BOTTOM : gray dotted thin;
70
+ TEXT-ALIGN : center;
71
+ }
72
+ .bl {
73
+ BORDER-LEFT : gray dotted thin;
74
+ }
75
+ .center {
76
+ TEXT-ALIGN : center;
77
+ }
78
+ p.comment {
79
+ background-color: transparent;
80
+ FONT-FAMILY : monospace;
81
+ FONT-SIZE : medium;
82
+ FONT-STYLE : italic;
83
+ FONT-WEIGHT : 300;
84
+ WHITE-SPACE : pre;
85
+ }
86
+ span.comment {
87
+ background-color: transparent;
88
+ FONT-FAMILY : monospace;
89
+ FONT-SIZE : medium;
90
+ }
91
+ .example {
92
+ background-color: #DCDCDC;
93
+ FONT-FAMILY : Courier, "Courier New";
94
+ FONT-SIZE : small;
95
+ FONT-WEIGHT : 500;
96
+ LINE-HEIGHT : 1.2em;
97
+ WHITE-SPACE : pre;
98
+ }
99
+ .format {
100
+ BORDER : gray dotted thin;
101
+ FONT-FAMILY : Courier, "Courier New";
102
+ FONT-SIZE : small;
103
+ FONT-WEIGHT : 500;
104
+ LINE-HEIGHT : 1.5em;
105
+ WHITE-SPACE : pre;
106
+ }
107
+ .header {
108
+ BACKGROUND-COLOR: silver;
109
+ BORDER : thin solid black;
110
+ FONT-FAMILY : "Lucida Grande","Lucida Sans Unicode", "Bitstream Vera Sans", Lucida, Arial, Geneva, Helvetica, sans-serif;
111
+ FONT-SIZE : xx-large;
112
+ WIDTH : 600px;
113
+ }
114
+ .label {
115
+ FONT-FAMILY : arial;
116
+ FONT-SIZE : small;
117
+ FONT-WEIGHT : bold;
118
+ LETTER-SPACING : 0.1em;
119
+ }
120
+ .quotes {
121
+ background-color: transparent;
122
+ FONT-FAMILY : arial;
123
+ FONT-SIZE : small;
124
+ xFONT-STYLE : italic;
125
+ FONT-WEIGHT : 300;
126
+ LETTER-SPACING : 0.2em;
127
+ WHITE-SPACE : pre;
128
+ }
129
+ .ref {
130
+ BACKGROUND-COLOR: transparent;
131
+ FONT-FAMILY : monospace, arial;
132
+ FONT-SIZE : x-small;
133
+ xFONT-STYLE : italic;
134
+ xFONT-WEIGHT : 600;
135
+ VERTICAL-ALIGN : top;
136
+ LETTER-SPACING : 0.2em;
137
+ }
138
+ .top {
139
+ VERTICAL-ALIGN : top;
140
+ }
141
+ </style>
142
+ </head>
143
+ <body>
144
+ <a name="top"></a>
145
+ <p class="header">iCalcreator 2.10.23</p>
146
+ iCalcreator class v2.10.23<br>
147
+ copyright (c) 2007-2011 Kjell-Inge Gustafsson, kigkonsult<br>
148
+ <a href="http://kigkonsult.se/iCalcreator/index.php" title="kigkonsult.se/iCalcreator" target="_blank">kigkonsult.se/iCalcreator</a><br>
149
+ ical@kigkonsult.se<br>
150
+
151
+ <h2>Description:</h2>
152
+ iCalcreator is a <i>PHP</i> implementation of RFC2445/RFC2446 to manage iCal/xCal formatted files.
153
+ <br>
154
+
155
+ <a name="INTRO"></a><h1>1. INTRO</h1>
156
+ <p>
157
+ iCalcreator is a <i>PHP</i> class managing iCal formatted files for non-<i>calendar</i>
158
+ systems like CMS, project management systems and other applications able
159
+ to process <i>calendar</i> information like agendas, tasks, reports, todos,
160
+ journalling data and for communication with <i>calendar</i> systems and applications.
161
+ </p>
162
+ <p>
163
+ iCalcreator features create, parse, edit and select <i>calendar</i> and <i>calendar</i> components.
164
+ </p>
165
+ <p>
166
+ iCalcreator is built of a class file with support of a function class file and are <i>calendar</i>
167
+ component property oriented. Development environment is <i>PHP</i> version 5.x but coding is done
168
+ to meet 4.x backward compatibility and may work. Some functions requires <i>PHP</i> >= 5.2.0.
169
+ </p>
170
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
171
+
172
+ <a name="iCal"></a><h2>1.1 Ical</h2>
173
+
174
+ The iCalendar format, as described in
175
+ <dl>
176
+ <dt><a href="http://kigkonsult.se/downloads/dl.php?f=rfc5545" title="Download RFC5545 in text format" target="_blank">rfc5545</a>
177
+ <dd>&quot;Internet Calendaring and Scheduling Core Object Specification (iCalendar)&quot;
178
+ <dt><a href="http://kigkonsult.se/downloads/dl.php?f=rfc5546" title="Download RFC5546 in text format" target="_blank">rfc5546</a>
179
+ <dd>&quot;iCalendar Transport-Independent Interoperability Protocol (iTIP)&quot;<br>Scheduling Events, BusyTime, To-dos and Journal Entries
180
+ </dl>
181
+ <p class="quotes">. ..allows for the capture and exchange of information<br>normally stored within a calendaring and scheduling application.</p>
182
+ and
183
+ <p class="quotes">. ..is an exchange format between applications or systems.</p>
184
+ <p><a href="http://kigkonsult.se/downloads/dl.php?f=rfc5545" title="Download RFC5545 in text format" target="_blank">rfc5545</a> and
185
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc5546" title="Download RFC5546 in text format" target="_blank">rfc5546</a>
186
+ obsoletes, respectively,
187
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="Download RFC2445 in text format" target="_blank">rfc2445</a> and
188
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2446" title="Download RFC2446 in text format" target="_blank">rfc2446</a>.
189
+ </p>
190
+ <p>
191
+ A short iCal description is found at <a href="http://en.wikipedia.org/wiki/ICalendar#Core_object" title="iCalendar From Wikipedia, the free encyclopedia" target="_blank">Wikipedia</a>. If You are not familiar with iCal, read this first!
192
+ Knowledge of <i>calendar</i> protocol rfc5545/rfc5546 is to recommend.
193
+ </p>
194
+ <p>
195
+ Any references to rfc2445, below, corresponds to rfc5545.
196
+ </p>
197
+ <p>
198
+ All iCalcreator functions calls are made as simple as possible BUT (, !!!,) read these rfc's properly!
199
+ xCal (iCal xml) output format is supported but still experimental.
200
+ </p>
201
+ <br>
202
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
203
+
204
+ <a name="This_manual"></a><h2>1.2 This manual</h2>
205
+ This style is used for text.
206
+ <p class="format">This style is used for formats.</p>
207
+ <p class="example">This style is used for <i>PHP</i> coding examples.
208
+ <span class="comment"> // this style is used for coding comments.</span>
209
+ </p>
210
+ <p class="comment">This style is used for content details.</p>
211
+ <p class="quotes">This style is used for RFC2445 quotes.</p>
212
+ <p>
213
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
214
+
215
+ <a name="Versioning"></a><h2>1.3 Versioning</h2>
216
+
217
+ The release numbering convention used is major.minor(.micro&nbsp;/&nbsp;suffix).
218
+ <dl>
219
+ <dt>Major
220
+ <dd>Indicates a very large change in the core package. Rewrites or major milestones.
221
+ <dt>Minor
222
+ <dd>Significant amount of feature addition/modification.<br>odd number - development/experimental release<br> even number - production release
223
+ <dt>Micro
224
+ <dd>Primarily bug fix and maintenance number.
225
+ <dt>Suffix
226
+ <dd>rc1 for first release candidate etc.
227
+ </dl>
228
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
229
+
230
+ <a name="Support"></a><h2>1.4 Support</h2>
231
+ <p>
232
+ The main support channel is using iCalcreator
233
+ <a title="Sourceforge" href="http://sourceforge.net/projects/icalcreator/forums/" target="_blank">Sourceforge</a> forum.
234
+ </p>
235
+ <p>
236
+ Use the contact <a href="http://kigkonsult.se/contact/index.php" title="kigkonsult.se/contact" target="_blank">page</a>
237
+ for queries, improvement/development issues or professional support and development.
238
+ Please note that paid support or consulting service has the highest priority.
239
+ </p>
240
+ <p>
241
+ Our services are available for support and designing and developing iCalcreator etc. customizations,
242
+ adaptations and other <i>PHP</i>/MySQL solutions with a special focus on software utility and reliability,
243
+ supported through our iterative acquire/design/transition process modell.
244
+ </p>
245
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
246
+
247
+ <a name="Donate"></a><h2>1.5 Donate</h2>
248
+ <p>
249
+ You can show your appreciation for our free software,
250
+ and can support future development by making a donation to the kigkonsult project iCalcreator.
251
+ </p>
252
+ <p>
253
+ Make a donation of any size by clicking <a href="http://kigkonsult.se/contact/index.php#Donate" title="Donate" target="_blank">here</a>.
254
+ Thanks in advance!
255
+ </p>
256
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
257
+
258
+ <a name="INSTALL"></a><h2>1.6 Install</h2>
259
+
260
+ <a name="Basic"></a><h3>1.6.1 Basic</h3>
261
+ Unpack to any folder<br>
262
+ - add this folder to your include-path<br>
263
+ - or unpack to your application-(include)-folder<br>
264
+ Add
265
+ <p class="format">require_once &quot;[folder/]iCalcreator.class.php&quot;;</p>
266
+ to your php-script.
267
+ <br>
268
+ <br>
269
+ If using php version 5.1 or higher, the default timezone need to be set/altered, now &quot;Europe/Stockholm&quot;,
270
+ line 50 in the iCalcreator.class.php file.
271
+ <br>
272
+ <br>
273
+ When creating a new <i>calendar</i>/component instance, review <a href="#Calendar_configuration_functions">config</a> settings.
274
+ <br>
275
+ <br>
276
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
277
+
278
+ <a name="Boost"></a><h3>1.6.2 Boost performance</h3>
279
+ To really boost performance, kigkonsult can now offer <i>PHP</i> (4 and 5) packages (iCalcreator etc) in byte coded files,
280
+ using <a href="http://www.ioncube.com" target="_blank"><u>ionCube</u></a> encoder.
281
+ <br>
282
+ <br>
283
+ Encoded files use a platform independent file format, and can be run on any platform for which ionCube supply a (free) Loader.
284
+ Currently supported platforms are Windows (e.g. NT, XP, W2K), Intel Linux, FreeBSD, NetBSD, OpenBSD, OS X, and Sparc Solaris.
285
+ <br>
286
+ <br>
287
+ Visit kigkonsult.se contact <a href="http://kigkonsult.se/contact/index.php" target="_blank"><u>page</u></a> for information and purchase.
288
+ <br>
289
+ <br>
290
+ Use basic install (above), install ionCube Loader (requires an update of &quot;php.ini&quot; or additional file in &quot;/etc/php.d&quot; folder AND the execute rights to use the <i>PHP</i> &quot;dl&quot; function) and simply replace the <i>PHP</i> class files with the encoded files.
291
+ <br>
292
+ <br>
293
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
294
+
295
+ <a name="Additional_Descriptors"></a><h2>1.7 Additional Descriptors</h2>
296
+ The following properties (as described in <a href="http://en.wikipedia.org/wiki/ICalendar#Calendar_extensions" title="http://en.wikipedia.org/wiki/ICalendar#Calendar_extensions" target="_blank">wikipedia:iCal</a>) may be required when importing iCal files into some calendaring software (MS etc.):
297
+ <dl>
298
+ <dt>on <i>calendar</i> level
299
+ <dd><a href="#METHOD">METHOD</a> property (value PUBLISH etc.)
300
+ <dd><a href="#X-PROPERTY">X-WR-CALNAME</a> x-property
301
+ <dd><a href="#X-PROPERTY">X-WR-CALDESC</a> x-property
302
+ <dd><a href="#X-PROPERTY">X-WR-RELCALID</a> x-property <span class="comment">(a <a href="/wiki/Universally_Unique_Identifier" title="Universally Unique Identifier" class="mw-redirect">UUID</a>.)</span>
303
+ <dd><a href="#X-PROPERTY">X-WR-TIMEZONE</a> x-property
304
+ <dt>on component level
305
+ <dd><a href="#DTSTAMP">DTSTAMP</a> property (in iCalcreator created automatically, if not set)
306
+ <dd><a href="#UID">UID</a> property (in iCalcreator created automatically, if not set)
307
+ <dt>on component level in <a href="#VTIMEZONE">vtimezone</a> component
308
+ <dd><a href="#X-PROPERTY">X-LIC-LOCATION</a> x-property
309
+ </dl>
310
+ Recommendation is also to set <a href="#Unique_id">unique_id</a> when creating a new vcalendar/component instance, to ensure accurate setting of all components <a href="#UID">UID</a> property, even before <a href="#parse_merge">parse</a>.
311
+ <p class="label">Example</p>
312
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
313
+ $vcalendar = new vcalendar( $config );
314
+ $vcalendar->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; )
315
+ $vcalendar->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; );
316
+ $vcalendar->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; );
317
+ $uuid = &quot;3E26604A-50F4-4449-8B3E-E4F4932D05B5&quot;;
318
+ $vcalendar->setProperty( &quot;X-WR-RELCALID&quot;, $uuid );
319
+ $vcalendar->setProperty( &quot;X-WR-TIMEZONE&quot;, &quot;Europe/Stockholm&quot; );
320
+ .. .
321
+ </p>
322
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
323
+
324
+ <a name="Addendum"></a><h2>1.8 Addendum</h2>
325
+ <p>
326
+ Download iCalcreator <a title="download iCalcreator coding samples" href="http://kigkonsult.se/downloads/index.php#iCalcreator" target="_blank">coding samples</a>.
327
+ </p>
328
+ <dl>
329
+ <dt>Examples how to employ iCalcreator in software development
330
+ <dd><a title="tinycal" href="http://kigkonsult.se/tinycal/index.php" target="_blank">tinycal</a>, <i>calendar</i>-in-a-box.
331
+ <dd><a title="Create iCal event file on-demand from form" href="http://kigkonsult.se/eventCreator/index.php" target="_blank">The iCal file event editor</a>
332
+ </dl>
333
+ <p>
334
+ If you are downloading the iCalcreatorusing sub-package, there are free iCal/xCal icons in the images directory, to use as buttons on a web page.
335
+ </p>
336
+ The <i>PHP</i> coding in this document or &quot;coding samples&quot; (above) are only for display of usage, recommendation is to use a
337
+ coding standard, the following, incomplete, list is a good start;
338
+ <dl>
339
+ <dd><a href="http://www.dagbladet.no/development/phpcodingstandard/" target="_blank">http://www.dagbladet.no/development/phpcodingstandard/</a>
340
+ <!--
341
+ <br>
342
+ <a href="http://ez.no/ezpublish/documentation/development/standards/php" target="_blank">http://ez.no/ezpublish/documentation/development/standards/php</a>
343
+ -->
344
+ <dd><a href="http://framework.zend.com/manual/en/coding-standard.overview.html" target="_blank">http://framework.zend.com/manual/en/coding-standard.overview.html</a>
345
+ <!--
346
+ <br>
347
+ <a href="http://gforge.org/docman/view.php/1/2/coding-standards.html" target="_blank">http://gforge.org/docman/view.php/1/2/coding-standards.html</a>
348
+ -->
349
+ <dd><a href="http://pear.php.net/manual/en/standards.php" target="_blank">http://pear.php.net/manual/en/standards.php</a>
350
+ </dl>
351
+ <br>
352
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
353
+
354
+ <a name="INDEX"></a><h2>1.9 INDEX</h2>
355
+
356
+ <a href="#INTRO">1. INTRO</a><br>
357
+ <br>
358
+ <a href="#iCal">1.1 Ical</a><br>
359
+ <a href="#This_manual">1.2 This manual</a><br>
360
+ <a href="#Versioning">1.3 Versioning</a><br>
361
+ <a href="#Support">1.4 Support</a><br>
362
+ <a href="#Donate">1.5 Donate</a><br>
363
+ <a href="#INSTALL">1.6 Install</a><br>
364
+ <a href="#Basic">1.6.1 Basic</a><br>
365
+ <a href="#Boost">1.6.2 Boost performance</a><br>
366
+ <a href="#Additional_Descriptors">1.7 Additional_Descriptors</a><br>
367
+ <a href="#Addendum">1.8 Addendum</a><br>
368
+ <a href="#INDEX">1.9 INDEX</a><br>
369
+ <br>
370
+ <a href="#Calendar_Component_list">2. Calendar Component list</a><br>
371
+ <br>
372
+ <a href="#VCALENDAR">2.1 VCALENDAR</a><br>
373
+ <a href="#VEVENT">2.2 VEVENT</a><br>
374
+ <a href="#VTODO">2.3 VTODO</a><br>
375
+ <a href="#VJOURNAL">2.4 VJOURNAL</a><br>
376
+ <a href="#VFREEBUSY">2.5 VFREEBUSY</a><br>
377
+ <a href="#VALARM">2.6 VALARM</a><br>
378
+ <a href="#VTIMEZONE">2.7 VTIMEZONE</a><br>
379
+ <a href="#CalProps">2.10 Component Properties</a><br>
380
+ <br>
381
+ <a href="#Function_list">3. Function list</a><br>
382
+ <br>
383
+ <a href="#Calendar_object_functions">3.1 Calendar object functions</a><br>
384
+ <br>
385
+ <a href="#Calendar_object_constructors">3.1.1 Constructors</a><br>
386
+ <a href="#vcalendar">3.1.1.1 vcalendar</a><br>
387
+ <a href="#vevent">3.1.1.2 vevent</a><br>
388
+ <a href="#vtodo">3.1.1.3 vtodo</a><br>
389
+ <a href="#vjournal">3.1.1.4 vjournal</a><br>
390
+ <a href="#vfreebusy">3.1.1.5 vfreebusy</a><br>
391
+ <a href="#valarm">3.1.1.6 valarm</a><br>
392
+ <a href="#vtimezone">3.1.1.7 vtimezone</a><br>
393
+ <a href="#standard">3.1.1.8 standard</a><br>
394
+ <a href="#daylight">3.1.1.9 daylight</a><br>
395
+ <br>
396
+ <a href="#Calendar_property_functions">3.1.2 Calendar property functions</a><br>
397
+ <a href="#deleteProperty">3.1.2.1 deleteProperty</a><br>
398
+ <a href="#getProperty">3.1.2.2 getProperty</a><br>
399
+ <a href="#setProperty">3.1.2.3 setProperty</a><br>
400
+ <a href="#CALSCALE">3.1.2.4 CALSCALE</a><br>
401
+ <a href="#METHOD">3.1.2.5 METHOD</a><br>
402
+ <a href="#VERSION">3.1.2.6 VERSION</a><br>
403
+ <a href="#X-PROPERTY">3.1.2.7 X-PROPERTY</a><br>
404
+ <br>
405
+ <a href="#Calendar_component_functions">3.1.3 Calendar component functions</a><br>
406
+ <a href="#deleteComponent">3.1.3.1 deleteComponent</a><br>
407
+ <a href="#getComponent">3.1.3.2 getComponent</a><br>
408
+ <a href="#newComponent">3.1.3.3 newComponent</a><br>
409
+ <a href="#selectComponents">3.1.3.4 selectComponents</a><br>
410
+ <a href="#setComponent">3.1.3.5 setComponent</a><br>
411
+ <br>
412
+ <a href="#Calendar_inputoutput_functions">3.1.4 Calendar input/output functions</a><br>
413
+ <a href="#parse_merge">3.1.4.1 parse and merge</a><br>
414
+ <a href="#createCalendar">3.1.4.2 createCalendar</a><br>
415
+ <a href="#returnCalendar">3.1.4.3 returnCalendar</a><br>
416
+ <a href="#saveCalendar">3.1.4.4 saveCalendar</a><br>
417
+ <a href="#sort">3.1.4.5 sort</a><br>
418
+ <a href="#useCachedCalendar">3.1.4.6 useCachedCalendar</a><br>
419
+ <br>
420
+ <a href="#Calendar_configuration_functions">3.1.5 Calendar configuration functions</a><br>
421
+ <a href="#configKeys">3.1.5.1 configuration keys</a><br>
422
+ <a href="#getConfig">3.1.5.2 getConfig</a><br>
423
+ <a href="#initConfig">3.1.5.3 <i>calendar</i>/component initialization</a><br>
424
+ <a href="#setConfig">3.1.5.4 setConfig</a><br>
425
+ <a href="#allowEmpty">3.1.5.5 Allow empty components</a><br>
426
+ <a href="#Compsinfo">3.1.5.6 Component information</a><br>
427
+ <a href="#Delimiter">3.1.5.7 Delimiter</a><br>
428
+ <a href="#Directory">3.1.5.8 Directory</a><br>
429
+ <a href="#Fileinfo">3.1.5.9 Fileinfo</a><br>
430
+ <a href="#Filename">3.1.5.10 Filename</a><br>
431
+ <a href="#Filesize">3.1.5.11 Filesize</a><br>
432
+ <a href="#Format">3.1.5.12 Format</a><br>
433
+ <a href="#Language">3.1.5.13 Language</a><br>
434
+ <a href="#NewlineChar">3.1.5.14 NewlineChar</a><br>
435
+ <a href="#dTZID">3.1.5.15 TZID</a><br>
436
+ <a href="#Unique_id">3.1.5.16 Unique_id</a><br>
437
+ <a href="#configURL">3.1.5.17 URL</a><br>
438
+ <br>
439
+ <a href="#Calendar_component_object_property_function_list">3.2 Calendar component/object property function list</a><br>
440
+ <br>
441
+ <a href="#deleteProperty_PROP">3.2.1 deleteProperty</a><br>
442
+ <a href="#getProperty_PROP">3.2.2 getProperty</a><br>
443
+ <a href="#parse">3.2.3 parse</a><br>
444
+ <a href="#setProperty_PROP">3.2.4 setProperty</a><br>
445
+ <br>
446
+ <a href="#ACTION">3.2.5 ACTION</a><br>
447
+ <a href="#ATTACH">3.2.6 ATTACH</a><br>
448
+ <a href="#ATTENDEE">3.2.7 ATTENDEE</a><br>
449
+ <a href="#CATEGORIES">3.2.8 CATEGORIES</a><br>
450
+ <a href="#CLASS">3.2.9 CLASS</a><br>
451
+ <a href="#COMMENT">3.2.10 COMMENT</a><br>
452
+ <a href="#COMPLETED">3.2.11 COMPLETED</a><br>
453
+ <a href="#CONTACT">3.2.12 CONTACT</a><br>
454
+ <a href="#CREATED">3.2.13 CREATED</a><br>
455
+ <a href="#DESCRIPTION">3.2.14 DESCRIPTION</a><br>
456
+ <a href="#DTEND">3.2.15 DTEND</a><br>
457
+ <a href="#DTSTAMP">3.2.16 DTSTAMP</a><br>
458
+ <a href="#DTSTART">3.2.17 DTSTART</a><br>
459
+ <a href="#DUE">3.2.18 DUE</a><br>
460
+ <a href="#DURATION">3.2.19 DURATION</a><br>
461
+ <a href="#EXDATE">3.2.20 EXDATE</a><br>
462
+ <a href="#EXRULE">3.2.21 EXRULE</a><br>
463
+ <a href="#FREEBUSY_PROP">3.2.22 FREEBUSY</a><br>
464
+ <a href="#GEO">3.2.23 GEO</a><br>
465
+ <a href="#LAST-MODIFIED">3.2.24 LAST-MODIFIED</a><br>
466
+ <a href="#LOCATION">3.2.25 LOCATION</a><br>
467
+ <a href="#ORGANIZER">3.2.26 ORGANIZER</a><br>
468
+ <a href="#PERCENT-COMPLETE">3.2.27 PERCENT-COMPLETE</a><br>
469
+ <a href="#PRIORITY">3.2.28 PRIORITY</a><br>
470
+ <a href="#RDATE">3.2.29 RDATE</a><br>
471
+ <a href="#RECURRENCE-ID">3.2.30 RECURRENCE-ID</a><br>
472
+ <a href="#RELATED-TO">3.2.31 RELATED-TO</a><br>
473
+ <a href="#REPEAT">3.2.32 REPEAT</a><br>
474
+ <a href="#REQUEST-STATUS">3.2.33 REQUEST-STATUS</a><br>
475
+ <a href="#RESOURCES">3.2.34 RESOURCES</a><br>
476
+ <a href="#RRULE">3.2.35 RRULE</a><br>
477
+ <a href="#SEQUENCE">3.2.36 SEQUENCE</a><br>
478
+ <a href="#STATUS">3.2.37 STATUS</a><br>
479
+ <a href="#SUMMARY">3.2.38 SUMMARY</a><br>
480
+ <a href="#TRANSP">3.2.39 TRANSP</a><br>
481
+ <a href="#TRIGGER">3.2.40 TRIGGER</a><br>
482
+ <a href="#TZID">3.2.41 TZID</a><br>
483
+ <a href="#TZNAME">3.2.42 TZNAME</a><br>
484
+ <a href="#TZOFFSETFROM">3.2.43 TZOFFSETFROM</a><br>
485
+ <a href="#TZOFFSETTO">3.2.44 TZOFFSETTO</a><br>
486
+ <a href="#TZURL">3.2.45 TZURL</a><br>
487
+ <a href="#UID">3.2.46 UID</a><br>
488
+ <a href="#URL">3.2.47 URL</a><br>
489
+ <a href="#X-PROPERTY_PROP">3.2.48 X-PROPERTY</a><br>
490
+ <br>
491
+ <a href="#Calendar_component_configuration_functions">3.3 Calendar Component configuration functions</a><br>
492
+ <br>
493
+ <a href="#Language_PROP">3.3.1 Language</a><br>
494
+ <br>
495
+ <a href="#Calendar_component_object_misc_functions">3.4 Calendar component object misc. functions</a><br>
496
+ <br>
497
+ <a href="#deleteComponent_PROP">3.4.1 deleteComponent</a><br>
498
+ <a href="#getComponent_PROP">3.4.2 getComponent</a><br>
499
+ <a href="#newComponent_PROP">3.4.3 newComponent</a><br>
500
+ <a href="#setComponent_PROP">3.4.4 setComponent</a><br>
501
+ <br>
502
+ <a href="#iCalUtilityFunctions">4. iCalUtilityFunctions</a><br>
503
+ <br>
504
+ <a href="#createTimezone">4.1 createTimezone</a><br>
505
+ <a href="#transformDateTime">4.2 transformDateTime</a><br>
506
+ <br>
507
+ <a href="#Copyright_and_Licence">5. COPYRIGHT AND LICENSE</a><br>
508
+ <br>
509
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
510
+
511
+ <a name="Calendar_Component_list"></a><h1>2. Calendar Component list</h1>
512
+ Quote from <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar)!
513
+ (Described in iCal output format, content corresponds to xCal format.)<br>
514
+ <a name="VCALENDAR"></a><h2>2.1 VCALENDAR</h2>
515
+ <p class="center">icalobject = 1*(&quot;BEGIN&quot; &quot;:&quot; &quot;VCALENDAR&quot; CRLF</p>
516
+ <p class="center">icalbody</p>
517
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VCALENDAR&quot; CRLF)</p>
518
+ <br>
519
+ icalbody = calprops component
520
+ <br>
521
+ calprops = 2*(
522
+ <br>
523
+ <p class="center">&quot;prodid&quot; and &quot;version&quot; are both REQUIRED, but MUST NOT occur more than once
524
+ <p class="center">prodid / <a href="#VERSION">version</a> /</p>
525
+ <p class="center">&quot;calscale&quot;and &quot;method&quot;are optional, but MUST NOT occur more than once</p>
526
+ <p class="center"><a href="#CALSCALE">calscale</a> / <a href="#METHOD">method</a> /</p>
527
+ <p class="center"><a href="#X-PROPERTY">x-prop</a></p>
528
+ )
529
+ <br>
530
+ <p class="center">component = 1*(<a href="#VEVENT">eventc</a> / <a href="#VTODO">todoc</a> / <a href="#VJOURNAL">journalc</a> / <a href="#VFREEBUSY">freebusyc</a> / <a href="#VTIMEZONE">timezonec</a> / iana-comp* / x-comp*)</p>
531
+ <p class="center">iana-comp = &quot;BEGIN&quot; &quot;:&quot; iana-token CRLF</p>
532
+ <p class="center">1*contentline</p>
533
+ <p class="center">&quot;END&quot; &quot;:&quot; iana-token CRLF</p>
534
+ <p class="center">x-comp = &quot;BEGIN&quot; &quot;:&quot; x-name CRLF</p>
535
+ <p class="center">1*contentline</p>
536
+ <p class="center">&quot;END&quot; &quot;:&quot; x-name CRLF</p>
537
+ *) <span class="comment">not supported by iCalcreator</span>
538
+ <br>
539
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
540
+
541
+ <a name="VEVENT"></a><h2>2.2 VEVENT</h2>
542
+ <p class="center">&quot;BEGIN&quot; &quot;:&quot; &quot;VEVENT&quot; CRLF</p>
543
+ <p class="center">eventprop *alarmc</p>
544
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VEVENT&quot; CRLF</p>
545
+ eventprop = *(
546
+ <p class="center">the following are optional,but MUST NOT occur more than once</p>
547
+ <p class="center"><a href="#CLASS">class</a> / <a href="#CREATED">created</a> / <a href="#DESCRIPTION">description</a> / <a href="#DTSTART">dtstart</a> /</p>
548
+ <p class="center"><a href="#GEO">geo</a> / <a href="#LAST-MODIFIED">last-mod</a> / <a href="#LOCATION">location</a> / <a href="#ORGANIZER">organizer</a> / <a href="#PRIORITY">priority</a> / </p>
549
+ <p class="center"><a href="#DTSTAMP">dtstamp</a> / <a href="#SEQUENCE">seq</a> / <a href="#STATUS">status</a> / <a href="#SUMMARY">summary</a> / </p>
550
+ <p class="center"><a href="#TRANSP">transp</a> / <a href="#UID">uid</a> / <a href="#URL">url</a> / <a href="#RECURRENCE-ID">recurid</a> /</p>
551
+ <p class="center">either &quot;<a href="#DTEND">dtend</a>&quot; or &quot;<a href="#DURATION">duration</a>&quot; may appear in a &quot;eventprop&quot;, </p>
552
+ <p class="center">but &quot;<a href="#DTEND">dtend</a>&quot; and &quot;<a href="#DURATION">duration</a>&quot; MUST NOT occur in the same &quot;eventprop&quot;</p>
553
+ <p class="center"><a href="#DTEND">dtend</a> / <a href="#DURATION">duration</a> /</p>
554
+ <p class="center">the following are optional, and MAY occur more than once</p>
555
+ <p class="center"><a href="#ATTACH">attach</a> / <a href="#ATTENDEE">attendee</a> / <a href="#CATEGORIES">categories</a> / <a href="#COMMENT">comment</a> / </p>
556
+ <p class="center"><a href="#CONTACT">contact</a> / <a href="#EXDATE">exdate</a> / <a href="#EXRULE">exrule</a> / <a href="#REQUEST-STATUS">rstatus</a> / </p>
557
+ <p class="center"><a href="#RELATED-TO">related</a> / <a href="#RESOURCES">resources</a> / <a href="#RDATE">rdate</a> / <a href="#RRULE">rrule</a> / <a href="#X-PROPERTY_PROP">x-prop</a></p>
558
+ )
559
+ <br>
560
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
561
+
562
+ <a name="VTODO"></a><h2>2.3 VTODO</h2>
563
+ <p class="center">&quot;BEGIN&quot; &quot;:&quot; &quot;VTODO&quot; CRLF</p>
564
+ <p class="center">todoprop *alarmc</p>
565
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VTODO&quot; CRLF</p>
566
+ todoprop = *(
567
+ <p class="center">the following are optional, but MUST NOT occur more than once</p>
568
+ <p class="center"><a href="#CLASS">class</a> / <a href="#COMPLETED">completed</a> / <a href="#CREATED">created</a> / <a href="#DESCRIPTION">description</a> / <a href="#DTSTAMP">dtstamp</a> / <a href="#DTSTART">dtstart</a> / </p>
569
+ <p class="center"><a href="#GEO">geo</a> / <a href="#LAST-MODIFIED">last-mod</a> / <a href="#LOCATION">location</a> / <a href="#ORGANIZER">organizer</a> / <a href="#PERCENT-COMPLETE">percent</a> / <a href="#PRIORITY">priority</a> / </p>
570
+ <p class="center"><a href="#RECURRENCE-ID">recurid</a> / <a href="#SEQUENCE">seq</a> / <a href="#STATUS">status</a> / <a href="#SUMMARY">summary</a> /<a href="#UID">uid</a> / <a href="#URL">url</a> /</p>
571
+ <p class="center">either &quot;<a href="#DUE">due</a>&quot; or &quot;<a href="#DURATION">duration</a>&quot; may appear in a &quot;todoprop&quot;,</p>
572
+ <p class="center"> but &quot;<a href="#DUE">due</a>&quot; and &quot;<a href="#DURATION">duration</a>&quot; MUST NOT occur in the same &quot;todoprop&quot;</p>
573
+ <p class="center"><a href="#DUE">due</a> / <a href="#DURATION">duration</a> /</p>
574
+ <p class="center">the following are optional,and MAY occur more than once</p>
575
+ <p class="center"><a href="#ATTACH">attach</a> / <a href="#ATTENDEE">attendee</a> / <a href="#CATEGORIES">categories</a> / <a href="#COMMENT">comment</a> / </p>
576
+ <p class="center"><a href="#CONTACT">contact</a> / <a href="#EXDATE">exdate</a> / <a href="#EXRULE">exrule</a> / <a href="#REQUEST-STATUS">rstatus</a> / </p>
577
+ <p class="center"><a href="#RELATED-TO">related</a> / <a href="#RESOURCES">resources</a> / <a href="#RDATE">rdate</a> / <a href="#RRULE">rrule</a> / <a href="#X-PROPERTY_PROP">x-prop</a></p>
578
+ )
579
+ <br>
580
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
581
+
582
+ <a name="VJOURNAL"></a><h2>2.4 VJOURNAL</h2>
583
+ <p class="center">journalc = &quot;BEGIN&quot; &quot;:&quot; &quot;VJOURNAL&quot; CRLF</p>
584
+ <p class="center">jourprop</p>
585
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VJOURNAL&quot; CRLF</p>
586
+ jourprop = *(
587
+ <p class="center">the following are optional, but MUST NOT occur more than once</p>
588
+ <p class="center"><a href="#CLASS">class</a> / <a href="#CREATED">created</a> / <a href="#DESCRIPTION">description</a> / <a href="#DTSTART">dtstart</a> / </p>
589
+ <p class="center"><a href="#DTSTAMP">dtstamp</a> / <a href="#LAST-MODIFIED">last-mod</a> / <a href="#ORGANIZER">organizer</a> / <a href="#RECURRENCE-ID">recurid</a> / </p>
590
+ <p class="center"><a href="#SEQUENCE">seq</a> / <a href="#STATUS">status</a> / <a href="#SUMMARY">summary</a> /<a href="#UID">uid</a> / <a href="#URL">url</a> /</p>
591
+ <p class="center">the following are optional,and MAY occur more than once</p>
592
+ <p class="center"><a href="#ATTACH">attach</a> / <a href="#ATTENDEE">attendee</a> / <a href="#CATEGORIES">categories</a> / <a href="#COMMENT">comment</a> /</p>
593
+ <p class="center"><a href="#CONTACT">contact</a> / <a href="#EXDATE">exdate</a> / <a href="#EXRULE">exrule</a> / <a href="#RELATED-TO">related</a> / </p>
594
+ <p class="center"><a href="#RDATE">rdate</a> / <a href="#RRULE">rrule</a> / <a href="#REQUEST-STATUS">rstatus</a> / <a href="#X-PROPERTY_PROP">x-prop</a></p>
595
+ )
596
+ <br>
597
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
598
+
599
+ <a name="VFREEBUSY"></a><h2>2.5 VFREEBUSY</h2>
600
+ <p class="center">&quot;BEGIN&quot; &quot;:&quot; &quot;VFREEBUSY&quot; CRLF</p>
601
+ <p class="center">fbprop</p>
602
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VFREEBUSY&quot; CRLF</p>
603
+ fbprop = *(
604
+ <p class="center">the following are optional, but MUST NOT occur more than once</p>
605
+ <p class="center"><a href="#CONTACT">contact</a> / <a href="#DTSTART">dtstart</a> / <a href="#DTEND">dtend</a> / <a href="#DURATION">duration</a> / </p>
606
+ <p class="center"><a href="#DTSTAMP">dtstamp</a> / <a href="#ORGANIZER">organizer</a> / <a href="#UID">uid</a> / <a href="#URL">url</a> / </p>
607
+ <p class="center">the following are optional,and MAY occur more than once</p>
608
+ <p class="center"><a href="#ATTENDEE">attendee</a> / <a href="#COMMENT">comment</a> / <a href="#FREEBUSY_PROP">freebusy</a> / <a href="#REQUEST-STATUS">rstatus</a> / <a href="#X-PROPERTY_PROP">x-prop</a></p>
609
+ )
610
+ <br>
611
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
612
+
613
+ <a name="VALARM"></a><h2>2.6 VALARM</h2>
614
+ <p class="center">&quot;BEGIN&quot; &quot;:&quot; &quot;VALARM&quot; CRLF</p>
615
+ <p class="center">(audioprop / dispprop / emailprop / procprop)</p>
616
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VALARM&quot; CRLF</p> audioprop = 2*(
617
+ <p class="center">&quot;<a href="#ACTION">action</a>&quot; and &quot;<a href="#TRIGGER">trigger</a>&quot; are both REQUIRED, but MUST NOT occur more than once</p>
618
+ <p class="center"><a href="#ACTION">action</a> / <a href="#TRIGGER">trigger</a> /</p>
619
+ <p class="center">&quot;<a href="#DURATION">duration</a>&quot; and &quot;<a href="#REPEAT">repeat</a>&quot; are both optional,and MUST NOT occur more than once each,</p>
620
+ <p class="center">but if one occurs, so MUST the other</p>
621
+ <p class="center"><a href="#DURATION">duration</a> / <a href="#REPEAT">repeat</a> /</p>
622
+ <p class="center">the following is optional, but MUST NOT occur more than once</p>
623
+ <p class="center"><a href="#ATTACH">attach</a> / </p>
624
+ <p class="center">the following is optional, and MAY occur more than once</p>
625
+ <p class="center"><a href="#X-PROPERTY_PROP">x-prop</a></p>
626
+ )
627
+ <br>
628
+ dispprop = 3*(
629
+ <p class="center">the following are all REQUIRED, but MUST NOT occur more than once</p>
630
+ <p class="center"><a href="#ACTION">action</a> / <a href="#DESCRIPTION">description</a> / <a href="#TRIGGER">trigger</a> /</p>
631
+ <p class="center">&quot;<a href="#DURATION">duration</a>&quot; and &quot;<a href="#REPEAT">repeat</a>&quot; are both optional,and MUST NOT occur more than once each,</p>
632
+ <p class="center">but if one occurs, so MUST the other</p>
633
+ <p class="center"><a href="#DURATION">duration</a> / <a href="#REPEAT">repeat</a> /</p>
634
+ <p class="center">the following is optional, and MAY occur more than once</p>
635
+ <p class="center"><a href="#X-PROPERTY_PROP">x-prop</a></p>
636
+ )
637
+ <br>
638
+ emailprop = 5*(
639
+ <p class="center">the following are all REQUIRED, but MUST NOT occur more than once</p>
640
+ <p class="center"><a href="#ACTION">action</a> / <a href="#DESCRIPTION">description</a> / <a href="#TRIGGER">trigger</a> / <a href="#SUMMARY">summary</a></p>
641
+ <p class="center">the following is REQUIRED, and MAY occur more than once</p>
642
+ <p class="center"><a href="#ATTENDEE">attendee</a> / </p>
643
+ <p class="center">&quot;<a href="#DURATION">duration</a>&quot; and &quot;<a href="#REPEAT">repeat</a>&quot; are both optional, and MUST NOT occur more than once each,</p>
644
+ <p class="center">but if one occurs, so MUST the other</p>
645
+ <p class="center"><a href="#DURATION">duration</a> / <a href="#REPEAT">repeat</a> /</p>
646
+ <p class="center">the following are optional, and MAY occur more than once</p>
647
+ <p class="center"><a href="#ATTACH">attach</a> / <a href="#X-PROPERTY_PROP">x-prop</a></p>
648
+ )
649
+ <br>
650
+ procprop = 3*(
651
+ <p class="center">the following are all REQUIRED, but MUST NOT occur more than once</p>
652
+ <p class="center"><a href="#ACTION">action</a> / <a href="#ATTACH">attach</a> / <a href="#TRIGGER">trigger</a> /</p>
653
+ <p class="center">&quot;<a href="#DURATION">duration</a>&quot; and &quot;<a href="#REPEAT">repeat</a>&quot; are both optional, and MUST NOT occur more than once each,</p>
654
+ <p class="center">but if one occurs, so MUST the other</p>
655
+ <p class="center"><a href="#DURATION">duration</a> /
656
+ <a href="#REPEAT">repeat</a> /</p>
657
+ <p class="center">&quot;<a href="#DESCRIPTION">description</a>&quot; is optional, and MUST NOT occur more than once</p>
658
+ <p class="center"><a href="#DESCRIPTION">description</a> / </p>
659
+ <p class="center">the following is optional, and MAY occur more than once</p>
660
+ <p class="center"><a href="#X-PROPERTY_PROP">x-prop</a></p>
661
+ )
662
+ <br>
663
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
664
+
665
+ <a name="VTIMEZONE"></a><h2>2.7 VTIMEZONE</h2>
666
+ <p class="center">&quot;BEGIN&quot; &quot;:&quot; &quot;VTIMEZONE&quot; CRLF</p>
667
+ 2*(
668
+ <p class="center">&quot;<a href="#TZID">tzid</a>&quot; is required, but MUST NOT occur more than once</p>
669
+ <p class="center"><a href="#TZID">tzid</a> / </p>
670
+ <p class="center">&quot;<a href="#LAST-MODIFIED">last-mod</a>&quot; and &quot;<a href="#TZURL">tzurl</a>&quot; are optional, but MUST NOT occur more than once</p>
671
+ <p class="center"><a href="#LAST-MODIFIED">last-mod</a> / <a href="#TZURL">tzurl</a> /</p>
672
+ <p class="center">one of &quot;standardc&quot; or &quot;daylightc&quot; MUST occur and each MAY occur more than once.</p>
673
+ <p class="center">standardc / daylightc /</p>
674
+ <p class="center">the following is optional, and MAY occur more than once</p>
675
+ <p class="center"><a href="#X-PROPERTY_PROP">x-prop</a></p>
676
+ )
677
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;VTIMEZONE&quot; CRLF</p>
678
+ <p class="center">standardc = &quot;BEGIN&quot; &quot;:&quot; &quot;STANDARD&quot; CRLF</p>
679
+ <p class="center">tzprop</p>
680
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;STANDARD&quot; CRLF</p>
681
+ <p class="center">daylightc = &quot;BEGIN&quot; &quot;:&quot; &quot;DAYLIGHT&quot; CRLF</p>
682
+ <p class="center">tzprop</p>
683
+ <p class="center">&quot;END&quot; &quot;:&quot; &quot;DAYLIGHT&quot; CRLF</p>
684
+ <br>
685
+ tzprop = 3*(
686
+ <p class="center">the following are each REQUIRED, but MUST NOT occur more than once</p>
687
+ <p class="center"><a href="#DTSTART">dtstart</a> / <a href="#TZOFFSETTO">tzoffsetto</a> / <a href="#TZOFFSETFROM">tzoffsetfrom</a> /</p>
688
+ <p class="center">the following are optional, and MAY occur more than once</p>
689
+ <p class="center"><a href="#COMMENT">comment</a> /<a href="#RDATE">rdate</a> / <a href="#RRULE">rrule</a> / <a href="#TZNAME">tzname</a> / <a href="#X-PROPERTY_PROP">x-prop</a></p>
690
+ )
691
+ <br>
692
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
693
+
694
+ <a name="CalProps"></a><h2>2.8 Component Properties</h2>
695
+ A comprehensive table showing relation between <i>calendar</i> components and properties.
696
+ <a href="#VTIMEZONE">vtimezone</a> properties are not included.
697
+ <br><br>
698
+ <table>
699
+ <tr>
700
+ <td>0-1</td>
701
+ <td colspan="8">OPTIONAL property, MUST NOT occur more than once.</td>
702
+ </tr>
703
+ <tr>
704
+ <td>0-m</td>
705
+ <td colspan="8">OPTIONAL property, MAY occur more than once.</td>
706
+ </tr>
707
+ <tr>
708
+ <td>0&nbsp;/&nbsp;1=1</td>
709
+ <td colspan="8">A pair of OPTIONAL properties, MUST NOT occur more than once each.<br>If one occurs, so MUST the other</td>
710
+ </tr>
711
+ <tr>
712
+ <td>0*1</td>
713
+ <td colspan="8">A pair of OPTIONAL properties, MUST NOT occur more than once each.<br>If one occurs, so MUST NOT the other</td>
714
+ </tr>
715
+ <tr>
716
+ <td>1-m</td>
717
+ <td colspan="8">REQUIRED property, MAY occur more than once.</td>
718
+ </tr>
719
+ <tr>
720
+ <td>1</td>
721
+ <td colspan="8">REQUIRED property, MUST NOT occur more than once.</td>
722
+ </tr>
723
+ <tr>
724
+ <td colspan="9">&nbsp;</td>
725
+ </tr>
726
+ <tr>
727
+ <td>&nbsp;</td>
728
+ <td class="bl bb center top" rowspan="2"><a class="ref" href="#VEVENT">v<br>e<br>v<br>e<br>n<br>t</a></td>
729
+ <td class="bl bb center top" rowspan="2"><a class="ref" href="#VTODO">v<br>t<br>o<br>d<br>o</a></td>
730
+ <td class="bl bb center top" rowspan="2"><a class="ref" href="#VJOURNAL">v<br>j<br>o<br>u<br>r<br>n<br>a<br>l</a></td>
731
+ <td class="bl bb center top" rowspan="2"><a class="ref" href="#VFREEBUSY">v<br>f<br>r<br>e<br>e<br>b<br>u<br>s<br>y</a></td>
732
+ <td class="bl top center" colspan="4"><a class="ref" href="#VALARM">v&nbsp;a&nbsp;l&nbsp;a&nbsp;r&nbsp;m</a></td>
733
+ </tr>
734
+ <tr>
735
+ <td class="bb">&nbsp;</td>
736
+ <td class="bl bb center ref"><br><br><br><br>a<br>u<br>d<br>i<br>o</td>
737
+ <td class="bl bb center ref"><br><br>d<br>i<br>s<br>p<br>l<br>a<br>y</td>
738
+ <td class="bl bb center ref"><br><br><br><br>e<br>m<br>a<br>i<br>l</td>
739
+ <td class="bl bb center ref">p<br>r<br>o<br>c<br>e<br>d<br>u<br>r<br>e</td>
740
+ </tr>
741
+ <tr>
742
+ <td class="bb"><a class="ref" href="#ACTION">action</a></td>
743
+ <td class="blb">&nbsp;</td>
744
+ <td class="blb">&nbsp;</td>
745
+ <td class="blb">&nbsp;</td>
746
+ <td class="blb">&nbsp;</td>
747
+ <td class="blb">1</td>
748
+ <td class="blb">1</td>
749
+ <td class="blb">1</td>
750
+ <td class="blb">1</td>
751
+ </tr>
752
+ <tr>
753
+ <td class="bb"><a class="ref" href="#ATTACH">attach</a></td>
754
+ <td class="blb">0-m</td>
755
+ <td class="blb">0-m</td>
756
+ <td class="blb">0-m</td>
757
+ <td class="blb"></td>
758
+ <td class="blb">0-1</td>
759
+ <td class="blb">&nbsp;</td>
760
+ <td class="blb">0-m</td>
761
+ <td class="blb">1</td>
762
+ </tr>
763
+ <tr>
764
+ <td class="bb"><a class="ref" href="#ATTENDEE">attendee</a></td>
765
+ <td class="blb">0-m</td>
766
+ <td class="blb">0-m</td>
767
+ <td class="blb">0-m</td>
768
+ <td class="blb">0-m</td>
769
+ <td class="blb">&nbsp;</td>
770
+ <td class="blb">&nbsp;</td>
771
+ <td class="blb">1-m</td>
772
+ <td class="blb">&nbsp;</td>
773
+ </tr>
774
+ <tr>
775
+ <td class="bb"><a class="ref" href="#CATEGORIES">categories</a></td>
776
+ <td class="blb">0-m</td>
777
+ <td class="blb">0-m</td>
778
+ <td class="blb">0-m</td>
779
+ <td class="blb">&nbsp;</td>
780
+ <td class="blb">&nbsp;</td>
781
+ <td class="blb">&nbsp;</td>
782
+ <td class="blb">&nbsp;</td>
783
+ <td class="blb">&nbsp;</td>
784
+ </tr>
785
+ <tr>
786
+ <td class="bb"><a class="ref" href="#CLASS">class</a></td>
787
+ <td class="blb">0-1</td>
788
+ <td class="blb">0-1</td>
789
+ <td class="blb">0-1</td>
790
+ <td class="blb">&nbsp;</td>
791
+ <td class="blb">&nbsp;</td>
792
+ <td class="blb">&nbsp;</td>
793
+ <td class="blb">&nbsp;</td>
794
+ <td class="blb">&nbsp;</td>
795
+ </tr>
796
+ <tr>
797
+ <td class="bb"><a class="ref" href="#COMMENT">comment</a></td>
798
+ <td class="blb">0-m</td>
799
+ <td class="blb">0-m</td>
800
+ <td class="blb">0-m</td>
801
+ <td class="blb">0-m</td>
802
+ <td class="blb">&nbsp;</td>
803
+ <td class="blb">&nbsp;</td>
804
+ <td class="blb">&nbsp;</td>
805
+ <td class="blb">&nbsp;</td>
806
+ </tr>
807
+ <tr>
808
+ <td class="bb"><a class="ref" href="#COMPLETED">completed</a></td>
809
+ <td class="blb">&nbsp;</td>
810
+ <td class="blb">0-1</td>
811
+ <td class="blb">&nbsp;</td>
812
+ <td class="blb">&nbsp;</td>
813
+ <td class="blb">&nbsp;</td>
814
+ <td class="blb">&nbsp;</td>
815
+ <td class="blb">&nbsp;</td>
816
+ <td class="blb">&nbsp;</td>
817
+ </tr>
818
+ <tr>
819
+ <td class="bb"><a class="ref" href="#CONTACT">contact</a></td>
820
+ <td class="blb">0-m</td>
821
+ <td class="blb">0-m</td>
822
+ <td class="blb">0-m</td>
823
+ <td class="blb">0-1</td>
824
+ <td class="blb">&nbsp;</td>
825
+ <td class="blb">&nbsp;</td>
826
+ <td class="blb">&nbsp;</td>
827
+ <td class="blb">&nbsp;</td>
828
+ </tr>
829
+ <tr>
830
+ <td class="bb"><a class="ref" href="#CREATED">created</a></td>
831
+ <td class="blb">0-1</td>
832
+ <td class="blb">0-1</td>
833
+ <td class="blb">0-1</td>
834
+ <td class="blb">&nbsp;</td>
835
+ <td class="blb">&nbsp;</td>
836
+ <td class="blb">&nbsp;</td>
837
+ <td class="blb">&nbsp;</td>
838
+ <td class="blb">&nbsp;</td>
839
+ </tr>
840
+ <tr>
841
+ <td class="bb"><a class="ref" href="#DESCRIPTION">description</a></td>
842
+ <td class="blb">0-1</td>
843
+ <td class="blb">0-1</td>
844
+ <td class="blb">0-m</td>
845
+ <td class="blb">&nbsp;</td>
846
+ <td class="blb">&nbsp;</td>
847
+ <td class="blb">1</td>
848
+ <td class="blb">1</td>
849
+ <td class="blb">0-1</td>
850
+ </tr>
851
+ <tr>
852
+ <td class="bb"><a class="ref" href="#DTEND">dtend</a></td>
853
+ <td class="blb">0*1</td>
854
+ <td class="blb">&nbsp;</td>
855
+ <td class="blb">&nbsp;</td>
856
+ <td class="blb">0-1</td>
857
+ <td class="blb">&nbsp;</td>
858
+ <td class="blb">&nbsp;</td>
859
+ <td class="blb">&nbsp;</td>
860
+ <td class="blb">&nbsp;</td>
861
+ </tr>
862
+ <tr>
863
+ <td class="bb"><a class="ref" href="#DTSTAMP">dtstamp</a></td>
864
+ <td class="blb">0-1</td>
865
+ <td class="blb">0-1</td>
866
+ <td class="blb">0-1</td>
867
+ <td class="blb">0-1</td>
868
+ <td class="blb">&nbsp;</td>
869
+ <td class="blb">&nbsp;</td>
870
+ <td class="blb">&nbsp;</td>
871
+ <td class="blb">&nbsp;</td>
872
+ </tr>
873
+ <tr>
874
+ <td class="bb"><a class="ref" href="#DTSTART">dtstart</a></td>
875
+ <td class="blb">0-1</td>
876
+ <td class="blb">0-1</td>
877
+ <td class="blb">0-1</td>
878
+ <td class="blb">0-1</td>
879
+ <td class="blb">&nbsp;</td>
880
+ <td class="blb">&nbsp;</td>
881
+ <td class="blb">&nbsp;</td>
882
+ <td class="blb">&nbsp;</td>
883
+ </tr>
884
+ <tr>
885
+ <td class="bb"><a class="ref" href="#DUE">due</a></td>
886
+ <td class="blb">&nbsp;</td>
887
+ <td class="blb">0*1</td>
888
+ <td class="blb">&nbsp;</td>
889
+ <td class="blb">&nbsp;</td>
890
+ <td class="blb">&nbsp;</td>
891
+ <td class="blb">&nbsp;</td>
892
+ <td class="blb">&nbsp;</td>
893
+ <td class="blb">&nbsp;</td>
894
+ </tr>
895
+ <tr>
896
+ <td class="bb"><a class="ref" href="#DURATION">duration</a></td>
897
+ <td class="blb">0*1</td>
898
+ <td class="blb">0*1</td>
899
+ <td class="blb">&nbsp;</td>
900
+ <td class="blb">0-1</td>
901
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
902
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
903
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
904
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
905
+ </tr>
906
+ <tr>
907
+ <td class="bb"><a class="ref" href="#EXDATE">exdate</a></td>
908
+ <td class="blb">0-m</td>
909
+ <td class="blb">0-m</td>
910
+ <td class="blb">0-m</td>
911
+ <td class="blb">&nbsp;</td>
912
+ <td class="blb">&nbsp;</td>
913
+ <td class="blb">&nbsp;</td>
914
+ <td class="blb">&nbsp;</td>
915
+ <td class="blb">&nbsp;</td>
916
+ </tr>
917
+ <tr>
918
+ <td class="bb"><a class="ref" href="#EXRULE">exrule</a></td>
919
+ <td class="blb">0-m</td>
920
+ <td class="blb">0-m</td>
921
+ <td class="blb">0-m</td>
922
+ <td class="blb">&nbsp;</td>
923
+ <td class="blb">&nbsp;</td>
924
+ <td class="blb">&nbsp;</td>
925
+ <td class="blb">&nbsp;</td>
926
+ <td class="blb">&nbsp;</td>
927
+ </tr>
928
+ <tr>
929
+ <td class="bb"><a class="ref" href="#FREEBUSY_PROP">freebusy</a></td>
930
+ <td class="blb">&nbsp;</td>
931
+ <td class="blb">&nbsp;</td>
932
+ <td class="blb">&nbsp;</td>
933
+ <td class="blb">0-m</td>
934
+ <td class="blb">&nbsp;</td>
935
+ <td class="blb">&nbsp;</td>
936
+ <td class="blb">&nbsp;</td>
937
+ <td class="blb">&nbsp;</td>
938
+ </tr>
939
+ <tr>
940
+ <td class="bb"><a class="ref" href="#GEO">geo</a></td>
941
+ <td class="blb">0-1</td>
942
+ <td class="blb">0-1</td>
943
+ <td class="blb">&nbsp;</td>
944
+ <td class="blb">&nbsp;</td>
945
+ <td class="blb">&nbsp;</td>
946
+ <td class="blb">&nbsp;</td>
947
+ <td class="blb">&nbsp;</td>
948
+ <td class="blb">&nbsp;</td>
949
+ </tr>
950
+ <tr>
951
+ <td class="bb"><a class="ref" href="#LAST-MODIFIED">last-mod</a></td>
952
+ <td class="blb">0-1</td>
953
+ <td class="blb">0-1</td>
954
+ <td class="blb">0-1</td>
955
+ <td class="blb"></td>
956
+ <td class="blb">&nbsp;</td>
957
+ <td class="blb">&nbsp;</td>
958
+ <td class="blb">&nbsp;</td>
959
+ <td class="blb">&nbsp;</td>
960
+ </tr>
961
+ <tr>
962
+ <td class="bb"><a class="ref" href="#LOCATION">location</a></td>
963
+ <td class="blb">0-1</td>
964
+ <td class="blb">0-1</td>
965
+ <td class="blb">&nbsp;</td>
966
+ <td class="blb">&nbsp;</td>
967
+ <td class="blb">&nbsp;</td>
968
+ <td class="blb">&nbsp;</td>
969
+ <td class="blb">&nbsp;</td>
970
+ <td class="blb">&nbsp;</td>
971
+ </tr>
972
+ <tr>
973
+ <td class="bb"><a class="ref" href="#ORGANIZER">organizer</a></td>
974
+ <td class="blb">0-1</td>
975
+ <td class="blb">0-1</td>
976
+ <td class="blb">0-1</td>
977
+ <td class="blb">0-1</td>
978
+ <td class="blb">&nbsp;</td>
979
+ <td class="blb">&nbsp;</td>
980
+ <td class="blb">&nbsp;</td>
981
+ <td class="blb">&nbsp;</td>
982
+ </tr>
983
+ <tr>
984
+ <td class="bb"><a class="ref" href="#PERCENT-COMPLETE">percent</a></td>
985
+ <td class="blb">&nbsp;</td>
986
+ <td class="blb">0-1</td>
987
+ <td class="blb">&nbsp;</td>
988
+ <td class="blb">&nbsp;</td>
989
+ <td class="blb">&nbsp;</td>
990
+ <td class="blb">&nbsp;</td>
991
+ <td class="blb">&nbsp;</td>
992
+ <td class="blb">&nbsp;</td>
993
+ </tr>
994
+ <tr>
995
+ <td class="bb"><a class="ref" href="#PRIORITY">priority</a></td>
996
+ <td class="blb">0-1</td>
997
+ <td class="blb">0-1</td>
998
+ <td class="blb">&nbsp;</td>
999
+ <td class="blb">&nbsp;</td>
1000
+ <td class="blb">&nbsp;</td>
1001
+ <td class="blb">&nbsp;</td>
1002
+ <td class="blb">&nbsp;</td>
1003
+ <td class="blb">&nbsp;</td>
1004
+ </tr>
1005
+ <tr>
1006
+ <td class="bb"><a class="ref" href="#RDATE">rdate</a></td>
1007
+ <td class="blb">0-m</td>
1008
+ <td class="blb">0-m</td>
1009
+ <td class="blb">0-m</td>
1010
+ <td class="blb">&nbsp;</td>
1011
+ <td class="blb">&nbsp;</td>
1012
+ <td class="blb">&nbsp;</td>
1013
+ <td class="blb">&nbsp;</td>
1014
+ <td class="blb">&nbsp;</td>
1015
+ </tr>
1016
+ <tr>
1017
+ <td class="bb"><a class="ref" href="#RECURRENCE-ID">recurid</a></td>
1018
+ <td class="blb">0-1</td>
1019
+ <td class="blb">0-1</td>
1020
+ <td class="blb">0-1</td>
1021
+ <td class="blb">&nbsp;</td>
1022
+ <td class="blb">&nbsp;</td>
1023
+ <td class="blb">&nbsp;</td>
1024
+ <td class="blb">&nbsp;</td>
1025
+ <td class="blb">&nbsp;</td>
1026
+ </tr>
1027
+ <tr>
1028
+ <td class="bb"><a class="ref" href="#RELATED-TO">related</a></td>
1029
+ <td class="blb">0-m</td>
1030
+ <td class="blb">0-m</td>
1031
+ <td class="blb">0-m</td>
1032
+ <td class="blb">&nbsp;</td>
1033
+ <td class="blb">&nbsp;</td>
1034
+ <td class="blb">&nbsp;</td>
1035
+ <td class="blb">&nbsp;</td>
1036
+ <td class="blb">&nbsp;</td>
1037
+ </tr>
1038
+ <tr>
1039
+ <td class="bb"><a class="ref" href="#REPEAT">repeat</a></td>
1040
+ <td class="blb">&nbsp;</td>
1041
+ <td class="blb">&nbsp;</td>
1042
+ <td class="blb">&nbsp;</td>
1043
+ <td class="blb">&nbsp;</td>
1044
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
1045
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
1046
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
1047
+ <td class="blb">0&nbsp;/&nbsp;1=1</td>
1048
+ </tr>
1049
+ <tr>
1050
+ <td class="bb"><a class="ref" href="#RESOURCES">resources</a></td>
1051
+ <td class="blb">0-m</td>
1052
+ <td class="blb">0-m</td>
1053
+ <td class="blb">&nbsp;</td>
1054
+ <td class="blb">&nbsp;</td>
1055
+ <td class="blb">&nbsp;</td>
1056
+ <td class="blb">&nbsp;</td>
1057
+ <td class="blb">&nbsp;</td>
1058
+ <td class="blb">&nbsp;</td>
1059
+ </tr>
1060
+ <tr>
1061
+ <td class="bb"><a class="ref" href="#RRULE">rrule</a></td>
1062
+ <td class="blb">0-m</td>
1063
+ <td class="blb">0-m</td>
1064
+ <td class="blb">0-m</td>
1065
+ <td class="blb">&nbsp;</td>
1066
+ <td class="blb">&nbsp;</td>
1067
+ <td class="blb">&nbsp;</td>
1068
+ <td class="blb">&nbsp;</td>
1069
+ <td class="blb">&nbsp;</td>
1070
+ </tr>
1071
+ <tr>
1072
+ <td class="bb"><a class="ref" href="#REQUEST-STATUS">rstatus</a></td>
1073
+ <td class="blb">0-m</td>
1074
+ <td class="blb">0-m</td>
1075
+ <td class="blb">0-m</td>
1076
+ <td class="blb">0-m</td>
1077
+ <td class="blb">&nbsp;</td>
1078
+ <td class="blb">&nbsp;</td>
1079
+ <td class="blb">&nbsp;</td>
1080
+ <td class="blb">&nbsp;</td>
1081
+ </tr>
1082
+ <tr>
1083
+ <td class="bb"><a class="ref" href="#SEQUENCE">sequence</a></td>
1084
+ <td class="blb">0-1</td>
1085
+ <td class="blb">0-1</td>
1086
+ <td class="blb">0-1</td>
1087
+ <td class="blb">&nbsp;</td>
1088
+ <td class="blb">&nbsp;</td>
1089
+ <td class="blb">&nbsp;</td>
1090
+ <td class="blb">&nbsp;</td>
1091
+ <td class="blb">&nbsp;</td>
1092
+ </tr>
1093
+ <tr>
1094
+ <td class="bb"><a class="ref" href="#STATUS">status</a></td>
1095
+ <td class="blb">0-1</td>
1096
+ <td class="blb">0-1</td>
1097
+ <td class="blb">0-1</td>
1098
+ <td class="blb">&nbsp;</td>
1099
+ <td class="blb">&nbsp;</td>
1100
+ <td class="blb">&nbsp;</td>
1101
+ <td class="blb">&nbsp;</td>
1102
+ <td class="blb">&nbsp;</td>
1103
+ </tr>
1104
+ <tr>
1105
+ <td class="bb"><a class="ref" href="#SUMMARY">summary</a></td>
1106
+ <td class="blb">0-1</td>
1107
+ <td class="blb">0-1</td>
1108
+ <td class="blb">0-1</td>
1109
+ <td class="blb">&nbsp;</td>
1110
+ <td class="blb">&nbsp;</td>
1111
+ <td class="blb">&nbsp;</td>
1112
+ <td class="blb">1</td>
1113
+ <td class="blb">&nbsp;</td>
1114
+ </tr>
1115
+ <tr>
1116
+ <td class="bb"><a class="ref" href="#TRANSP">transp</a></td>
1117
+ <td class="blb">0-1</td>
1118
+ <td class="blb">&nbsp;</td>
1119
+ <td class="blb">&nbsp;</td>
1120
+ <td class="blb">&nbsp;</td>
1121
+ <td class="blb">&nbsp;</td>
1122
+ <td class="blb">&nbsp;</td>
1123
+ <td class="blb">&nbsp;</td>
1124
+ <td class="blb">&nbsp;</td>
1125
+ </tr>
1126
+ <tr>
1127
+ <td class="bb"><a class="ref" href="#TRIGGER">trigger</a></td>
1128
+ <td class="blb">&nbsp;</td>
1129
+ <td class="blb">&nbsp;</td>
1130
+ <td class="blb">&nbsp;</td>
1131
+ <td class="blb">&nbsp;</td>
1132
+ <td class="blb">1</td>
1133
+ <td class="blb">1</td>
1134
+ <td class="blb">1</td>
1135
+ <td class="blb">1</td>
1136
+ </tr>
1137
+ <tr>
1138
+ <td class="bb"><a class="ref" href="#UID">uid</a></td>
1139
+ <td class="blb">0-1</td>
1140
+ <td class="blb">0-1</td>
1141
+ <td class="blb">0-1</td>
1142
+ <td class="blb">0-1</td>
1143
+ <td class="blb">&nbsp;</td>
1144
+ <td class="blb">&nbsp;</td>
1145
+ <td class="blb">&nbsp;</td>
1146
+ <td class="blb">&nbsp;</td>
1147
+ </tr>
1148
+ <tr>
1149
+ <td class="bb"><a class="ref" href="#URL">url</a></td>
1150
+ <td class="blb">0-1</td>
1151
+ <td class="blb">0-1</td>
1152
+ <td class="blb">0-1</td>
1153
+ <td class="blb">0-1</td>
1154
+ <td class="blb">&nbsp;</td>
1155
+ <td class="blb">&nbsp;</td>
1156
+ <td class="blb">&nbsp;</td>
1157
+ <td class="blb">&nbsp;</td>
1158
+ </tr>
1159
+ <tr>
1160
+ <td class="bb"><a class="ref" href="#X-PROPERTY_PROP">x-prop</a></td>
1161
+ <td class="blb">0-m</td>
1162
+ <td class="blb">0-m</td>
1163
+ <td class="blb">0-m</td>
1164
+ <td class="blb">0-m</td>
1165
+ <td class="blb">0-m</td>
1166
+ <td class="blb">0-m</td>
1167
+ <td class="blb">0-m</td>
1168
+ <td class="blb">0-m</td>
1169
+ </tr>
1170
+ </table>
1171
+ <p>
1172
+ If not set, the <a href="#DTSTAMP">DTSTAMP</a> and <a href="#UID">UID</a> properties
1173
+ are automatically created by iCalcreator<br>
1174
+ for <a href="#VEVENT">vevent</a>,<a href="#VTODO">vtodo</a>, <a href="#VJOURNAL">vjournal</a> and <a href="#VFREEBUSY">vfreebusy</a> components<br>
1175
+ when using <i>calendar</i> functions <a href="#saveCalendar">saveCalendar</a> or <a href="#returnCalendar">returnCalendar</a><br>
1176
+ or when fetching DTSTAMP/UID property value with the component function <a href="#getProperty_PROP">getProperty</a>.
1177
+ </p>
1178
+ <br>
1179
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_Component_list">[up]</a>
1180
+
1181
+ <a name="Function_list"></a><h1>3. Function list</h1>
1182
+
1183
+ <a name="Calendar_object_functions"></a><h2>3.1 Calendar object functions</h2>
1184
+
1185
+ <a name="Calendar_object_constructors"></a><h3>3.1.1 Constructors</h3>
1186
+ <a name="vcalendar"></a><h2>3.1.1.1 vcalendar</h2>
1187
+ Create a new <a href="#VCALENDAR">VCALENDAR</a> object.
1188
+ <p class="label">Format</p>
1189
+ <p class="format">vcalendar()</p>
1190
+ <p class="label">Example</p>
1191
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1192
+ $vcalendar = new vcalendar( $config );
1193
+ ...
1194
+ </p>
1195
+ <br>
1196
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1197
+
1198
+ <a name="vevent"></a><h4>3.1.1.2 vevent</h4>
1199
+ <p class="label">Format 1</p>
1200
+ Create a new <a href="#VEVENT">VEVENT</a> object using a <i>calendar</i> factory-method, returning a reference to the new component.
1201
+ <p class="format">newComponent( &quot;vevent&quot; )</p>
1202
+ <p class="label">Example</p>
1203
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1204
+ $vcalendar = new vcalendar( $config );
1205
+ ...
1206
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
1207
+ $vevent->setProperty(...
1208
+ ...
1209
+ </p>
1210
+ <p class="label">Format 2</p>
1211
+ Create a new <a href="#VEVENT">VEVENT</a> object.
1212
+ <p class="format">vevent()</p>
1213
+ <p class="label">Example</p>
1214
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1215
+ $vcalendar = new vcalendar( $config );
1216
+ ...
1217
+ $vevent = new vevent();
1218
+ $vevent->setProperty(...
1219
+ ...
1220
+ $vcalendar->setComponent( $vevent );
1221
+ ...
1222
+ </p>
1223
+ <br>
1224
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1225
+
1226
+ <a name="vtodo"></a><h4>3.1.1.3 vtodo</h4>
1227
+ <p class="label">Format 1</p>
1228
+ Create a new <a href="#VTODO">VTODO</a> object using a <i>calendar</i> factory-method, returning a reference to the new component.
1229
+ <p class="format">newComponent( &quot;vtodo&quot; )</p>
1230
+ <p class="label">Example</p>
1231
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1232
+ $vcalendar = new vcalendar( $config );
1233
+ ...
1234
+ $vtodo = &amp; $vcalendar->newComponent( &quot;vtodo&quot; );
1235
+ $vtodo->setProperty(...
1236
+ ...
1237
+ </p>
1238
+ <p class="label">Format 2</p>
1239
+ Create a new <a href="#VTODO">VTODO</a> object.
1240
+ <p class="format">vtodo()</p>
1241
+ <p class="label">Example</p>
1242
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1243
+ $vcalendar = new vcalendar( $config );
1244
+ ...
1245
+ $vtodo = new vtodo();
1246
+ $vtodo->setProperty(...
1247
+ ...
1248
+ $vcalendar->setComponent( $vtodo );
1249
+ ...
1250
+ </p>
1251
+ <br>
1252
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1253
+
1254
+ <a name="vjournal"></a><h4>3.1.1.4 vjournal</h4>
1255
+ <p class="label">Format 1</p>
1256
+ Create a new <a href="#VJOUNAL">VJOURNAL</a> object using a <i>calendar</i> factory-method, returning a reference to the new component.
1257
+ <p class="format">newComponent( &quot;vjournal&quot; )</p>
1258
+ <p class="label">Example</p>
1259
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1260
+ $vcalendar = new vcalendar( $config );
1261
+ ...
1262
+ $vjournal = &amp; $vcalendar->newComponent( &quot;vjournal&quot; );
1263
+ $vjournal->setProperty(...
1264
+ ...
1265
+ </p>
1266
+ <p class="label">Format 2</p>
1267
+ Create a new <a href="#VJOURNAL">VJOURNAL</a> object.
1268
+ <p class="format">vjournal()</p>
1269
+ <p class="label">Example</p>
1270
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1271
+ $vcalendar = new vcalendar( $config );
1272
+ ...
1273
+ $vjournal = new vjournal();
1274
+ $vjournal->setProperty(...
1275
+ ...
1276
+ $vcalendar->setComponent( $vjournal );
1277
+ ...
1278
+ </p>
1279
+ <br>
1280
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1281
+
1282
+ <a name="vfreebusy"></a><h4>3.1.1.5 vfreebusy</h4>
1283
+ <p class="label">Format 1</p>
1284
+ Create a new <a href="#VFREEBUSY">VFREEBUSY</a> object using a <i>calendar</i> factory-method, returning a reference to the new component.
1285
+ <p class="format">newComponent( &quot;vfreebusy&quot; )</p>
1286
+ <p class="label">Example</p>
1287
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1288
+ $vcalendar = new vcalendar( $config );
1289
+ ...
1290
+ $vfreebusy = &amp; $vcalendar->newComponent( &quot;vfreebusy&quot; );
1291
+ $vfreebusy->setProperty(...
1292
+ ...
1293
+ </p>
1294
+ <p class="label">Format 2</p>
1295
+ Create a new <a href="#VFREEBUSY">VFREEBUSY</a> object.
1296
+ <p class="format">vfreebusy()</p>
1297
+ <p class="label">Example</p>
1298
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1299
+ $vcalendar = new vcalendar( $config );
1300
+ ...
1301
+ $vfreebusy = new vfreebusy();
1302
+ $vfreebusy->setProperty(...
1303
+ ...
1304
+ $vcalendar->setComponent( $vfreebusy );
1305
+ ...
1306
+ </p>
1307
+ <br>
1308
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1309
+
1310
+ <a name="valarm"></a><h4>3.1.1.6 valarm</h4>
1311
+ <p class="label">Format 1</p>
1312
+ Create a new <a href="#VALARM">VALARM</a> object using a component factory-method, returning a reference to the new (sub-)component.
1313
+ <p class="format">newComponent( &quot;valarm&quot; )</p>
1314
+ <p class="label">Example</p>
1315
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1316
+ $vcalendar = new vcalendar( $config );
1317
+ ...
1318
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
1319
+ $vevent->setProperty(...
1320
+ ...
1321
+ $valarm = &amp; $vevent->newComponent( &quot;valarm&quot; );
1322
+ $valarm->setProperty(...
1323
+ ...
1324
+ </p>
1325
+ <p class="label">Format 2</p>
1326
+ Create a new <a href="#VALARM">VALARM</a> object.
1327
+ <p class="format">valarm()</p>
1328
+ <p class="label">Example</p>
1329
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1330
+ $vcalendar = new vcalendar( $config );
1331
+ ...
1332
+ $vevent = new vevent();
1333
+ $vevent->setProperty(...
1334
+ ...
1335
+ $valarm = new valarm();
1336
+ $valarm->setProperty(...
1337
+ ...
1338
+ $vevent->setComponent( $valarm );
1339
+ ...
1340
+ $vcalendar->setComponent( $vevent );
1341
+ ...
1342
+ </p>
1343
+ <br>
1344
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1345
+
1346
+ <a name="vtimezone"></a><h4>3.1.1.7 vtimezone</h4>
1347
+ <p>
1348
+ The vtimezone component describe, at a minimum, the base offset from <b>UTC</b> for the time zone.
1349
+ For dates with UTC DATE-TIME, read <a href="#DATE_WITH_UTC_TIME">this</a>!
1350
+ </p>
1351
+ <p class="label">Format 1</p>
1352
+ Create a new <a href="#VTIMEZONE">VTIMEZONE</a> object using a <i>calendar</i> factory-method, returning a reference to the new component.
1353
+ <p class="format">newComponent( &quot;vtimezone&quot; )</p>
1354
+ <p class="label">Example</p>
1355
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1356
+ $vcalendar = new vcalendar( $config );
1357
+ ...
1358
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
1359
+ $vtimezone->setProperty(...
1360
+ ...
1361
+ </p>
1362
+ <p class="label">Format 2</p>
1363
+ Create a new <a href="#VTIMEZONE">VTIMEZONE</a> object.
1364
+ <p class="format">vtimezone()</p>
1365
+ <p class="label">Example</p>
1366
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1367
+ $vcalendar = new vcalendar( $config );
1368
+ ...
1369
+ $vtimezone = new vtimezone();
1370
+ $vtimezone->setProperty(...
1371
+ ...
1372
+ $vcalendar->setComponent( $vtimezone );
1373
+ ...
1374
+ </p>
1375
+ <br>
1376
+ <h5>Creation of timezone components</h5>
1377
+ It is possible to create timezone components, using a function in iCalUtilityFunctions class, <a href="#createTimezone">createTimezone</a>
1378
+ and utilizing The <i>PHP</i> DateTimeZone class (<i>PHP</i> 5 >= 5.2.0).
1379
+ <br>
1380
+ <br>
1381
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1382
+
1383
+ <a name="standard"></a><h4>3.1.1.8 standard</h4>
1384
+ <p class="label">Format 1</p>
1385
+ Create a new <a href="#VTIMEZONE">VTIMEZONE</a> <b>standard</b> object using a component factory-method, returning a reference to the new (sub-)component.
1386
+ <p class="format">newComponent( &quot;standard&quot; )</p>
1387
+ <p class="label">Example</p>
1388
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1389
+ $vcalendar = new vcalendar( $config );
1390
+ ...
1391
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
1392
+ $vtimezone->setProperty(...
1393
+ ...
1394
+ $standard = &amp; $vtimezone->newComponent( &quot;standard&quot; );
1395
+ $standard->setProperty(...
1396
+ ...
1397
+ $daylight = &amp; $vtimezone->newComponent( &quot;daylight&quot; );
1398
+ $daylight->setProperty(...
1399
+ ...
1400
+ </p>
1401
+ <p class="label">Format 2</p>
1402
+ Create a new <a href="#VTIMEZONE">VTIMEZONE</a> STANDARD object.
1403
+ <p class="format">vtimezone( &quot;standard&quot; )</p>
1404
+ <p class="label">Example</p>
1405
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1406
+ $vcalendar = new vcalendar( $config );
1407
+ ...
1408
+ $vtimezone = new vtimezone();
1409
+ $vtimezone->setProperty(...
1410
+ ...
1411
+ $standard = new vtimezone( &quot;standard&quot; );
1412
+ $standard->setProperty(...
1413
+ ...
1414
+ $vtimezone->setComponent( $standard );
1415
+ ...
1416
+ $daylight = new vtimezone( &quot;daylight&quot; );
1417
+ $daylight->setProperty(...
1418
+ ...
1419
+ $vtimezone->setComponent( $daylight );
1420
+ ...
1421
+ $vcalendar->setComponent( $vtimezone );
1422
+ ...
1423
+ </p>
1424
+ <br>
1425
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1426
+
1427
+ <a name="daylight"></a><h4>3.1.1.9 daylight</h4>
1428
+ <p class="label">Format 1</p>
1429
+ Create a new <a name="VTIMEZONE">VTIMEZONE</a> <b>daylight</b> object using a component factory-method, returning a reference to the new (sub-)component.
1430
+ <p class="format">newComponent( &quot;standard&quot; )</p>
1431
+ <p class="label">Example</p>
1432
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1433
+ $vcalendar = new vcalendar( $config );
1434
+ ...
1435
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
1436
+ ...
1437
+ $standard = &amp; $vtimezone->newComponent( &quot;standard&quot; );
1438
+ ...
1439
+ $daylight = &amp; $vtimezone->newComponent( &quot;daylight&quot; );
1440
+ ...
1441
+ </p>
1442
+ <p class="label">Format 2</p>
1443
+ Create a new <a href="#VTIMEZONE">VTIMEZONE</a> DAYLIGHT object.
1444
+ <p class="format">vtimezone( &quot;daylight&quot; )</p>
1445
+ <p class="label">Example</p>
1446
+ <p class="example"></p>
1447
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1448
+ $vcalendar = new vcalendar( $config );
1449
+ ...
1450
+ $vtimezone = new vtimezone();
1451
+ ...
1452
+ $standard = new vtimezone( &quot;standard&quot; );
1453
+ ...
1454
+ $vtimezone->setComponent( $standard );
1455
+ $daylight = new vtimezone( &quot;daylight&quot; );
1456
+ ...
1457
+ $vtimezone->setComponent( $daylight );
1458
+ $vcalendar->setComponent( $vtimezone );
1459
+ ...
1460
+ </p>
1461
+ <br>
1462
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Function_list">[up]</a>
1463
+
1464
+
1465
+ <a name="Calendar_property_functions"></a><h3>3.1.2 Calendar property functions</h3>
1466
+
1467
+ <a name="deleteProperty"></a><h4>3.1.2.1 deleteProperty</h4>
1468
+ General <i>calendar</i> deleteProperty function, simplifying removal of <i>calendar</i> properties.<br>
1469
+ FALSE is returned if no property exists or when end-of-properties at consecutive function calls.
1470
+ <p class="label">Format</p>
1471
+ <p class="format">deleteProperty( [ string PropName [, int order=1 ] )</p>
1472
+ <p class="comment">propName - case independent, rfc2445 component property names,
1473
+ unknown/missing propName will be regarded as <a href="#X-PROPERTY">X-property</a>.
1474
+ order - if missing 1st/next occurrence,
1475
+ used with multiple (property) occurrences
1476
+ </p>
1477
+ <p class="label">Example 1</p>
1478
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1479
+ $vcalendar = new vcalendar( $config );
1480
+ $vcalendar->parse();
1481
+ if( !$vcalendar->deleteProperty( &quot;method&quot; ))
1482
+ &nbsp;&nbsp;echo "METHOD property not found";
1483
+ .. .
1484
+ </p>
1485
+ <br>
1486
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1487
+
1488
+ <a name="getProperty"></a><h4>3.1.2.2 getProperty</h4>
1489
+ <p class="label">Format 1</p>
1490
+ General <i>calendar</i> getProperty function, simplifying fetch of <i>calendar</i> properties.<br>
1491
+ FALSE is returned if no property exists or when end-of-properties at consecutive function calls.
1492
+ <p class="format">getProperty( [ string PropName [, int order=1 [, bool complete=FALSE ]]] )</p>
1493
+ <p class="comment">propName - case independent, rfc2445 component property names,
1494
+ unknown/missing propName will be regarded as <a href="#X-PROPERTY">X-property</a>.
1495
+ order - if missing 1st/next occurrence,
1496
+ used with multiply (property) occurrences
1497
+ complete - FALSE (default) : output only property value
1498
+ - TRUE : output =
1499
+ array( &quot;value&quot;=&gt; &lt;value&gt; ,&quot;params&quot; =&gt; &lt;parameter array&gt;)
1500
+ </p>
1501
+ <p class="label">Example 1</p>
1502
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1503
+ $vcalendar = new vcalendar( $config );
1504
+ $vcalendar->parse();
1505
+ $calscale = $vcalendar->getProperty( &quot;calscale&quot; );
1506
+ .. .
1507
+ </p>
1508
+ <p class="label">Example 2</p>
1509
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1510
+ $vcalendar = new vcalendar( $config );
1511
+ $vcalendar->parse();
1512
+ while( $xprop = $vcalendar->getProperty( )) { // <span class="ref">get x-properties</span>
1513
+ .. .
1514
+ </p>
1515
+ <a name="getProperty2">
1516
+ <p class="label">Format 2</p>
1517
+ Ability to fetch specific property (unique) values and number of occurrences. Supported properties are
1518
+ <a href="#ATTENDEE">ATTENDEE</a>, <a href="#CATEGORIES">CATEGORIES</a>, <a href="#DTSTART">DTSTART</a>, <a href="#LOCATION">LOCATION</a>, <a href="#ORGANIZER">ORGANIZER</a>, <a href="#PRIORITY">PRIORITY</a>, <a href="#RESOURCES">RESOURCES</a>,
1519
+ <a href="#STATUS">STATUS</a>, <a href="#SUMMARY">SUMMARY</a>, <a href="#UID">UID</a> or &quot;RECURRENCE-ID-UID&quot; (alt. &quot;R-UID&quot; ).
1520
+ The search includes in <b>ALL</b> components within <i>calendar</i>.
1521
+ <br><br>
1522
+ Outputs an array( *[&lt;unique-property-value&gt; =&gt; &lt;number of occurrence&gt;] )<br>or an empty array if no hits.
1523
+ The array is sorted by (asc.) key.
1524
+ <br><br>
1525
+ If a property contains multiple values (ex. &quot;CATAGORIES:course1,courseB&quot, &quot;LOCATION:London,Paris&quot; or &quot;RESOURCES:pc,developer&quot;), they are split into unique values.
1526
+ <br><br>
1527
+ To select components based on property values, see <a href="#selectComponents2">selectComponents</a> (Format 2).
1528
+ <p class="format">getProperty( string PropName )</p>
1529
+ <p class="comment">propName - case independent
1530
+ <a href="#DTSTART">DTSTART</a> as argument returns dates, in format &quot;YYYYMMDD&quot;,
1531
+ &quot;RECURRENCE-ID-UID&quot;returns <a href="#UID">UID</a> values for component(-s) where <a href="#RECURRENCE-ID">RECURRENCE-ID</a> is set.
1532
+ <a href="#ATTENDEE">ATTENDEE</a> and <a href="#ORGANIZER">ORGANIZER</a> values are prefixed by protocol like
1533
+ &quot;MAILTO:chair@kigkonsult.se&quot;.
1534
+ </p>
1535
+ <p class="label">Example 1</p>
1536
+ <p class="example">.. .
1537
+ $attendees = $vcalendar->getProperty( &quot;ATTENDEE&quot; );
1538
+ foreach( $attendees as $attendee => $occurrCount ) {
1539
+ .. .
1540
+ </p>
1541
+ <p class="label">Example 2</p>
1542
+ <p class="example">.. .
1543
+ $startDates = $vcalendar->getProperty( &quot;DTSTART&quot; );
1544
+ foreach( $startDates as $startDate => $occurrCount ) {
1545
+ .. .
1546
+ </p>
1547
+ <br>
1548
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1549
+
1550
+ <a name="setProperty"></a><h4>3.1.2.3 setProperty</h4>
1551
+ General <i>calendar</i> setProperty function,simplifying insert of <i>calendar</i> properties.<br>
1552
+ A successful update returns TRUE.
1553
+ <p class="label">Format</p>
1554
+ <p class="format">setProperty( string PropName, mixed Proparg_1 *[, mixed Proparg_n] )</p>
1555
+ propName case independent, strict rfc2445 <i>calendar</i> property names, unknown propName will be regarded as <a href="#X-PROPERTY">X-property</a>.
1556
+ <p class="label">Example</p>
1557
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1558
+ $vcalendar = new vcalendar( $config ); // <span class="ref">initiate new CALENDAR</span>
1559
+ $vcalendar->setProperty( &quot;calscale&quot;, &quot;GREGORIAN&quot; );
1560
+ </p>
1561
+ <br>
1562
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1563
+
1564
+ <a name="CALSCALE"></a><h4>3.1.2.4 CALSCALE</h4>
1565
+ This property defines the <i>calendar</i> scale used for the <i>calendar</i> information specified in the iCalendar object.
1566
+ <br><br>
1567
+ The default value is &quot;GREGORIAN&quot;, implied when missing.
1568
+ <h5>Delete CALSCALE</h5>
1569
+ Remove CALSCALE from component.
1570
+ <p class="label">Format</p>
1571
+ <p class="format">deleteProperty( &quot;calscale&quot; )</p>
1572
+ <p class="label">Example</p>
1573
+ <p class="example">$vcalendar->deleteProperty( &quot;CALSCALE&quot; );</p>
1574
+ <h5>Get Calscale</h5>
1575
+ Fetch property value.
1576
+ <p class="label">Format</p>
1577
+ <p class="format">getProperty( &quot;calscale&quot; )</p>
1578
+ <p class="label">Example</p>
1579
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1580
+ $vcalendar = new vcalendar( $config );
1581
+ $vcalendar->parse();
1582
+ $calscale = $vcalendar->getProperty( &quot;calscale&quot; );
1583
+ .. .
1584
+ </p>
1585
+ <h5>Set CALSCALE</h5>
1586
+ Insert property value.
1587
+ <p class="label">Format</p>
1588
+ <p class="format">setProperty( &quot;calscale&quot;, string value )</p>
1589
+ <p class="label">Example</p>
1590
+ <p class="example">
1591
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
1592
+ $vcalendar = new vcalendar( $config ); // <span class="ref">initiate new CALENDAR</span>
1593
+ $vcalendar->setProperty( &quot;calscale&quot;, &quot;GREGORIAN&quot; );
1594
+ .. .
1595
+ </p>
1596
+ <br>
1597
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1598
+
1599
+
1600
+ <a name="METHOD"></a><h4>3.1.2.5 METHOD</h4>
1601
+ This property defines the iCalendar object method associated with the <i>calendar</i> object.
1602
+ <br><br>
1603
+ METHOD property (value PUBLISH etc.) may be required when importing iCal files
1604
+ into some calendaring software (MS etc.), as well as <a href="#X-PROPERTY">x-properties</a>
1605
+ "X-WR-CALNAME", "X-WR-CALDESC" and "X-WR-TIMEZONE"
1606
+ and the (automatically created) <a href="#DTSTAMP">DTSTAMP</a> and <a href="#UID">UID</a> properties.
1607
+ <h5>Delete METHOD</h5>
1608
+ Remove METHOD from component.
1609
+ <p class="label">Format</p>
1610
+ <p class="format">deleteProperty( &quot;METHOD&quot; )</p>
1611
+ <p class="label">Example</p>
1612
+ <p class="example">$vcalendar->deleteProperty( &quot;METHOD&quot; );</p>
1613
+ <h5>Get METHOD</h5>
1614
+ Fetch property value.
1615
+ <p class="label">Format</p>
1616
+ <p class="format">getProperty( &quot;method&quot; );</p>
1617
+ <p class="label">Example</p>
1618
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;);
1619
+ $vcalendar = new vcalendar( $config );
1620
+ $vcalendar->parse();
1621
+ $method = $vcalendar->getProperty( &quot;method&quot; )
1622
+ .. .
1623
+ </p>
1624
+ <h5>Set METHOD</h5>
1625
+ Insert property value.
1626
+ <p class="label">Format</p>
1627
+ <p class="format">setProperty( &quot;method&quot;, string value )</p>
1628
+ <p class="label">Example</p>
1629
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
1630
+ $vcalendar = new vcalendar( $config ); // <span class="ref">initiate new CALENDAR</span>
1631
+ $vcalendar->setProperty( &quot;method&quot;, &quot;PUBLISH&quot; )
1632
+ </p>
1633
+ <br>
1634
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1635
+
1636
+
1637
+ <a name="VERSION"></a><h4>3.1.2.6 VERSION</h4>
1638
+ This property specifies the identifier corresponding to the highest version number or the minimum
1639
+ and maximum range of the iCalendar specification that is required in order to interpret the iCalendar object.<br>
1640
+ This property is always placed first in the <i>calendar</i> file.<br>
1641
+ <h5>Get Version</h5>
1642
+ Fetch property value.
1643
+ <p class="label">Format</p>
1644
+ <p class="format">getProperty( &quot;version&quot; )</p>
1645
+ <p class="label">Example</p>
1646
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1647
+ $vcalendar = new vcalendar( $config );
1648
+ $vcalendar->parse();
1649
+ $version = $vcalendar->getProperty( &quot;version&quot; )
1650
+ .. .
1651
+ </p>
1652
+ <h5>Set Version</h5>
1653
+ Insert property value.
1654
+ Only version 2.0 valid, version is <b>AUTO</b> generated at <i>calendar</i> creation.
1655
+ <p class="label">Format</p>
1656
+ <p class="format">setProperty( &quot;version&quot;, string version )</p>
1657
+ <p class="label">Example</p>
1658
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
1659
+ $vcalendar = new vcalendar( $config ); // <span class="ref">initiate new CALENDAR</span>
1660
+ $vcalendar->setProperty( &quot;version&quot;, &quot;2.0&quot; )
1661
+ </p>
1662
+ <br>
1663
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1664
+
1665
+ <a name="X-PROPERTY"></a><h4>3.1.2.7 X-PROPERTY</h4>
1666
+ A <i>calendar</i>, non-standard property with a TEXT value and a name with an &quot;X-&quot; prefix. In a <i>calendar</i>,
1667
+ an x-property, with an unique name, can occur only once but the number of x-properties are unlimited.
1668
+ <br><br>
1669
+ X-properties "X-WR-CALNAME", "X-WR-CALDESC" and "X-WR-TIMEZONE" may be required when importing iCal files
1670
+ into some calendaring software (MS etc.), as well as <a href="#METHOD">METHOD</a> property (value PUBLISH etc.)
1671
+ and the (automatically created) <a href="#DTSTAMP">DTSTAMP</a> and <a href="#UID">UID</a> properties.
1672
+ <h5>Delete X-PROPERTY</h5>
1673
+ Remove X-PROPERTY from <i>calendar</i>.
1674
+ <p class="label">Format</p>
1675
+ <p class="format">deleteProperty( &quot;&lt;X-PROPERTY&gt;&quot; )</p>
1676
+ <p class="label">Example 1</p>
1677
+ <p class="example">$vcalendar->deleteProperty( &quot;&lt;X-PROPERTY&gt;&quot; );</p>
1678
+ <p class="label">Example 2</p>
1679
+ Deleting all x-properties.
1680
+ <p class="example">while( $vcalendar->deleteProperty())
1681
+ continue;</p>
1682
+ <h5>Get X-PROPERTY</h5>
1683
+ Fetch property value.
1684
+ <p class="label">Format</p>
1685
+ <p class="format">getProperty()<br>
1686
+ getProperty( &quot;&lt;X-PROPERTY&gt;&quot; )</p>
1687
+ <p class="comment">output = array( propertyName<span class="ref">1</span>, propertyData<span class="ref">2</span> )</p>
1688
+ <p class="format">getProperty( FALSE, propOrderNo/FALSE, TRUE )</p>
1689
+ <p class="comment">output = array( propertyName<span class="ref">1</span>
1690
+ , array( &quot;value&quot; =&gt; propertyData<span class="ref">2</span> )
1691
+ , &quot;params&quot; =&gt; params<span class="ref">&nbsp;3</span>))
1692
+ </p>
1693
+ <p class="label">Example 1</p>
1694
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1695
+ $vcalendar = new vcalendar( $config );
1696
+ $vcalendar->parse();
1697
+ while( $xprop = $vcalendar->getProperty( )) { //<span class="ref">read all x-props in a loop</span>
1698
+ .. .
1699
+ </p>
1700
+ <p class="comment">$xprop = array( propertyName<span class="ref">1</span>, propertyData<span class="ref">2</span> )</p>
1701
+ <p class="label">Example 2</p>
1702
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1703
+ $vcalendar = new vcalendar( $config );
1704
+ $vcalendar->parse();
1705
+ if( $xprop = $vcalendar->getProperty( &quot;X-WR-TIMEZONE&quot; )) {
1706
+ //<span class="ref">if exists, read X-WR-TIMEZONE x-prop</span>
1707
+ .. .
1708
+ </p>
1709
+ <p class="comment">$xprop = array( &quot;X-WR-TIMEZONE&quot;, propertyData<span class="ref">2</span> )</p>
1710
+ <p class="label">Example 3</p>
1711
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1712
+ $vcalendar = new vcalendar( $config );
1713
+ $vcalendar->parse();
1714
+ while( $xprop = $vcalendar->getProperty( FALSE, FALSE, TRUE )) {
1715
+ .. .
1716
+ </p>
1717
+ <p class="comment">$xprop = array( propertyName<span class="ref">1</span>
1718
+ , array( &quot;value &quot; =&gt; propertyData<span class="ref">2</span> )
1719
+ , &quot;params &quot;=&gt; params<span class="ref">&nbsp;3</span> )
1720
+ </p>
1721
+ <h5>Set X-PROPERTY</h5>
1722
+ Insert property name and value. If an x-prop with the same name already exists, it will be replaced.
1723
+ PropertyNames are always stored upperCase, ex. x-wr-calname =&gt; X-WR-CALNAME.
1724
+ <p class="label">Format</p>
1725
+ <p class="format">setProperty( propertyName, propertyData [, params ] )</p>
1726
+ <p class="comment">propertyName<span class="ref">1</span> = Any property name with a &quot;X-&quot; prefix
1727
+ propertyData<span class="ref">2</span> = Value type TEXT
1728
+ params<span class="ref">3</span> = array( [&quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;] [, xparam] )
1729
+ xparam = *[ xparamkey =&gt; xparamvalue ]
1730
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
1731
+ <p class="label">Example</p>
1732
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
1733
+ $vcalendar = new vcalendar( $config ); // initiate new CALENDAR
1734
+ // <span class="ref">set some X-properties.. .</span>
1735
+ $vcalendar->setProperty( &quot;x-wr-calname&quot;, &quot;Calendar Sample&quot; )
1736
+ $vcalendar->setProperty( &quot;X-WR-CALDESC&quot;, &quot;Calendar Description&quot; );
1737
+ $vcalendar->setProperty( &quot;X-WR-TIMEZONE&quot;, &quot;Europe/Stockholm&quot; );
1738
+ </p>
1739
+ <br>
1740
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_property_functions">[up]</a>
1741
+
1742
+ <a name="Calendar_component_functions"></a><h3>3.1.3 Calendar component functions</h3>
1743
+
1744
+ <a name="deleteComponent"></a><h4>3.1.3.1 deleteComponent</h4>
1745
+ Remove component from <i>calendar</i>.<br>
1746
+ FALSE is returned if no property exists or when end-of-properties at consecutive function calls.
1747
+ <p class="label">format 1</p>
1748
+ Remove component with order number (1st=1, 2nd=2.. .).
1749
+ <p class="format">deleteComponent( int orderNumber )</p>
1750
+ <p class="label">format 2</p>
1751
+ Remove component with component type (e.g. &quot;vevent&quot;) and order 1 alt. suborder number.
1752
+ <p class="format">deleteComponent( string componentType [, int componentSuborderNumber])</p>
1753
+ <p class="label">format 3</p>
1754
+ Remove component with <a href="#UID">UID</a>. N.B <a href="#UID">UID</a> is NOT set for
1755
+ <a href="#VALARM">ALARM</a> / <a href="#VTIMEZONE">TIMEZONE</a> components.
1756
+ <p class="format">deleteComponent( string <a href="#UID">UID</a> )</p>
1757
+ <p class="label">Example 1</p>
1758
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1759
+ $vcal = new vcalendar( $config );
1760
+ $vcal->parse();
1761
+ $vcal->deleteComponent( 1 );
1762
+ $vcal->deleteComponent( &quot;vtodo&quot;, 2 );
1763
+ $vcal->deleteComponent( &quot;20070803T194810CEST-0123U3PXiX@kigkonsult.se&quot;);
1764
+ .. .
1765
+ </p>
1766
+ <p class="label">Example 2</p>
1767
+ Deleting all components, using format 2 without order number.
1768
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1769
+ $vcal = new vcalendar( $config );
1770
+ $vcal->parse();
1771
+ .. .
1772
+ while( $vcal->deleteComponent( &quot;vevent&quot;))
1773
+ continue;
1774
+ .. .
1775
+ $vtodo = $vcal->getComponent( &quot;vtodo&quot; );
1776
+ while( $vtodo->deleteComponent( &quot;valarm&quot;))
1777
+ continue;
1778
+ .. .
1779
+ </p>
1780
+ <br>
1781
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_functions">[up]</a>
1782
+
1783
+ <a name="getComponent"></a><h4>3.1.3.2 getComponent</h4>
1784
+ Get component from <i>calendar</i>.<br>
1785
+ FALSE is returned if no property exists or when end-of-properties at consecutive function calls.
1786
+
1787
+ <p class="label">format 1</p>
1788
+ Get next component, until end-of-components.
1789
+ <p class="format">getComponent()</p>
1790
+
1791
+ <p class="label">format 2</p>
1792
+ Get specific component with order number (1st=1, 2nd=2.. .).
1793
+ <p class="format">getComponent( int orderNumber )</p>
1794
+
1795
+ <p class="label">format 3</p>
1796
+ Get (first/next) component with component type (until end-of-components) alt.
1797
+ get specific component with component type and suborder number (1st=1, 2nd=2.. .).
1798
+ <p class="format">getComponent( string componentType [, int componentSuborderNumber])</p>
1799
+
1800
+ <p class="label">format 4</p>
1801
+ Get (first/next) component with <a href="#UID">UID</a> as key. (<a href="#UID">UID</a> is NOT set for
1802
+ <a href="#VALARM">ALARM</a> / <a href="#VTIMEZONE">TIMEZONE</a> components.)
1803
+ <p class="format">getComponent( string <a href="#UID">UID</a> )</p>
1804
+
1805
+ <p class="label">format 5</p>
1806
+ Get (first/next) component based on specific property contents;
1807
+ <a href="#DTSTART">DTSTART</a>, <a href="#DTEND">DTEND</a>, <a href="#DUE">DUE</a>, <a href="#CREATED">CREATED</a>, <a href="#COMPLETED">COMPLETED</a>, <a href="#DTSTAMP">DTSTAMP</a>, <a href="#LAST-MODIFIED">LAST-MODIFIED</a>, <a href="#RECURRENCE-ID">RECURRENCE-ID</a>,
1808
+ <a href="#ATTENDEE">ATTENDEE</a>, <a href="#CATEGORIES">CATEGORIES</a>, <a href="#LOCATION">LOCATION</a>, <a href="#ORGANIZER">ORGANIZER</a>, <a href="#PRIORITY">PRIORITY</a>, <a href="#RESOURCES">RESOURCES</a>, <a href="#STATUS">STATUS</a>, <a href="#SUMMARY">SUMMARY</a>, <a href="#UID">UID</a>.
1809
+ For the property &quot;SUMMARY&quot; ,if a search value (any case) exists within property value, a hit exists.
1810
+ For the other, non-date, properties an exact (strict case) match is required.<br>
1811
+ Note, <a href="#ATTENDEE">ATTENDEE</a> and <a href="#ORGANIZER">ORGANIZER</a> values must be prefixed by protocol ex.&quot;MAILTO:chair@ical.net&quot;.
1812
+
1813
+ <p class="format">getComponent( array(*[string propertyName =&gt; string uniqueValue] ))</p>
1814
+ <p class="comment">propertyName = property name, above
1815
+ propertyData = unique property value (strict case),
1816
+ date format &quot;YYYYMMDD&quot; (if any side is DATE, only dates are used),
1817
+ datetime format &quot;YYYYMMDDTHHMMSS&quot;
1818
+ </p>
1819
+ <p class="label">Example 1</p>
1820
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1821
+ $vcalendar = new vcalendar( $config );
1822
+ $vcalendar->parse();
1823
+ while( $comp = $vcalendar->getComponent()) {
1824
+ .. .
1825
+ }
1826
+ .. .
1827
+ </p>
1828
+ <p class="label">Example 2</p>
1829
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1830
+ $vcalendar = new vcalendar( $config );
1831
+ $vcalendar->parse();
1832
+ if( $comp = $vcalendar->getComponent( 1 )) {
1833
+ .. .
1834
+ }
1835
+ .. .
1836
+ </p>
1837
+ <p class="label">Example 3</p>
1838
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1839
+ $vcalendar = new vcalendar( $config );
1840
+ $vcalendar->parse();
1841
+ if( $comp = $vcalendar->getComponent( &quot;vtodo&quot;, 2 ) {
1842
+ .. .
1843
+ }
1844
+ .. .
1845
+ </p>
1846
+ <p class="label">Example 4</p>
1847
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
1848
+ $vcalendar = new vcalendar( $config );
1849
+ $vcalendar->parse();
1850
+ $uid = &quot;20070803T194810CEST-0123U3PXiX@kigkonsult.se&quot;;
1851
+ if($comp = $vcalendar->getComponent( $uid ){
1852
+ .. .
1853
+ }
1854
+ .. .
1855
+ </p>
1856
+ <br>
1857
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_functions">[up]</a>
1858
+
1859
+ <a name="newComponent"></a><h4>3.1.3.3 newComponent</h4>
1860
+ Create component (<a href="#VEVENT">EVENT</a> / <a href="#VTODO">VTODO</a> / <a href="#VJOURNAL">VJOURNAL</a> / <a href="#VFREEBUSY">VFREEBUSY</a> / <a href="#VTIMEZONE">VTIMEZONE</a>)
1861
+ using a <i>calendar</i> factory-method, returning a reference to the new component.
1862
+ <p class="label">Format</p>
1863
+ <p class="format">newComponent( string componentType )</p>
1864
+ <p class="label">Example</p>
1865
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
1866
+ $vcalendar = new vcalendar( $config );
1867
+ ...
1868
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
1869
+ ...
1870
+ </p>
1871
+
1872
+ <br>
1873
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_functions">[up]</a>
1874
+
1875
+ <a name="selectComponents"></a><h4>3.1.3.4 selectComponents</h4>
1876
+ <p class="label">Format 1</p>
1877
+ Selects <a href="#VEVENT">EVENT</a> / <a href="#VTODO">VTODO</a> / <a href="#VJOURNAL">VJOURNAL</a> / <a href="#VFREEBUSY">VFREEBUSY</a> components from <i>calendar</i> on based on <b>dates</b> (notice <a href="#date_restriction">date restriction</a>), based on the initial <a href="#DTSTART">DTSTART</a> property
1878
+ along with the <a href="#RRULE">RRULE</a>, <a href="#RDATE">RDATE</a>, <a href="#EXDATE">EXDATE</a> and <a href="#EXRULE">EXRULE</a> properties in the component.
1879
+ If property <a href="#DTSTART">DTSTART</a> is missing in a <a href="#VTODO">VTODO</a> component then <a href="#DTSTART">DUE</a> is used.<br>
1880
+ <br>
1881
+ Limitations:
1882
+ <ul>
1883
+ <li>The values &quot;SECONDLY&quot; / &quot;MINUTELY&quot; / &quot;HOURLY&quot; in the &quot;FREQ&quot; rule part are NOT supported.
1884
+ <li>If using components with properties<br />
1885
+ <a href="#UID">UID</a> in combination with <a href="#SEQUENCE">SEQUENCE</a> and <a href="#RECURRENCE-ID">RECURRENCE-ID</a><br />
1886
+ (i.e. an individual instance within the recurrence set),<br />
1887
+ the <a href="#RECURRENCE-ID">RECURRENCE-ID</a> parameter &quot;RANGE&quot; (&quot;THISANDPRIOR&quot; / &quot;THISANDFUTURE&quot;) is NOT supported.<br>
1888
+ </ul>
1889
+ Requirement:
1890
+ <ul>
1891
+ <li><a href="#sort">sort</a> <b>MUST</b> be executed before &quot;selectComponents&quot;, notice example below.
1892
+ </ul>
1893
+ FALSE is returned if no selected component exists.
1894
+ <p class="format">selectComponents([ int startYear, int startMonth, int startDay
1895
+ [, int endYear, int endMonth, int endDay
1896
+ [, mixed cType [, bool flat [,bool any [,bool split]]]]]])
1897
+ </p>
1898
+ Returns an array with components (events.. .).
1899
+ For all recurrent instances of a <i>calendar</i> component, an x-property,
1900
+ &quot;X-CURRENT-DTSTART&quot; and opt. also &quot;X-CURRENT-DTEND&quot; alt. &quot;X-CURRENT-DUE&quot;,
1901
+ has been created with a TEXT content, &quot;Y-m-d&nbsp;[H:i:s][timezone/UTC&nbsp;offset]&quot;
1902
+ showing the current start and opt. also end alt. due date.<br>
1903
+ Also a &quot;X-RECURRENCE&quot; x-property is set with order number (valid if selectComponents is called from DTSTART date).
1904
+ <p class="comment">startYear : start year (4*digit), default current year
1905
+ startMonth : start month (1-2*digit), default current month
1906
+ startDay : start day (1-2*digit), default current day
1907
+ endYear : end year (4*digit), default startYear
1908
+ endMonth : end month (1-2*digit), default startMonth
1909
+ endDay : end day (1-2*digit), default startDay
1910
+ cType : <i>calendar</i> component type(-s), string/array
1911
+ (&quot;vevent&quot;, &quot;vtodo&quot;, &quot;vjournal&quot;, &quot;vfreebusy&quot;)
1912
+ FALSE (default) =&gt; all
1913
+ flat : TRUE =&gt; output : array[] (ignores split)
1914
+ component where recurrence pattern exists within period
1915
+ FALSE (default) =&gt; output : array[Year][Month][Day][]
1916
+ any : TRUE (default) =&gt; select components with recurrence pattern in period
1917
+ FALSE =&gt; only components that starts (DTSTART) within period
1918
+ split : TRUE (default) =&gt; one component copy for every day it occurs
1919
+ within the period
1920
+ FALSE =&gt; one occurrence of component in output array,
1921
+ start date/recurrence (start) date
1922
+
1923
+ valid flat any split
1924
+ combinations (defaults in upper case)
1925
+ 1 FALSE TRUE TRUE
1926
+ 2 FALSE TRUE false
1927
+ 3 FALSE false [false] (split set to false if flat=FALSE and any=false)
1928
+ 4 true TRUE [false] (split set to false if flat=true)
1929
+ 5 true false [false] (split set to false if flat=true)
1930
+ </p>
1931
+ <p class="label">Example</p>
1932
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
1933
+ &quot;directory&quot; =&gt; &quot;import&quot;,
1934
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
1935
+ $vcalendar = new vcalendar( $config );
1936
+ $vcalendar->parse();
1937
+ $vcalendar->sort();
1938
+ $events_arr = $vcalendar->selectComponents( 2007,11,1,2007,11,30,&quot;vevent&quot;);
1939
+ // <span class="comment">select all events occurring 1-30 nov. 2007</span>
1940
+ foreach( $events_arr as $year =&gt; $year_arr ) {
1941
+ foreach( $year_arr as $month =&gt; $month_arr ) {
1942
+ foreach( $month_arr as $day =&gt; $day_arr ) {
1943
+ foreach( $day_arr as $event ) {
1944
+ $currddate = $event->getProperty( &quot;x-current-dtstart&quot; );
1945
+ <span class="comment">// if member of a recurrence set, returns
1946
+ // array(&quot; x-current-dtstart&quot;,
1947
+ // &lt;(string) date(&quot;Y-m-d&nbsp;[H:i:s][timezone/UTC&nbsp;offset]&quot;)&gt;)</span>
1948
+ $startDate = $event->getProperty( &quot;dtstart&quot; );
1949
+ $summary = $event->getProperty( &quot;summary&quot; );
1950
+ $description = $event->getProperty( &quot;description&quot; );
1951
+ .. .
1952
+ </p>
1953
+ <a name="selectComponents2"></a>
1954
+ <p class="label">format 2</p>
1955
+ Using this format, the function selects components based on specific property value(-s),
1956
+ <a href="#ATTENDEE">ATTENDEE</a>, <a href="#CATEGORIES">CATEGORIES</a>, <a href="#LOCATION">LOCATION</a>, <a href="#ORGANIZER">ORGANIZER</a>, <a href="#PRIORITY">PRIORITY</a>, <a href="#RESOURCES">RESOURCES</a>, <a href="#STATUS">STATUS</a>, <a href="#SUMMARY">SUMMARY</a> or <a href="#UID">UID</a>.
1957
+ For the property &quot;SUMMARY&quot; ,if a search value (any case) exists within property value, a hit is found.
1958
+ For the other properties an exact (strict case) match is required.<br>
1959
+ <a href="#ATTENDEE">ATTENDEE</a> and <a href="#ORGANIZER">ORGANIZER</a> search values must be prefixed by protocol ex. &quot;MAILTO:chair@ical.net&quot;.
1960
+ Multiple search properties may coexist.
1961
+ <br>
1962
+ <br>
1963
+ To retrieve property values, see <a href="#getProperty2">getProperty</a> (Format 2) on <i>calendar</i> level.
1964
+ <p class="format">selectComponents( searchArray )</p>
1965
+ Outputs an array of matched (unique) components in <a href="#UID">UID</a> order.
1966
+ <p class="comment">searchArray : array( propertyName =&gt; propertyValue )
1967
+ propertyName : above (any case)
1968
+ propertyValue : string value / array( *[string value] )
1969
+ </p>
1970
+ <p class="label">Example</p>
1971
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
1972
+ &quot;directory&quot; =&gt; &quot;import&quot;,
1973
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
1974
+ $vcalendar = new vcalendar( $config );
1975
+ $vcalendar->parse();
1976
+ $vcalendar->sort();
1977
+ $searchArray = array( &quot;PRIORITY&quot; =&gt; array( 1, 2, 3, 4 ));
1978
+ $highPrioArr = $vcalendar->selectComponents( $searchArray );
1979
+ // <span class="comment">select all components with PRIORITY set to high (1-4)</span>
1980
+ if( !empty( $highPrioArr )) {
1981
+ $highPrioCal = new vcalendar( array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; ));
1982
+ $highPrioCal-&gt;setProperty( "X-WR-CALDESC", "High priority events" );
1983
+ foreach( $highPrioArr as $highPrioComponent )
1984
+ $highPrioCal-&gt;setComponent( $highPrioComponent );
1985
+ $highPrioCal-&gt;returnCalendar();
1986
+ }
1987
+ .. .
1988
+ </p>
1989
+ <br>
1990
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_functions">[up]</a>
1991
+
1992
+ <a name="setComponent"></a><h4>3.1.3.5 setComponent</h4>
1993
+ Replace or update component in <i>calendar</i>.
1994
+ Also add <i>calendar</i> component to <i>calendar</i> when <i>calendar</i> component is created with the procedural (<b>non</b>-factory) method,
1995
+ see example <a href="#vevent">VEVENT</a>, format 2.
1996
+ A successful update return TRUE.
1997
+ <p class="label">format 1</p>
1998
+ Insert last in component chain.
1999
+ <p class="format">setComponent( component )
2000
+ addComponent( component ) // <span class="ref">alias</span>
2001
+ </p>
2002
+ <p class="comment">addComponent, may be removed i future versions.</p>
2003
+ <p class="label">format 2</p>
2004
+ Insert/replace component with order number (1st=1, 2nd=2.. .).
2005
+ If replace and orderNumber is not found, component is inserted last in chain.
2006
+ <p class="format">setComponent( component, int orderNumber )</p>
2007
+ <p class="label">format 3</p>
2008
+ Replace component with component type and 1st alt. component order number.
2009
+ If orderNumber is not found, component is inserted last in chain.
2010
+ <p class="format">setComponent( component, string componentType [,int component suborder no])</p>
2011
+ <p class="label">format 4</p>
2012
+ Replace component with <a href="#UID">UID</a>.
2013
+ N.B <a href="#UID">UID</a> is NOT set for <a href="#VALARM">ALARM</a> / <a href="#VTIMEZONE">TIMEZONE</a> components.
2014
+ If <a href="#UID">UID</a> is not found, component is inserted last in chain.
2015
+ <p class="format">setComponent( component, string <a href="#UID">UID</a> )</p>
2016
+ <p class="label">Example</p>
2017
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
2018
+ $vcalendar = new vcalendar( $config );
2019
+ $vcalendar->parse();
2020
+ $vevent = vcalendar->getComponent( 1 );&nbsp;//<span class="comment">fetch first EVENT</span>
2021
+ $vevent->setProperty( &quot;dtstart&quot;&nbsp;//<span class="comment">update <a class="ref" href="#DTSTART">DTSTART</a> property</span>
2022
+ , 2006, 12, 24, 19, 30, 00 );
2023
+ .. .
2024
+ $vcalendar->setComponent( $vevent, 1 ); // replace first component
2025
+ .. .
2026
+ </p>
2027
+ <br>
2028
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_functions">[up]</a>
2029
+
2030
+ <a name="Calendar_inputoutput_functions"></a><h3>3.1.4 Calendar input/output functions</h3>
2031
+
2032
+ <a name="parse_merge"></a><h4>3.1.4.1 parse and merge</h4>
2033
+ Parse iCal file(-s) or string/array <i>calendar</i>Content into a single vcalendar object (components, properties and parameters),
2034
+ including multiple vcalendars (within a single ICS file) parse, e.g. Oracle Calendar exports.
2035
+
2036
+ <br><br>
2037
+ As long as php.ini directive &quot;allow_url_fopen&quot; is enabled, remote files, URLs; protocol &quot;http&quot; (&quot;webcal&quot;), are supported. A remote file, URL, <b>must</b> be prefixed by &quot;http://&quot; (&quot;webcal://&quot;) and suffixed by a valid filename.! Recommendation is to download (cache) remote file before parsing, due to execution time and control.
2038
+ <br><br>
2039
+ If missing, component property <a href="#UID">UID</a> is created when parsing. For that reason <a href="#Unique_id">UNIQUE_ID</a> might need to be set before parsing, Se examples below.
2040
+ <br><br>
2041
+ Notice <a href="#date_restriction">date restriction</a>!
2042
+ <br><br>
2043
+ If parse error occurs (like file access error, invalid <i>calendar</i> file or <i>calendar</i> file without components), FALSE is returned.
2044
+ <p class="label">Format</p>
2045
+ <p class="format">parse( [ mixed textToParse ] )</p>
2046
+ <p class="comment">textToParse = string calendarContent
2047
+ ex. result from - file_get_contents( &quot;filename&quot;)
2048
+ array calendarContent
2049
+ ex. result from - file( &quot;filename&quot;, FILE_IGNORE_NEW_LINES )</p>
2050
+ <p class="label">parse example 1</p>
2051
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;, &quot;filename&quot; =&gt; &quot;file.ics&quot;);
2052
+ $vcalendar = new vcalendar( $config );
2053
+ $vcalendar->parse();
2054
+ .. .
2055
+ </p>
2056
+ <p class="label">parse example 2</p>
2057
+ <p class="example">
2058
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2059
+ &quot;url&quot; =&gt; &quot;http://www.ical.net/calendars/calendar.ics&quot; );
2060
+ $vcalendar = new vcalendar( $config );
2061
+ $vcalendar->parse();
2062
+ .. .
2063
+ </p>
2064
+ <p class="label">parse example 3</p>
2065
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2066
+ &quot;url&quot; =&gt; &quot;http://www.ical.net/calendars/calendar.ics&quot; );
2067
+ $vcalendar = new vcalendar( $config );
2068
+ ...
2069
+ $str = array(
2070
+ &quot;BEGIN:VCALENDAR&quot;,
2071
+ &quot;PRODID:-//kigkonsult.se//NONSGML kigkonsult.se iCalcreator 2.10.23//&quot;,
2072
+ &quot;VERSION:2.0&quot;,
2073
+ &quot;BEGIN:VEVENT&quot;,
2074
+ &quot;DTSTART:20101224T190000Z&quot;,
2075
+ &quot;DTEND:20101224T200000Z&quot;,
2076
+ &quot;DTSTAMP:20101020T103827Z&quot;,
2077
+ &quot;UID:20101020T113827-1234GkdhFR@test.org&quot;,
2078
+ &quot;DESCRIPTION:example&quot;,
2079
+ &quot;END:VEVENT&quot;,
2080
+ &quot;END:VCALENDAR&quot;);
2081
+ $vcalendar->parse( $str );
2082
+ ...
2083
+ </p>
2084
+ <p class="label">merge example</p>
2085
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2086
+ &quot;directory&quot; =&gt; &quot;import&quot; );
2087
+ $vcalendar = new vcalendar( $config );
2088
+
2089
+ $vcalendar->setConfig( &quot;filename&quot;,&nbsp;&nbsp;&quot;file1.ics&quot; );
2090
+ $vcalendar->parse();
2091
+
2092
+ $vcalendar->setConfig( &quot;filename&quot;,&nbsp;&nbsp;&quot;file2.ics&quot; );
2093
+ $vcalendar->parse();
2094
+
2095
+ $vcalendar->sort();
2096
+ $vcalendar->setConfig( &quot;directory&quot;,&nbsp;&quot;export&quot; );
2097
+ $vcalendar->setConfig( &quot;filename&quot;,&nbsp;&nbsp;&quot;icalmerge.ics&quot; );
2098
+ $vcalendar->saveCalendar();
2099
+ .. .
2100
+ </p>
2101
+ <br>
2102
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_inputoutput_functions">[up]</a>
2103
+
2104
+ <a name="createCalendar"></a><h4>3.1.4.2 createCalendar</h4>
2105
+ Generate and return <i>calendar</i> in a string, testing.. .?
2106
+ <p class="label">Format</p>
2107
+ <p class="format">createCalendar()</p>
2108
+ <p class="label">Example</p>
2109
+ <p class="example">.. .
2110
+ $str = $vcalendar->createCalendar();
2111
+ echo $str;
2112
+ </p>
2113
+ <br>
2114
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_inputoutput_functions">[up]</a>
2115
+
2116
+ <a name="returnCalendar"></a><h4>3.1.4.3 returnCalendar</h4>
2117
+ Redirect <i>calendar</i> content to user browser. Filename, addressed to browser, is automatically generated if missing or not set;<br>
2118
+ <span class="format">$filename = date( &quot;YmdHis&quot; ).&quot;.ics&quot; </span><br>
2119
+ <p class="label">Format</p>
2120
+ <p class="format">returnCalendar( [bool utf8Encode [, bool gzip ]] )</p>
2121
+ <p class="comment">utf8Encode = TRUE: utf8 encoded output, FALSE: (default) no encoding
2122
+ gzip = TRUE: gzip compressed output and header &quot;Content-Encoding: gzip&quot; set,
2123
+ FALSE: (default) no compressing</p>
2124
+ <p class="label">Example 1</p>
2125
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
2126
+ $vcalendar = new vcalendar( $config );
2127
+ .. .
2128
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
2129
+ $vevent->setProperty( &quot;dtstart&quot;, array( &quot;year&quot; =&gt; 2007
2130
+ , &quot;month&quot; =&gt; 4
2131
+ , &quot;day&quot; =&gt; 1
2132
+ , &quot;hour&quot; =&gt; 19 ));
2133
+ $vevent->setProperty( &quot;duration&quot;, 0, 0, 3 ));
2134
+ $vevent->setProperty( &quot;LOCATION&quot;, &quot;Central Plaza&quot; );
2135
+ $vevent->setProperty( &quot;summary&quot;, &quot;PHP summit&quot; );
2136
+ .. .
2137
+ $vcalendar->returnCalendar();
2138
+ </p>
2139
+ <p class="label">Example 2</p>
2140
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2141
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2142
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2143
+ $vcalendar = new vcalendar( $config );
2144
+ $vcalendar->parse();
2145
+ $utf8Encode = TRUE;
2146
+ $hacPar = &quot;HTTP_ACCEPT_ENCODING&quot;;
2147
+ if( isset( $_SERVER[$hacPar] ) &amp;&amp;
2148
+ ( FALSE !== strpos( strtolower( $_SERVER[$hacPar] ), &quot;gzip&quot; )))
2149
+ $gzip = TRUE;
2150
+ else
2151
+ $gzip = FALSE;
2152
+ $vcalendar->returnCalendar( $utf8Encode, $gzip );
2153
+ </p>
2154
+ <br>
2155
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_inputoutput_functions">[up]</a>
2156
+
2157
+ <a name="saveCalendar"></a><h4>3.1.4.4 saveCalendar</h4>
2158
+ Save ical <i>calendar</i> in a file, uses present directory if directory not set, filename is automatically generated if missing or not set;<br>
2159
+ <span class="format">$filename = date( &quot;YmdHis&quot; ).&quot;.ics&quot; </span><br>
2160
+ Directory/filename <b>must</b> be writeable, delimiter default <i>PHP</i> constant DIRECTORY_SEPARATOR.
2161
+ <br><br>
2162
+ As long as php.ini directive &quot;allow_url_fopen&quot; is enabled, remote files, URLs; protocol &quot;http&quot; (&quot;webcal&quot;), are supported. Recommendation is to save to a local file and upload later, due to execution time and control.
2163
+ <br><br>
2164
+ If file error occurs, FALSE is returned.
2165
+ <p class="label">Format</p>
2166
+ <p class="format">saveCalendar ( string directory/FALSE
2167
+ [, string filename/FALSE
2168
+ [, string delimiter/FALSE ]] )
2169
+ </p>
2170
+ Parameters for <span class="format">directory/filename/delimiter</span>, kept for backward compatibility,
2171
+ may be removed i future versions. Recommendation is to use <span class="format">setConfig</span>, Se
2172
+ example below.
2173
+ <p class="label">Example</p>
2174
+ <p class="example">.. .
2175
+ $vcalendar->setConfig( array( &quot;directory&quot; =&gt; &quot;depot&quot;,
2176
+ &quot;filename&quot; =&gt; &quot;calendar.ics&quot; ));
2177
+ $result = $vcalendar->saveCalendar();
2178
+ if( !$result )
2179
+ &nbsp;&nbsp;echo &quot;error when saving.. .&quot;
2180
+ </p>
2181
+ <br>
2182
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_inputoutput_functions">[up]</a>
2183
+
2184
+ <a name="sort"></a><h4>3.1.4.5 sort</h4>
2185
+ <p class="label">Format 1</p>
2186
+ Sort created/parsed <i>calendar</i> components on the following (prioritized) keys:<br>
2187
+ 1 - X-CURRENT-DTSTART - X-CURRENT-DTEND/X-CURRENT-DUE<br>
2188
+ &nbsp;&nbsp;&nbsp;&nbsp;(if created in function <a href="#selectComponents">selectComponents</a>)<br>
2189
+ 1 - <a href="#DTSTART">DTSTART</a> - <a href="#DTEND">DTEND</a> alt. <a href="#DURATION">DURATION</a> (<a href="#VEVENT">VEVENT</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components)<br>
2190
+ 1 - <a href="#DTSTART">DTSTART</a> - <a href="#DUE">DUE</a> alt. <a href="#DURATION">DURATION</a> (<a href="#VTODO">VTODO</a> components)<br>
2191
+ 1 - <a href="#DTSTART">DTSTART</a> (<a href="#VJOURNAL">VJOURNAL</a> components)<br>
2192
+ 2 - <a href="#CREATED">CREATED</a> / <a href="#DTSTAMP">DTSTAMP</a><br>
2193
+ 3 - <a href="#UID">UID</a><br>
2194
+ <a href="#VTIMEZONE">VTIMEZONE</a> component(-s) are always sorted first in chain.<br>
2195
+ Sub-components (<a href="#VTIMEZONE">STANDARD</a>&nbsp;/&nbsp;<a href="#VTIMEZONE">DAYLIGHT</a>&nbsp;/&nbsp;<a href="#VALARM">ALARM</a>), if exists, are not sorted.
2196
+ <p class="format">sort()</p>
2197
+ <p class="label">Example</p>
2198
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2199
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2200
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2201
+ $vcalendar = new vcalendar( $config );
2202
+ $vcalendar->parse();
2203
+ $vcalendar->sort();
2204
+ $vcalendar->returnCalendar();
2205
+ </p>
2206
+
2207
+ <p class="label">Format 2</p>
2208
+ Sort created/parsed <i>calendar</i> components on specific property values and ascending order.
2209
+ <p class="format">sort( sortArgument )</p>
2210
+ <p class="comment">sortArgument: &quot;<a href="#ATTENDEE">ATTENDEE</a>&quot; / &quot;<a href="#CATEGORIES">CATEGORIES</a>&quot; / &quot;<a href="#DTSTAMP">DTSTAMP</a>&quot; / &quot;<a href="#LOCATION">LOCATION"</a>&quot; /
2211
+ &quot;<a href="#ORGANIZER">ORGANIZER</a>&quot; /&quot;<a href="#RESOURCES">RESOURCES</a>&quot; / &quot;<a href="#PRIORITY">PRIORITY</a>&quot; / &quot;<a href="#STATUS">STATUS</a>&quot; / &quot;<a href="#SUMMARY">SUMMARY</a>&quot;
2212
+ for a property where multiple occurrence may exist
2213
+ (<a href="#ATTENDEE">ATTENDEE</a>, <a href="#CATEGORIES">CATEGORIES</a>, <a href="#RESOURCES">RESOURCES</a> ),
2214
+ lowest (alphabetic) value is used as sort parameter.
2215
+ </p>
2216
+ <br>
2217
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_inputoutput_functions">[up]</a>
2218
+
2219
+ <a name="useCachedCalendar"></a><h4>3.1.4.6 useCachedCalendar</h4>
2220
+ If recent version of local (non-empty and saved) <i>calendar</i> file exists, an HTTP redirect header is sent otherwise FALSE is returned.
2221
+ <p class="label">Format</p>
2222
+ <p class="format">useCachedCalendar( [ int timeout ] )
2223
+ useCachedCalendar( string directory/FALSE
2224
+ , string filename/FALSE
2225
+ , string delimiter/FALSE
2226
+ [, int timeout ] )
2227
+ </p>
2228
+ <p class="comment">timeout : default 3600 sec
2229
+ Second format with parameters for <span class="format">directory/filename/delimiter</span>,<br>kept for backward compatibility, may be removed i future<br>versions. Recommendation is to use <span class="format">setConfig</span>, Se example below.</p>
2230
+ <p class="label">Example</p>
2231
+ <p class="example">.. .
2232
+ $vcalendar->setConfig( &quot;directory&quot;, &quot;depot&quot; );
2233
+ $vcalendar->setConfig( &quot;filename&quot;, &quot;calendar.ics&quot; );
2234
+ $vcalendar->useCachedCalendar();
2235
+ </p>
2236
+ <br>
2237
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_inputoutput_functions">[up]</a>
2238
+
2239
+ <a name="Calendar_configuration_functions"></a><h3>3.1.5 Calendar configuration functions</h3>
2240
+
2241
+ <a name="configKeys"></a><h4>3.1.5.1 configuration keys</h4>
2242
+ All configuration keys (allowEmpty, compsInfo etc.) case independent.
2243
+ <br>
2244
+ <br>
2245
+ <table>
2246
+ <tr>
2247
+ <td class="bl bb">key</td>
2248
+ <td class="bl bb"><i>calendar</i></td>
2249
+ <td class="bl bb">component</td>
2250
+ <td class="bl bb">remark</td>
2251
+ </tr>
2252
+ <tr>
2253
+ <td class="bl bb"><a class="ref" href="#allowEmpty">allowEmpty</a></td>
2254
+ <td class="bl bb center">*</td>
2255
+ <td class="bl bb center">*</td>
2256
+ <td class="bl bb ref">&nbsp;</td>
2257
+ </tr>
2258
+ <tr>
2259
+ <td class="bl bb"><a class="ref" href="#Compsinfo">Compsinfo</a></td>
2260
+ <td class="bl bb center">*</td>
2261
+ <td class="bl bb center">*</td>
2262
+ <td class="bl bb ref">getConfig only</td>
2263
+ </tr>
2264
+ <tr>
2265
+ <td class="bl bb"><a class="ref" href="#Delimiter">Delimiter</a></td>
2266
+ <td class="bl bb center">*</td>
2267
+ <td class="bl bb">&nbsp;</td>
2268
+ <td class="bl bb ref">&nbsp;</td>
2269
+ </tr>
2270
+ <tr>
2271
+ <td class="bl bb"><a class="ref" href="#Directory">Directory</a></td>
2272
+ <td class="bl bb center">*</td>
2273
+ <td class="bl bb">&nbsp;</td>
2274
+ <td class="bl bb ref">&nbsp;</td>
2275
+ </tr>
2276
+ <tr>
2277
+ <td class="bl bb"><a class="ref" href="#Filename">Filename</a></td>
2278
+ <td class="bl bb center">*</td>
2279
+ <td class="bl bb">&nbsp;</td>
2280
+ <td class="bl bb ref">&nbsp;</td>
2281
+ </tr>
2282
+ <tr>
2283
+ <td class="bl bb"><a class="ref" href="#Dirfile">Dirfile</a></td>
2284
+ <td class="bl bb center">*</td>
2285
+ <td class="bl bb">&nbsp;</td>
2286
+ <td class="bl bb ref">getConfig only</td>
2287
+ </tr>
2288
+ <tr>
2289
+ <td class="bl bb"><a class="ref" href="#Filesize">Filesize</a></td>
2290
+ <td class="bl bb center">*</td>
2291
+ <td class="bl bb">&nbsp;</td>
2292
+ <td class="bl bb ref">getConfig only</td>
2293
+ </tr>
2294
+ <tr>
2295
+ <td class="bl bb"><a class="ref" href="#Format">Format</a></td>
2296
+ <td class="bl bb center">*</td>
2297
+ <td class="bl bb">&nbsp;</td>
2298
+ <td class="bl bb ref">&nbsp;</td>
2299
+ </tr>
2300
+ <tr>
2301
+ <td class="bl bb"><a class="ref" href="#Language">Language</a></td>
2302
+ <td class="bl bb center">*</td>
2303
+ <td class="bl bb center">*</td>
2304
+ <td class="bl bb ref">&nbsp;</td>
2305
+ </tr>
2306
+ <tr>
2307
+ <td class="bl bb"><a class="ref" href="#NewlineChar">NewlineChar</a></td>
2308
+ <td class="bl bb center">*</td>
2309
+ <td class="bl bb center">*</td>
2310
+ <td class="bl bb ref">&nbsp;</td>
2311
+ </tr>
2312
+ <tr>
2313
+ <td class="bl bb"><a class="ref" href="#dTZID">TZID</a></td>
2314
+ <td class="bl bb center">*</td>
2315
+ <td class="bl bb center">*</td>
2316
+ <td class="bl bb ref">&nbsp;</td>
2317
+ </tr>
2318
+ <tr>
2319
+ <td class="bl bb"><a class="ref" href="#Unique_id">Unique_id</a></td>
2320
+ <td class="bl bb center">*</td>
2321
+ <td class="bl bb center">*</td>
2322
+ <td class="bl bb ref">&nbsp;</td>
2323
+ </tr>
2324
+ <tr>
2325
+ <td class="bl bb"><a class="ref" href="#configURL">URL</a></td>
2326
+ <td class="bl bb center">*</td>
2327
+ <td class="bl bb">&nbsp;</td>
2328
+ <td class="bl bb ref">&nbsp;</td>
2329
+ </tr>
2330
+ </table>
2331
+ <br>
2332
+ <br>
2333
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2334
+
2335
+ <a name="getConfig"></a><h4>3.1.5.2 getConfig</h4>
2336
+ <p class="format">getConfig( [string key )</p>
2337
+ <p class="label">Example 1</p>
2338
+ <p class="example">.. .
2339
+ $filename = $vcalendar->getConfig( &quot;filename&quot; );
2340
+ .. .</p>
2341
+ In this example, notice <a href="#Filename">Filename</a>
2342
+ <br>
2343
+ <p class="label">Example 2</p>
2344
+ <p class="example">.. .
2345
+ $config = $vcalendar->getConfig();
2346
+ .. .</p>
2347
+ <p class="comment">Output= array( string key =&gt; mixed value
2348
+ *[, string key =&gt; mixed value] )</p>
2349
+ <br>
2350
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2351
+
2352
+ <a name="initConfig"></a><h4>3.1.5.3 calendar/component initialization</h4>
2353
+ <p class="label">Format</p>
2354
+ When creating a new <i>calendar</i>.
2355
+ <p class="format">vcalendar( array( string key =&gt; mixed value *[,string key =&gt; mixed value]))</p>
2356
+ <p class="label">Example 1</p>
2357
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2358
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2359
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2360
+ $vcalendar = new vcalendar( $config );
2361
+ .. .
2362
+ </p>
2363
+ When creating a new <i>calendar</i> component.
2364
+ <p class="format">component( array( string key =&gt; mixed value *[,string key =&gt; mixed value]))</p>
2365
+ <p class="label">Example 2</p>
2366
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
2367
+ $vevent = new vevent( $config );
2368
+ .. .
2369
+ </p>
2370
+ <p class="label">Example 3</p>
2371
+ <p class="example">. ..
2372
+ $config = $vcalendar->getConfig();
2373
+ $vevent = new vevent( $config );
2374
+ .. .
2375
+ </p>
2376
+ Only component relevant configuration are set. If using the <a href="#newComponent">newComponent</a> function, configuration is set automatically.
2377
+ <br>
2378
+ <br>
2379
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2380
+
2381
+ <a name="setConfig"></a><h4>3.1.5.4 setConfig</h4>
2382
+ A successful &quot;setConfig&quot; returns TRUE.
2383
+ <p class="label">Format 1</p>
2384
+ <p class="format">setConfig( array( string key=>mixed value *[, string key=>mixed value]))</p>
2385
+ <p class="label">Example 1</p>
2386
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2387
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2388
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2389
+ $vcalendar = new vcalendar();
2390
+ $vcalendar->setConfig( $config );
2391
+ .. .
2392
+ </p>
2393
+ <p class="label">Example 2</p>
2394
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
2395
+ $vevent = new vevent();
2396
+ $vevent->setConfig( $config );
2397
+ .. .
2398
+ </p>
2399
+ <p class="label">Format 2</p>
2400
+ <p class="format">setConfig( string key, string value )</p>
2401
+ <p class="label">Example 1</p>
2402
+ <p class="example">$vcalendar = new vcalendar();
2403
+ $vcalendar->setConfig( &quot;directory&quot;, &quot;depot&quot; );
2404
+ .. .
2405
+ </p>
2406
+ <p class="label">Example 2</p>
2407
+ <p class="example">$vevent = new vevent();
2408
+ $vevent->setConfig( &quot;unique_id&quot;, &quot;kigkonsult.se&quot; );
2409
+ .. .
2410
+ </p>
2411
+ <br>
2412
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2413
+
2414
+ <a name="allowEmpty"></a><h4>3.1.5.5 Allow empty components</h4>
2415
+ Allow or reject empty <i>calendar</i> properties, default allow (TRUE).
2416
+
2417
+ <br>
2418
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2419
+
2420
+ <a name="Compsinfo"></a><h4>3.1.5.6 Component information</h4>
2421
+ Only to use with function getConfig.<br>
2422
+ <br>
2423
+ Get information about <i>calendar</i> components. Returns array with basic information
2424
+ about all components (in array format) within <i>calendar</i>.
2425
+ <p class="comment">Output = array ( *compinfo )
2426
+ compinfo = array ( &quot;ordno&quot; =&gt; int ordno,
2427
+ // <span class="ref">order number (1st=1, 2nd=2..)</span>
2428
+ , &quot;type&quot; =&gt; string type
2429
+ // <span class="ref">component type (vevent, vtodo.. .</span>
2430
+ , &quot;uid&quot; =&gt; string uid
2431
+ // <span class="ref">component <a href="#UID">UID</a> (not for <a href="#VALARM">ALARM</a> / <a href="#VTIMEZONE">TIMEZONE</a>)</span>
2432
+ , &quot;props&quot; =&gt;
2433
+ array( *[ propertyName =&gt; Property count ])
2434
+ // <span class="ref">for every set property</span>
2435
+ , &quot;sub&quot; =&gt; array( *compinfo ))
2436
+ // <span class="ref">if subcomponents exists, an array for each subcomponent</span></p>
2437
+ <p class="label">Example</p>
2438
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2439
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2440
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2441
+ $vcalendar = new vcalendar( $config );
2442
+ $vcalendar->parse();
2443
+ $compsinfo = $vcalendar->getConfig( &quot;compsinfo&quot; );
2444
+ foreach( $compsinfo as compinfo) {
2445
+ &nbsp;echo &quot; order number : &quot;.$compinfo[&quot;ordno&quot;].&quot;&lt;br&nbsp;/&gt;&quot;;
2446
+ &nbsp;echo &quot; type : &quot;.$compinfo[&quot;type&quot;].&quot;&lt;br&nbsp;/&gt;&quot;;
2447
+ &nbsp;echo &quot; UID : &quot;.$compinfo[&quot;uid&quot;].&quot;&lt;br&nbsp;/&gt;&quot;;
2448
+ &nbsp;foreach( $compinfo[&quot;props&quot;] as $propertyName =&gt; $propertyCount )
2449
+ &nbsp;&nbsp;echo &quot; $propertyName = $propertyCount&quot;;
2450
+ &nbsp;if( is_array( $compinfo[&quot;sub&quot;] )) {
2451
+ &nbsp;&nbsp;foreach( $compinfo[&quot;sub&quot;] as $subcompinfo ) {
2452
+ &nbsp;&nbsp;&nbsp;echo &quot; order number : &quot;.$subcompinfo[&quot;ordno&quot;].&quot;&lt;br&nbsp;/&gt;&quot;;
2453
+ &nbsp;&nbsp;&nbsp;/* .. dito if subcomponents exists .. . */
2454
+ &nbsp;&nbsp;}
2455
+ &nbsp;}
2456
+ }
2457
+ </p>
2458
+ <br>
2459
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2460
+
2461
+ <a name="Delimiter"></a><h4>3.1.5.7 Delimiter</h4>
2462
+ Directory/filename delimiter.
2463
+ <br>
2464
+ <br>
2465
+ Default <i>PHP</i> constant DIRECTORY_SEPARATOR. If used, <b>must</b> be set BEFORE filename!
2466
+ <br>
2467
+ <br>
2468
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2469
+
2470
+ <a name="Directory"></a><h4>3.1.5.8 Directory</h4>
2471
+ Local directory to store/read iCal files, default &nbsp;&quot;<b>.</b>&quot;.
2472
+ <br>
2473
+ <br>
2474
+ Directory <b>must</b> be set BEFORE <a href="#Filename">filename</a> and <b>must</b> exist and be writeable otherwise FALSE is returned.
2475
+ If set using an config array and together with <a name="Filename"><u>Filename</u></a>, Directory are set first.
2476
+ When setting Directory any previously set <a href="#configURL">URL</a> is removed.
2477
+ <br>
2478
+ <br>
2479
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2480
+
2481
+ <a name="Fileinfo"></a><h4>3.1.5.9 Fileinfo</h4>
2482
+ Only available in function getConfig, giving information in array format about <a href="#Directory">directory</a>, <a href="#Filename">filename</a> and <a href="#Filesize">filesize</a>.
2483
+ <p class="label">Example</p>
2484
+ <p class="example">$fileinfo = $vcalendar->getConfig( &quot;fileinfo&quot; );</p>
2485
+ <p class="comment">output = array( &lt;directory&gt;, &lt;filename&gt;, &lt;filesize&gt; )</p>
2486
+ <br>
2487
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2488
+
2489
+ <a name="Filename"></a><h4>3.1.5.10 Filename</h4>
2490
+ iCal local file name, default created like (if not set):<br>
2491
+ <p class="format">$filename = date( &quot;YmdHis&quot; ).&quot;.ics&quot;;</p>
2492
+ <p class="format">$filename = date( &quot;YmdHis&quot; ).&quot;.xml&quot;; <span class="comment"> // if <a href="#Format">format</a> set to &quot;xcal&quot;</span></p>
2493
+ <br>
2494
+ If not set, filename is created when requested, ex. in functions <a href="#saveCalendar">saveCalendar</a> or getConfig(&quot;filename&quot;).
2495
+ <br>
2496
+ <br>
2497
+ Local filename <b>must</b> be set AFTER setting directory (and opt. delimiter)!
2498
+ Filename (and opt. directory) <b>must</b> be readable/writeable otherwise FALSE is returned.
2499
+ <br>
2500
+ <br>
2501
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2502
+
2503
+ <a name="Filesize"></a><h4>3.1.5.11 Filesize</h4>
2504
+ Only when getting configuration (using function getConfig).<br>
2505
+ Returns the size of the file in bytes, to be called<br>
2506
+ - after &quot;saveCalendar()&quot;<br>
2507
+ or<br>
2508
+ - after a &quot;setConfig( &quot;directory&quot; / &quot;filename&quot; )&quot; and before/after &quot;parse()&quot;.<br>
2509
+ Getting the filesize for a remote file (URL) will always return zero.
2510
+ <br>
2511
+ <br>
2512
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2513
+
2514
+ <a name="Format"></a><h4>3.1.5.12 Format</h4>
2515
+ Format for <i>calendar</i> output, &quot;iCal&quot;/&quot;xCal&quot;, any case.
2516
+ <br>
2517
+ &quot;iCal&quot; is default (rfc2445), &quot;xCal&quot; force xml formatted output.
2518
+ <br>
2519
+ <br>
2520
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2521
+
2522
+ <a name="Language"></a><h4>3.1.5.13 Language</h4>
2523
+ Language for <i>calendar</i> and component TEXT value properties as defined in [RFC 1766].
2524
+ <br>
2525
+ <br>
2526
+ If NOT set in TEXT property parameters, language from &quot;setConfig( &quot;language&quot;, ..&quot; at component level will be used, if set,
2527
+ otherwise language from &quot;setConfig( &quot;language&quot;, ..&quot; at <i>calendar</i> level will be used, if set.
2528
+ <br>
2529
+ <br>
2530
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2531
+
2532
+ <a name="NewlineChar"></a><h4>3.1.5.14 NewlineChar</h4>
2533
+ Character(s) used for carriage return + line feed (CR+LF), default &quot;\r\n&quot;.
2534
+ <br>
2535
+ <br>
2536
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2537
+
2538
+ <a name="dTZID"></a><h4>3.1.5.15 TZID</h4>
2539
+ Default (local?) timezone, will be used if no TZID parameter is supplied when setting <a href="#DTSTART">DTSTART</a>, <a href="#DTEND">DTEND</a>, <a href="#DUE">DUE</a> or <a href="#RECURRENCE-ID">RECURRENCE-ID</a> (auto completion).
2540
+ Note, some <i>calendar</i> software also require <a href="#Additional_Descriptors">X-WR-TIMEZONE</a> (to be set manually).
2541
+ <br>
2542
+ <br>
2543
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2544
+
2545
+ <a name="Unique_id"></a><h4>3.1.5.16 Unique_id</h4>
2546
+ Unique_id is used in property PRODID at <i>calendar</i> level and <a href="#UID">UID</a> at component level, both created automatically, if not set.
2547
+ <p class="quotes">PRODID
2548
+ The identifier is RECOMMENDED to be the identical syntax to the
2549
+ [RFC 822] addr-spec. A good method to assure uniqueness is to put the
2550
+ domain name or a domain literal IP address of the host on which.. .<p>
2551
+ Default <b>AUTOMATICALLY</b> generated by using <i>PHP</i> function gethostbyname( $_SERVER[&quot;SERVER_NAME&quot;] )
2552
+ when running in a web server environment or &quot;localhost&quot; when using command line interface.
2553
+ Used when setting other (domain) name than server name.
2554
+ <br>
2555
+ <br>
2556
+ A strong recommendation is <b>always</b> to set unique_id when creating a new vcalendar or component object,
2557
+ to ensure accurate creation of all components <a href="#UID">UID</a> property, also before <a href="#parse">parse</a>, in case of missing <a href="#UID">UID</a>.
2558
+ <br>
2559
+ <br>
2560
+
2561
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2562
+
2563
+ <a name="configURL"></a><h4>3.1.5.17 URL</h4>
2564
+ When managing remote files with URL (writing using <a href="#saveCalendar">saveCalendar()</a>, or reading using <a href="#parse">parse()</a>),
2565
+ only protocol &quot;http&quot; (&quot;webcal&quot;) is supported,
2566
+ i.e. url <b>must</b> be prefixed by &quot;http://&quot; (&quot;webcal://&quot;) and suffixed by a valid filename.
2567
+ <br>
2568
+ When setting URL, any previously set Directory is removed.<br>
2569
+ The URL filename part can be retrieved by - getConfig( &quot;filename&quot; ).
2570
+ <br>
2571
+ <br>
2572
+ When storing a remote iCal file locally, only directory need to be set,
2573
+ filename remains unchanged (i.e. 1. set URL, 2. parse, 3. set directory).
2574
+ <p class="label">Example</p>
2575
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2576
+ &quot;url&quot;, &quot;http://www.iCal.net/depot/calendar.ics&quot; );
2577
+ $vcalendar = new vcalendar( $config );
2578
+ $vcalendar->parse();
2579
+ $vcalendar->sort();
2580
+ .. .
2581
+ .. .
2582
+ $vcalendar->setConfig( &quot;directory&quot;, &quot;depot&quot; );
2583
+ $vcalendar->saveCalendar(); // <span class="ref">local save in &quot;depot&quot; folder, </span>
2584
+ // <span class="ref">using original filename</span>
2585
+ </p>
2586
+ <br>
2587
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_configuration_functions">[up]</a>
2588
+
2589
+ <a name="Calendar_component_object_property_function_list"></a><h2>3.2 Calendar component object property function list</h2>
2590
+ <p>
2591
+ All <i>calendar</i> component property functions for get/set data.<br>
2592
+ For property format in detail, see
2593
+ <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar).
2594
+ </p>
2595
+ <a name="DATE_WITH_UTC_TIME"></a>
2596
+ <span class="label">Notice:</span> for properties and DATE-TIME with <b>UTC</b> time.
2597
+ <p class="quotes">RFC2445:
2598
+ The date with UTC time, or absolute time, is identified by a LATIN
2599
+ CAPITAL LETTER Z suffix character (US-ASCII decimal 90), the UTC
2600
+ designator, appended to the time value. For example, the following
2601
+ represents January 19, 1998, at 0700 UTC:
2602
+ </p>
2603
+ <p class="quotes">DTSTART:19980119T070000Z</p>
2604
+ <p class="quotes">The <a href="#TZID">TZID</a> property parameter MUST <b>NOT</b> be applied to DATE-TIME
2605
+ properties whose time values are specified in UTC.
2606
+ </p>
2607
+ <p>
2608
+ <a name="date_restriction"></a>
2609
+ <span class="label">Notice:</span> date limitation.<br>
2610
+ Due to a limitation in <i>PHP</i> date functions, e.g. <span class="format">mktime</span>,
2611
+ <span class="format">strtotime</span>, a date (e.g. while setting <a href="#DTSTART">DTSTART</a> property)
2612
+ before &quot;January 1 1970 00:00:00 GMT&quot; may force a <i>PHP</i> date function to generate an error or set date to &quot;January 1 1970&quot;.
2613
+ </p>
2614
+ <a name="deleteProperty_PROP"></a><h3>3.2.1 deleteProperty</h3>
2615
+ General <i>calendar</i> delete property function,simplifying removal of <i>calendar</i> properties.<br>
2616
+ FALSE is returned if no property exists or when end-of-properties at consecutive function calls.
2617
+ <p class="label">Format</p>
2618
+ <p class="format">deleteProperty( [ string PropName [, int order=1 ] )</p>
2619
+ <p class="comment">propName - case independent, rfc2445 component property names,
2620
+ unknown/missing propName will be used as <a href="#X-PROPERTY_PROP">X-property</a>.
2621
+ order - if missing 1st/next occurrence,
2622
+ used with multiply (property) occurrences</p>
2623
+ <p class="label">Example</p>
2624
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2625
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2626
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2627
+ $vcalendar = new vcalendar( $config );
2628
+ $vcalendar->parse();
2629
+ $e = $vcalendar->getComponent( &quot;vevent&quot; );
2630
+ while( $e->deleteProperty( &quot;comment&quot; ))
2631
+ &nbsp;&nbsp;continue; // <span class="ref">remove all COMMENT properties</span>
2632
+ .. .
2633
+ </p>
2634
+ <br>
2635
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
2636
+
2637
+ <a name="getProperty_PROP"></a><h3>3.2.2 getProperty</h3>
2638
+ General get property function, simplifying fetch of <i>calendar</i> properties.<br>
2639
+ FALSE is returned if no property exists or when end-of-properties at consecutive function calls.
2640
+ <p class="label">Format</p>
2641
+ <p class="format">getProperty( string PropName [, int order=1 [, bool complete=FALSE ]] )</p>
2642
+ <p class="comment">propName - case independent, rfc2445 component property names,
2643
+ unknown/missing propName will be used as <a href="#X-PROPERTY_PROP">X-property</a>.
2644
+ order - if missing/FALSE 1st/next occurrence,
2645
+ otherwise with multiply occurrences (1st=1, 2nd=2.. .)
2646
+ complete - FALSE (default): output only property value
2647
+ TRUE : output =
2648
+ array(&quot;value&quot; =&gt; &lt;value&gt;
2649
+ ,&quot;params&quot;=&gt; &lt;parameter array&gt;)
2650
+ </p>
2651
+ <p class="label">Example</p>
2652
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
2653
+ &quot;directory&quot; =&gt; &quot;import&quot;,
2654
+ &quot;filename&quot; =&gt; &quot;file.ics&quot; );
2655
+ $vcalendar = new vcalendar( $config );
2656
+ $vcalendar->parse();
2657
+ while( $vevent = $vcalendar->getComponent( &quot;vevent&quot; )) {
2658
+ &nbsp;$dtstart = $vevent->getProperty( &quot;dtstart&quot; ); // <span class="ref">one occurrence</span>
2659
+ &nbsp;$description = $vevent->getProperty( &quot;description&quot; ); // <span class="ref">one occurrence</span>
2660
+ &nbsp;while( $comment = $vevent->getProperty( &quot;comment&quot; )) {
2661
+ // <span class="ref">MAY occur more than once</span>
2662
+ &nbsp;.. .
2663
+ &nbsp;}
2664
+ .. .
2665
+ </p>
2666
+ <br>
2667
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
2668
+
2669
+ <a name="parse"></a><h3>3.2.3 parse</h3>
2670
+ Parse strict rfc2445 component property text and/or ALARMs.
2671
+ <br><br>
2672
+ A rfc2445 strict formatted property text, in string or array format and starting with property name.
2673
+ <br>
2674
+ <br>
2675
+ Complete <a href="#VALARM">ALARM</a>s, all properties included, in array format and
2676
+ first array row as &quot;BEGIN:VALARM&quot;, last as &quot;END:VALARM&quot;
2677
+ as well as <a href="#VTIMEZONE">TIMEZONE</a> and standard/daylight subcomponents.
2678
+ <br><br>
2679
+ FALSE is returned if (read-file) problems occur.
2680
+ <p class="label">Format</p>
2681
+ <p class="format">parse( mixed propertyText )</p>
2682
+ <p class="comment">
2683
+ propertyText = string/array,
2684
+ rcf2445 formatted property/properties,
2685
+ property name <b>must</b> begin (first) line</p>
2686
+ <p class="label">example</p>
2687
+ <p class="example">.. .
2688
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
2689
+ $e->parse( &quot;DTSTAMP:19970324T1200Z&quot; );
2690
+ $e->parse( &quot;SEQUENCE:0&quot; );
2691
+ $e->parse( &quot;ORGANIZER:MAILTO:jdoe@host1.com&quot; );
2692
+ $e->parse( array(
2693
+ &quot;ATTENDEE;RSVP=TRUE:MAILTO:jsmith@host1.com&quot;,
2694
+ &quot;ATTENDEE;RSVP=TRUE:MAILTO:jsmith@host2.com&quot;,
2695
+ &quot;ATTENDEE;RSVP=TRUE:MAILTO:jsmith@host3.com&quot;,
2696
+ &quot;ATTENDEE;RSVP=TRUE:MAILTO:jsmith@host4.com&quot; ));
2697
+ $e->parse( &quot;DTSTART:19970324T123000Z&quot; );
2698
+ $e->parse( &quot;DTEND:19970324T210000Z&quot; );
2699
+ $e->parse( &quot;CATEGORIES:MEETING,PROJECT&quot; );
2700
+ $e->parse( &quot;CLASS:PUBLIC&quot; );
2701
+ $e->parse( &quot;SUMMARY:Calendaring Interoperability Planning Meeting&quot; );
2702
+ $e->parse( &quot;STATUS:DRAFT&quot; );
2703
+ $e->parse( array(
2704
+ &quot;DESCRIPTION:Project xyz Review Meeting Minutes&quot;
2705
+ ,&quot;Agenda&quot;
2706
+ ,&quot;1. Review of project version 1.0 requirements.&quot;
2707
+ ,&quot;2. Definition of project processes.&quot;
2708
+ ,&quot;3. Review of project schedule.&quot;
2709
+ ,&quot;Participants: John Smith, Jane Doe, Jim Dandy&quot;
2710
+ ,&quot;- It was decided that the requirements need to be signed off by &quot;.
2711
+ &quot;product marketing.&quot;
2712
+ ,&quot;- Project processes were accepted.&quot;
2713
+ ,&quot;- Project schedule needs to account for scheduled holidays and employee&quot;.
2714
+ &quot; vacation time. Check with HR for specific dates.&quot;
2715
+ ,&quot;- New schedule will be distributed by Friday.&quot;
2716
+ ,&quot;- Next weeks meeting is cancelled. No meeting until 3/23.&quot; ));
2717
+ $e->parse( &quot;LOCATION:LDB Lobby&quot; );
2718
+ $e->parse(
2719
+ &quot;ATTACH;FMTTYPE=application/postscript:ftp://xyz.com/pub/conf/bkgrnd.ps&quot; );
2720
+ $e->parse( array(
2721
+ &quot;BEGIN:VALARM&quot;,
2722
+ &quot;ACTION:AUDIO&quot;,
2723
+ &quot;TRIGGER;VALUE=DATE-TIME:19970224T070000Z&quot;,
2724
+ &quot;ATTACH;FMTTYPE=audio/basic:http://host.com/pub/audio-files/ssbanner.aud&quot;,
2725
+ &quot;REPEAT:4&quot;,
2726
+ &quot;DURATION:PT1H&quot;,
2727
+ &quot;X-alarm:non-standard ALARM property&quot;,
2728
+ &quot;END:VALARM&quot; ));
2729
+ $e->parse(
2730
+ &quot;X-xomment:non-standard property will be displayed, comma escaped&quot;);
2731
+ .. .
2732
+ </p>
2733
+ <br>
2734
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
2735
+
2736
+
2737
+ <a name="setProperty_PROP"></a><h3>3.2.4 setProperty</h3>
2738
+ General set property function, simplifying insert of component properties. For properties where
2739
+ multiple occurrences are allowed, last parameter is an index, implementing replaceProperty functionality.<br>
2740
+ A successful update returns TRUE.
2741
+ <p class="label">Format</p>
2742
+ <p class="format">setProperty( string PropName, mixed Proparg_1 *[, mixed Proparg_n] )</p>
2743
+ <p class="comment">propName case independent, rfc2445 component property names,
2744
+ unknown propName will be regarded as <a href="#X-PROPERTY_PROP">X-property</a>.</p>
2745
+ <p class="label">Example</p>
2746
+ <p class="example">$vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
2747
+ $vevent->setProperty( &quot;dtstart&quot;
2748
+ , array(&quot;year&quot;=&gt;2007,&quot;month&quot;=&gt;4,&quot;day&quot;=&gt;1,&quot;hour&quot;=&gt;19));
2749
+ $vevent->setProperty( &quot;duration&quot;, 0, 0, 3 ));
2750
+ $vevent->setProperty( &quot;LOCATION&quot;, &quot;Central Plaza&quot; );
2751
+ $vevent->setProperty( &quot;summary&quot;, &quot;PHP summit&quot; );
2752
+ .. .
2753
+ </p>
2754
+ <br>
2755
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
2756
+
2757
+
2758
+ <a name="ACTION"></a><h3>3.2.5 ACTION</h3>
2759
+ This property defines the action to be invoked when an <a href="#VALARM">VALARM</a> is triggered,<br> &quot;AUDIO&quot; / &quot;DISPLAY&quot; / &quot;EMAIL&quot; / &quot;PROCEDURE&quot;. This property is REQUIRED and MUST NOT occur more than once.
2760
+ <h5>Delete ACTION</h5>
2761
+ Remove ACTION from component.
2762
+ <p class="label">Format</p>
2763
+ <p class="format">deleteProperty( &quot;Action&quot; )</p>
2764
+ <p class="label">Example</p>
2765
+ <p class="example">$valarm->deleteProperty( &quot;Action&quot; );</p>
2766
+ <h5>Get ACTION</h5>
2767
+ Fetch property value.
2768
+ <p class="label">Format 1</p>
2769
+ <p class="format">getProperty( &quot;Action&quot; )</p>
2770
+ <p class="comment">output = actionValue <span class="ref">1</span></p>
2771
+ <p class="label">Format 2</p>
2772
+ <p class="format">getProperty( &quot;Action&quot;, FALSE , TRUE )</p>
2773
+ <p class="comment">output = array( &quot;value&quot; =&gt; actionValue<span class="ref">1</span>
2774
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
2775
+ <p class="label">Example</p>
2776
+ <p class="example">$action = $valarm->getProperty( &quot;action&quot; );</p>
2777
+ <h5>Set ACTION</h5>
2778
+ Insert property value.
2779
+ <p class="label">Format</p>
2780
+ <p class="format">setProperty( &quot;Action&quot;, actionValue [, xparam ] )</p>
2781
+ <p class="comment">actionValue<span class="ref">1</span> = one of &quot;AUDIO&quot; / &quot;DISPLAY&quot; / &quot;EMAIL&quot; / &quot;PROCEDURE&quot;
2782
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
2783
+ <p class="label">Example</p>
2784
+ <p class="example">$valarm->setProperty( &quot;action&quot;, &quot;DISPLAY&quot; );</p>
2785
+ <br>
2786
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
2787
+
2788
+
2789
+ <a name="ATTACH"></a><h3>3.2.6 ATTACH</h3>
2790
+ The property provides the capability to associate a document object with a <i>calendar</i> component. The property is
2791
+ is REQUIRED and MUST NOT occur more than once in an &quot;ALARM&quot; (&quot;ACTION&quot; &quot;procedure&quot;),
2792
+ OPTIONAL and MUST NOT occur more than once in an &quot;ALARM&quot; (&quot;ACTION&quot; &quot;audio&quot;) and
2793
+ OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VALARM">VALARM</a> (&quot;ACTION&quot; &quot;email&quot;) components.
2794
+ <br><br>
2795
+ The default value type for ATTACH is URI. The value type can also be set to BINARY to indicate inline binary encoded content information (params <span class="ref">2</span>).
2796
+ <h5>Delete ATTACH</h5>
2797
+ Remove ATTACH from component.
2798
+ <p class="label">Format</p>
2799
+ <p class="format">deleteProperty( &quot;ATTACH&quot; )</p>
2800
+ <p class="label">Example 1</p>
2801
+ <p class="example">$valarm->deleteProperty( &quot;ATTACH&quot; );</p>
2802
+ <p class="label">Example 2</p>
2803
+ Delete ATTACH property no 2.
2804
+ <p class="format">$valarm->deleteProperty( &quot;ATTACH&quot;, 2 );</p>
2805
+ <p class="label">Example 3</p>
2806
+ Deleting all ATTACH properties.
2807
+ <p class="example">while( $valarm->deleteProperty( &quot;ATTACH&quot; ))
2808
+ continue;</p>
2809
+ <h5>Get ATTACH</h5>
2810
+ Fetch property value.
2811
+ <p class="label">Format 1</p>
2812
+ <p class="format">getProperty( &quot;Attach&quot; )</p>
2813
+ <p class="comment">output = attachValue<span class="ref">1</span></p>
2814
+ <p class="label">Format 2</p>
2815
+ <p class="format">getProperty( &quot;ATTACH&quot;, propOrderNo/FALSE , TRUE )</p>
2816
+ <p class="comment">output = array( &quot;value&quot; =&gt; attachValue<span class="ref">1</span>
2817
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
2818
+ <p class="label">Format 3</p>
2819
+ <p class="format">getProperty( &quot;Attach&quot;, propOrderNo )</p>
2820
+ <p class="comment">Get propOrderNo ATTACH</p>
2821
+ <p class="label">Example</p>
2822
+ <p class="example">$attach = $valarm->getProperty( &quot;attach&quot; );</p>
2823
+ <h5>Set ATTACH</h5>
2824
+ Insert property value.
2825
+ <br>
2826
+ Parameters, if any, will be ordered as prescribed in rcf2445.
2827
+ <p class="label">Format</p>
2828
+ <p class="format">setProperty( &quot;attach&quot;, attachValue<span class="ref">1</span> [, params [, propOrderNo ]] )</p>
2829
+ <p class="comment">attachValue<span class="ref">1</span> = URI / inline binary encoded content information.
2830
+ params<span class="ref">2</span> = array( [ &quot;ENCODING&quot; =&gt; &quot;BASE64&quot;, &quot;VALUE&quot; =&gt; &quot;BINARY&quot; ]
2831
+ [, &quot;FMTTYPE&quot; =&gt; contentType ]
2832
+ [,&nbsp;xparam ] )
2833
+ contentType = The parameter value MUST be the TEXT for either
2834
+ an IANA registered content type or a non-standard
2835
+ content type.
2836
+ xparam = *[ xparamkey =&gt; xparamvalue ]
2837
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
2838
+ <p class="label">Example</p>
2839
+ <p class="example">$vevent->setProperty( &quot;attach&quot;
2840
+ , &quot;ftp://domain.com/pub/docs/agenda.doc&quot;
2841
+ , array( &quot;FMTTYPE&quot; =&gt; &quot;application/binary&quot; ));
2842
+ </p>
2843
+ <br>
2844
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
2845
+
2846
+
2847
+ <a name="ATTENDEE"></a><h3>3.2.7 ATTENDEE</h3>
2848
+ The property defines an "Attendee" within a <i>calendar</i> component and is OPTIONAL and MUST NOT occur more than once
2849
+ in a VALARM (&quot;ACTION&quot; &quot;email&quot;), OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components.
2850
+ <br><br>
2851
+ This value type for ATTENDEE is URI, a <i>calendar</i> user address.
2852
+ <h5>Delete ATTENDEE</h5>
2853
+ Remove ATTENDEE from component.
2854
+ <p class="label">Format</p>
2855
+ <p class="format">deleteProperty( &quot;ATTENDEE&quot; )</p>
2856
+ <p class="label">Example 1</p>
2857
+ <p class="example">$valarm->deleteProperty( &quot;ATTENDEE&quot; );</p>
2858
+ <p class="label">Example 2</p>
2859
+ Delete ATTENDEE property no 2.
2860
+ <p class="example">$valarm->deleteProperty( &quot;ATTENDEE&quot;, 2 );</p>
2861
+ <p class="label">Example 3</p>
2862
+ Deleting all ATTENDEE properties.
2863
+ <p class="example">while( $valarm->deleteProperty( &quot;ATTENDEE&quot; ))
2864
+ continue;</p>
2865
+ <h5>Get ATTENDEE</h5>
2866
+ Fetch property value.
2867
+ <p class="label">Format 1</p>
2868
+ <p class="format">getProperty( &quot;Attendee&quot; )</p>
2869
+ <p class="comment">output = attendeeValue <span class="ref">1</span></p>
2870
+ <p class="label">Format 2</p>
2871
+ <p class="format">getProperty( &quot;ATTENDEE&quot;, propOrderNo/FALSE , TRUE )</p>
2872
+ <p class="comment">output = array( &quot;value&quot; =&gt; attendeeValue<span class="ref">1</span>
2873
+ , &quot;params&quot; =&gt; array( params<span class="ref">2</span> ))</p>
2874
+ <p class="label">Format 3</p>
2875
+ <p class="format">getProperty( &quot;ATTENDEE&quot;, propOrderNo )</p>
2876
+ <p class="comment">Get propOrderNo ATTENDEE</p>
2877
+ <p class="label">Example</p>
2878
+ <p class="example">$attendee = $valarm->getProperty( &quot;attendee&quot; );</p>
2879
+ <h5>Set ATTENDEE</h5>
2880
+ Insert property value. If exist, default parameter values are removed after input (params<span class="ref">2</span>).
2881
+ Property value must be prefixed by protocol (ftp://, http://,mailto:, file://.. . ref. rfc 1738 ), if missing, &quot;mailto:&quot; is set (ex. indicating an internet mail address).
2882
+ Also MEMBER and DIR parameters must be prefixed by protocol. DELEGATED-TO, DELEGATED-FROM, SENT-BY parameters must use protocol &quot;mailto:&quot;, prefixed if missing (ex. indicating an internet mail address).
2883
+ <br>
2884
+ Parameters, if any, will be ordered as prescribed in rcf2445.
2885
+ <p class="label">Format</p>
2886
+ <p class="format">setProperty( &quot;attendee&quot;, attendeeValue [, params [, propOrderNo ]] )</p>
2887
+ <p class="comment">attendeeValue<span class="ref">1</span> = a <i>calendar</i> user address, a URI as defined by
2888
+ [RFC 1738] or any other IANA registered form
2889
+ for a URI.
2890
+ params<span class="ref">2</span> = array( [CUTYPE] [,MEMBER] [,ROLE] [,PARTSTAT]
2891
+ [,RVSP] [,DELEGATED-TO] [,DELEGATED-FROM]
2892
+ [,SENT-BY] [,CN] [,DIR] [,LANGUAGE]
2893
+ [,xparams] )
2894
+ CUTYPE = "CUTYPE" =&gt; &quot;INDIVIDUAL&quot;
2895
+ (An individual, <b>Default</b>)
2896
+ / &quot;GROUP&quot;
2897
+ (A group of individuals)
2898
+ / &quot;RESOURCE&quot;
2899
+ (A physical resource)
2900
+ / &quot;ROOM&quot;
2901
+ (A room resource)
2902
+ / &quot;UNKNOWN&quot;
2903
+ (Otherwise not known)
2904
+ / x-name
2905
+ (Experimental type)
2906
+ / iana-token
2907
+ (Other IANA registered type)
2908
+ MEMBER = "MEMBER" =&gt; array( *[ &quot;single member
2909
+ of the group or list membership&quot;])
2910
+ ROLE = "ROLE" =&gt; &quot;CHAIR&quot;
2911
+ (Indicates chair of the <i>calendar</i>
2912
+ entity)
2913
+ / &quot;REQ-PARTICIPANT&quot;
2914
+ (required participation, <b>Default</b>)
2915
+ / &quot;OPT-PARTICIPANT&quot;
2916
+ (optional participation)
2917
+ / &quot;NON-PARTICIPANT&quot;
2918
+ (information purposes only)
2919
+ / x-name
2920
+ (Experimental role)
2921
+ / iana-token
2922
+ (Other IANA role)
2923
+ PARTSTAT = &quot;PARTSTAT&quot; =&gt; &quot;NEEDS-ACTION&quot;
2924
+ (Event needs action, <b>Default</b>)
2925
+ / &quot;ACCEPTED&quot;
2926
+ (Event accepted)
2927
+ / &quot;DECLINED&quot;
2928
+ (Event declined)
2929
+ / &quot;TENTATIVE&quot;
2930
+ (Event tentatively accepted)
2931
+ / &quot;DELEGATED&quot;
2932
+ (Event delegated)
2933
+ / &quot;NEEDS-ACTION&quot;
2934
+ (To-do needs action, <b>Default</b>)
2935
+ / &quot;ACCEPTED&quot;
2936
+ (To-do accepted)
2937
+ / &quot;DECLINED&quot;
2938
+ (To-do declined)
2939
+ / &quot;TENTATIVE&quot;
2940
+ (To-do tentatively accepted)
2941
+ / &quot;DELEGATED&quot;
2942
+ (To-do delegated)
2943
+ / &quot;COMPLETED&quot;
2944
+ (To-do completed.
2945
+ <a href="#COMPLETED">COMPLETED</a> property
2946
+ has date/time completed)
2947
+ / &quot;IN-PROCESS&quot;
2948
+ (To-do in process of being completed)
2949
+ / &quot;NEEDS-ACTION&quot;
2950
+ (Journal needs action, <b>Default</b>)
2951
+ / &quot;ACCEPTED&quot;
2952
+ (Journal accepted)
2953
+ / &quot;DECLINED&quot;
2954
+ (Journal declined)
2955
+ / x-name
2956
+ (Experimental status)
2957
+ / iana-token
2958
+ (Other IANA registered status)
2959
+ RSVP = &quot;RSVP&quot; =&gt; &quot;TRUE&quot;
2960
+ / &quot;FALSE&quot;, <b>Default</b> (reply expectation)
2961
+ DELEGATED-TO = &quot;DELEGATED-TO&quot; =&gt; array(*[&quot;single <i>calendar</i> user
2962
+ to specified by the property
2963
+ has delegated participation&quot;])
2964
+ DELEGATED-FROM = &quot;DELEGATED-FROM&quot; =&gt; array( *[ &quot;single <i>calendar</i> user that
2965
+ have delegated their
2966
+ participation to the
2967
+ <i>calendar</i> user specified
2968
+ by the property&quot; ] )
2969
+ SENT-BY = &quot;SENT-BY&quot; =&gt; single <i>calendar</i> user that is
2970
+ acting on behalf
2971
+ of the <i>calendar</i> user
2972
+ specified by the property&quot;
2973
+ LANGUAGE = &quot;LANGUAGE&quot; =&gt; language for text values in CN parameter&quot;
2974
+ CN = &quot;CN&quot; =&gt; &quot;common name to be associated with the <i>calendar</i>
2975
+ user specified by the property&quot;
2976
+ DIR = &quot;DIR&quot; =&gt; &quot;reference to a directory entry associated with
2977
+ the <i>calendar</i> user specified by the property&quot;
2978
+ xparam = *[ xparamkey =&gt; xparamvalue ]
2979
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
2980
+ See rules in detail in <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar).
2981
+ <p class="label">Example</p>
2982
+ <p class="example">$vevent->setProperty( &quot;attendee&quot;
2983
+ , &quot;attendee1@ical.net&quot;
2984
+ $vevent->setProperty( &quot;attendee&quot;
2985
+ , &quot;attendee2@ical.net&quot;
2986
+ , array( &quot;cutype&quot; =&gt; &quot;INDIVIDUAL&quot;
2987
+ , &quot;member&quot; =&gt; array( &quot;member1@ical.net&quot;
2988
+ , &quot;member2@ical.net&quot;
2989
+ , &quot;member3@ical.net&quot; )
2990
+ , &quot;role&quot; =&gt; &quot;CHAIR&quot;
2991
+ , &quot;PARTSTAT&quot; =&gt; &quot;ACCEPTED&quot;
2992
+ , &quot;RSVP&quot; =&gt; &quot;TRUE&quot;
2993
+ , &quot;DELEgated-to&quot; =&gt; array( &quot;part1@ical.net&quot;
2994
+ , &quot;part2@ical.net&quot;
2995
+ , &quot;part3@ical.net&quot; )
2996
+ , &quot;delegateD-FROM&quot; =&gt;array( &quot;cio@ical.net&quot;
2997
+ , &quot;vice.cio@ical.net&quot;)
2998
+ , &quot;SENT-BY&quot; =&gt; &quot;secretary@ical.net&quot;
2999
+ , &quot;LANGUAGE&quot; =&gt; &quot;us-EN&quot;
3000
+ , &quot;CN&quot; =&gt; &quot;John Doe&quot;
3001
+ , &quot;DIR&quot; =&gt; &quot;http://www.ical.net/info.doc&quot;
3002
+ , &quot;x-agenda&quot; =&gt; &quot;status reports&quot; <span class="comment">// xparam</span>
3003
+ , &quot;x-length&quot; =&gt; &quot;15 min&quot; )); <span class="comment">// xparam</span>
3004
+ </p>
3005
+ <br>
3006
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3007
+
3008
+ <a name="CATEGORIES"></a><h3>3.2.8 CATEGORIES</h3>
3009
+ This property defines the categories for a <i>calendar</i> component and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components.<br><br>
3010
+ The value type for CATEGORIES is TEXT.
3011
+ <h5>Delete CATEGORIES</h5>
3012
+ Remove CATEGORIES from component.
3013
+ <p class="label">Format</p>
3014
+ <p class="format">deleteProperty( &quot;CATEGORIES&quot; )</p>
3015
+ <p class="label">Example 1</p>
3016
+ <p class="example">$vevent->deleteProperty( &quot;CATEGORIES&quot; );</p>
3017
+ <p class="label">Example 2</p>
3018
+ Delete CATEGORIES property no 2.
3019
+ <p class="example">$vevent->deleteProperty( &quot;CATEGORIES&quot;, 2 );</p>
3020
+ <p class="label">Example 3</p>
3021
+ Deleting all CATEGORIES properties.
3022
+ <p class="example">while( $vevent->deleteProperty( &quot;CATEGORIES&quot; ))
3023
+ continue;</p>
3024
+ <h5>Get CATEGORIES</h5>
3025
+ Fetch property value.
3026
+ <p class="label">Format 1</p>
3027
+ <p class="format">getProperty( &quot;CATEGORIES&quot; )</p>
3028
+ <p class="comment">output = categoryValue<span class="ref">1</span></p>
3029
+ <p class="label">Format 2</p>
3030
+ <p class="format">getProperty( &quot;CATEGORIES&quot;, propOrderNo/FALSE , TRUE )</p>
3031
+ <p class="comment">output = array( &quot;value&quot; =&gt; categories<span class="ref">1</span>
3032
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3033
+ <p class="label">Format 3</p>
3034
+ <p class="format">getProperty( &quot;CATEGORIES&quot;, propOrderNo )</p>
3035
+ <p class="comment">Get propOrderNo CATEGORIES</p>
3036
+ <p class="label">Example</p>
3037
+ <p class="example">$categories = $valarm->getProperty( &quot;categories&quot; );</p>
3038
+ <h5>Set CATEGORIES</h5>
3039
+ Insert property value.
3040
+ <br>
3041
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3042
+ <p class="label">Format</p>
3043
+ <p class="format">setProperty( &quot;categories&quot;, mixed categories [, params [, propOrderNo ]] )</p>
3044
+ <p class="comment">categories<span class="ref">1</span> = string categoryValue / array( *categoryValue )
3045
+ categoryValue<span class="ref"> </span>= textual categories or subtypes of the <i>calendar</i> component,
3046
+ can be specified as a list of categories
3047
+ separated by the COMMA character
3048
+ params<span class="ref">2</span> = array( [&quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;][, xparam] )
3049
+ xparam<span class="ref"> </span> = *[ xparamkey =&gt; xparamvalue ]
3050
+ propOrderNo<span class="ref"> </span> = int ordernumber, 1=1st, 2=2nd etc</p>
3051
+ <p class="label">Example</p>
3052
+ <p class="example">$vevent->setProperty( &quot;categories&quot;, &quot;project_x&quot; );</p>
3053
+ <br>
3054
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3055
+
3056
+
3057
+ <a name="CLASS"></a><h3>3.2.9 CLASS</h3>
3058
+ This property defines the access classification for a <i>calendar</i> component and is OPTIONAL
3059
+ and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components.
3060
+ <h5>Delete CLASS</h5>
3061
+ Remove CLASS from component.
3062
+ <p class="label">Format</p>
3063
+ <p class="format">deleteProperty( &quot;CLASS&quot; )</p>
3064
+ <p class="label">Example</p>
3065
+ <p class="example">$vjournal->deleteProperty( &quot;CLASS&quot; );</p>
3066
+ <h5>Get CLASS</h5>
3067
+ Fetch property value.
3068
+ <p class="label">Format 1</p>
3069
+ <p class="format">getProperty( &quot;CLASS&quot; )</p>
3070
+ <p class="comment">output = classValue<span class="ref">1</span></p>
3071
+ <p class="label">Format 2</p>
3072
+ <p class="format">getProperty( &quot;CLASS&quot;, FALSE , TRUE )</p>
3073
+ <p class="comment">output = array &quot;value&quot; =&gt; classValue<span class="ref">1</span>
3074
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
3075
+ <p class="label">Example</p>
3076
+ <p class="example">$class = $valarm->getProperty( &quot;class&quot; );</p>
3077
+ <h5>Set CLASS</h5>
3078
+ Insert property value.
3079
+ <p class="label">Format</p>
3080
+ <p class="format">setProperty( &quot;class&quot;, string classvalue [, xparam ] )</p>
3081
+ <p class="comment">classvalue<span class="ref">1</span> = &quot;PUBLIC&quot;
3082
+ / &quot;PRIVATE&quot;
3083
+ / &quot;CONFIDENTIAL&quot;
3084
+ / iana-token
3085
+ / x-name
3086
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
3087
+ <p class="label">Example</p>
3088
+ <p class="example">$vevent->setProperty( &quot;class&quot;, &quot;CONFIDENTIAL&quot; );</p>
3089
+ <br>
3090
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3091
+
3092
+ <a name="COMMENT"></a><h3>3.2.10 COMMENT</h3>
3093
+ This property specifies non-processing information intended to provide a comment to the <i>calendar</i> user
3094
+ and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a>, <a href="#VFREEBUSY">VFREEBUSY</a>, <a href="#VTIMEZONE">STANDARD</a> and <a href="#VTIMEZONE">DAYLIGHT</a> components.<br><br>
3095
+ The value type for COMMENT is TEXT.
3096
+ <h5>Delete COMMENT</h5>
3097
+ Remove COMMENT from component.
3098
+ <p class="label">Format</p>
3099
+ <p class="format">deleteProperty( &quot;COMMENT&quot; )</p>
3100
+ <p class="label">Example 1</p>
3101
+ <p class="example">$vevent->deleteProperty( &quot;COMMENT&quot; );</p>
3102
+ <p class="label">Example 2</p>
3103
+ Delete COMMENT property no 2.
3104
+ <p class="example">$vevent->deleteProperty( &quot;COMMENT&quot;, 2 );</p>
3105
+ <p class="label">Example 3</p>
3106
+ Deleting all COMMENT properties.
3107
+ <p class="example">while( $vevent->deleteProperty( &quot;COMMENT&quot; ))
3108
+ continue;</p>
3109
+ <h5>Get COMMENT</h5>
3110
+ Fetch property value.
3111
+ <p class="label">Format 1</p>
3112
+ <p class="format">getProperty( &quot;COMMENT&quot; )</p>
3113
+ <p class="comment">output = commentValue<span class="ref">1</span></p>
3114
+ <p class="label">Format 2</p>
3115
+ <p class="format">getProperty( &quot;COMMENT&quot;, propOrderNo/FALSE , TRUE )</p>
3116
+ <p class="comment">output = array( &quot;value&quot; =&gt; commentValue<span class="ref">1</span>
3117
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3118
+ <p class="label">Format 3</p>
3119
+ <p class="format">getProperty( &quot;COMMENT&quot;, propOrderNo )</p>
3120
+ <p class="comment">Get propOrderNo COMMENT</p>
3121
+ <p class="label">Example</p>
3122
+ <p class="example">$comment = $vevent->getProperty( &quot;comment&quot; );</p>
3123
+ <h5>Set COMMENT</h5>
3124
+ Insert property value.
3125
+ <br>
3126
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3127
+ <p class="label">Format</p>
3128
+ <p class="format">setProperty( &quot;comment&quot;, commentValue [, params [, propOrderNo ]] )</p>
3129
+ <p class="comment">commentValue<span class="ref">1</span> = Value type Text
3130
+ params<span class="ref">2</span> = array( [&quot;ALTREP&quot; =&gt; &quot;&lt;an alternate text representation, URI&gt;&quot;]
3131
+ [, &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;]
3132
+ [, xparam ] )
3133
+ xparam = *[ xparamkey =&gt; xparamvalue ]
3134
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
3135
+ <p class="label">Example</p>
3136
+ <p class="example">$vevent->setProperty( &quot;comment&quot;, &quot;this is a comment&quot; );</p>
3137
+ <br>
3138
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3139
+
3140
+
3141
+ <a name="COMPLETED"></a><h3>3.2.11 COMPLETED</h3>
3142
+ This property defines the date and time that a <a href="#VTODO">VTODO</a> was actually completed and is OPTIONAL and MUST NOT occur more than once.<br><br>
3143
+ The value type for COMPLETED is <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
3144
+ <h5>Delete COMPLETED</h5>
3145
+ Remove COMPLETED from component.
3146
+ <p class="label">Format</p>
3147
+ <p class="format">deleteProperty( &quot;COMPLETED&quot; )</p>
3148
+ <p class="label">Example</p>
3149
+ <p class="example">$vtodo->deleteProperty( &quot;COMPLETED&quot; );</p>
3150
+ <h5>Get COMPLETED</h5>
3151
+ Fetch property value.
3152
+ <p class="label">Format 1</p>
3153
+ <p class="format">getProperty( &quot;COMPLETED&quot; )</p>
3154
+ <p class="comment">output = completedDate<span class="ref">1</span></p>
3155
+ <p class="label">Format 2</p>
3156
+ <p class="format">getProperty( &quot;COMPLETED&quot;, FALSE , TRUE )</p>
3157
+ <p class="comment">output = array( &quot;value&quot; =&gt; completedDate<span class="ref">1</span>
3158
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
3159
+ <p class="label">Example</p>
3160
+ <p class="example">$completed = $vtodo->getProperty( &quot;completed&quot; );</p>
3161
+ <h5>Set COMPLETED</h5>
3162
+ Insert property value. Input date is always a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME or,
3163
+ if &quot;offset&quot; parameter is used, converted to a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
3164
+ Notice, use function <a href="#transformDateTime">transformDateTime</a> to change a datetime from local to UTC datetime.
3165
+ <p class="label">Format</p>
3166
+ <p class="format">setProperty( &quot;completed&quot;, completedDate [, xparam ] )</p>
3167
+ <p class="comment">completedDate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
3168
+ , &quot;month&quot; =&gt; int month
3169
+ , &quot;day&quot; =&gt; int day
3170
+ [, &quot;hour&quot; =&gt; int hour
3171
+ , &quot;min&quot; =&gt; int min
3172
+ , &quot;sec&quot; =&gt; int sec
3173
+ , &quot;tz&quot; =&gt; offset ]] )
3174
+ completedDate = int year
3175
+ , int month
3176
+ , int day
3177
+ [, int hour
3178
+ , int min
3179
+ , int sec ]
3180
+ completedDate = array( int year
3181
+ , int month
3182
+ , int day
3183
+ [, int hour
3184
+ , int min
3185
+ , int sec
3186
+ [, offset ]] )
3187
+ completedDate = array ( &quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; => offset])
3188
+ completedDate = string datestring // <span class="ref">string date,
3189
+ acceptable by strtotime function,
3190
+ ex. &nbsp;&quot;14 august 2006 16.00.00&quot;
3191
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3192
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3193
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
3194
+ <p class="label">Example 1</p>
3195
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;);
3196
+ $vcalendar = new vcalendar( $config );
3197
+ $vtodo = &amp; $vcalendar->newComponent( &quot;vtodo&quot; );
3198
+ .. .
3199
+ $vtodo->setProperty( &quot;completed&quot;, 2006, 8, 10, 10, 0, 0 );
3200
+ // <span class="ref">10 august 2006 10.00 UTC</span></p>
3201
+ <p class="label">Example 2</p>
3202
+ <p class="example">$date = array(&quot;year&quot; =&gt; 2006, &quot;month&quot; =&gt; 10, &quot;day&quot; =&gt; 10,
3203
+ &quot;hour&quot; =&gt; 10, &quot;min&quot; =&gt; 0, &quot;sec&quot; =&gt; 0, &quot;tz&quot; =&gt; &quot;+0200&quot;);
3204
+ // <span class="ref">local date + UTC offset =&gt; <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a>DATE-TIME</span>
3205
+ $vtodo->setProperty( &quot;completed&quot;, $date );</p>
3206
+ <br>
3207
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3208
+
3209
+
3210
+ <a name="CONTACT"></a><h3>3.2.12 CONTACT</h3>
3211
+ The property is used to represent textual contact information or alternately a reference to textual contact information associated with the <i>calendar</i> component. The property is OPTIONAL and MUST NOT occur more than once in a VFREEBUSY or MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components.<br><br>
3212
+ The value type for CONTACT is TEXT.
3213
+ <h5>Delete CONTACT</h5>
3214
+ Remove CONTACT from component.
3215
+ <p class="label">Format</p>
3216
+ <p class="format">deleteProperty( &quot;CONTACT&quot; )</p>
3217
+ <p class="label">Example 1</p>
3218
+ <p class="example">$vevent->deleteProperty( &quot;CONTACT&quot; );</p>
3219
+ <p class="label">Example 2</p>
3220
+ Delete CONTACT property no 2.
3221
+ <p class="example">$vevent->deleteProperty( &quot;CONTACT&quot;, 2 );</p>
3222
+ <p class="label">Example 3</p>
3223
+ Deleting all CONTACT properties.
3224
+ <p class="example">while( $vevent->deleteProperty( &quot;CONTACT&quot; ))
3225
+ continue;</p>
3226
+ <h5>Get CONTACT</h5>
3227
+ Fetch property value.
3228
+ <p class="label">Format 1</p>
3229
+ <p class="format">getProperty( &quot;CONTACT&quot; )</p>
3230
+ <p class="comment">output = contactValue<span class="ref">1</span></p>
3231
+ <p class="label">Format 2</p>
3232
+ <p class="format">getProperty( &quot;CONTACT&quot;, propOrderNo/FALSE , TRUE )</p>
3233
+ <p class="comment">output = array( &quot;value&quot; =&gt; contactValue<span class="ref">1</span>
3234
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3235
+ <p class="label">Format 3</p>
3236
+ <p class="format">getProperty( &quot;CONTACT&quot;, propOrderNo )</p>
3237
+ <p class="comment">Get propOrderNo CONTACT</p>
3238
+ <p class="label">Example</p>
3239
+ <p class="example">$contact = $vevent->getProperty( &quot;contact&quot; );</p>
3240
+ <h5>Set CONTACT</h5>
3241
+ Insert property value.
3242
+ <br>
3243
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3244
+ <p class="label">Format</p>
3245
+ <p class="format">setProperty( &quot;contact&quot;, contactValue [, params [, propOrderNo ]] )</p>
3246
+ <p class="comment">contactValue<span class="ref">1</span> = Value type TEXT
3247
+ params<span class="ref">2</span> = array ( [&quot;ALTREP&quot; =&gt; &quot;&lt;an alternate text representation, URI&gt;&quot;]
3248
+ [, &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;]
3249
+ [, xparam] )
3250
+ xparam = *[ xparamkey =&gt; xparamvalue ]
3251
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
3252
+ <p class="label">Example</p>
3253
+ <p class="example">$c->setProperty( &quot;contact&quot;, &quot;tel 012-34 56 789&quot; )</p>
3254
+ <br>
3255
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3256
+
3257
+
3258
+ <a name="CREATED"></a><h3>3.2.13 CREATED</h3>
3259
+ This property specifies the date and time that the <i>calendar</i> information was created by the <i>calendar</i> user agent in the <i>calendar</i> store. Note: This is analogous to the creation date and time for a file in the file system. The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components.<br><br>
3260
+ The value type for CREATED is <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
3261
+ <h5>Delete CREATED</h5>
3262
+ Remove CREATED from component.
3263
+ <p class="label">Format</p>
3264
+ <p class="format">deleteProperty( &quot;CREATED&quot; )</p>
3265
+ <p class="label">Example</p>
3266
+ <p class="example">$vevent->deleteProperty( &quot;CREATED&quot; );</p>
3267
+ <h5>Get CREATED</h5>
3268
+ Fetch property value.
3269
+ <p class="label">Format 1</p>
3270
+ <p class="format">getProperty( &quot;CREATED&quot; )</p>
3271
+ <p class="comment">output = createdDate<span class="ref">1</span></p>
3272
+ <p class="label">Format 2</p>
3273
+ <p class="format">getProperty( &quot;CREATED&quot;, FALSE , TRUE )</p>
3274
+ <p class="comment">output = array( &quot;value&quot; =&gt; createdDate<span class="ref">1</span>
3275
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
3276
+ <p class="label">Example</p>
3277
+ <p class="example">$created = $vevent->getProperty( &quot;CREATED&quot; );</p>
3278
+ <h5>Set CREATED</h5>
3279
+ Insert property value. Input date is always a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME or,
3280
+ if &quot;offset&quot; parameter is used, converted to a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
3281
+ Notice, use function <a href="#transformDateTime">transformDateTime</a> to change a datetime from local to UTC datetime.
3282
+ <p class="label">Format</p>
3283
+ <p class="format">setProperty( &quot;created&quot;, [ createdDate [, xparam ]] )</p>
3284
+ <p class="comment">createdDate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
3285
+ , &quot;month&quot; =&gt; int month
3286
+ , &quot;day&quot; =&gt; int day
3287
+ [, &quot;hour&quot; =&gt; int hour
3288
+ , &quot;min&quot; =&gt; int min
3289
+ , &quot;sec&quot; =&gt; int sec
3290
+ , &quot;tz&quot; =&gt; offset ]] )
3291
+ createdDate = int year
3292
+ , int month
3293
+ , int day
3294
+ [, int hour
3295
+ , int min
3296
+ , int sec ]
3297
+ createdDate = array( int year
3298
+ , int month
3299
+ , int day
3300
+ [, int hour
3301
+ , int min
3302
+ , int sec
3303
+ [, offset ]] )
3304
+ createdDate = array ( &quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; => offset ])
3305
+ createdDate = string datestring // <span class="ref">string date,
3306
+ acceptable by strtotime function,
3307
+ ex. &nbsp;&quot;14 august 2006 16.00.00&quot;
3308
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3309
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3310
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
3311
+ <p class="label">Example 1</p>
3312
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
3313
+ $vcalendar = new vcalendar( $config );
3314
+ $vtodo = &amp; $vcalendar->newComponent( &quot;vtodo&quot; );
3315
+ .. .
3316
+ $vtodo->setProperty( &quot;created&quot;, 2006, 8, 11, 14, 30, 35 );
3317
+ // <span class="ref">11 august 2006 14.30.35 UTC</span> </p>
3318
+ <p class="label">Example 2</p>
3319
+ <p class="example">$date = array(&quot;year&quot; =&gt; 2006, &quot;month&quot; =&gt; 10, &quot;day&quot; =&gt; 10,
3320
+ &quot;hour&quot; =&gt; 10, &quot;min&quot; =&gt; 0, &quot;sec&quot; =&gt; 0, &quot;tz&quot; =&gt; &quot;+0200&quot;);
3321
+ // <span class="ref">local date + UTC offset =&gt; <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME</span>
3322
+ $vtodo->setProperty( &quot;created&quot;, $date );
3323
+ .. .</p>
3324
+ <p class="label">Example 3</p>
3325
+ <p class="example">$vevent->setProperty( &quot;created&quot; );
3326
+ // <span class="ref">current UTC date-time is set if called without parameters</span></p>
3327
+ <br>
3328
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3329
+
3330
+
3331
+ <a name="DESCRIPTION"></a><h3>3.2.14 DESCRIPTION</h3>
3332
+ This property provides a more complete textual description of the <i>calendar</i> component, than that provided by the <a href="#SUMMARY">SUMMARY</a> property (, analogous to a mail BODY). The property is OPTIONAL, MUST NOT occur more than once within <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> or <a href="#VALARM">VALARM</a> (PROCEDURE) but can be specified multiple times within a <a href="#VJOURNAL">VJOURNAL</a> <i>calendar</i> component. The property is REQUIRED in <a href="#VALARM">VALARM</a> (DISPLAY, EMAIL) component.<br><br>
3333
+ The value type for DESCRIPTION is TEXT.
3334
+ <h5>Delete DESCRIPTION</h5>
3335
+ Remove DESCRIPTION from component.
3336
+ <p class="label">Format</p>
3337
+ <p class="format">deleteProperty( &quot;DESCRIPTION&quot; )</p>
3338
+ <p class="label">Example 1</p>
3339
+ <p class="example">$vevent->deleteProperty( &quot;DESCRIPTION&quot; );</p>
3340
+ <p class="label">Example 2</p>
3341
+ Delete DESCRIPTION property no 2.
3342
+ <p class="example">$vjournal->deleteProperty( &quot;DESCRIPTION&quot;, 2 );</p>
3343
+ <p class="label">Example 3</p>
3344
+ Deleting all DESCRIPTION properties.
3345
+ <p class="example">while( $vjournal->deleteProperty( &quot;DESCRIPTION&quot; ))
3346
+ continue;</p>
3347
+ <h5>Get DESCRIPTION</h5>
3348
+ Fetch property value.
3349
+ <p class="label">Format 1</p>
3350
+ <p class="format">getProperty( &quot;DESCRIPTION&quot; )</p>
3351
+ <p class="comment">output = descriptionValue<span class="ref">1</span></p>
3352
+ <p class="label">Format 2</p>
3353
+ <p class="format">getProperty( &quot;DESCRIPTION&quot;, FALSE , TRUE )</p>
3354
+ <p class="comment">output = array( &quot;value&quot; =&gt; descriptionValue<span class="ref">1</span>
3355
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3356
+ <p class="label">Example</p>
3357
+ <p class="example">$description = $vevent->getProperty( &quot;description&quot; );</p>
3358
+ <h5>Set DESCRIPTION</h5>
3359
+ Insert property value.
3360
+ <br>
3361
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3362
+ <p class="label">Format</p>
3363
+ <p class="format">setProperty( &quot;description&quot;, descriptionValue [, params [, propOrderNo ]] )</p>
3364
+ <p class="comment">descriptionValue<span class="ref">1</span> = Value type TEXT
3365
+ params<span class="ref">2</span> = array( [&quot;ALTREP&quot; =&gt; &quot;&lt;an alternate text representation, URI&gt;&quot;]
3366
+ [, &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;]
3367
+ [, xparam] )
3368
+ xparam = *[ xparamkey =&gt; xparamvalue ]
3369
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
3370
+ <p class="label">Example</p>
3371
+ <p class="example">$vevent->setProperty( &quot;description&quot;, &quot;This is a description&quot; );</p>
3372
+ <br>
3373
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3374
+
3375
+
3376
+ <a name="DTEND"></a><h3>3.2.15 DTEND</h3>
3377
+ This property specifies the date and time that a <i>calendar</i> component ends.
3378
+ The property is OPTIONAL and MUST NOT occur more than once in VFREEBUSY and VEVENT. In VEVENT, it only occurs
3379
+ if DURATION NOT occurs.
3380
+ <br><br>
3381
+ The default value type for DTEND is DATE-TIME, can be set to a DATE value type.
3382
+ <br><br>
3383
+ Notice that an end date without a time is in effect midnight of the day before the date, so for timeless dates, use the date following the event date for it to be correct. For an &quot;all-day event&quot; and using timeless dates, the DTEND is equal DTSTART plus one day, example all-day event (2007-12-01)<br>DTSTART;VALUE=DATE:20071201<br> DTEND;VALUE=DATE:20071202.
3384
+ <h5>Delete DTEND</h5>
3385
+ Remove DTEND from component.
3386
+ <p class="label">Format</p>
3387
+ <p class="format">deleteProperty( &quot;DTEND&quot; )</p>
3388
+ <p class="label">Example</p>
3389
+ <p class="example">$vevent->deleteProperty( &quot;DTEND&quot; );</p>
3390
+ <h5>Get DTEND</h5>
3391
+ Fetch property value.
3392
+ <p class="label">Format 1</p>
3393
+ <p class="format">getProperty( &quot;DTEND&quot; )</p>
3394
+ <p class="comment">output = dtendDate<span class="ref">1</span></p>
3395
+ <p class="label">Format 2</p>
3396
+ <p class="format">getProperty( &quot;DTEND&quot;, FALSE , TRUE )</p>
3397
+ <p class="comment">output = array( &quot;value&quot; =&gt; dtendDate<span class="ref">1</span>
3398
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3399
+ <p class="label">Example</p>
3400
+ <p class="example">$dtend = $vevent->getProperty( &quot;dtend&quot; );</p>
3401
+ <h5>Set DTEND</h5>
3402
+ Insert property value. If DATE value type is expected, &quot;VALUE&quot; = &quot;DATE&quot; <b>must</b> be set
3403
+ (in params<span class="ref">2</span>) otherwise DATE-TIME (default) value type is set.
3404
+ <br>
3405
+ <br>
3406
+ If no timezone parameter (tz or tzidparam below) is set (then local time is assumed) and config <a href="#dTZID">TZID</a> is set,
3407
+ date-time values will be set WITH timezone from config. Notice, use function <a href="#transformDateTime">transformDateTime</a>
3408
+ to change a datetime from a time zone to another.
3409
+ <br>
3410
+ <br>
3411
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3412
+ <p class="label">Format</p>
3413
+ <p class="format">setProperty( &quot;dtend&quot;, dtendDate [, params<span class="ref">2</span> ] )
3414
+ <p class="comment">dtendDate<span class="ref">1</span> = array ( &quot;year&quot; =&gt; int year
3415
+ , &quot;month&quot; =&gt; int month
3416
+ , &quot;day&quot; =&gt; int day
3417
+ [, &quot;hour&quot; =&gt; int hour
3418
+ , &quot;min&quot; =&gt; int min
3419
+ , &quot;sec&quot; =&gt; int sec
3420
+ [, &quot;tz&quot; =&gt; mixed tz ]] )
3421
+ dtendDate = int year
3422
+ , int month
3423
+ , int day
3424
+ [, int hour
3425
+ , int min
3426
+ , int sec
3427
+ [, mixed tz ]]
3428
+ dtendDate = array( int year
3429
+ , int month
3430
+ , int day
3431
+ [, int hour
3432
+ , int min
3433
+ , int sec
3434
+ [, mixed tz ]] )
3435
+ dtendDate = array( &quot;timestamp&quot; =&gt; int timestamp [,&quot;tz&quot; =&gt; mixed tz])
3436
+ dtendDate = string datestring // <span class="ref">string date,
3437
+ acceptable by strtotime function,
3438
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
3439
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3440
+ dtendDate : Within the "VFREEBUSY" <i>calendar</i> component,
3441
+ the time MUST be specified in the <a href="#DATE_WITH_UTC_TIME">UTC</a> time format.
3442
+ tz = &lt;timezone identifier&gt; / UTC offset
3443
+ (timezone will be used as tzidparam (below), if tzidparam not set)
3444
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3445
+ params<span class="ref">2</span> = array([ tzidparam/datetimeparam/dateparam ] *[,xparams])
3446
+ tzidparam = &quot;TZID&quot; =&gt; &lt;timezone identifier&gt;
3447
+ // <span class="ref">output as local date-time with timezone identifier</span>
3448
+ datetimeparam = &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot; // <span class="ref">default, output as date-time</span>
3449
+ dateparam = &quot;VALUE&quot; =&gt; &quot;DATE&quot; // <span class="ref">output as DATE, ex. all-day event</span>
3450
+ xparams = xparamkey =&gt; xparamvalue</p>
3451
+ <p class="label">Example 1</p>
3452
+ <p class="example">$vevent->setProperty( &quot;dtend&quot;
3453
+ , 2006, 8, 11, 16, 30, 0 );
3454
+ <span class="ref">// 11 august 2006 16.30.00 local date</span></p>
3455
+ <p class="label">Example 2</p>
3456
+ <p class="example">$vfreebusy->setProperty( &quot;dtend&quot;
3457
+ , 2006, 8, 11, 16, 30, 0, &quot;-040000&quot; );
3458
+ <span class="ref">// 11 august 2006 16.30.00 -040000 :
3459
+ local date + UTC offset =&gt; <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME</span></p>
3460
+ <p class="label">Example 3</p>
3461
+ <p class="example">$vevent->setProperty( &quot;dtend&quot;
3462
+ , array( &quot;year&quot; =&gt;, 2006, &quot;month&quot; =&gt; 8, &quot;day&quot;=&gt; 11 )
3463
+ , array( &quot;VALUE&quot; =&gt; &quot;DATE&quot; ));
3464
+ <span class="ref">// end of one or more all-day events</span></p>
3465
+ <br>
3466
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3467
+
3468
+
3469
+ <a name="DTSTAMP"></a><h3>3.2.16 DTSTAMP</h3>
3470
+ The property indicates the date/time that the instance of the iCalendar object was created and is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components. However, DTSTAMP is <b>AUTOMATICALLY</b> GENERATED in iCalcreator.
3471
+ <br><br>
3472
+ DTSTAMP may be required when importing iCal files into some calendaring software<br>(MS etc.),
3473
+ as well as (<i>calendar</i>) <a href="#X-PROPERTY">x-properties</a> "X-WR-CALNAME", "X-WR-CALDESC" and<br>"X-WR-TIMEZONE",
3474
+ <a href="#METHOD">METHOD</a> property (value PUBLISH etc.) and the (also created) <a href="#UID">UID</a> property.
3475
+ <br><br>
3476
+ The value type for DTSTAMP is <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
3477
+ <h5>Delete DTSTAMP</h5>
3478
+ If DTSTAMP if removed from a component, DTSTAMP will automatically be recreated when calendar output functions like <a href="#createCalendar">createCalendar</a>, <a href="#returnCalendar">returnCalendar</a> or <a href="#saveCalendar">saveCalendar</a> is executed.
3479
+ <p class="label">Format</p>
3480
+ <p class="format">deleteProperty( &quot;DTSTAMP&quot; )</p>
3481
+ <p class="label">Example</p>
3482
+ <p class="example">$vevent->deleteProperty( &quot;DTSTAMP&quot; );</p>
3483
+ <h5>Get DTSTAMP</h5>
3484
+ Fetch property value.
3485
+ <p class="label">Format 1</p>
3486
+ <p class="format">getProperty( &quot;DTSTAMP&quot; )</p>
3487
+ <p class="comment">output = dtstampDate<span class="ref">1</span></p>
3488
+ <p class="label">Format 2</p>
3489
+ <p class="format">getProperty( &quot;DTSTAMP&quot;, FALSE , TRUE )</p>
3490
+ <p class="comment">output = array( &quot;value&quot; =&gt; dtstampDate<span class="ref">1</span>
3491
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
3492
+ <p class="label">Example</p>
3493
+ <p class="example">$dtstamp = $vevent->getProperty( &quot;dtstamp&quot; );</p>
3494
+ <h5>Set DTSTAMP</h5>
3495
+ Insert property value. Input date is always a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME or,
3496
+ if &quot;offset&quot; parameter is used, converted to a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
3497
+ Notice, use function <a href="#transformDateTime">transformDateTime</a> to change a datetime To UTC.
3498
+ <p class="label">Format</p>
3499
+ <p class="format">setProperty( &quot;dtstamp&quot;, dtstampDate [, xparam ] )</p>
3500
+ <p class="comment">dtstampDate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
3501
+ , &quot;month&quot; =&gt; int month
3502
+ , &quot;day&quot; =&gt; int day
3503
+ [, &quot;hour&quot; =&gt; int hour
3504
+ , &quot;min&quot; =&gt; int min
3505
+ , &quot;sec&quot; =&gt; int sec
3506
+ , &quot;tz&quot; =&gt; offset ]] )
3507
+ dtstampDate = int year
3508
+ , int month
3509
+ , int day
3510
+ [, int hour
3511
+ , int min
3512
+ , int sec ]
3513
+ dtstampDate = array( int year
3514
+ , int month
3515
+ , int day
3516
+ [, int hour
3517
+ , int min
3518
+ , int sec
3519
+ [, offset ]] )
3520
+ dtstampDate = array ( &quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; => offset ])
3521
+ dtstampDate = string datestring // <span class="ref">string date,
3522
+ acceptable by strtotime function,
3523
+ ex. &nbsp;&quot;14 august 2006 16.00.00&quot;
3524
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3525
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3526
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
3527
+ <p class="label">Example 1</p>
3528
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
3529
+ $vcalendar = new vcalendar( $config );
3530
+ $vtodo = &amp; $vcalendar->newComponent( &quot;vtodo&quot; );
3531
+ .. .
3532
+ $vtodo->setProperty( &quot;dstamp&quot;
3533
+ , 2006, 8, 11, 7, 30, 1 );
3534
+ <span class="ref">// 11 august 2006 07.30.01 UTC</span></p>
3535
+ <p class="label">Example 2</p>
3536
+ <p class="example">$date = array(&quot;year&quot; =&gt; 2006, &quot;month&quot; =&gt; 10, &quot;day&quot; =&gt; 10,
3537
+ &quot;hour&quot; =&gt; 10, &quot;min&quot; =&gt; 0, &quot;sec&quot; =&gt; 0, &quot;tz&quot; =&gt; &quot;+0200&quot;);
3538
+ // <span class="ref">local date + UTC offset =&gt; <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME</span>
3539
+ $vtodo->setProperty( &quot;dtstamp&quot;, $date );
3540
+ .. .</p>
3541
+ <br>
3542
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3543
+
3544
+ <a name="DTSTART"></a><h3>3.2.17 DTSTART</h3>
3545
+ This property specifies when the <i>calendar</i> component begins.<br>
3546
+ The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components.<br>
3547
+ The property is REQUIRED, but MUST NOT occur more than once in <a href="#VTIMEZONE">STANDARD</a> and <a href="#VTIMEZONE">DAYLIGHT</a> components.<br><br>
3548
+ The default value type for DTSTART is DATE-TIME, can be set to a DATE value type.<br><br>
3549
+ For an &quot;all-day event&quot; and using timeless dates, example (2007-12-01)<br>
3550
+ DTSTART;VALUE=DATE:20071201<br>
3551
+ DTEND;VALUE=DATE:20071202. // <span class="ref">opt., in effect midnight of the day <u>before</u> the date!!</span>
3552
+ <h5>Delete DTSTART</h5>
3553
+ Remove DTSTART from component.
3554
+ <p class="label">Format</p>
3555
+ <p class="format">deleteProperty( &quot;DTSTART&quot; )</p>
3556
+ <p class="label">Example</p>
3557
+ <p class="example">$vevent->deleteProperty( &quot;DTSTART&quot; );</p>
3558
+ <h5>Get DTSTART</h5>
3559
+ Fetch property value.
3560
+ <p class="label">Format 1</p>
3561
+ <p class="format">getProperty( &quot;DTSTART&quot; )</p>
3562
+ <p class="comment">output = dtstartDate<span class="ref">1</span></p>
3563
+ <p class="label">Format 2</p>
3564
+ <p class="format">getProperty( &quot;DTSTART&quot;, FALSE , TRUE )</p>
3565
+ <p class="comment">output = array( &quot;value&quot; =&gt; dtstartDate<span class="ref">1</span>
3566
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3567
+ <p class="label">Example</p>
3568
+ <p class="example">$dtstart = $vevent->getProperty( &quot;dtstart&quot; );</p>
3569
+ <h5>Set DTSTART</h5>
3570
+ Insert property value. If DATE value type is expected, &quot;VALUE&quot; = &quot;DATE&quot; <b>must</b> be set (in params<span class="ref">2</span>) otherwise DATE-TIME (default) value type is set.
3571
+ <br>
3572
+ <br>
3573
+ If no timezone parameter (tz or tzidparam below) is set (then local time is assumed) and config <a href="#dTZID">TZID</a> is set,
3574
+ date-time values will be set WITH timezone from config. Notice, use function <a href="#transformDateTime">transformDateTime</a>
3575
+ to change a datetime from a time zones to another.
3576
+ <br>
3577
+ <br>
3578
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3579
+ <p class="label">Format</p>
3580
+ <p class="format">setProperty( &quot;dtstart&quot;, dtstartDate [, params ] )</p>
3581
+ <p class="comment">dtstartDate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
3582
+ , &quot;month&quot; =&gt; int month
3583
+ , &quot;day&quot; =&gt; int day
3584
+ [, &quot;hour&quot; =&gt; int hour
3585
+ , &quot;min&quot; =&gt; int min
3586
+ , &quot;sec&quot; =&gt; int sec
3587
+ [, &quot;tz&quot; =&gt; mixed tz ]] )
3588
+ dtstartDate = int year
3589
+ , int month
3590
+ , int day
3591
+ [, int hour
3592
+ , int min
3593
+ , int sec
3594
+ [, mixed tz ]]
3595
+ dtstartDate = array( int year
3596
+ , int month
3597
+ , int day
3598
+ [, int hour
3599
+ , int min
3600
+ , int sec
3601
+ [, mixed tz ]] )
3602
+ dtstartDate = array(&quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; =&gt; mixed tz])
3603
+ dtstartDate = string datestring // <span class="ref">string date,
3604
+ acceptable by strtotime function,
3605
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
3606
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3607
+ dtstartDate : Within the "VFREEBUSY" <i>calendar</i> component,
3608
+ the dtstartDate MUST be specified in the <a href="#DATE_WITH_UTC_TIME">UTC</a> time format.
3609
+ tz = &lt;timezone identifier&gt; / offset
3610
+ (timezone will be used as tzidparam (below), if tzidparam not set)
3611
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3612
+ params<span class="ref">2</span> = array([ tzidparam/datetimeparam/dateparam ] *[, xparams])
3613
+ tzidparam = &quot;TZID&quot; =&gt; &lt;timezone identifier&gt;
3614
+ // <span class="ref">output as local date-time with timezone identifier</span>
3615
+ datetimeparam = &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot; // <span class="ref">default, output as date-time</span>
3616
+ dateparam = &quot;VALUE&quot; =&gt; &quot;DATE&quot; // <span class="ref">output as DATE, ex. all-day event</span>
3617
+ xparams = xparamkey =&gt; xparamvalue</p>
3618
+ <p class="label">Example 1</p>
3619
+ <p class="example">$vevent->setProperty( &quot;dstart&quot;
3620
+ , 2006, 8, 11, 7, 30, 1 );
3621
+ <span class="comment">// 11 august 2006 07.30.01 local date</span></p>
3622
+ <p class="label">Example 2</p>
3623
+ <p class="example">$vevent->setProperty( &quot;dstart&quot;
3624
+ , 2006, 8, 11, 16, 30, 0, &quot;-040000&quot; );
3625
+ <span class="comment">// 11 august 2006 16.30.00 -040000,
3626
+ // local date + UTC offset =&gt; <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME</span></p>
3627
+ <p class="label">Example 3</p>
3628
+ <p class="example">$vevent->setProperty( &quot;dtstart&quot;
3629
+ , array( &quot;year&quot; =&gt;, 2006, &quot;month&quot; =&gt; 8, &quot;day&quot;=&gt; 11 )
3630
+ , array( &quot;VALUE&quot; =&gt; &quot;DATE&quot; ));
3631
+ <span class="comment">// start of an all-day event, or a period of (entire) days</span></p>
3632
+ <br>
3633
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3634
+
3635
+
3636
+ <a name="DUE"></a><h3>3.2.18 DUE</h3>
3637
+ This property defines the date and time when a <a href="#VTODO">VTODO</a> is expected to be completed
3638
+ and is OPTIONAL and MUST NOT occur more than once and only if DURATION NOT occurs.<br><br>
3639
+ The default value type for DUE is DATE-TIME, can be set to a DATE value type.
3640
+ <h5>Delete DUE</h5>
3641
+ Remove DUE from component.
3642
+ <p class="label">Format</p>
3643
+ <p class="format">deleteProperty( &quot;DUE&quot; )</p>
3644
+ <p class="label">Example</p>
3645
+ <p class="example">$vtodo->deleteProperty( &quot;DUE&quot; );</p>
3646
+ <h5>Get DUE</h5>
3647
+ Fetch property value.
3648
+ <p class="label">Format 1</p>
3649
+ <p class="format">getProperty( &quot;DUE&quot; )</p>
3650
+ <p class="comment">output = dueDate<span class="ref">1</span></p>
3651
+ <p class="label">Format 2</p>
3652
+ <p class="format">getProperty( &quot;DUE&quot;, FALSE , TRUE )</p>
3653
+ <p class="comment">output = array( &quot;value&quot; =&gt; dueDate<span class="ref">1</span>
3654
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
3655
+ <p class="label">Example</p>
3656
+ <p class="example">$due = $vtodo->getProperty( &quot;due&quot; );</p>
3657
+ <h5>Set DUE</h5>
3658
+ Insert property value. If DATE value type is expected, &quot;VALUE&quot; = &quot;DATE&quot; <b>must</b> be set
3659
+ (in params<span class="ref">2</span>) otherwise DATE-TIME (default) value type is set.
3660
+ <br>
3661
+ <br>
3662
+ If no timezone parameter (tz or tzidparam below) is set (then local time is assumed) and config <a href="#dTZID">TZID</a> is set,
3663
+ date-time values will be set WITH timezone from config. Notice, use function <a href="#transformDateTime">transformDateTime</a>
3664
+ to change a datetime from a time zone to another.
3665
+ <br>
3666
+ <br>
3667
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3668
+ <p class="label">Format</p>
3669
+ <p class="format">setProperty( &quot;due&quot;, dueDate [, params ] )</p>
3670
+ <p class="comment">dueDate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
3671
+ , &quot;month&quot; =&gt; int month
3672
+ , &quot;day&quot; =&gt; int day
3673
+ [, &quot;hour&quot; =&gt; int hour
3674
+ , &quot;min&quot; =&gt; int min
3675
+ , &quot;sec&quot; =&gt; int sec
3676
+ [, &quot;tz&quot; =&gt; mixed tz ]] )
3677
+ dueDate = int year
3678
+ , int month
3679
+ , int day
3680
+ [, int hour
3681
+ , int min
3682
+ , int sec
3683
+ [, mixed tz ]]
3684
+ dueDate = array( int year
3685
+ , int month
3686
+ , int day
3687
+ [, int hour
3688
+ , int min
3689
+ , int sec
3690
+ [, mixed tz ]] )
3691
+ dueDate = array( &quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; =&gt; mixed tz])
3692
+ dueDate = string datestring // <span class="ref">string date,
3693
+ acceptable by strtotime function,
3694
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
3695
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3696
+ tz = &lt;timezone identifier&gt; / offset
3697
+ (timezone will be used as tzidparam (below), if tzidparam not set)
3698
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3699
+ params<span class="ref">2</span> = array([ tzidparam/datetimeparam/dateparam ] *[, xparams])
3700
+ tzidparam = &quot;TZID&quot; =&gt; &lt;timezone identifier&gt;
3701
+ // <span class="ref">output as local date-time with timezone identifier</span>
3702
+ datetimeparam = &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot; // <span class="ref">default, output as date-time</span>
3703
+ dateparam = &quot;VALUE&quot; =&gt; &quot;DATE&quot; // <span class="ref">output as DATE, &quot;during the day&quot;</span>
3704
+ xparams = xparamkey =&gt; xparamvalue</p>
3705
+ <p class="label">Example 1</p>
3706
+ <p class="example">$vtodo->setProperty( &quot;due&quot;
3707
+ , 2006, 8, 11, 18, 0, 0 );
3708
+ <span class="comment">// 11 august 2005 18.00.00 local date</span></p>
3709
+ <p class="label">Example 2</p>
3710
+ <p class="example">$vtodo->setProperty( &quot;due&quot;
3711
+ , 2006, 8, 11, 16, 30, 0, &quot;-040000&quot; );
3712
+ <span class="comment">// 11 august 2006 16.30.00 -040000
3713
+ // local date + UTC offset sets <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a>DATE-TIME</span></p>
3714
+ <p class="label">Example 3</p>
3715
+ <p class="example">$vtodo->setProperty( &quot;due&quot;
3716
+ , array( &quot;year&quot; =&gt;, 2006, &quot;month&quot; =&gt; 8, &quot;day&quot;=&gt; 11 )
3717
+ , array( &quot;VALUE&quot; =&gt; &quot;DATE&quot; ));
3718
+ <span class="comment">// due &quot;during the day&quot;</span></p>
3719
+ <br>
3720
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3721
+
3722
+
3723
+ <a name="DURATION"></a><h3>3.2.19 DURATION</h3>
3724
+ The property specifies a positive duration of time<br>
3725
+ In a VEVENT it is OPTIONAL and MUST NOT occur more than once and MUST NOT occur in pair with DTEND. If one occurs, so MUST NOT the other.<br>
3726
+ In a VTODO it is OPTIONAL and MUST NOT occur more than once and MUST NOT occur in pair with DUE. If one occurs, so MUST NOT the other.<br>
3727
+ In a VFREEBUSY it is OPTIONAL and MUST NOT occur more than once.<br>
3728
+ In a VALARM it is OPTIONAL and MUST NOT occur more than once and MUST occur in pair with TRIGGER. If one occurs, so MUST the other.
3729
+ <h5>Delete DURATION</h5>
3730
+ Remove DURATION from component.
3731
+ <p class="label">Format</p>
3732
+ <p class="format">deleteProperty( &quot;DURATION&quot; )</p>
3733
+ <p class="label">Example</p>
3734
+ <p class="example">$valarm->deleteProperty( &quot;DURATION&quot; );</p>
3735
+ <h5>Get DURATION</h5>
3736
+ Fetch property value.
3737
+ <p class="label">Format 1</p>
3738
+ <p class="format">getProperty( &quot;DURATION&quot; )</p>
3739
+ <p class="comment">output = duration<span class="ref">1</span></p>
3740
+ <p class="label">Format 2</p>
3741
+ <p class="format">getProperty( &quot;DURATION&quot;, FALSE , TRUE )</p>
3742
+ <p class="comment">output = array( &quot;value&quot; =&gt; duration<span class="ref">1</span>
3743
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
3744
+ <p class="label">Example</p>
3745
+ <p class="example">$duration = $vtodo->getProperty( &quot;duration&quot; );</p>
3746
+ <p class="label">option</p>
3747
+ If a 4th argument is used and set to TRUE, returned output is in a DATE-TIME
3748
+ output format (like <a href="#DTEND">DTEND</a> / <a href="#DUE">DUE</a>), based on
3749
+ <a href="#DTSTART">DTSTART</a> value with added DURATION value.
3750
+ <h5>Set DURATION</h5>
3751
+ Insert property value.
3752
+ <p class="label">Format</p>
3753
+ <p class="format">setProperty( &quot;duration&quot;, duration [, xparam ] )</p>
3754
+ <p class="comment">
3755
+ duration<span class="ref">1</span> = array ( &quot;week&quot; =&gt; int week )
3756
+ duration<span class="ref">1</span> = array ( &quot;day&quot; =&gt; int day )
3757
+ [, &quot;hour&quot; =&gt; int hour
3758
+ , &quot;min&quot; =&gt; int min
3759
+ , &quot;sec&quot; =&gt; int sec ])
3760
+ duration = array ( &quot;sec&quot; =&gt; int sec )
3761
+ duration = array( int week/false
3762
+ [, int day/false
3763
+ [, int hour
3764
+ , int min
3765
+ , int sec ]] )
3766
+ duration = int week/false
3767
+ [, int day/false
3768
+ [, int hour
3769
+ , int min
3770
+ , int sec ]]
3771
+ duration = string dur-value = [&quot;+&quot;] &quot;P&quot; (dur-date/dur-time/dur-week)
3772
+ dur-date = dur-day [dur-time]
3773
+ dur-time = &quot;T&quot; (dur-hour / dur-minute / dur-second)
3774
+ dur-week = 1*DIGIT &quot;W&quot;
3775
+ dur-hour = 1*DIGIT &quot;H&quot; [dur-minute]
3776
+ dur-minute = 1*DIGIT &quot;M&quot; [dur-second]
3777
+ dur-second = 1*DIGIT &quot;S&quot;
3778
+ dur-day = 1*DIGIT &quot;D&quot;
3779
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
3780
+ <p class="label">Example 1</p>
3781
+ <p class="example">$vtodo->setProperty &quot;duration&quot;
3782
+ , array( &quot;day&quot; =&gt; 1 )); </p>
3783
+ <p class="ref">// one day</p>
3784
+ <p class="label">Example 2</p>
3785
+ <p class="example">$vtodo->setProperty( &quot;duration&quot;
3786
+ , &quot;PT4H&quot; );
3787
+ <p class="ref"> // four hours</p>
3788
+ <br>
3789
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3790
+
3791
+
3792
+ <a name="EXDATE"></a><h3>3.2.20 EXDATE</h3>
3793
+ This property defines the list of date/time exceptions for a recurring <i>calendar</i> component and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> components.<br><br>
3794
+ The default value type for EXDATE is DATE-TIME, can be set to a DATE value type.
3795
+ <h5>Delete EXDATE</h5>
3796
+ Remove EXDATE from component.
3797
+ <p class="label">Format</p>
3798
+ <p class="format">deleteProperty( &quot;EXDATE&quot; )</p>
3799
+ <p class="label">Example 1</p>
3800
+ <p class="example">$vtodo->deleteProperty( &quot;EXDATE&quot; );</p>
3801
+ <p class="label">Example 2</p>
3802
+ Delete EXDATE property no 2.
3803
+ <p class="example">$vjournal->deleteProperty( &quot;EXDATE&quot;, 2 );</p>
3804
+ <p class="label">Example 3</p>
3805
+ Deleting all EXDATE properties.
3806
+ <p class="example">while( $vjournal->deleteProperty( &quot;EXDATE&quot; ))
3807
+ continue;</p>
3808
+ <h5>Get EXDATE</h5>
3809
+ Fetch property value.
3810
+ <p class="label">Format 1</p>
3811
+ <p class="format">getProperty( &quot;EXDATE&quot; )<p>
3812
+ <p class="comment">output = exdates<span class="ref">1</span></p>
3813
+ <p class="label">Format 2</p>
3814
+ <p class="format">getProperty( &quot;exdate&quot;, propOrderNo/FALSE, TRUE )</p>
3815
+ <p class="comment">output = array( &quot;value&quot; =&gt; exdates<span class="ref">1</span>
3816
+ , &quot;params&quot; =&gt; xparams<span class="ref">2</span> )</p>
3817
+ <p class="label">Format 3</p>
3818
+ <p class="format">getProperty( &quot;EXDATE&quot;, propOrderNo )</p>
3819
+ <p class="comment">Get propOrderNo EXDATE</p>
3820
+ <p class="label">Example</p>
3821
+ <p class="example">$exdate = $vtodo->getProperty( &quot;exdate&quot; );</p>
3822
+ <h5>Set EXDATE</h5>
3823
+ Insert property value.<br>
3824
+ If &quot;TZID&quot; is set in params, ex. &quot;TZID&quot; = &quot;CET&quot;,
3825
+ all timezone or offset in dates are ignored and DATE-TIME value type is set.<br>
3826
+ If DATE value type is set in params (&quot;VALUE&quot; = &quot;DATE&quot;), all timezone or offset in dates are ignored.<br>
3827
+ If no &quot;VALUE&quot; parameter in params, DATE-TIME (default) value type is set.<br>
3828
+ If empty params and offset in 1st date, all remaining dates are set to UTC.<br>
3829
+ If no &quot;TZID&quot; is set in params and timezone in 1st date, all remaining dates are within this timezone and param &quot;TZID&quot; is set.<br>
3830
+ If none of the above rules are applicable, DATE-TIME and local date is set default.<br>
3831
+ Notice, use function <a href="#transformDateTime">transformDateTime</a>
3832
+ to change a datetime from a time zone to another.
3833
+ <br>
3834
+ Parameters, if any, will be ordered as prescribed in rcf2445.
3835
+ <p class="label">Format</p>
3836
+ <p class="format">setProperty( &quot;exdate&quot;, exdates [, xparams [, propOrderNo ]] )</p>
3837
+ <p class="comment">exdates<span class="ref">1</span> = array ( date *[, date ] )
3838
+ date = array( int year
3839
+ , int month
3840
+ , int day
3841
+ [, int hour
3842
+ , int min
3843
+ , int sec
3844
+ [, mixed tz ]] )
3845
+ date<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
3846
+ , &quot;month&quot; =&gt; int month
3847
+ , &quot;day&quot; =&gt; int day
3848
+ [, &quot;hour&quot; =&gt; int hour
3849
+ , &quot;min&quot; =&gt; int min
3850
+ , &quot;sec&quot; =&gt; int sec
3851
+ [, &quot;tz&quot; =&gt; mixed tz ]] )
3852
+ date = array( &quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; =&gt; mixed tz])
3853
+ date = string datestring // <span class="ref">string date,
3854
+ acceptable by strtotime function,
3855
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
3856
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
3857
+ tz = &lt;timezone identifier&gt; / offset
3858
+ (timezone will be used as tzidparam (below), if tzidparam not set)
3859
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
3860
+ params<span class="ref">2</span> = array([(datetimeparam/dateparam)&nbsp;/ tzidparam] [,xparam])
3861
+ datetimeparam = &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot; // <span class="ref">default, output as date-time</span>
3862
+ dateparam = &quot;VALUE&quot; =&gt; &quot;DATE&quot; // <span class="ref">output as DATE</span>
3863
+ tzidparam = &quot;TZID&quot; =&gt; &lt;timezone identifier&gt;
3864
+ xparams = *[ xparamkey =&gt; xparamvalue ]
3865
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
3866
+ <p class="label">Example 1</p>
3867
+ <p class="example">$vevent->setProperty( &quot;exdate&quot;
3868
+ , array( array( 2006, 8, 14, 16, 0, 0 ));
3869
+ <span class="ref">// >exclude 2006-08-14 16.00.00 (local date) from recurrence pattern</span></p>
3870
+ <p class="label">Example 2</p>
3871
+ <p class="example">$vevent->setProperty( &quot;exdate&quot;
3872
+ , array( array(&quot;year&quot; =&gt;,2006,&quot;month&quot; =&gt; 8,&quot;day&quot;=&gt; 11))
3873
+ , array( &quot;VALUE&quot; =&gt; &quot;DATE&quot; ));
3874
+ <span class="ref">// exclude 2006-08-11 from recurrence pattern;</span></p>
3875
+ <br>
3876
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
3877
+
3878
+
3879
+ <a name="EXRULE"></a><h3>3.2.21 EXRULE</h3>
3880
+ This property defines a rule or repeating pattern for an exception to a recurrence set and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> components.
3881
+ <h5>Delete EXRULE</h5>
3882
+ Remove EXRULE from component.
3883
+ <p class="label">Format</p>
3884
+ <p class="format">deleteProperty( &quot;EXRULE&quot; )</p>
3885
+ <p class="label">Example 1</p>
3886
+ <p class="example">$vtodo->deleteProperty( &quot;EXRULE&quot; );</p>
3887
+ <p class="label">Example 2</p>
3888
+ Delete EXRULE property no 2.
3889
+ <p class="example">$vjournal->deleteProperty( &quot;EXRULE&quot;, 2 );</p>
3890
+ <p class="label">Example 3</p>
3891
+ Deleting all EXRULE properties.
3892
+ <p class="example">while( $vjournal->deleteProperty( &quot;EXRULE&quot; ))
3893
+ continue;</p>
3894
+ <h5>Get EXRULE</h5>
3895
+ Fetch property value.
3896
+ <p class="label">Format 1</p>
3897
+ <p class="format">getProperty( &quot;EXRULE&quot; )</p>
3898
+ <p class="comment">output = recur<span class="ref">1</span></p>
3899
+ <p class="label">Format 2</p>
3900
+ <p class="format">getProperty( &quot;exrule&quot;, propOrderNo/FALSE, TRUE )</p>
3901
+ <p class="comment">output = array( &quot;value&quot; =&gt; recur<span class="ref">1</span>
3902
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
3903
+ <p class="label">Format 3</p>
3904
+ <p class="format">getProperty( &quot;EXRULE&quot;, propOrderNo )</p>
3905
+ <p class="comment">Get propOrderNo EXRULE</p>
3906
+ <p class="label">Example</p>
3907
+ <p class="example">$exrule = $vtodo->getProperty( &quot;exrule&quot; );</p>
3908
+ <h5>Set EXRULE</h5>
3909
+ Insert property value.<br>
3910
+ Notice, use function <a href="#transformDateTime">transformDateTime</a>
3911
+ to change a datetime to UTC time zone.<br>
3912
+ Parameters, will be ordered as prescribed in rcf2445.
3913
+ <p class="label">Format</p>
3914
+ <p class="format">setProperty( &quot;exrule&quot;, recur [, xparams [, propOrderNo ]] )</p>
3915
+ See rules in detail in <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar).
3916
+ <p class="comment">recur<span class="ref">1</span> = array( "FREQ"=&gt;freq
3917
+ // <span class="ref">either UNTIL or COUNT may appear in a &quot;recur&quot;,
3918
+ but UNTIL and COUNT MUST NOT occur in the same &quot;recur&quot;</span>
3919
+ [, &quot;UNTIL&quot; &quot;=&gt;&quot; >enddate ]
3920
+ [, &quot;COUNT&quot; &quot;=&gt;&quot; 1*DIGIT ]
3921
+ // <span class="ref">the rest of these keywords are optional,
3922
+ but MUST NOT occur more than once</span>
3923
+ [, &quot;INTERVAL&quot; &quot;=&gt;&quot; 1*DIGIT ]
3924
+ [, &quot;BYSECOND&quot; &quot;=&gt;&quot; byseclist ]
3925
+ [, &quot;BYMINUTE&quot; &quot;=&gt;&quot; byminlist ]
3926
+ [, &quot;BYHOUR&quot; &quot;=&gt;&quot; byhrlist ]
3927
+ [, &quot;BYDAY&quot; &quot;=&gt;&quot; bywdaylist ]
3928
+ [, &quot;BYMONTHDAY&quot; &quot;=&gt;&quot; bymodaylist ]
3929
+ [, &quot;BYYEARDAY&quot; &quot;=&gt;&quot; byyrdaylist ]
3930
+ [, &quot;BYWEEKNO&quot; &quot;=&gt;&quot; bywknolist ]
3931
+ [, &quot;BYMONTH&quot; &quot;=&gt;&quot; bymolist ]
3932
+ [, &quot;BYSETPOS&quot; &quot;=&gt;&quot; bysplist ]
3933
+ [, &quot;WKST&quot; &quot;=&gt;&quot; weekday ]
3934
+ [, x-name &quot;=&gt;&quot; text ] )
3935
+ freq = &quot;SECONDLY&quot; /
3936
+ &quot;MINUTELY&quot; /
3937
+ &quot;HOURLY&quot; /
3938
+ &quot;DAILY&quot; /
3939
+ &quot;WEEKLY&quot; /
3940
+ &quot;MONTHLY&quot; /
3941
+ &quot;YEARLY&quot;
3942
+ enddate = date
3943
+ enddate = / date-time ;An <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME value
3944
+ byseclist = seconds
3945
+ byseclist = array(seconds *(, seconds ))
3946
+ seconds = 1DIGIT / 2DIGIT ;0 to 59
3947
+ byminlist = minutes
3948
+ byminlist = array( minutes *(, minutes ))
3949
+ minutes = 1DIGIT / 2DIGIT ;0 to 59
3950
+ byhrlist = hour
3951
+ byhrlist = array( hour *(, hour ))
3952
+ hour = 1DIGIT / 2DIGIT ;0 to 23
3953
+ bywdaylist = weekdaynum
3954
+ bywdaylist = array( weekdaynum *("," weekdaynum ))
3955
+ weekdaynum = array( [([plus] ordwk / minus ordwk)], &quot;DAY&quot; =&gt; weekday )
3956
+ plus = &quot;+&quot;
3957
+ minus = &quot;-&quot;
3958
+ ordwk = 1DIGIT / 2DIGIT ;1 to 53
3959
+ weekday = &quot;SU&quot; / &quot;MO&quot; / &quot;TU&quot; / &quot;WE&quot; / &quot;TH&quot; / &quot;FR&quot; / &quot;SA&quot;
3960
+ ; Corresponding to
3961
+ ; SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY,
3962
+ ; FRIDAY, SATURDAY and SUNDAY days of the week.
3963
+ bymodaylist = monthdaynum
3964
+ bymodaylist = array( monthdaynum *(, monthdaynum ))
3965
+ monthdaynum = ( [plus] ordmoday ) / ( minus ordmoday )
3966
+ ordmoday = 1DIGIT / 2DIGIT ;1 to 31
3967
+ byyrdaylist = yeardaynum
3968
+ byyrdaylist = array( yeardaynum *(, yeardaynum ))
3969
+ yeardaynum = ( [plus] ordyrday ) / ( minus ordyrday )
3970
+ ordyrday = 1DIGIT / 2DIGIT / 3DIGIT ;1 to 366
3971
+ bywknolist = weeknum
3972
+ bywknolist = array( weeknum *(, weeknum ))
3973
+ weeknum = ( [plus] ordwk ) / ( minus ordwk )
3974
+ bymolist = monthnum
3975
+ bymolist = array( monthnum *(, monthnum ))
3976
+ monthnum = 1DIGIT / 2DIGIT ;1 to 12
3977
+ bysplist = setposday
3978
+ bysplist = array( setposday *(, setposday ))
3979
+ setposday = yeardaynum</p>
3980
+ <p class="comment">
3981
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )
3982
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
3983
+ <p class="label">Example</p>
3984
+ <p class="example">$vevent->setProperty(&nbsp;&quot;Exrule&quot;
3985
+ ,&nbsp;array( &quot;FREQ&quot; =&gt; &quot;MONTHLY&quot;
3986
+ , &quot;UNTIL&quot; =&gt; &quot;20060831&quot;
3987
+ // <span class="ref">DATE / DATE-TIME in <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a> format; string/array, see <a href="#CREATED">CREATED</a> format</span>
3988
+ , &quot;INTERVAL&quot; =&gt; 2
3989
+ , &quot;WKST&quot; =&gt; &quot;SU&quot;
3990
+ , &quot;BYSECOND&quot; =&gt; 2
3991
+ , &quot;BYMINUTE&quot; =&gt; array( 2, -4, 6 ) // (*)
3992
+ , &quot;BYHOUR&quot; =&gt; array( 2, 4, -6 ) // (*)
3993
+ , &quot;BYMONTHDAY&quot; =&gt; -2 // (*)
3994
+ , &quot;BYYEARDAY&quot; =&gt; 2 // (*)
3995
+ , &quot;BYWEEKNO&quot; =&gt; array( 2, -4, 6 ) // (*)
3996
+ , &quot;BYMONTH&quot; =&gt; 2 // (*)
3997
+ , &quot;BYSETPOS&quot; =&gt; array( 2, -4, 6 ) // (*)
3998
+ , &quot;BYday&quot; =&gt; array( array(-2, &quot;DAY&quot; =&gt; &quot;WE&quot; )
3999
+ , array( 3, &quot;DAY&quot; =&gt; &quot;TH&quot;)
4000
+ , array( 5, &quot;DAY&quot; =&gt; &quot;FR&quot;)
4001
+ , array( &quot;DAY&quot; =&gt; &quot;MO&quot;))
4002
+ // (**)
4003
+ , &quot;X-NAME&quot; =&gt; &quot;x-value&quot; )
4004
+ , array( &quot;xparamkey&quot; =&gt; &quot;xparamValue&quot; ));
4005
+
4006
+ $vtodo->setProperty( >&quot;exrule&quot;
4007
+ , array( &quot;FREQ&quot; =&gt; &quot;WEEKLY&quot;
4008
+ , &quot;COUNT&quot; =&gt; 2
4009
+ , &quot;INTERVAL&quot; =&gt; 2
4010
+ , &quot;WKST&quot; =&gt; &quot;SU&quot;
4011
+ , &quot;BYSECOND&quot; =&gt; array( -2, 4, 6 ) // (*)
4012
+ , &quot;BYMINUTE&quot; =&gt; -2 // (*)
4013
+ , &quot;BYHOUR&quot; =&gt; 2 // (*)
4014
+ , &quot;BYMONTHDAY&quot; =&gt; array( 2, -4, 6 ) // (*)
4015
+ , &quot;BYYEARDAY&quot; =&gt; array( -2, 4, 6 ) // (*)
4016
+ , &quot;BYWEEKNO&quot; =&gt; -2 // (*)
4017
+ , &quot;BYMONTH&quot; =&gt; array( 2, 4, -6 ) // (*)
4018
+ , &quot;BYSETPOS&quot; =&gt; -2 // (*)
4019
+ , &quot;BYday&quot; =&gt; array( 5, &quot;DAY&quot; =&gt; &quot;WE&quot; )
4020
+ // (**)
4021
+ , &quot;X-NAME&quot; =&gt; &quot;x-value&quot; )
4022
+ , array( &quot;xparamkey&quot; =&gt; &quot;xparamValue&quot; ));
4023
+ //<span class="ref">(*) single value/array of values</span>
4024
+ //<span class="ref">(**) single value array /array of arrays</span>
4025
+ </p>
4026
+ <br>
4027
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4028
+
4029
+
4030
+ <a name="FREEBUSY_PROP"></a><h3>3.2.22 FREEBUSY</h3>
4031
+ The property defines one or more free or busy time intervals in a <a href="#VFREEBUSY">VFREEBUSY</a> <i>calendar</i> component.<br><br>
4032
+ The value type for FREEBUSY is PERIOD. A PERIOD is a DATE-TIME/DATE-TIME or a DATE-TIME/duration.
4033
+ <h5>Delete FREEBUSY</h5>
4034
+ Remove FREEBUSY from component.
4035
+ <p class="label">Format</p>
4036
+ <p class="format">deleteProperty( &quot;FREEBUSY&quot; )</p>
4037
+ <p class="label">Example 1</p>
4038
+ <p class="example">$vfreebusy->deleteProperty( &quot;FREEBUSY&quot; );</p>
4039
+ <p class="label">Example 2</p>
4040
+ Delete FREEBUSY property no 2.
4041
+ <p class="example">$vfreebusy->deleteProperty( &quot;FREEBUSY&quot;, 2 );</p>
4042
+ <p class="label">Example 3</p>
4043
+ Deleting all FREEBUSY properties.
4044
+ <p class="example">while( $vfreebusy->deleteProperty( &quot;FREEBUSY&quot; ))
4045
+ continue;</p>
4046
+ <h5>Get FREEBUSY</h5>
4047
+ Fetch property value.
4048
+ <p class="label">Format 1</p>
4049
+ <p class="format">getProperty( &quot;FREEBUSY&quot; )</p>
4050
+ <p class="comment">output = array( &quot;fbtyp&quot; =&gt; freebusytype<span class="ref">1</span> , periods<span class="ref">2</span> )</p>
4051
+ <p class="label">Format 3</p>
4052
+ <p class="format">getProperty( &quot;FREEBUSY&quot;, propOrderNo/FALSE , TRUE )</p>
4053
+ <p class="comment">output = array( &quot;value&quot; =&gt; array(&quot;fbtype&quot; =&gt; freebusytype<span class="ref">1</span> ,periods<span class="ref">2</span>)
4054
+ , &quot;params&quot; =&gt; xparams<span class="ref"> 3</span> )</p>
4055
+ <p class="label">Format 3</p>
4056
+ <p class="format">getProperty( &quot;FREEBUSY&quot;, propOrderNo )</p>
4057
+ <p class="comment">Get propOrderNo FREEBUSY</p>
4058
+ <p class="label">Example</p>
4059
+ <p class="example">$freebusy = $vfreebusy->getProperty( &quot;FREEBUSY&quot; );</p>
4060
+ <h5>Set FREEBUSY</h5>
4061
+ Insert property value. A FREEBUSY input date is always a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
4062
+ <p class="label">Format</p>
4063
+ <p class="format">setProperty( &quot;freebusy&quot;,freebusytype,fbperiods [,xparams [,propOrderNo ]] )</p>
4064
+ <p class="comment">freebusytype<span class="ref">1</span> = one of &quot;FREE&quot;
4065
+ / &quot;BUSY&quot; <b>Default</b>
4066
+ / &quot;BUSY-UNAVAILABLE&quot;
4067
+ / &quot;BUSY-TENTATIVE&quot;
4068
+ / x-name
4069
+ fbperiods = array( periods<span class="ref">2</span> )&nbsp;
4070
+ periods<span class="ref">2</span> = array( startdate, enddate/duration )
4071
+ *[, array( startdate, enddate/duration )]
4072
+ startdate/enddate = array( int year
4073
+ , int month
4074
+ , int day
4075
+ , int int hour
4076
+ , int min
4077
+ , int day )
4078
+ startdate/enddate = array( &quot;year&quot; =&gt; int year
4079
+ , &quot;month&quot; =&gt; int month
4080
+ , &quot;day&quot; =&gt; int day
4081
+ , &quot;hour&quot; =&gt; int hour
4082
+ , &quot;min&quot; =&gt; int min
4083
+ , &quot;sec&quot; =&gt; int sec ) // <span class="ref">output format</span>
4084
+ startdate/enddate = array( &quot;timestamp&quot; =&gt; int timestamp )
4085
+ startdate/enddate = string datestring // <span class="ref">string date,
4086
+ acceptable by strtotime function,
4087
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
4088
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
4089
+ startdate/enddate : date and time values MUST be an <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
4090
+ duration = array( int week/false
4091
+ [, int day/false
4092
+ , int hour
4093
+ , int min
4094
+ , int sec] )
4095
+ duration = array( &quot;week&quot; =&gt; int week/false
4096
+ [, &quot;day&quot; =&gt; int day/false
4097
+ [, &quot;hour&quot; =&gt; int hour
4098
+ , &quot;min&quot; =&gt; int min
4099
+ , &quot;sec&quot; =&gt; int sec ]] ); // <span class="ref">output format</span>
4100
+ duration = array( &quot;sec&quot; =&gt; int sec )
4101
+ duration = string dur-value
4102
+ = ([&quot;+&quot;]/&quot;-&quot;) &quot;P&quot; (dur-date/dur-time/dur-week)
4103
+ dur-date = dur-day [dur-time]
4104
+ dur-time = &quot;T&quot; (dur-hour / dur-minute / dur-second)
4105
+ dur-week = 1*DIGIT &quot;W&quot;
4106
+ dur-hour = 1*DIGIT &quot;H&quot; [dur-minute]
4107
+ dur-minute = 1*DIGIT &quot;M&quot; [dur-second]
4108
+ dur-second = 1*DIGIT &quot;S&quot;
4109
+ dur-day = 1*DIGIT &quot;D&quot;
4110
+ xparams<span class="ref">3</span> = array( *[ xparamkey =&gt; xparamvalue ] )
4111
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
4112
+ <p class="label">Example</p>
4113
+ See rules in detail in <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar).
4114
+ <p class="example">$fdate1 = array ( 2001, 1, 1, 1, 1, 1 );
4115
+ alt.
4116
+ $fdate1 = array ( &quot;year&quot; =&gt; 2001
4117
+ , &quot;month&quot; =&gt; 1
4118
+ , &quot;day&quot; =&gt; 1
4119
+ , &quot;hour&quot; =&gt; 1
4120
+ , &quot;min&quot; =&gt; 1
4121
+ , &quot;sec&quot; =&gt; 1 );
4122
+ $fdate2 = array ( 2002, 2, 2, 2, 2, 2 );
4123
+ $fdate3 = array ( 2003, 3, 3, 3, 3, 3 );
4124
+ $fdate4 = &quot;4 April 2005 4:4:4&quot;;
4125
+ $fdate7 = array ( &quot;year&quot; =&gt; 2007
4126
+ , &quot;month&quot; =&gt; 7
4127
+ , &quot;day&quot; =&gt; 7 );
4128
+ $fdur6 = array ( &quot;week&quot; =&gt; 0
4129
+ , &quot;day&quot; =&gt; 5
4130
+ , &quot;hour&quot; =&gt; 5
4131
+ , &quot;min&quot; =&gt; 5
4132
+ , &quot;sec&quot; =&gt; 5 );
4133
+ $fdur7 = array ( 0, 0, 6 ); // <span class="ref">duration for 6 hours</span>
4134
+ $fdur8 = &quot;P2D&quot;; // <span class="ref">duration two days</span>
4135
+ $freebusy->setProperty &quot;freebusy&quot;
4136
+ , &quot;FREE&quot;
4137
+ , array( array( $fdate1, $fdate2 )
4138
+ , array( $fdate3, $fdur6 )
4139
+ , array( $fdate4, $fdate5 )));
4140
+ $freebusy->setProperty(&quot;freebusy&quot;
4141
+ , &quot;Busy&quot;
4142
+ , array( array( array( $fdate1, $fdate2 )
4143
+ , array( $fdate3, $fdur8 )
4144
+ , array( $fdate4, $fdur7 )
4145
+ , array( $fdate1, $fdate3 )));</p>
4146
+ <br>
4147
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4148
+
4149
+
4150
+ <a name="GEO"></a><h3>3.2.23 GEO</h3>
4151
+ This property specifies information related to the global position for the activity specified by VEVENT and VTODO components and is OPTIONAL and MUST NOT occur more than once.
4152
+ <br><br>
4153
+ Value type for latitude and longitude is FLOAT. &quot;Values for latitude and longitude shall be expressed as decimal fractions of degrees. Whole degrees of latitude shall be represented by a two-digit decimal number ranging from 0 through 90. Whole degrees of longitude shall be represented by a decimal number ranging from 0 through 180. When a decimal fraction of a degree is specified, it shall be separated from the whole number of degrees by a decimal point.&quot;
4154
+ <h5>Delete GEO</h5>
4155
+ Remove GEO from component.
4156
+ <p class="label">Format</p>
4157
+ <p class="format">deleteProperty( &quot;GEO&quot; )</p>
4158
+ <p class="label">Example</p>
4159
+ <p class="example">$vevent->deleteProperty( &quot;GEO&quot; );</p>
4160
+ <h5>Get GEO</h5>
4161
+ Fetch property value.
4162
+ <p class="label">Format 1</p>
4163
+ <p class="format">getProperty( &quot;GEO&quot; )</p>
4164
+ <p class="comment">output = array( &quot;latitude&quot; =&gt; &lt;latitude&gt;
4165
+ , &quot;longitude&quot; =&gt; &lt;longitude&gt;))</p>
4166
+ <p class="label">Format 2</p>
4167
+ <p class="format">getProperty( &quot;GEO&quot;, FALSE , TRUE )</p>
4168
+ <p class="comment">output = array( &quot;value&quot; =&gt; array ( &quot;latitude&quot; =&gt; &lt;latitude&gt;
4169
+ , &quot;longitude&quot; =&gt; &lt;longitude&gt;))
4170
+ , &quot;params&quot; =&gt; xparam <span class="ref">1</span> )</p>
4171
+ <p class="label">Example</p>
4172
+ <p class="example">$geo = $vevent->getProperty( &quot;GEO&quot; );</p>
4173
+ <h5>Set GEO</h5>
4174
+ Insert property value.
4175
+ <p class="label">Format</p>
4176
+ <p class="format">setProperty( &quot;geo&quot;, float latitude, float longitude [, xparam ] )</p>
4177
+ <p class="comment">xparam <span class="ref">1</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4178
+ <p class="label">Example</p>
4179
+ <p class="example">$vevent->setProperty( &quot;geo&quot;, 11.23456, -23.45678 );</p>
4180
+ <br>
4181
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4182
+
4183
+
4184
+ <a name="LAST-MODIFIED"></a><h3>3.2.24 LAST-MODIFIED</h3>
4185
+ The property specifies the date and time that the information associated with the <i>calendar</i> component was last revised in the <i>calendar</i> store. The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VTIMEZONE">VTIMEZONE</a> components.<br><br>
4186
+ The value type for LAST-MODIFIED is <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
4187
+ <h5>Delete LAST-MODIFIED</h5>
4188
+ Remove LAST-MODIFIED from component.
4189
+ <p class="label">Format</p>
4190
+ <p class="format">deleteProperty( &quot;LAST-MODIFIED&quot; )</p>
4191
+ <p class="label">Example</p>
4192
+ <p class="example">$vevent->deleteProperty( &quot;LAST-MODIFIED&quot; );</p>
4193
+ <h5>Get LAST-MODIFIED</h5>
4194
+ Fetch property value.
4195
+ <p class="label">Format 1</p>
4196
+ <p class="format">getProperty( &quot;LAST-MODIFIED&quot; )</p>
4197
+ <p class="comment">output = moddate<span class="ref">1</span></p>
4198
+ <p class="label">Format 2</p>
4199
+ <p class="format">getProperty( &quot;LAST-MODIFIED&quot;, FALSE , TRUE )</p>
4200
+ <p class="comment">output = array( &quot;value&quot; =&gt; moddate<span class="ref">1</span>
4201
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
4202
+ <p class="label">Example</p>
4203
+ <p class="example">$lastMod = $vevent->getProperty( &quot;LAST-MODIFIED&quot; );</p>
4204
+ <h5>Set LAST-MODIFIED</h5>
4205
+ Insert property value. Input date is always a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME or,
4206
+ if &quot;offset&quot; parameter is used, converted to a <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME.
4207
+ Notice, use function <a href="#transformDateTime">transformDateTime</a>
4208
+ to change a datetime to UTC time zone.
4209
+ <p class="label">Format</p>
4210
+ <p class="format">setProperty( &quot;Last-Modified&quot; [, moddate [, xparam ]] )</p>
4211
+ <p class="comment">moddate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
4212
+ , &quot;month&quot; =&gt; int month
4213
+ , &quot;day&quot; =&gt; int day
4214
+ [, &quot;hour&quot; =&gt; int hour
4215
+ , &quot;min&quot; =&gt; int min
4216
+ , &quot;sec&quot; =&gt; int sec
4217
+ , &quot;tz&quot; =&gt; offset ]] )
4218
+ completedDate = int year
4219
+ , int month
4220
+ , int day
4221
+ [, int hour
4222
+ , int min
4223
+ , int sec ]
4224
+ completedDate = array( int year
4225
+ , int month
4226
+ , int day
4227
+ [, int hour
4228
+ , int min
4229
+ , int sec
4230
+ [, offset ]] )
4231
+ completedDate = array ( &quot;timestamp&quot; =&gt; int timestamp [, &quot;tz&quot; => offset])
4232
+ completedDate = string datestring // <span class="ref">string date,
4233
+ acceptable by strtotime function,
4234
+ ex. &nbsp;&quot;14 august 2006 16.00.00&quot;
4235
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
4236
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
4237
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4238
+ <p class="label">Example 1</p>
4239
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
4240
+ $vcalendar = new vcalendar( $config );
4241
+ $vtodo = &amp; $vcalendar->newComponent( &quot;vtodo&quot; );
4242
+ .. .
4243
+ $vtodo->setProperty(&quot;last-modified&quot;
4244
+ , 2006, 8, 14, 12, 1, 2 );
4245
+ <span class="ref">// 14 august 2006 12.01.02 UTC</span></p>
4246
+ <p class="label">Example 2</p>
4247
+ <p class="example">$date = array(&quot;year&quot; =&gt; 2006, &quot;month&quot; =&gt; 10, &quot;day&quot; =&gt; 10,
4248
+ &quot;hour&quot; =&gt; 10, &quot;min&quot; =&gt; 0, &quot;sec&quot; =&gt; 0, &quot;tz&quot; =&gt; &quot;+0200&quot;);
4249
+ <span class="ref">// local date + UTC offset =&gt; <a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME</span>
4250
+ $vtodo->setProperty( &quot;last-modified&quot;, $date );
4251
+ .. .</p>
4252
+ <p class="label">Example 3</p>
4253
+ <p class="example">$vevent->setProperty( &quot;last-modified&quot; );
4254
+ <span class="ref">// current UTC DATE-TIME is set if called without parameters</span></p>
4255
+ <br>
4256
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4257
+
4258
+ <a name="LOCATION"></a><h3>3.2.25 LOCATION</h3>
4259
+ The property defines the intended venue for the activity defined by a <i>calendar</i> component. The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a> and <a href="#VTODO">VTODO</a> components.
4260
+ <br><br>
4261
+ The value type for LOCATION is TEXT.
4262
+ <h5>Delete LOCATION</h5>
4263
+ Remove LOCATION from component.
4264
+ <p class="label">Format</p>
4265
+ <p class="format">deleteProperty( &quot;LOCATION&quot; )</p>
4266
+ <p class="label">Example</p>
4267
+ <p class="example">$vevent->deleteProperty( &quot;LOCATION&quot; );</p>
4268
+ <h5>Get LOCATION</h5>
4269
+ Fetch property value.
4270
+ <p class="label">Format 1</p>
4271
+ <p class="format">getProperty( &quot;LOCATION&quot; )</p>
4272
+ <p class="comment">output = location<span class="ref">1</span></p>
4273
+ <p class="label">Format 2</p>
4274
+ <p class="format">getProperty( &quot;LOCATION&quot;, FALSE , TRUE )</p>
4275
+ <p class="comment">output = array( &quot;value&quot; =&gt; location<span class="ref">1</span>
4276
+ , &quot;params&quot; =&gt; param<span class="ref">2</span> )</p>
4277
+ <p class="label">Example</p>
4278
+ <p class="example">$location = $vevent->getProperty( &quot;LOCATION&quot; );</p>
4279
+ <h5>Set LOCATION</h5>
4280
+ Insert property value.
4281
+ <br>
4282
+ Parameters, if any, will be ordered as prescribed in rcf2445.
4283
+ <p class="label">Format</p>
4284
+ <p class="format">setProperty( &quot;location&quot;, string location [, array param] )</p>
4285
+ <p class="comment">location<span class="ref">1</span> = Value type TEXT
4286
+ params<span class="ref">2</span> = array( [&quot;ALTREP&quot; =&gt; &quot;&lt;an alternate text representation, URI&gt;&quot;]
4287
+ [, &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;]
4288
+ [, xparam ]
4289
+ xparam = *[ xparamkey =&gt; xparamvalue ]</p>
4290
+ <p class="label">Example</p>
4291
+ <p class="example">$vevent->setProperty( &quot;location&quot;, &quot;Buckingham Palace&quot; );</p>
4292
+ <br>
4293
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4294
+
4295
+
4296
+ <a name="ORGANIZER"></a><h3>3.2.26 ORGANIZER</h3>
4297
+ The property defines the organizer for a <i>calendar</i> component and is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components.<br><br>
4298
+ This value type for ORGANIZER is URI, a <i>calendar</i> user address.
4299
+ <h5>Delete ORGANIZER</h5>
4300
+ Remove ORGANIZER from component.
4301
+ <p class="label">Format</p>
4302
+ <p class="format">deleteProperty( &quot;ORGANIZER&quot; )</p>
4303
+ <p class="label">Example</p>
4304
+ <p class="example">$vevent->deleteProperty( &quot;ORGANIZER&quot; );</p>
4305
+ <h5>Get ORGANIZER</h5>
4306
+ Fetch property value.
4307
+ <p class="label">Format 1</p>
4308
+ <p class="format">getProperty( &quot;ORGANIZER&quot; )</p>
4309
+ <p class="comment">output = organizer<span class="ref">1</span></p>
4310
+ <p class="label">Format 2</p>
4311
+ <p class="format">getProperty( &quot;ORGANIZER&quot;, FALSE , TRUE )</p>
4312
+ <p class="comment">output = array( &quot;value&quot; =&gt; organizer<span class="ref">1</span>
4313
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
4314
+ <p class="label">Example</p>
4315
+ <p class="example">$organizer = $vevent->getProperty( &quot;ORGANIZER&quot; );</p>
4316
+ <h5>Set ORGANIZER</h5>
4317
+ Insert property value.
4318
+ Property value must be prefixed by protocol (ftp://, http://,mailto:, file://.. . ref. rfc 1738 ).
4319
+ Also DIR parameter must be prefixed by protocol.
4320
+ SENT-BY parameter must use protocol &quot;mailto:&quot;, prefixed if missing.
4321
+ <br>
4322
+ Parameters, if any, will be ordered as prescribed in rcf2445.
4323
+ <p class="label">Format</p>
4324
+ <p class="format">setProperty( &quot;organizer&quot;, organizer [, params] )</p>
4325
+ <p class="comment">organizer<span class="ref">1</span> = a <i>calendar</i> user address, a URI as defined by [RFC
4326
+ 1738] or any other IANA registered form for a URI.
4327
+ params<span class="ref">2</span> = array( [&quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;
4328
+ (applies to the CN parameter value) ]
4329
+ [, &quot;CN&quot; =&gt; &quot;common name to be associated
4330
+ with the <i>calendar</i> user
4331
+ specified by the property&quot;]
4332
+ [, &quot;DIR&quot; =&gt; &quot;reference to a directory
4333
+ entry associated with the <i>calendar</i> user
4334
+ specified by the property&quot; ]
4335
+ [, &quot;SENT-BY&quot; =&gt; &quot;single <i>calendar</i> user
4336
+ that is acting on behalf
4337
+ of the <i>calendar</i> user
4338
+ specified by the property&quot; ]
4339
+ [, xparam ]
4340
+ xparam = *[ xparamkey =&gt; xparamvalue ]</p>
4341
+ <p class="label">Example</p>
4342
+ <p class="example">
4343
+ $dir = &quot;ldap://domain.com:6666/o=3DDC%20Comp,c=3DUS??(cn=3DJohn%20Doe)&quot;;
4344
+ $vevent-&gt;setProperty( &quot;organizer&quot;
4345
+ , &quot;ical@domain.com&quot;
4346
+ , array( &quot;CN&quot; =&gt; &quot;John Doe&quot;
4347
+ , &quot;DIR&quot; =&gt; $dir
4348
+ , &quot;SENT-BY&quot; =&gt; &quot;secretary@domain.com&quot;
4349
+ , &quot;X-Key1&quot; =&gt; &quot;X-Value1&quot;
4350
+ , &quot;X-Key2&quot; =&gt; &quot;X-Value2&quot; ));</p>
4351
+ <br>
4352
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4353
+
4354
+
4355
+ <a name="PERCENT-COMPLETE"></a><h3>3.2.27 PERCENT-COMPLETE</h3>
4356
+ This property is used by an assignee or delegatee of a <a href="#VTODO">VTODO</a> to convey the percent completion of a <a href="#VTODO">VTODO</a> to the Organizer and is OPTIONAL and MUST NOT occur more than once.<br><br>
4357
+ The property value is a positive integer between zero and one hundred. A value of "0" indicates the <a href="#VTODO">VTODO</a> has not yet been started. A value of "100" indicates that the <a href="#VTODO">VTODO</a> has been completed. Integer values in between indicate the percent partially complete.
4358
+ <h5>Delete PERCENT-COMPLETE</h5>
4359
+ Remove PERCENT-COMPLETE from component.
4360
+ <p class="label">Format</p>
4361
+ <p class="format">deleteProperty( &quot;PERCENT-COMPLETE&quot; )</p>
4362
+ <p class="label">Example</p>
4363
+ <p class="example">$vtodo->deleteProperty( &quot;PERCENT-COMPLETE&quot; );</p>
4364
+ <h5>Get PERCENT-COMPLETE</h5>
4365
+ Fetch property value.
4366
+ <p class="label">Format 1</p>
4367
+ <p class="format">getProperty( &quot;PERCENT-COMPLETE&quot; )</p>
4368
+ <p class="comment">output = percent<span class="ref">1</span></p>
4369
+ <p class="label">Format 2</p>
4370
+ <p class="format">getProperty( &quot;PRIORITY&quot;, FALSE , TRUE )</p>
4371
+ <p class="comment">output = array( &quot;value&quot; =&gt; percent<span class="ref">1</span>
4372
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
4373
+ <p class="label">Example</p>
4374
+ <p class="example">$percent = $vtodo->getProperty( &quot;PERCENT-COMPLETE&quot; );</p>
4375
+ <h5>Set PERCENT-COMPLETE</h5>
4376
+ Insert property value.
4377
+ <p class="label">Format</p>
4378
+ <p class="format">setProperty( &quot;Percent-Complete&quot;, percent [, xparam ] )</p>
4379
+ <p class="comment">percent<span class="ref">1</span> = Value type INTEGER
4380
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4381
+ <p class="label">Example</p>
4382
+ <p class="example">$vtodo->setProperty( &quot;percent-complete&quot;, 90 );</p>
4383
+ <br>
4384
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4385
+
4386
+
4387
+ <a name="PRIORITY"></a><h3>3.2.28 PRIORITY</h3>
4388
+ The property defines the relative priority for a <i>calendar</i> component and is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a> and <a href="#VTODO">VTODO</a> components.<br><br>
4389
+ The priority is specified as an integer in the range zero to nine.<br>
4390
+ A value of zero (US-ASCII decimal 48) specifies an undefined priority.<br>
4391
+ A value of one (US-ASCII decimal 49) is the highest priority.<br>
4392
+ A value of two (US-ASCII decimal 50) is the second highest priority.<br>
4393
+ Subsequent numbers specify a decreasing ordinal priority.<br>
4394
+ A value of nine (US-ASCII decimal 58) is the lowest priority.
4395
+ <h5>Delete PRIORITY</h5>
4396
+ Remove PRIORITY from component.
4397
+ <p class="label">Format</p>
4398
+ <p class="format">deleteProperty( &quot;PRIORITY&quot; )</p>
4399
+ <p class="label">Example</p>
4400
+ <p class="example">$vevent->deleteProperty( &quot;PRIORITY&quot; );</p>
4401
+ <h5>Get PRIORITY</h5>
4402
+ Fetch property value.
4403
+ <p class="label">Format 1</p>
4404
+ <p class="format">getProperty( &quot;PRIORITY&quot; )</p>
4405
+ <p class="comment">output = priority<span class="ref">1</span></p>
4406
+ <p class="label">Format 2</p>
4407
+ <p class="format">getProperty( &quot;PRIORITY&quot;, FALSE , TRUE )</p>
4408
+ <p class="comment">output = array( &quot;value&quot; =&gt; priority<span class="ref">1</span>
4409
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
4410
+ <p class="label">Example</p>
4411
+ <p class="example">$priority = $vevent->getProperty( &quot;priority&quot; );</p>
4412
+ <h5>Set PRIORITY</h5>
4413
+ Insert property value.
4414
+ <p class="label">Format</p>
4415
+ <p class="format">setProperty( &quot;priority&quot;, priority [, xparam ] )</p>
4416
+ <p class="comment">priority<span class="ref">1</span> = Value type INTEGER
4417
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4418
+ <p class="label">Example</p>
4419
+ <p class="example">$vevent->setProperty( &quot;priority&quot;, 3 );</p>
4420
+ <br>
4421
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4422
+
4423
+
4424
+ <a name="RDATE"></a><h3>3.2.29 RDATE</h3>
4425
+ This property defines the list of date/times for a recurrence set and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a>, <a href="#VTIMEZONE">STANDARD</a> and <a href="#VTIMEZONE">DAYLIGHT</a> components.<br><br>
4426
+ The default value type for RDATE is DATE-TIME, can be set to DATE or PERIOD (params <span class="ref">2</span>).
4427
+ <h5>Delete RDATE</h5>
4428
+ Remove RDATE from component.
4429
+ <p class="label">Format</p>
4430
+ <p class="format">deleteProperty( &quot;RDATE&quot; )</p>
4431
+ <p class="label">Example 1</p>
4432
+ <p class="example">$vtodo->deleteProperty( &quot;RDATE&quot; );</p>
4433
+ <p class="label">Example 2</p>
4434
+ Delete RDATE property no 2.
4435
+ <p class="example">$vjournal->deleteProperty( &quot;RDATE&quot;, 2 );</p>
4436
+ <p class="label">Example 3</p>
4437
+ Deleting all RDATE properties.
4438
+ <p class="example">while( $vjournal->deleteProperty( &quot;RDATE&quot; ))
4439
+ continue;</p>
4440
+ <h5>Get RDATE</h5>
4441
+ Fetch property value.
4442
+ <p class="label">Format 1</p>
4443
+ <p class="format">getProperty( &quot;RDATE&quot; )</p>
4444
+ <p class="comment">output = dates<span class="ref">1</span></p>
4445
+ <p class="label">Format 2</p>
4446
+ <p class="format">getProperty( &quot;RDATE&quot;, propOrderNo/FALSE , TRUE )</p>
4447
+ <p class="comment">output = array( &quot;value&quot; =&gt; dates<span class="ref">1</span>
4448
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
4449
+ <p class="label">Format 3</p>
4450
+ <p class="format">getProperty( &quot;RDATE&quot;, propOrderNo )</p>
4451
+ <p class="comment">Get propOrderNo RDATE</p>
4452
+ <p class="label">Example</p>
4453
+ <p class="example">$rdates = $vevent->getProperty( &quot;RDATE&quot; );</p>
4454
+ <h5>Set RDATE</h5>
4455
+ Insert property value.<br>
4456
+ If &quot;TZID&quot; is set in params, ex. &quot;TZID&quot; = &quot;CET&quot;, all timezone or offset in dates are ignored and DATE-TIME value type is set.<br>
4457
+ If DATE value type is set in params (&quot;VALUE&quot; = &quot;DATE&quot;), all timezone or offset in dates are ignored.<br>
4458
+ If &quot;PERIOD&quot; is set in params (&quot;VALUE&quot; = &quot;PERIOD&quot;), DATE-TIME value type is set.<br>
4459
+ If no &quot;VALUE&quot; parameter in params, DATE-TIME (default) value type is set.<br>
4460
+ If empty params and offset in 1st date, all remaining dates are set to UTC.<br>
4461
+ If no &quot;TZID&quot; is set in params and timezone in 1st date, all remaining dates are within this timezone and param &quot;TZID&quot; is set.<br>
4462
+ If none of the above rules are applicable, DATE-TIME and local date is set default.
4463
+ <br>
4464
+ Parameters, if any, will be ordered as prescribed in rcf2445.
4465
+ <p class="label">Format</p>
4466
+ <p class="format">setProperty( &quot;rdate&quot;, dates [, params [, propOrderNo ]] )</p>
4467
+ <p class="comment">dates<span class="ref">1</span> = array ( date2 *[, date2 ] )
4468
+ date2 = date
4469
+ date2 = array( startdate, enddate/duration ) ]
4470
+ startdate = date
4471
+ enddate = date
4472
+ date = array( int year
4473
+ , int month
4474
+ , int day
4475
+ [, int int hour
4476
+ , int min
4477
+ , int day
4478
+ , mixed tz ] )
4479
+ date = array( &quot;year&quot; =&gt; int year
4480
+ , &quot;month&quot; =&gt; int month
4481
+ , &quot;day&quot; =&gt; int day
4482
+ [, &quot;hour&quot; =&gt; int hour
4483
+ , &quot;min&quot; =&gt; int min
4484
+ , &quot;sec&quot; =&gt; int sec
4485
+ [, &quot;tz&quot; =&gt; mixed tz ]] )
4486
+ // <span class="ref">output format</span>
4487
+ date = array( &quot;timestamp&quot; =&gt; int timestamp
4488
+ [, &quot;tz&quot; =&gt; mixed tz ] )
4489
+ date = string datestring // <span class="ref">string date,
4490
+ acceptable by strtotime function,
4491
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
4492
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
4493
+ tz = timezone / offset
4494
+ (timezone will be used as tzidparam, if tzidparam not exists)
4495
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
4496
+ duration = array( int week/false
4497
+ [, int day/false
4498
+ , int hour
4499
+ , int min
4500
+ , int sec] )
4501
+ duration = array([ &quot;week&quot; =&gt; int week/false ,] /
4502
+ [ &quot;day&quot; =&gt; int day/false
4503
+ [, &quot;hour&quot; =&gt; int hour
4504
+ , &quot;min&quot; =&gt; int min
4505
+ , &quot;sec&quot; =&gt; int sec ]] );
4506
+ // <span class="ref">output format, only used keys</span>
4507
+ duration = array( &quot;sec&quot; =&gt; int sec );
4508
+ duration = string format duration like &quot;P15DT5H0M20S&quot;
4509
+ params<span class="ref">2</span> = ([tzidparam ( / datetimeparam / dateparam / periodparam )]
4510
+ *[, xparams ] )
4511
+ tzidparam = &quot;TZID&quot; =&gt; &lt;timezone identifier&gt;
4512
+ // <span class="ref">output as local DATE-TIME with timezone identifier</span>
4513
+ datetimeparam = &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot; // <span class="ref">default, output as DATE-TIME</span>
4514
+ dateparam = &quot;VALUE&quot; =&gt; &quot;DATE&quot; // <span class="ref">output as DATE</span>
4515
+ periodparam = &quot;VALUE&quot; =&gt; &quot;PERIOD&quot; // <span class="ref">output as PERIOD (datetime)</span>
4516
+ xparams = xparamkey =&gt; xparamvalue
4517
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
4518
+ <p class="label">Example</p>
4519
+ See rules in detail in <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar).<br>
4520
+ <p class="example">// $rdate1 = array ( 2001, 1, 1, 1, 1, 1 );
4521
+ // alt.
4522
+ $rdate1 = array( &quot;year&quot; =&gt; 2001
4523
+ , &quot;month&quot; =&gt; 1
4524
+ , &quot;day&quot; =&gt; 1
4525
+ , &quot;hour&quot; =&gt; 1
4526
+ , &quot;min&quot; =&gt; 1
4527
+ , &quot;sec&quot; =&gt; 1
4528
+ , &quot;tz&quot; =&gt; &quot;GMT&quot; );
4529
+ $rdate2 = array( 2002, 2, 2, 2, 2, 2, &quot;GMT&quot; );
4530
+ $rdate3 = &quot;3 March 2003 03.03.03&quot;;
4531
+ $rdate4 = array( 2004, 4, 4, 4, 4, 4, &quot;GMT&quot; );
4532
+ $rdate5 = array( 2005, 10, 5, 5, 5, 5 );
4533
+ $rdate8 = array( &quot;year&quot; =&gt; 2007, &quot;month&quot; =&gt; 7, &quot;day&quot; =&gt; 7 );
4534
+ $rdur6 = array( &quot;week&quot; =&gt; 0
4535
+ , &quot;day&quot; =&gt; 0
4536
+ , &quot;hour&quot; =&gt; 5
4537
+ , &quot;min&quot; =&gt; 5
4538
+ , &quot;sec&quot; =&gt; 5 );
4539
+ $rdur7 = array( 0, 0, 6 );
4540
+ <span class="comment">// duration for 6 hours</span>
4541
+ $rdur8 = array( &quot;week&quot; =&gt; 8 );
4542
+ <span class="comment">// duration for 8 weeks</span>
4543
+
4544
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
4545
+ $vevent->setProperty( &quot;rdate&quot;, array( $rdate1 ));
4546
+ <span class="comment">// one recurrence date, date in 7-params format (DATE-TIME)</span>
4547
+
4548
+ $vevent->setProperty( &quot;rdate&quot;, array( $rdate1, $rdate2 ));
4549
+ <span class="comment">// two dates, date 7-params format (DATE-TIME)</span>
4550
+
4551
+ $vevent->setProperty( &quot;rdate&quot;, array( array( $rdate1, $rdate2 )
4552
+ , array( $rdate3, $rdate4 ))
4553
+ , array( &quot;VALUE&quot; => &quot;PERIOD&quot; ));
4554
+ <span class="comment">// Both fromdate and enddate must have 7 params (DATE-TIME) !!!</span>
4555
+
4556
+ $vevent->setProperty( &quot;rdate&quot;, array( array( $rdate2, $rdur6 ))
4557
+ , array( &quot;VALUE&quot; => &quot;PERIOD&quot; ));
4558
+ <span class="comment">// one duration (fromdate-duration)</span>
4559
+
4560
+ $vevent->setProperty( &quot;rdate&quot;, array( array( $rdate1, $date2 )
4561
+ , array( $rdate3, $rdur7 ))
4562
+ , array( &quot;VALUE&quot; => &quot;PERIOD&quot; ));
4563
+ <span class="comment">// period, pairs of fromdate+enddate and fromdate-duration</span>
4564
+
4565
+ $vevent->setProperty( &quot;rdate&quot;, array( $rdate5, $date8 ))
4566
+ , array( &quot;VALUE&quot; => &quot;DATE&quot; ));
4567
+ <span class="comment">// dates in DATE format</span>
4568
+ .. .</p>
4569
+ <br>
4570
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4571
+
4572
+
4573
+ <a name="RECURRENCE-ID"></a><h3>3.2.30 RECURRENCE-ID</h3>
4574
+ This property is used in conjunction with the <a href="#UID">UID</a> and <a href="#SEQUENCE">SEQUENCE</a> property to identify a specific instance of a recurring <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> or <a href="#VJOURNAL">VJOURNAL</a> <i>calendar</i> component and is OPTIONAL and MAY NOT occur more than once.<br><br>
4575
+ The property value is the effective value of the <a href="#DTSTART">DTSTART</a> property of the recurrence instance. The default value type is DATE-TIME, can be set to DATE (params <span class="ref">2</span>).
4576
+ <h5>Delete RECURRENCE-ID</h5>
4577
+ Remove RECURRENCE-ID from component.
4578
+ <p class="label">Format</p>
4579
+ <p class="format">deleteProperty( &quot;RECURRENCE-ID&quot; )</p>
4580
+ <p class="label">Example</p>
4581
+ <p class="example">$vevent->deleteProperty( &quot;RECURRENCE-ID&quot; );</p>
4582
+ <h5>Get RECURRENCE-ID</h5>
4583
+ Fetch property value.
4584
+ <p class="label">Format 1</p>
4585
+ <p class="format">getProperty( &quot;RECURRENCE-ID&quot; )</p>
4586
+ <p class="comment">output = recurrIdDate<span class="ref">1</span></p>
4587
+ <p class="label">Format 2</p>
4588
+ <p class="format">getProperty( &quot;RECURRENCE-ID&quot;, FALSE , TRUE )</p>
4589
+ <p class="comment">output = array( &quot;value&quot; =&gt; recurrIdDate<span class="ref">1</span>
4590
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
4591
+ <p class="label">Example</p>
4592
+ <p class="example">$recurrDate = $vtodo->getProperty( &quot;RECURRENCE-ID&quot; );</p>
4593
+ <h5>Set RECURRENCE-ID</h5>
4594
+ Insert property value. If DATE value type is expected, &quot;VALUE&quot; = &quot;DATE&quot; <b>must</b> be set (in params<span class="ref">2</span>) otherwise DATE-TIME (default) value type is set.
4595
+ <br>
4596
+ <br>
4597
+ If no timezone parameter (tz or tzidparam below) is set (then local time is assumed) and config <a href="#dTZID">TZID</a> is set,
4598
+ date-time values will be set WITH timezone from config.
4599
+ Notice, use function <a href="#transformDateTime">transformDateTime</a>
4600
+ to change a datetime from a time zone to another.
4601
+ <p class="label">Format</p>
4602
+ <p class="format">setProperty( &quot;recurrence-id&quot;, recurrIdDate [, params ] )</p>
4603
+ <p class="comment">recurrIdDate<span class="ref">1</span> = array( &quot;year&quot; =&gt; int year
4604
+ , &quot;month&quot; =&gt; int month
4605
+ , &quot;day&quot; =&gt; int day
4606
+ [, &quot;hour&quot; =&gt; int hour
4607
+ , &quot;min&quot; =&gt; int min
4608
+ , &quot;sec&quot; =&gt; int sec
4609
+ [, &quot;tz&quot; =&gt; mixed tz ]] )
4610
+ recurrIdDate = int year
4611
+ , int month
4612
+ , int day
4613
+ [, int hour
4614
+ , int min
4615
+ , int sec
4616
+ [, mixed tz ]]
4617
+ recurrIdDate = array( int year
4618
+ , int month
4619
+ , int day
4620
+ [, int hour
4621
+ , int min
4622
+ , int sec
4623
+ [, mixed tz ]] )
4624
+ recurrIdDate = array( &quot;timestamp&quot; =&gt; int timestamp
4625
+ [, &quot;tz&quot; =&gt; mixed tz ] )
4626
+ recurrIdDate = string datestring // <span class="ref">string date,
4627
+ acceptable by strtotime function,
4628
+ ex. &quot;14 august 2006 16.00.00&quot;
4629
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
4630
+ tz = timezone / offset
4631
+ (timezone will be used as tzidparam, if tzidparam not exists)
4632
+ offset = (+/-)HHmm[ss], local date + UTC offset =&gt; <a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME
4633
+ params<span class="ref">2</span> = array([ datetimeparam/dateparam/tzidparam ]
4634
+ [, rangeparam ]
4635
+ [, xparam ] )
4636
+ datetimeparam = &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot; // <span class="ref">default, output as DATE-TIME</span>
4637
+ dateparam = &quot;VALUE&quot; =&gt; &quot;DATE&quot; // <span class="ref">output as DATE</span>
4638
+ tzidparam = &quot;TZID&quot; =&gt; &lt;timezone identifier&gt;
4639
+ // <span class="ref">output as local date-time with timezone identifier</span>
4640
+ rangeparam = &quot;RANGE&quot; =&gt; ( "THISANDPRIOR" / "THISANDFUTURE" )
4641
+ // <span class="ref">range parameter</span>
4642
+ xparam = *[ xparamkey =&gt; xparamvalue ]</p>
4643
+ <p class="label">Example</p>
4644
+ <p class="example">$vtodo->setProperty( &quot;recurrence-id&quot;, &quot;3 March 2003 03.03.03&quot; );
4645
+ <span class="comment">// 3 march 2003 03.03.03 local time</span></p>
4646
+ <br>
4647
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4648
+
4649
+
4650
+ <a name="RELATED-TO"></a><h3>3.2.31 RELATED-TO</h3>
4651
+ The property is used to represent a relationship or reference between one <i>calendar</i> component and another and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> components.<br><br>
4652
+ The property value consists of the persistent, globally unique identifier of another <i>calendar</i> component. This value would be represented in a <i>calendar</i> component by the <a href="#UID">UID</a> property.<br><br>
4653
+ The value type for RELATED-TO is TEXT.
4654
+ <h5>Delete RELATED-TO</h5>
4655
+ Remove RELATED-TO from component.
4656
+ <p class="label">Format</p>
4657
+ <p class="format">deleteProperty( &quot;RELATED-TO&quot; )</p>
4658
+ <p class="label">Example 1</p>
4659
+ <p class="example">$vtodo->deleteProperty( &quot;RELATED-TO&quot; );</p>
4660
+ <p class="label">Example 2</p>
4661
+ Delete RELATED-TO property no 2.
4662
+ <p class="example">$vjournal->deleteProperty( &quot;RELATED-TO&quot;, 2 );</p>
4663
+ <p class="label">Example 3</p>
4664
+ Deleting all RELATED-TO properties.
4665
+ <p class="example">while( $vjournal->deleteProperty( &quot;RELATED-TO&quot; ))
4666
+ continue;</p>
4667
+ <h5>Get RELATED-TO</h5>
4668
+ Fetch property value.
4669
+ <p class="label">Format 1</p>
4670
+ <p class="format">getProperty( &quot;RELATED-TO&quot; )</p>
4671
+ <p class="comment">output = relid<span class="ref">1</span></p>
4672
+ <p class="label">Format 2</p>
4673
+ <p class="format">getProperty( &quot;RELATED-TO&quot;, propOrderNo/FALSE , TRUE )</p>
4674
+ <p class="comment">output = array( &quot;value&quot; =&gt; relid<span class="ref">1</span>
4675
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
4676
+ <p class="label">Format 3</p>
4677
+ <p class="format">getProperty( &quot;RELATED-TO&quot;, propOrderNo )</p>
4678
+ <p class="comment">Get propOrderNo RELATED-TO</p>
4679
+ <p class="label">Example</p>
4680
+ <p class="example">$relatedId = $vtodo->getProperty( &quot;RELATED-TO&quot; );</p>
4681
+ <h5>Set RELATED-TO</h5>
4682
+ Insert property value.
4683
+ <p class="label">Format</p>
4684
+ <p class="format">setProperty( &quot;Related-To&quot;, relid [, params [, propOrderNo ]] )</p>
4685
+ <p class="comment">relid<span class="ref">1</span> = Value type TEXT.
4686
+ params<span class="ref">2</span> = array( [ reltype ] [, xparam] )
4687
+ reltype = &quot;RELTYPE&quot; =&gt; (&quot;PARENT&quot; (Default)
4688
+ / &quot;CHILD&quot;
4689
+ / &quot;SIBLING&quot;
4690
+ / iana-token
4691
+ / x-name)
4692
+ xparam = *[ xparamkey =&gt; xparamvalue ]
4693
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
4694
+ <p class="label">Example</p>
4695
+ <p class="example">$vtodo->setProperty( &quot;related-to&quot;, &quot;19960401-080045-4000F192713@host.com&quot;);</p>
4696
+ <br>
4697
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4698
+
4699
+ <a name="REPEAT"></a><h3>3.2.32 REPEAT</h3>
4700
+ This property defines the number of time the <a href="#VALARM">ALARM</a> should be repeated, after the initial trigger.
4701
+ If the <a href="#VALARM">ALARM</a> triggers more than once, then this property MUST be specified along with the <a href="#DURATION">DURATION</a> property.
4702
+ <h5>Delete REPEAT</h5>
4703
+ Remove REPEAT from component.
4704
+ <p class="label">Format</p>
4705
+ <p class="format">deleteProperty( &quot;REPEAT&quot; )</p>
4706
+ <p class="label">Example</p>
4707
+ <p class="example">$valarm->deleteProperty( &quot;REPEAT&quot; );</p>
4708
+ <h5>Get REPEAT</h5>
4709
+ Fetch property value.
4710
+ <p class="label">Format 1</p>
4711
+ <p class="format">getProperty( &quot;REPEAT&quot; )</p>
4712
+ <p class="comment">output = repeatTimes<span class="ref">1</span></p>
4713
+ <p class="label">Format 2</p>
4714
+ <p class="format">getProperty( &quot;REPEAT&quot;, FALSE , TRUE )</p>
4715
+ <p class="comment">output = array( &quot;value&quot; =&gt; repeatTimes<span class="ref">1</span>
4716
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
4717
+ <p class="label">Example</p>
4718
+ <p class="example">$repeat = $vtodo->getProperty( &quot;REPEAT&quot; );</p>
4719
+ <h5>Set REPEAT</h5>
4720
+ Insert property value.
4721
+ <p class="label">Format</p>
4722
+ <p class="format">setProperty( &quot;repeat&quot;, repeatTimes [, xparam ] )</p>
4723
+ <p class="comment">repeatTimes<span class="ref">1</span> = Value type INTEGER
4724
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4725
+ <p class="label">Example</p>
4726
+ <p class="example">$valarm->setProperty( &quot;repeat&quot;, 2 );</p>
4727
+ <br>
4728
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4729
+
4730
+
4731
+ <a name="REQUEST-STATUS"></a><h3>3.2.33 REQUEST-STATUS</h3>
4732
+ This property defines the status code returned for a scheduling request and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components.
4733
+ <h5>Delete REQUEST-STATUS</h5>
4734
+ Remove REQUEST-STATUS from component.
4735
+ <p class="label">Format</p>
4736
+ <p class="format">deleteProperty( &quot;REQUEST-STATUS&quot; )</p>
4737
+ <p class="label">Example 1</p>
4738
+ <p class="example">$vtodo->deleteProperty( &quot;REQUEST-STATUS&quot; );</p>
4739
+ <p class="label">Example 2</p>
4740
+ Delete REQUEST-STATUS property no 2.
4741
+ <p class="example">$vjournal->deleteProperty( &quot;REQUEST-STATUS&quot;, 2 );</p>
4742
+ <p class="label">Example 3</p>
4743
+ Deleting all REQUEST-STATUS properties.
4744
+ <p class="example">while( $vjournal->deleteProperty( &quot;REQUEST-STATUS&quot; ))
4745
+ continue;</p>
4746
+ <h5>Get REQUEST-STATUS</h5>
4747
+ Fetch property value.
4748
+ <p class="label">Format 1</p>
4749
+ <p class="format">getProperty( &quot;REQUEST-STATUS&quot; )</p>
4750
+ <p class="comment">output = array( &quot;statcode&quot; =&gt; statcode<span class="ref">1</span>
4751
+ , &quot;text&quot; =&gt; errtext<span class="ref">2</span>
4752
+ [ , &quot;extdata&quot; =&gt; extraData<span class="ref"> 3</span> ] )</p>
4753
+ <p class="label">Format 2</p>
4754
+ <p class="format">getProperty( &quot;REQUEST-STATUS&quot;, propOrderNo/FALSE, TRUE )</p>
4755
+ <p class="comment">output = array( &quot;value&quot; =&gt; array( &quot;statcode&quot; =&gt; statcode<span class="ref">1</span>
4756
+ , &quot;text&quot; =&gt; errtext<span class="ref">2</span>
4757
+ [ , &quot;extdata&quot; =&gt; extraData<span class="ref">3</span> ] )
4758
+ , &quot;params&quot; =&gt; params<span class="ref">4</span> )</p>
4759
+ <p class="label">Format 3</p>
4760
+ <p class="format">getProperty( &quot;REQUEST-STATUS&quot;, propOrderNo )</p>
4761
+ <p class="comment">Get propOrderNo REQUEST-STATUS</p>
4762
+ <p class="label">Example</p>
4763
+ <p class="example">$requestStatus = $vtodo->getProperty( &quot;REQUEST-STATUS&quot; );</p>
4764
+ <h5>Set REQUEST-STATUS</h5>
4765
+ Insert property value.
4766
+ <p class="label">Format</p>
4767
+ <p class="format">setProperty( &quot;Request-Status&quot;
4768
+ , statcode, errtext [,extraData/FALSE [,params [,propOrderNo]]])</p>
4769
+ <p class="comment">statcode<span class="ref">1</span> = Hierarchical, numeric return status code
4770
+ (1*DIGIT *(&quot;.&quot; 1*DIGIT))
4771
+ errtext<span class="ref">2</span> = Textual status description
4772
+ extraData<span class="ref">3</span> = Textual exception data.
4773
+ For example, the offending property name and value
4774
+ or complete property line.
4775
+ params<span class="ref">4</span> = array( [&quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;] [, xparam ] )
4776
+ xparam = *[ xparamkey =&gt; xparamvalue ]
4777
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
4778
+ <p class="label">Example</p>
4779
+ <p class="example">$vfreebusy->setProperty(&quot;request-status&quot;
4780
+ , 2.0
4781
+ , &quot;Invalid property value&quot;
4782
+ , &quot;DTSTART:96-Apr-31&quot;);</p>
4783
+ <br>
4784
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4785
+
4786
+
4787
+ <a name="RESOURCES"></a><h3>3.2.34 RESOURCES</h3>
4788
+ This property defines the equipment or resources anticipated for an activity specified by a <i>calendar</i> entity and is OPTIONAL and MAY occur more than once in <a href="#VEVENT">VEVENT</a> and <a href="#VTODO">VTODO</a> components.<br><br>
4789
+ The value type for RESOURCES is TEXT.
4790
+ <h5>Delete RESOURCES</h5>
4791
+ Remove RESOURCES from component.
4792
+ <p class="label">Format</p>
4793
+ <p class="format">deleteProperty( &quot;RESOURCES&quot; )</p>
4794
+ <p class="label">Example 1</p>
4795
+ <p class="example">$vevent->deleteProperty( &quot;RESOURCES&quot; );</p>
4796
+ <p class="label">Example 2</p>
4797
+ Delete RESOURCES property no 2.
4798
+ <p class="example">$vevent->deleteProperty( &quot;RESOURCES&quot;, 2 );</p>
4799
+ <p class="label">Example 3</p>
4800
+ Deleting all RESOURCES properties.
4801
+ <p class="example">while( $vevent->deleteProperty( &quot;RESOURCES&quot; ))
4802
+ continue;</p>
4803
+ <h5>Get RESOURCES</h5>
4804
+ Fetch property value.
4805
+ <p class="label">Format 1</p>
4806
+ <p class="format">getProperty( &quot;RESOURCES&quot; )</p>
4807
+ <p class="comment">output = resources<span class="ref">1</span></p>
4808
+ <p class="label">Format 2</p>
4809
+ <p class="format">getProperty( &quot;RESOURCES&quot;, propOrderNo/FALSE, TRUE )</p>
4810
+ <p class="comment">output = array( &quot;value&quot; =&gt; resources<span class="ref">1</span>
4811
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
4812
+ <p class="label">Format 3</p>
4813
+ <p class="format">getProperty( &quot;RESOURCES&quot;, propOrderNo )</p>
4814
+ <p class="comment">Get propOrderNo RESOURCES</p>
4815
+ <p class="label">Example</p>
4816
+ <p class="example">$resources = $vtodo->getProperty( &quot;RESOURCES&quot; );</p>
4817
+ <h5>Set RESOURCES</h5>
4818
+ Insert property value.
4819
+ <br>
4820
+ Parameters, if any, will be ordered as prescribed in rcf2445.
4821
+ <p class="label">Format</p>
4822
+ <p class="format">setProperty( &quot;resources&quot;, resources [, params [, propOrderNo ]] )</p>
4823
+ <p class="comment">resources<span class="ref">1</span> = string resource / array( *resource )
4824
+ resource = textual resources or subtypes of the <i>calendar</i> component,
4825
+ can be specified as a list of resources
4826
+ separated by the COMMA character.
4827
+ params<span class="ref">2</span> = array([ &quot;ALTREP&quot; =&gt; &quot;&lt;an alternate text representation, URI&gt;&quot;]
4828
+ [, &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;]
4829
+ [, xparam] )
4830
+ xparam = *[ xparamkey =&gt; xparamvalue ]
4831
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
4832
+ <p class="label">Example</p>
4833
+ <p class="example">$vevent->setProperty( &quot;resources&quot;, &quot;COMPUTER PROJECTOR&quot; );</p>
4834
+ <br>
4835
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4836
+
4837
+
4838
+ <a name="RRULE"></a><h3>3.2.35 RRULE</h3>
4839
+ This property defines a rule or repeating pattern for recurring <a href="#VEVENT">EVENTs</a>, <a href="#VTODO">TODOs</a>, <a href="#VTIMEZONE">STANDARD</a> or <a href="#VTIMEZONE">DAYLIGHT</a> definitions and is OPTIONAL and MAY occur more than once.
4840
+ <h5>Delete RRULE</h5>
4841
+ Remove RRULE from component.
4842
+ <p class="label">Format</p>
4843
+ <p class="format">deleteProperty( &quot;RRULE&quot; )</p>
4844
+ <p class="label">Example 1</p>
4845
+ <p class="example">$vevent->deleteProperty( &quot;RRULE&quot; );</p>
4846
+ <p class="label">Example 2</p>
4847
+ Delete RRULE property no 2.
4848
+ <p class="example">$vevent->deleteProperty( &quot;RRULE&quot;, 2 );</p>
4849
+ <p class="label">Example 3</p>
4850
+ Deleting all RRULE properties.
4851
+ <p class="example">while( $vevent->deleteProperty( &quot;RRULE&quot; ))
4852
+ continue;</p>
4853
+ <h5>Get RRULE</h5>
4854
+ Fetch property value.
4855
+ <p class="label">Format 1</p>
4856
+ <p class="format">getProperty( &quot;RRULE&quot; )</p>
4857
+ <p class="comment">output = recur<span class="ref">1</span></p>
4858
+ <p class="label">Format 2</p>
4859
+ <p class="format">getProperty( &quot;RRULE&quot;, propOrderNo/FALSE, TRUE )</p>
4860
+ <p class="comment">output = array( &quot;value&quot; =&gt; recur<span class="ref">1</span>
4861
+ , &quot;params&quot; =&gt; xparams<span class="ref">2</span> )</p>
4862
+ <p class="label">Format 3</p>
4863
+ <p class="format">getProperty( &quot;RRULE&quot;, propOrderNo )</p>
4864
+ <p class="comment">Get propOrderNo RRULE</p>
4865
+ <p class="label">Example</p>
4866
+ <p class="example">$rrules = $vtodo->getProperty( &quot;RRULE&quot; );</p>
4867
+ <h5>Set RRULE</h5>
4868
+ Insert property value.
4869
+ <br>
4870
+ Parameters will be ordered as prescribed in rcf2445.
4871
+ <p class="label">Format</p>
4872
+ <p class="format">setProperty( &quot;rrule&quot;, recur [, xparams [, propOrderNo ]] )</p>
4873
+ <p>
4874
+ For rules example see <a href="#EXRULE">Exrule</a> format and in detail in <a href="http://kigkonsult.se/downloads/dl.php?f=rfc2445" title="RFC2445" target="_blank">RFC2445</a> - Internet Calendaring and Scheduling Core Object Specification (iCalendar).
4875
+ </p>
4876
+ <p class="comment">recur<span class="ref">1</span> = see <a href="#EXRULE">Exrule</a>
4877
+ xparams<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )
4878
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
4879
+ <br>
4880
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4881
+
4882
+ <a name="SEQUENCE"></a><h3>3.2.36 SEQUENCE</h3>
4883
+ This property defines the revision sequence number of the <i>calendar</i> component within a sequence of revisions.
4884
+ The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>,
4885
+ <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components.
4886
+ <br>
4887
+ <p class="quotes">
4888
+ It is monotonically incremented by the <a href="#ORGANIZER">ORGANIZER's</a> CUA (Calendar
4889
+ User Agent) each time the <a href="#ORGANIZER">ORGANIZER</a> makes a significant revision
4890
+ to the <i>calendar</i> component.
4891
+
4892
+ When the <a href="#ORGANIZER">ORGANIZER</a> makes changes to one of the following
4893
+ properties, the sequence number MUST be incremented: <a href="#DTSTART">DTSTART</a>,
4894
+ <a href="#DTEND">DTEND</a>, <a href="#DUE">DUE</a>, <a href="#RDATE">RDATE</a>, <a href="#RRULE">RRULE</a>,
4895
+ <a href="#EXDATE">EXDATE</a>, <a href="#EXRULE">EXRULE</a>, <a href="#STATUS">STATUS</a>. In addition,
4896
+ changes made by the <a href="#ORGANIZER">ORGANIZER</a> to other properties can also force
4897
+ the sequence number to be incremented. The <a href="#ORGANIZER">ORGANIZER</a> CUA MUST
4898
+ increment the sequence number when ever it makes changes to
4899
+ properties in the <i>calendar</i> component that the <a href="#ORGANIZER">ORGANIZER</a>
4900
+ deems will jeopardize the validity of the participation status of the
4901
+ <a href="#ATTENDEE">Attendees</a>. For example, changing the location
4902
+ of a meeting from one locale to another distant locale could
4903
+ effectively impact the participation status of the <a href="#ATTENDEE">Attendees</a>.
4904
+ </p>
4905
+ <h5>Delete SEQUENCE</h5>
4906
+ Remove SEQUENCE from component.
4907
+ <p class="label">Format</p>
4908
+ <p class="format">deleteProperty( &quot;SEQUENCE&quot; )</p>
4909
+ <p class="label">Example</p>
4910
+ <p class="example">$vtodo->deleteProperty( &quot;SEQUENCE&quot; );</p>
4911
+ <h5>Get SEQUENCE</h5>
4912
+ Fetch property value.
4913
+ <p class="label">Format 1</p>
4914
+ <p class="format">getProperty( &quot;SEQUENCE&quot; )</p>
4915
+ <p class="comment">output = sequence<span class="ref">1</span></p>
4916
+ <p class="label">Format 2</p>
4917
+ <p class="format">getProperty( &quot;SEQUENCE&quot;, FALSE , TRUE )</p>
4918
+ <p class="comment">output = array( &quot;value&quot; =&gt; sequence<span class="ref">1</span>
4919
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
4920
+ <p class="label">Example</p>
4921
+ <p class="example">$sequence = $vtodo->getProperty( &quot;SEQUENCE&quot; );</p>
4922
+ <h5>Set SEQUENCE</h5>
4923
+ Insert property value.
4924
+ <p class="label">Format</p>
4925
+ <p class="format">setProperty( &quot;sequence&quot; [, sequence [, xparam ]] )</p>
4926
+ <p class="comment">sequence<span class="ref">1</span> = Value type INTEGER
4927
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4928
+ <p class="label">Example 1</p>
4929
+ <p class="example">$vevent->setProperty( &quot;sequence&quot;, 2 );
4930
+ <span class="comment">// set sequence number to 2</span></p>
4931
+ <p class="label">Example 2</p>
4932
+ <p class="example">$vevent->setProperty( &quot;sequence&quot; );
4933
+ <span class="comment">// force sequence number to be set to 0
4934
+ // or, if sequence exists, incremented by 1</span></p>
4935
+ <br>
4936
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4937
+
4938
+
4939
+ <a name="STATUS"></a><h3>3.2.37 STATUS</h3>
4940
+ This property defines the overall status or confirmation for the <i>calendar</i> component. The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components.
4941
+ <h5>Delete STATUS</h5>
4942
+ Remove STATUS from component.
4943
+ <p class="label">Format</p>
4944
+ <p class="format">deleteProperty( &quot;STATUS&quot; )</p>
4945
+ <p class="label">Example</p>
4946
+ <p class="example">$vtodo->deleteProperty( &quot;STATUS&quot; );</p>
4947
+ <h5>Get STATUS</h5>
4948
+ Fetch property value.
4949
+ <p class="label">Format 1</p>
4950
+ <p class="format">getProperty( &quot;STATUS&quot; )</p>
4951
+ <p class="comment">output = status<span class="ref">1</span></p>
4952
+ <p class="label">Format 2</p>
4953
+ <p class="format">getProperty( &quot;STATUS&quot;, FALSE , TRUE )</p>
4954
+ <p class="comment">output = array( &quot;value&quot; =&gt; status<span class="ref">1</span>
4955
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
4956
+ <p class="label">Example</p>
4957
+ <p class="example">$status = $vtodo->getProperty( &quot;STATUS&quot; );</p>
4958
+ <h5>Set STATUS</h5>
4959
+ Insert property value.
4960
+ <p class="label">Format</p>
4961
+ <p class="format">setProperty( &quot;status&quot;, status [, xparam ] )</p>
4962
+ <p class="comment"> // <span class="ref">Status values for a <a href="#vevent">VEVENT</a></span>
4963
+ status<span class="ref">1</span> = &quot;TENTATIVE&quot; // <span class="ref">Indicates event is tentative</span>
4964
+ / &quot;CONFIRMED&quot; // <span class="ref">Indicates event is definite</span>
4965
+ / &quot;CANCELLED&quot; // <span class="ref">Indicates event was cancelled</span>
4966
+ // <span class="ref">Status values for <a href="#VTODO">VTODO</a></span>
4967
+ status<span class="ref">1</span> = &quot;NEEDS-ACTION&quot; // <span class="ref">Indicates to-do needs action</span>
4968
+ / &quot;COMPLETED&quot; // <span class="ref">Indicates to-do completed</span>
4969
+ / &quot;IN-PROCESS&quot; // <span class="ref">Indicates to-do in process of</span>
4970
+ / &quot;CANCELLED&quot; // <span class="ref">Indicates to-do was cancelled</span>
4971
+ // <span class="ref">Status values for <a href="#VJOURNAL">VJOURNAL</a></span>
4972
+ status<span class="ref">1</span> = &quot;DRAFT&quot; // <span class="ref">Indicates journal is draft</span>
4973
+ / &quot;FINAL&quot; // <span class="ref">Indicates journal is final</span>
4974
+ / &quot;CANCELLED&quot; // <span class="ref">Indicates journal is removed</span>
4975
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
4976
+ <p class="label">Example</p>
4977
+ <p class="example">$vevent->setProperty( &quot;Status&quot;, &quot;COMPLETED&quot; );</p>
4978
+ <br>
4979
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
4980
+
4981
+
4982
+ <a name="SUMMARY"></a><h3>3.2.38 SUMMARY</h3>
4983
+ This property defines a short (&quot;one line&quot;) summary or subject for the <i>calendar</i> component. (In &quot;rfc2445, Recommended Practices&quot;, up to 255 characters) (, analogous to a mail SUBJECT). The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a> and <a href="#VJOURNAL">VJOURNAL</a> components. The property is REQUIRED and MUST occur once in <a href="#VALARM">VALARM</a> (EMAIL) <i>calendar</i> component.<br><br>
4984
+ The value type for SUMMARY is TEXT.
4985
+ <h5>Delete SUMMARY</h5>
4986
+ Remove SUMMARY from component.
4987
+ <p class="label">Format</p>
4988
+ <p class="format">deleteProperty( &quot;SUMMARY&quot; )</p>
4989
+ <p class="label">Example</p>
4990
+ <p class="example">$vevent->deleteProperty( &quot;SUMMARY&quot; );</p>
4991
+ <h5>Get SUMMARY</h5>
4992
+ Fetch property value.
4993
+ <p class="label">Format 1</p>
4994
+ <p class="format">getProperty( &quot;SUMMARY&quot; )</p>
4995
+ <p class="comment">output = summary<span class="ref">1</span></p>
4996
+ <p class="label">Format 2</p>
4997
+ <p class="format">getProperty( &quot;SUMMARY&quot;, FALSE , TRUE )</p>
4998
+ <p class="comment">output = array( &quot;value&quot; =&gt; summary<span class="ref">1</span>
4999
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
5000
+ <p class="label">Example</p>
5001
+ <p class="example">$summary = $vtodo->getProperty( &quot;SUMMARY&quot; );</p>
5002
+ <h5>Set SUMMARY</h5>
5003
+ Insert property value.
5004
+ <br>
5005
+ Parameters, if any, will be ordered as prescribed in rcf2445.
5006
+ <p class="label">Format</p>
5007
+ <p class="format">setProperty( &quot;summary&quot;, summary [, params ] )</p>
5008
+ <p CLASS="comment">summary<span class="ref">1</span> = Value type TEXT,
5009
+ a short, one line summary about the activity or journal entry.
5010
+ params<span class="ref">2</span> = array( [&quot;ALTREP&quot; =&gt; &quot;&lt;an alternate text representation, URI&gt;&quot;]
5011
+ [, &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;]
5012
+ [, xparam ] )
5013
+ xparam = *[ xparamkey =&gt; xparamvalue ]</p>
5014
+ <p class="label">Example</p>
5015
+ <p class="example">$vevent->setProperty( &quot;summary&quot;, &quot;This is a summary&quot; );</p>
5016
+ <br>
5017
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5018
+
5019
+
5020
+ <a name="TRANSP"></a><h3>3.2.39 TRANSP</h3>
5021
+ This property defines whether an <a href="#VEVENT">EVENT</a> is transparent or not to busy time searches and is OPTIONAL and MUST NOT occur more than once.
5022
+ <h5>Delete TRANSP</h5>
5023
+ Remove TRANSP from component.
5024
+ <p class="label">Format</p>
5025
+ <p class="format">deleteProperty( &quot;TRANSP&quot; )</p>
5026
+ <p class="label">Example</p>
5027
+ <p class="example">$vevent->deleteProperty( &quot;TRANSP&quot; );</p>
5028
+ <h5>Get TRANSP</h5>
5029
+ Fetch property value.
5030
+ <p class="label">Format 1</p>
5031
+ <p class="format">getProperty( &quot;TRANSP&quot; )</p>
5032
+ <p class="comment">output = transp<span class="ref">1</span></p>
5033
+ <p class="label">Format 2</p>
5034
+ <p class="format">getProperty( &quot;TRANSP&quot;, FALSE , TRUE )</p>
5035
+ <p class="comment">output = array( &quot;value&quot; =&gt; transp<span class="ref">1</span>
5036
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5037
+ <p class="label">Example</p>
5038
+ <p class="example">$transp = $vtodo->getProperty( &quot;TRANSP&quot; );</p>
5039
+ <h5>Set TRANSP</h5>
5040
+ Insert property value.
5041
+ <p class="label">Format</p>
5042
+ <p class="format">setProperty( &quot;transp&quot;, transp [, xparam ] )</p>
5043
+ <p class="comment">transp<span class="ref">1</span> = &quot;OPAQUE&quot; / &quot;TRANSPARENT&quot;
5044
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
5045
+ <p class="label">Example</p>
5046
+ <p class="example">$vevent->setProperty( &quot;transp&quot;, &quot;TRANSPARENT&quot; );</p>
5047
+ <br>
5048
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5049
+
5050
+
5051
+ <a name="TRIGGER"></a><h3>3.2.40 TRIGGER</h3>
5052
+ This property specifies when an <a href="#VALARM">ALARM</a> will trigger and is REQUIRED and MUST NOT occur more than once.<br><br>
5053
+ The default value type is DURATION. The value type can be set to a DATE-TIME value type, in which case the value MUST specify an <a href="#DATE_WITH_UTC_TIME">UTC</a> formatted DATE-TIME value.
5054
+ <h5>Delete TRIGGER</h5>
5055
+ Remove TRIGGER from component.
5056
+ <p class="label">Format</p>
5057
+ <p class="format">deleteProperty( &quot;TRIGGER&quot; )</p>
5058
+ <p class="label">Example</p>
5059
+ <p class="example">$valarm->deleteProperty( &quot;TRIGGER&quot; );</p>
5060
+ <h5>Get TRIGGER</h5>
5061
+ Fetch property value.
5062
+ <p class="label">Format 1</p>
5063
+ <p class="format">getProperty( &quot;TRIGGER&quot; )</p>
5064
+ <p class="comment">output = duration/date</p>
5065
+ <p class="label">Format 2</p>
5066
+ <p class="format">getProperty( &quot;TRIGGER&quot;, FALSE , TRUE )</p>
5067
+ <p class="comment">output = array( &quot;value&quot; =&gt; duration<span class="ref">1</span>/date<span class="ref">3</span> )
5068
+ , &quot;params&quot; =&gt; params<span class="ref">4</span> )
5069
+ <p class="label">Example</p>
5070
+ <p class="example">$trigger = $vtodo->getProperty( &quot;TRIGGER&quot; );</p>
5071
+ <h5>Set TRIGGER</h5>
5072
+ Insert property value.<br>
5073
+ Note, use function <a href="#transformDateTime">transformDateTime</a>
5074
+ to change a datetime (in a local time zone) to UTC time zone.
5075
+ <p class="label">Format 1</p>
5076
+ <p class="format">setProperty( &quot;trigger&quot;, duration<span class="ref">1</span> [, params<span class="ref">4</span> ] )</p>
5077
+ <p class="label">Format 2</p>
5078
+ <p class="format">setProperty( &quot;trigger&quot;, duration<span class="ref">2</span> [, params<span class="ref">4</span> ] )</p>
5079
+ <p class="label">Format 3</p>
5080
+ <p class="format">setProperty( &quot;trigger&quot;, date<span class="ref">3</span> [, params<span class="ref">4</span> ] )</p>
5081
+ <p class="label">Format</p>
5082
+ <p class="format">setProperty( &quot;trigger&quot;, int year/FALSE
5083
+ , int month/FALSE
5084
+ , int day/FALSE
5085
+ [, int week/FALSE
5086
+ [, int hour/FALSE
5087
+ , int min/FALSE
5088
+ , int sec/FALSE
5089
+ [, bool relatedStart=TRUE
5090
+ [, bool before=TRUE
5091
+ [, array params<span class="ref">4</span> ]]]]] )</p>
5092
+ <p class="comment">duration<span class="ref">1</span> = array( &quot;week&quot; =&gt; int week
5093
+ , &quot;relatedStart&quot; =&gt; bool relstart
5094
+ , &quot;before&quot; =&gt; bool before )
5095
+ duration<span class="ref">1</span> = array( &quot;day&quot; =&gt; int day
5096
+ , &quot;hour&quot; =&gt; int hour
5097
+ , &quot;min&quot; =&gt; int min
5098
+ , &quot;sec&quot; =&gt; int sec
5099
+ , &quot;relatedStart&quot; =&gt; bool relstart
5100
+ , &quot;before&quot; =&gt; bool before )
5101
+ relatedStart = TRUE : related start (default),
5102
+ FALSE : related end
5103
+ before = TRUE : before relatedStart (default),
5104
+ FALSE : after relatedStart
5105
+ duration<span class="ref">2</span> = string dur-value = ([&quot;+&quot;]/&quot;-&quot;)&quot;P&quot;(dur-date/dur-time/dur-week)
5106
+ dur-date = dur-day [dur-time]
5107
+ dur-time = &quot;T&quot; (dur-hour / dur-minute / dur-second)
5108
+ dur-week = 1*DIGIT &quot;W&quot;
5109
+ dur-day = 1*DIGIT &quot;D&quot;
5110
+ dur-hour = 1*DIGIT &quot;H&quot; [dur-minute]
5111
+ dur-minute = 1*DIGIT &quot;M&quot; [dur-second]
5112
+ dur-second = 1*DIGIT &quot;S&quot;
5113
+ date<span class="ref">3</span> = array( &quot;year&quot; =&gt; int year // <span class="ref"><a href="#DATE_WITH_UTC_TIME">UTC</a> DATE-TIME</span>
5114
+ , &quot;month&quot; =&gt; int month
5115
+ , &quot;day&quot; =&gt; int day
5116
+ [, &quot;hour&quot; =&gt; int hour
5117
+ , &quot;min&quot; =&gt; int min
5118
+ , &quot;sec&quot; =&gt; int sec ])
5119
+ date<span class="ref">3</span> = array ( &quot;timestamp&quot; =&gt; int timestamp ) // <span class="ref"><a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a>DATE-TIME</span>
5120
+ date<span class="ref">3</span> = string datestring // <span class="ref">string date,
5121
+ acceptable by strtotime function,
5122
+ ex.&nbsp;&quot;14 august 2006 16.00.00&quot;
5123
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
5124
+ // <span class="ref"><a class="ref" href="#DATE_WITH_UTC_TIME">UTC</a>DATE-TIME</span>
5125
+ params<span class="ref">4</span> = array( [[ reltype [, trigRelparam ]] / datetimeparam ]
5126
+ [, xparams ] )
5127
+ reltyp = &quot;RELATED&quot; =&gt; &quot;START&quot; (default) / &quot;END&quot;
5128
+ trigRelparam = &quot;VALUE&quot; =&gt; &quot;DURATION&quot;
5129
+ datetimeparam= &quot;VALUE&quot; =&gt; &quot;DATE-TIME&quot;
5130
+ xparam = *[ xparamkey =&gt; xparamvalue ]</p>
5131
+ <p class="label">Example 1</p>
5132
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5133
+ , FALSE, FALSE, FALSE, FALSE, 1, 2, 3 );
5134
+ <span class="comment">// duration, 1 hour 2 min 3 sec, before start</span></p>
5135
+ <p class="label">Example 2</p>
5136
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5137
+ , array (&quot;hour&quot;=&gt;1,&quot;min&quot;=&gt;2,&quot;sec&quot;=&gt;3 );
5138
+ <span class="comment">// duration, 1 hour 2 min 3 sec, before start</span></p>
5139
+ <p class="label">Example 3</p>
5140
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5141
+ , &quot;PT1H2M3S&quot; );
5142
+ <span class="comment">// duration, 1 hour 2 min 3 sec, before start</span></p>
5143
+ <p class="label">Example 4</p>
5144
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5145
+ , FALSE, FALSE, FALSE, 1
5146
+ , FALSE, FALSE, FALSE, FALSE, FALSE );
5147
+ <span class="comment">// duration, 1 week after end</span></p>
5148
+ <p class="label">Example 5</p>
5149
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5150
+ , array ( &quot;week&quot; =&gt; 1
5151
+ , &quot;relatedStart&quot; =&gt; FALSE
5152
+ , &quot;before&quot; =&gt; FALSE ));
5153
+ <span class="comment">// duration, 1 week after end</span></p>
5154
+ <p class="label">Example 6</p>
5155
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5156
+ , &quot;P1W&quot;
5157
+ , array( &quot;related&quot; =&gt; &quot;END&quot; ));
5158
+ <span class="comment">// duration, 1 week after end</span></p>
5159
+ <p class="label">Example 7</p>
5160
+ <p class="example">$valarm->setProperty( &quot;trigger&quot;
5161
+ , array( &quot;year&quot; =&gt; 2007
5162
+ , &quot;month&quot; =&gt; 6
5163
+ , &quot;day&quot; =&gt; 5,
5164
+ , &quot;hour&quot; =&gt; 2
5165
+ , &quot;min&quot; =&gt; 2
5166
+ , &quot;sec&quot; =&gt; 3 ));</p>
5167
+ <br>
5168
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5169
+
5170
+
5171
+ <a name="TZID"></a><h3>3.2.41 TZID</h3>
5172
+ This property specifies the text value that uniquely identifies the <a href="#VTIMEZONE">VTIMEZONE</a> <i>calendar</i> component and is REQUIRED, but MUST NOT occur more than once. <br><br>
5173
+ The value type for TZID is TEXT.
5174
+ <h5>Delete TZID</h5>
5175
+ Remove TZID from component.
5176
+ <p class="label">Format</p>
5177
+ <p class="format">deleteProperty( &quot;TZID&quot; )</p>
5178
+ <p class="label">Example</p>
5179
+ <p class="example">$vtimezone->deleteProperty( &quot;TZID&quot; );</p>
5180
+ <h5>Get TZID</h5>
5181
+ Fetch property value.
5182
+ <p class="label">Format 1</p>
5183
+ <p class="format">getProperty( &quot;TZID&quot; )</p>
5184
+ <p class="comment">output = tzid<span class="ref">1</span></p>
5185
+ <p class="label">Format 2</p>
5186
+ <p class="format">getProperty( &quot;TZID&quot;, FALSE , TRUE )</p>
5187
+ <p class="comment">output = array( &quot;value&quot; =&gt; tzid<span class="ref">1</span>
5188
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5189
+ <p class="label">Example</p>
5190
+ <p class="example">$tzid = $vtimezone->getProperty( &quot;TZID&quot; );</p>
5191
+ <h5>Set TZID</h5>
5192
+ Insert property value.
5193
+ <p class="label">Format</p>
5194
+ <p class="format">setProperty( &quot;tzid&quot;, tzid [, xparam ] )</p>
5195
+ <p class="comment">tzid<span class="ref">1</span> = Value type TEXT
5196
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
5197
+ <p class="label">Example</p>
5198
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5199
+ $vcalendar = new vcalendar( $config );
5200
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
5201
+ $vtimezone->setProperty( &quot;tzid&quot;, &quot;US-Eastern&quot; );
5202
+ .. .</p>
5203
+ <br>
5204
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5205
+
5206
+
5207
+ <a name="TZNAME"></a><h3>3.2.42 TZNAME</h3>
5208
+ This property specifies the customary designation for a <a href="#VTIMEZONE">STANDARD</a> or <a href="#VTIMEZONE">DAYLIGHT</a> description and is OPTIONAL and MAY occur more than once.<br><br>
5209
+ The value type for TZNAME is TEXT.
5210
+ <h5>Delete TZNAME</h5>
5211
+ Remove TZNAME from component.
5212
+ <p class="label">Format</p>
5213
+ <p class="format">deleteProperty( &quot;TZNAME&quot; )</p>
5214
+ <p class="label">Example 1</p>
5215
+ <p class="example">$vtimezonestd->deleteProperty( &quot;TZNAME&quot; );</p>
5216
+ <p class="label">Example 2</p>
5217
+ Delete TZNAME property no 2.
5218
+ <p class="example">$vtimezonestd->deleteProperty( &quot;TZNAME&quot;, 2 );</p>
5219
+ <p class="label">Example 3</p>
5220
+ Deleting all TZNAME properties.
5221
+ <p class="example">while( $vtimezonestd->deleteProperty( &quot;TZNAME&quot; ))
5222
+ continue;</p>
5223
+ <h5>Get TZNAME</h5>
5224
+ Fetch property value.
5225
+ <p class="label">Format 1</p>
5226
+ <p class="format">getProperty( &quot;TZNAME&quot; )</p>
5227
+ <p class="comment">output = tzname<span class="ref">1</span></p>
5228
+ <p class="label">Format 2</p>
5229
+ <p class="format">getProperty( &quot;TZNAME&quot;, propOrderNo/FALSE, TRUE )</p>
5230
+ <p class="comment">output = array( &quot;value&quot; =&gt; tzname<span class="ref">1</span>
5231
+ , &quot;params&quot; =&gt; params<span class="ref">2</span> )</p>
5232
+ <p class="label">Format 3</p>
5233
+ <p class="format">getProperty( &quot;TZNAME&quot;, propOrderNo )</p>
5234
+ <p class="comment">Get propOrderNo TZNAME</p>
5235
+ <p class="label">Example</p>
5236
+ <p class="example">$tzname = $timezonestandard->getProperty( &quot;TZNAME&quot; );</p>
5237
+ <h5>Set TZNAME</h5>
5238
+ Insert property value.
5239
+ <p class="label">Format</p>
5240
+ <p class="format">setProperty( &quot;tzname&quot;, tzname [, params [, propOrderNo ]] )</p>
5241
+ <p class="comment">tzname<span class="ref">1</span> = Value type TEXT
5242
+ params<span class="ref">2</span> = array( [ &quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot; ] [, xparam ] )
5243
+ xparam = *[ xparamkey =&gt; xparamvalue ]
5244
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
5245
+ <p class="label">Example</p>
5246
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5247
+ $vcalendar = new vcalendar( $config );
5248
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
5249
+ $vtimezone->setProperty( &quot;Tzid&quot;, &quot;US-Eastern&quot; );
5250
+ $vtimezone->setProperty( &quot;Last-Modified&quot;, &quot;19870101&quot; );
5251
+ $standard = &amp; $vtimezone->newComponent( &quot;standard&quot; );
5252
+ $standard->setProperty( &quot;tzname&quot;, &quot;EST&quot; );
5253
+ .. .</p>
5254
+ <br>
5255
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5256
+
5257
+
5258
+ <a name="TZOFFSETFROM"></a><h3>3.2.43 TZOFFSETFROM</h3>
5259
+ This property specifies the offset which is in use prior to this <a href="#VTIMEZONE">TIMEZONE</a> observance.
5260
+ The property is REQUIRED, but MUST NOT occur more than once in <a href="#VTIMEZONE">STANDARD</a> and <a href="#VTIMEZONE">DAYLIGHT</a> components.
5261
+ <h5>Delete TZOFFSETFROM</h5>
5262
+ Remove TZOFFSETFROM from component.
5263
+ <p class="label">Format</p>
5264
+ <p class="format">deleteProperty( &quot;TZOFFSETFROM&quot; )</p>
5265
+ <p class="label">Example</p>
5266
+ <p class="example">$vtimezonestd->deleteProperty( &quot;TZOFFSETFROM&quot; );</p>
5267
+ <h5>Get TZOFFSETFROM</h5>
5268
+ Fetch property value.
5269
+ <p class="label">Format 1</p>
5270
+ <p class="format">getProperty( &quot;TZOFFSETFROM&quot; )</p>
5271
+ <p class="comment">output = tzoffsetfrom<span class="ref">1</span></p>
5272
+ <p class="label">Format 2</p>
5273
+ <p class="format">getProperty( &quot;TZOFFSETFROM&quot;, FALSE , TRUE )</p>
5274
+ <p class="comment">output = array( &quot;value&quot; =&gt; tzoffsetfrom<span class="ref">1</span>
5275
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5276
+ <p class="label">Example</p>
5277
+ <p class="example">$tzoffsetfrom = $timezonestandard->getProperty( &quot;TZOFFSETFROM&quot; );</p>
5278
+ <h5>Set TZOFFSETFROM</h5>
5279
+ Insert property value.
5280
+ <p class="label">Format</p>
5281
+ <p class="format">setProperty( &quot;tzoffsetfrom&quot;, tzoffsetfrom [, xparam ] )</p>
5282
+ <p class="comment">tzoffsetfrom<span class="ref">1</span> = (+/-)HHmm[ss], UTC offset
5283
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
5284
+ <p class="label">Example</p>
5285
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5286
+ $vcalendar = new vcalendar( $config );
5287
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
5288
+ $vtimezone->setProperty( &quot;Tzid&quot;, &quot;US-Eastern&quot; );
5289
+ $vtimezone->setProperty( &quot;Last-Modified&quot;, &quot;19870101&quot; );
5290
+ $standard = &amp; $vtimezone->newComponent( &quot;standard&quot; );
5291
+ $standard->setProperty( &quot;tzname&quot;, &quot;EST&quot; );
5292
+ $standard->setProperty( &quot;tzoffsetfrom&quot;, &quot;-0500&quot; );
5293
+ .. .</p>
5294
+ <br>
5295
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5296
+
5297
+
5298
+ <a name="TZOFFSETTO"></a><h3>3.2.44 TZOFFSETTO</h3>
5299
+ This property specifies the offset which is in use in this <a href="#VTIMEZONE">TIMEZONE</a> observance.
5300
+ The property is REQUIRED, but MUST NOT occur more than once in <a href="#VTIMEZONE">STANDARD</a> and <a href="#VTIMEZONE">DAYLIGHT</a> components.
5301
+ <h5>Delete TZOFFSETTO</h5>
5302
+ Remove TZOFFSETTO from component.
5303
+ <p class="label">Format</p>
5304
+ <p class="format">deleteProperty( &quot;TZOFFSETTO&quot; )</p>
5305
+ <p class="label">Example</p>
5306
+ <p class="example">$daylight->deleteProperty( &quot;TZOFFSETTO&quot; );</p>
5307
+ <h5>Get TZOFFSETTO</h5>
5308
+ Fetch property value.
5309
+ <p class="label">Format 1</p>
5310
+ <p class="format">getProperty( &quot;TZOFFSETTO&quot; )</p>
5311
+ <p class="comment">output = tzoffsetto<span class="ref">1</span></p>
5312
+ <p class="label">Format 2</p>
5313
+ <p class="format">getProperty( &quot;TZOFFSETTO&quot;, FALSE , TRUE )</p>
5314
+ <p class="comment">output = array( &quot;value&quot; =&gt; tzoffsetto<span class="ref">1</span>
5315
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5316
+ <p class="label">Example</p>
5317
+ <p class="example">$tzoffsetto = $timezonestandard->getProperty( &quot;TZOFFSETTO&quot; );</p>
5318
+ <h5>Set TZOFFSETTO</h5>
5319
+ Insert property value.
5320
+ <p class="label">Format</p>
5321
+ <p class="format">setProperty( &quot;tzoffsetto&quot;, tzoffsetto [, xparam ] )</p>
5322
+ <p class="comment">tzoffsetto<span class="ref">1</span> = (+/-)HHmm[ss], UTC offset
5323
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
5324
+ <p class="label">Example</p>
5325
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5326
+ $vcalendar = new vcalendar( $config );
5327
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
5328
+ $vtimezone->setProperty( &quot;Tzid&quot;, &quot;US-Eastern&quot; );
5329
+ $vtimezone->setProperty( &quot;Last-Modified&quot;, &quot;19870101&quot; );
5330
+ $standard = &amp; $vtimezone->newComponent( &quot;standard&quot; );
5331
+ .. .
5332
+ $daylight = &amp; $vtimezone->newComponent( &quot;daylight&quot; );
5333
+ $daylight->setProperty( &quot;tzoffsetto&quot;, &quot;1345&quot; );
5334
+ .. .</p>
5335
+ <br>
5336
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5337
+
5338
+
5339
+ <a name="TZURL"></a><h3>3.2.45 TZURL</h3>
5340
+ The TZURL provides a means for a <a href="#VTIMEZONE">VTIMEZONE</a> component to point to
5341
+ a network location that can be used to retrieve an up-to-date version of itself. The property
5342
+ is OPTIONAL and MUST NOT occur more than once.
5343
+ <h5>Delete TZURL</h5>
5344
+ Remove TZURL from component.
5345
+ <p class="label">Format</p>
5346
+ <p class="format">deleteProperty( &quot;TZURL&quot; )</p>
5347
+ <p class="label">Example</p>
5348
+ <p class="example">$vtimezone->deleteProperty( &quot;TZURL&quot; );</p>
5349
+ <h5>Get TZURL</h5>
5350
+ Fetch property value.
5351
+ <p class="label">Format 1</p>
5352
+ <p class="format">getProperty( &quot;TZURL&quot; )</p>
5353
+ <p class="comment">output = tzurl<span class="ref">1</span></p>
5354
+ <p class="label">Format 2</p>
5355
+ <p class="format">getProperty( &quot;TZURL&quot;, FALSE , TRUE )</p>
5356
+ <p class="comment">output = array( &quot;value&quot; =&gt; tzurl<span class="ref">1</span>
5357
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5358
+ <p class="label">Example</p>
5359
+ <p class="example">$tzurl = $timezonestandard->getProperty( &quot;TZURL&quot; );</p>
5360
+ <h5>Set TZURL</h5>
5361
+ Insert property value.
5362
+ <p class="label">Format</p>
5363
+ <p class="format">setProperty( &quot;tzurl&quot;, tzurl [, xparam ] )</p>
5364
+ <p class="comment">tzurl<span class="ref">1</span> = Value type URI
5365
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
5366
+ <p class="label">Example</p>
5367
+ <p class="example">$tz = &quot;http://zones.stds_r_us.net/tz/US-Eastern&quot; );
5368
+ $config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5369
+ $vcalendar = new vcalendar( $config );
5370
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
5371
+ $vtimezone->setProperty( &quot;Tzid&quot;, &quot;US-Eastern&quot; );
5372
+ $vtimezone->setProperty( &quot;Last-Modified&quot;, &quot;19870101T000000&quot; );
5373
+ $vtimezone->setProperty( &quot;tzurl&quot;, $tz );
5374
+ .. .
5375
+ .. .</p>
5376
+ <br>
5377
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5378
+
5379
+
5380
+ <a name="UID"></a><h3>3.2.46 UID</h3>
5381
+ The persistent, globally <b>U</b>nique <b>ID</b>entifier for the <i>calendar</i> component.
5382
+ The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components.<br>
5383
+ However, UID is <b>AUTOMATICALLY</b> generated in iCalcreator and configuration <a href="#Unique_id">unique_id</a>, is used when auto-creating component UID.
5384
+ <br>
5385
+ <br>
5386
+ UID generated format :
5387
+ <p class="format">date(&quot;Ymd\THisT&quot;).&quot;-&quot;.[microSec][random].&quot;@&quot;.<a href="#Unique_id">unique_id</a>
5388
+ </p>
5389
+ microSec = microseconds, 4 pos<br>
5390
+ random = 6 characters aA-zZ, 0-9
5391
+ <p class="label">Example</p>
5392
+ <p class="example">&quot;20070803T194810CEST-0123U3PXiX@kigkonsult.se&quot;</p>
5393
+ UID may be required when importing iCal files into some calendaring software (MS etc.),
5394
+ as well as (<i>calendar</i>) properties <a href="#X-PROPERTY">x-properties</a> "X-WR-CALNAME", "X-WR-CALDESC" and "X-WR-TIMEZONE",
5395
+ <a href="#METHOD">METHOD</a> (value PUBLISH etc.) and the (also automatically created) <a href="#DTSTAMP">DTSTAMP</a> property.
5396
+ <br><br>
5397
+ The value type for UID is TEXT.
5398
+ <h5>Delete UID</h5>
5399
+ If UID is remove from a component, UID will automatically be recreated when <i>calendar</i> output functions like <a href="#createCalendar">createCalendar</a>, <a href="#returnCalendar">returnCalendar</a> or <a href="#saveCalendar">saveCalendar</a> is executed.
5400
+ <p class="label">Format</p>
5401
+ <p class="format">deleteProperty( &quot;UID&quot; )</p>
5402
+ <p class="label">Example</p>
5403
+ <p class="example">$vevent->deleteProperty( &quot;UID&quot; );</p>
5404
+ <h5>Get UID</h5>
5405
+ Fetch property value.
5406
+ <p class="label">Format 1</p>
5407
+ <p class="format">getProperty( &quot;UID&quot; )</p>
5408
+ <p class="comment">output = uid<span class="ref">1</span></p>
5409
+ <p class="label">Format 2</p>
5410
+ <p class="format">getProperty( &quot;UID&quot;, FALSE , TRUE )</p>
5411
+ <p class="comment">output = array( &quot;value&quot; =&gt; uid<span class="ref">1</span>
5412
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5413
+ <p class="label">Example</p>
5414
+ <p class="example">$uid = $vevent->getProperty( &quot;UID&quot; );</p>
5415
+ <h5>Set UID</h5>
5416
+ Insert property value, overrides any previously set or auto-created UID.<br>
5417
+ Do <b>NOT</b> use an integer UID or only a component name in UID (ex. &quot;vevent&quot;), this may cause malfunction in <a href="#setComponent">setComponent</a> with index or UID argument.
5418
+ <p class="label">Format</p>
5419
+ <p class="format">setProperty( &quot;uid&quot;, uid [, xparam ] )</p>
5420
+ <p class="comment">uid<span class="ref">1</span> = Value type TEXT
5421
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] )</p>
5422
+ <p class="label">Example</p>
5423
+ <p class="example">$vevent->setProperty(&quot;uid&quot;,&quot;20070803T194810CEST-0123U3PXiX@kigkonsult.se&quot;);</p>
5424
+ <br>
5425
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5426
+
5427
+
5428
+ <a name="URL"></a><h3>3.2.47 URL</h3>
5429
+ This property defines a Uniform Resource Locator (URL) associated with the iCalendar object.
5430
+ The property is OPTIONAL and MUST NOT occur more than once in <a href="#VEVENT">VEVENT</a>, <a href="#VTODO">VTODO</a>, <a href="#VJOURNAL">VJOURNAL</a> and <a href="#VFREEBUSY">VFREEBUSY</a> components.
5431
+ <h5>Delete URL</h5>
5432
+ Remove URL from component.
5433
+ <p class="label">Format</p>
5434
+ <p class="format">deleteProperty( &quot;URL&quot; )</p>
5435
+ <p class="label">Example</p>
5436
+ <p class="example">$vevent->deleteProperty( &quot;URL&quot; );</p>
5437
+ <h5>Get URL</h5>
5438
+ Fetch property value.
5439
+ <p class="label">Format 1</p>
5440
+ <p class="format">getProperty( &quot;URL&quot; )</p>
5441
+ <p class="comment">output = url<span class="ref">1</span></p>
5442
+ <p class="label">Format 2</p>
5443
+ <p class="format">getProperty( &quot;URL&quot;, FALSE , TRUE )</p>
5444
+ <p class="comment">output = array &quot;value&quot; =&gt; url<span class="ref">1</span>
5445
+ , &quot;params&quot; =&gt; xparam<span class="ref">2</span> )</p>
5446
+ <p class="label">Example</p>
5447
+ <p class="example">$url = $vevent->getProperty( &quot;URL&quot; );</p>
5448
+ <h5>Set URL</h5>
5449
+ Insert property value.<br>
5450
+ <p class="label">Format</p>
5451
+ <p class="format">setProperty( &quot;url&quot;, url [, xparam ] )</p>
5452
+ <p class="comment">url<span class="ref">1</span> = Value type URI
5453
+ xparam<span class="ref">2</span> = array( *[ xparamkey =&gt; xparamvalue ] (</p>
5454
+ <p class="label">Example</p>
5455
+ <p class="example">$vtodo->setProperty( &quot;url&quot;, &quot;http://www.icaldomain.net&quot; );</p>
5456
+ <br>
5457
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5458
+
5459
+
5460
+ <a name="X-PROPERTY_PROP"></a><h3>3.2.48 X-PROPERTY</h3>
5461
+ A component, non-standard property with a TEXT value and a name with an &quot;X-&quot; prefix. In a component,
5462
+ an x-property, with an unique name, can occur only once but the number of x-properties are unlimited.
5463
+ <br>
5464
+ <h5>Delete X-PROPERTY</h5>
5465
+ Remove X-PROPERTY from component.
5466
+ <p class="label">Format</p>
5467
+ <p class="format">deleteProperty( &quot;&lt;X-PROPERTY&gt;&quot; )</p>
5468
+ <p class="label">Example 1</p>
5469
+ <p class="example">$vevent->deleteProperty( &quot;&lt;X-PROPERTY&gt;&quot; );</p>
5470
+ <p class="label">Example 2</p>
5471
+ Deleting all x-properties.
5472
+ <p class="example">while( $vevent->deleteProperty())
5473
+ continue;</p>
5474
+ <h5>Get X-property</h5>
5475
+ Fetch property value.
5476
+ <p class="label">Format 1</p>
5477
+ <p class="format">getProperty( &quot;&lt;X-PROPERTY&gt;&quot; )</p>
5478
+ <p class="comment">output = array( propertyName<span class="ref">1</span>
5479
+ , propertyData<span class="ref">2</span> )</p>
5480
+ <p class="label">Format 2</p>
5481
+ <p class="format">getProperty()</p>
5482
+ <p class="comment">output = array( propertyName<span class="ref">1</span>
5483
+ , propertyData<span class="ref">2</span> )</p>
5484
+ <p class="label">Format 3</p>
5485
+ <p class="format">getProperty( FALSE, propOrderNo/FALSE, TRUE )</p>
5486
+ <p class="comment">output = array( propertyName<span class="ref">1</span>
5487
+ , array ( &quot;value&quot; =&gt; propertyData<span class="ref">2</span> )
5488
+ , &quot;params&quot; =&gt; params<span class="ref">&nbsp;3</span>))</p>
5489
+ <p class="label">Format 4</p>
5490
+ <p class="format">getProperty( FALSE, propOrderNo )</p>
5491
+ <p class="comment">Get propOrderNo X-property</p>
5492
+
5493
+ <p class="label">Example 1</p>
5494
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5495
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5496
+ $vcalendar = new vcalendar( $config );
5497
+ $vcalendar->parse();
5498
+ if( FALSE !== ( $d = $vcalendar->getProperty( &quot;X-WR-TIMEZONE&quot; )))
5499
+ echo $d[1];
5500
+ .. .</p>
5501
+ <p class="comment"> // $xprop = array( propertyName<span class="ref">1</span>, propertyData<span class="ref">2</span> )</p>
5502
+
5503
+ <p class="label">Example 2</p>
5504
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5505
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5506
+ $vcalendar = new vcalendar( $config );
5507
+ $vcalendar->parse();
5508
+ while( $xprop = $vcalendar->getProperty( )) {
5509
+ .. .</p>
5510
+ <p class="comment"> // $xprop = array( propertyName<span class="ref">1</span>, propertyData<span class="ref">2</span> )</p>
5511
+
5512
+ <p class="label">Example 3</p>
5513
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5514
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5515
+ $vcalendar = new vcalendar( $config );
5516
+ $vcalendar->parse();
5517
+ while( $xprop = $vcalendar->getProperty( &quot;X-ABC-MMSUBJ&quot; )) {
5518
+ .. .</p>
5519
+ <p class="comment"> // $xprop = array( &quot;X-ABC-MMSUBJ&quot;, propertyData<span class="ref">2</span> )</p>
5520
+ <p class="label">Example 4</p>
5521
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5522
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5523
+ $vcalendar = new vcalendar( $config );
5524
+ $vcalendar->parse();
5525
+ while( $xprop = $vcalendar->getProperty( FALSE, FALSE, TRUE )) {
5526
+ .. .</p>
5527
+ <p class="comment"> // $xprop = array( propertyName<span class="ref">1</span>
5528
+ // , array( &quot;value&quot; =&gt; propertyData<span class="ref">2</span> )
5529
+ // , &quot;params&quot; =&gt; params<span class="ref">&nbsp;3</span> )</p>
5530
+ <h5>Set X-property</h5>
5531
+ Insert property name and value. If an x-prop with the same name already exists, it will be replaced.
5532
+ <p class="label">Format</p>
5533
+ <p class="format">setProperty( propertyName, propertyData [, params ] )</p>
5534
+ <p class="comment">propertyName<span class="ref">1</span> = Any property name with a &quot;X-&quot; prefix
5535
+ propertyData<span class="ref">2</span> = Value type TEXT
5536
+ params<span class="ref">3</span> = array( [&quot;LANGUAGE&quot; =&gt; &quot;&lt;lang&gt;&quot;] [, xparam] )
5537
+ xparam = *[ xparamkey =&gt; xparamvalue ]
5538
+ propOrderNo = int ordernumber, 1=1st, 2=2nd etc</p>
5539
+ <p class="label">Example</p>
5540
+ <p class="example">$component->setProperty(&quot;X-ABC-MMSUBJ&quot;,&quot;http://load.noise.org/mysubj.wav&quot;);</p>
5541
+ <br>
5542
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_object_property_function_list">[up]</a>
5543
+
5544
+
5545
+
5546
+ <a NAME="Calendar_component_configuration_functions"></a><h2>3.3 Calendar Component configuration functions</h2>
5547
+
5548
+ <a name="Language_PROP"></a><h3>3.3.1 Language</h3>
5549
+ Language for specific <i>calendar</i> component as defined in [RFC 1766].<br>
5550
+ Language set at component level can be overridden by specific component property parameter.<br>
5551
+ A successful &quot;setConfig&quot; returns TRUE.
5552
+ <h5>Get language</h5>
5553
+ Language for <i>calendar</i> (only if language is set at component level).
5554
+ <p class="label">Format</p>
5555
+ <p class="format">getConfig( &quot;language&quot; )</p>
5556
+ <p class="label">Example</p>
5557
+ <p class="example">$lang = $vevent->getConfig( &quot;language&quot; );</p>
5558
+ <h5>Set LANGUAGE</h5>
5559
+ <p class="label">Format</p>
5560
+ <p class="format">setConfig( &quot;language&quot;, string &lt;lang&gt; )</p>
5561
+ <p class="label">Example</p>
5562
+ <p class="example">$vevent->setConfig( &quot;language&quot;, &quot;en&quot; );</p>
5563
+ <br>
5564
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_configuration_functions">[up]</a>
5565
+
5566
+ <a name="Calendar_component_object_misc_functions"></a><h2>3.4 Calendar component object misc. functions</h2>
5567
+ Calendar component subcomponent functions
5568
+
5569
+ <a name="deleteComponent_PROP"></a><h4>3.4.1 deleteComponent</h4>
5570
+ Remove subcomponent from component.
5571
+ <p class="label">Format</p>
5572
+ <p class="format">deleteComponent( int orderNumber )</p>
5573
+ <p class="comment">Remove component with order number (1st=1, 2nd=2.. .).</p>
5574
+ <p class="format">deleteComponent( string componentType [, int componentSuborderNumber])</p>
5575
+ <p class="comment">Remove component with component type (ex. &quot;vevent&quot;)
5576
+ and order 1 alt. suborder number.</p>
5577
+ <p class="format">deleteComponent( string <a href="#UID">UID</a> )</p>
5578
+ <p class="comment">Remove component with <a href="#UID">UID</a>.
5579
+ N.B <a href="#UID">UID</a> is NOT set for <a href="#VALARM">ALARM</a> / <a href="#VTIMEZONE">timezone</a> components.</p>
5580
+ <p class="label">Example 1</p>
5581
+ Delete first subcomponent.
5582
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5583
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5584
+ $vcalendar = new vcalendar( $config );
5585
+ $vcalendar->parse();
5586
+ $comp1 = $vcalendar->getComponent();
5587
+ $comp1->deleteComponent( 1 );
5588
+ .. .</p>
5589
+ <p class="label">Example 2</p>
5590
+ Delete all subcomponents.
5591
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5592
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5593
+ $vcalendar = new vcalendar( $config );
5594
+ $vcalendar->parse();
5595
+ $comp1 = $vcalendar->getComponent();
5596
+ while( $comp1->deleteComponent( &quot;valarm&quot; )
5597
+ continue;
5598
+ .. .</p>
5599
+ <br>
5600
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_configuration_functions">[up]</a>
5601
+
5602
+ <a name="getComponent_PROP"></a><h4>3.4.2 getComponent</h4>
5603
+ Get subComponent from component.
5604
+ <p class="label">Format 1</p>
5605
+ <p class="format">getComponent()</p>
5606
+ <p class="comment">Get next component until end-of-components.</p>
5607
+ <p class="label">Format 2</p>
5608
+ <p class="format">getComponent( int orderNumber )</p>
5609
+ <p class="comment">Get component with order number (1st=1, 2nd=2.. .).</p>
5610
+ <p class="label">Format 3</p>
5611
+ <p class="format">getComponent( string componentType [, int componentSuborderNumber])</p>
5612
+ <p class="comment">Get (next) component with component type (until end-of-components)
5613
+ alt. component with component type and suborder number (1st=1, 2nd=2..).</p>
5614
+ <p class="label">Format 4</p>
5615
+ <p class="format">getComponent( string <a href="#UID">UID</a> )</p>
5616
+ <p class="comment">Get component with <a href="#UID">UID</a>.
5617
+ N.B <a href="#UID">UID</a> is NOT set for <a href="#VALARM">ALARM</a> / <a href="#VTIMEZONE">timezone</a> components.</p>
5618
+ <p class="label">Example</p>
5619
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot;,
5620
+ &quot;filename&quot;, &quot;file.ics&quot; ); );
5621
+ $vcalendar = new vcalendar( $config );
5622
+ $vcalendar->parse();
5623
+ $comp1 = $vcalendar->getComponent());
5624
+ while( $subComp = $comp1->getComponent()) {
5625
+ .. .</p>
5626
+ <br>
5627
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_configuration_functions">[up]</a>
5628
+
5629
+ <a name="newComponent_PROP"></a><h4>3.4.3 newComponent</h4>
5630
+ Create subcomponent (<a href="#VALARM">ALARN</a> / <a href="#VTIMEZONE">VTIMEZONE STANDARD</a> / <a href="#VTIMEZONE">VTIMEZONE DAYLIGHT</a>)
5631
+ using a component factory-method, returning a reference to the new component.
5632
+ <p class="label">Format</p>
5633
+ <p class="format">newComponent( string componentType )</p>
5634
+ <p class="label">Example 1</p>
5635
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
5636
+ $vcalendar = new vcalendar( $config );
5637
+ ...
5638
+ $vevent = &amp; $vcalendar->newComponent( &quot;vevent&quot; );
5639
+ $vevent->setProperty( &quot;dtstart&quot; // <span class="ref">add some <a href="#VEVENT">EVENT</a> properties</span>
5640
+ , 2006, 12, 24, 19, 30, 00 );
5641
+ $vevent->setProperty(.. .
5642
+ ...
5643
+ $valarm = &amp; $vevent->newComponent( &quot;valarm&quot; );
5644
+ $valarm->setProperty( &quot;trigger&quot;, .. .
5645
+ ...
5646
+ </p>
5647
+ <p class="label">Example 2</p>
5648
+ <p class="example">$config = array( &quot;unique_id&quot; => &quot;kigkonsult.se&quot; );
5649
+ $vcalendar = new vcalendar( $config );
5650
+ ...
5651
+ $vtimezone = &amp; $vcalendar->newComponent( &quot;vtimezone&quot; );
5652
+ $vtimezone->setProperty(.. .
5653
+ ...
5654
+ $standard = &amp; $vtimezone->newComponent( &quot;standard&quot; );
5655
+ $standard->setProperty(.. .
5656
+ ...
5657
+ $daylight = &amp; $vtimezone->newComponent( &quot;daylight&quot; );
5658
+ $daylight->setProperty(.. .
5659
+ ...
5660
+ </p>
5661
+
5662
+ <br>
5663
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_configuration_functions">[up]</a>
5664
+
5665
+ <a name="setComponent_PROP"></a><h4>3.4.4 setComponent</h4>
5666
+ Add <i>calendar</i> component to <i>calendar</i> or replace/update component in <i>calendar</i>.
5667
+ <p class="label">Format 1</p>
5668
+ <p class="format">setComponent( component )
5669
+ addSubComponent( component ) // <span class="ref">alias</span></p>
5670
+ <p class="comment">Insert last in component chain.</p>
5671
+ <p class="label">Format 2</p>
5672
+ <p class="format">setComponent( component, int orderNumber )</p>
5673
+ <p class="comment">Replace component with order number(1st=1, 2nd=2.. .).
5674
+ If orderNumber is not found, component is inserted last in chain.</p>
5675
+ <p class="label">Format 3</p>
5676
+ <p class="format">setComponent( component, string componentType [,component suborder number])</p>
5677
+ <p class="comment">Replace component with component type and component order number.
5678
+ if orderNumber is not found, component is inserted last in chain. </p>
5679
+ <p class="label">Example</p>
5680
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5681
+ $vcalendar = new vcalendar( $config ); // <span class="ref">initiate new CALENDAR</span>
5682
+ .. .
5683
+ $vevent = new vevent();
5684
+ $vevent->setProperty( &quot;dtstart&quot; // <span class="ref">add some <a href="#VEVENT">EVENT</a> properties</span>
5685
+ , 2006, 12, 24, 19, 30, 00 );
5686
+ $vevent->setProperty(.. .
5687
+ .. .
5688
+ $valarm = new valarm();
5689
+ $valarm->setProperty( &quot;trigger&quot;, .. .
5690
+ .. .
5691
+ $vevent->setComponent( $valarm );
5692
+ $vcalendar->setComponent( $vevent );
5693
+ .. .
5694
+ </p>
5695
+ <br>
5696
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#Calendar_component_configuration_functions">[up]</a>
5697
+
5698
+ <a name="iCalUtilityFunctions"></a><h1>4. iCalUtilityFunctions</h1>
5699
+ iCalUtilityFunctions.class.php contains static functions used by iCalcreator,
5700
+ also usable outside the iCalcreator class. Please examine the class file to explore other functions.
5701
+ <br>
5702
+ <br>
5703
+ <a name="createTimezone"></a><h4>4.1 createTimezone</h4>
5704
+ The function, applied on a iCalcrator instance and using a <i>PHP</i> valid timezone (as arguments)
5705
+ creates simple vtimezone, standard and (opt.) daylight components, based on <i>PHP</i> DateTimeZone class and
5706
+ the most recent transition dates for the timezone.<br>
5707
+ (<i>PHP</i> 5 >= 5.2.0)
5708
+ <br>
5709
+ <br>
5710
+ Note, only when timezone NOT is UTC.
5711
+ For dates with UTC DATE-TIME, read <a href="#DATE_WITH_UTC_TIME">this</a>!
5712
+ <br>
5713
+ <br>
5714
+ FALSE is returned if not using a <i>PHP</i> valid timezone.
5715
+ <p class="label">Format</p>
5716
+ <p class="format">createTimezone( calendar, timezone [, xprops ] )</p>
5717
+ <p class="comment">calendar = iCalcreator instance
5718
+ timezone = an <i>PHP</i> (DateTimeZone) valid timezone
5719
+ xprops = array( *[ x-propName =&gt; value ] ), timezone non-standard properties
5720
+ </p>
5721
+ <p class="label">Example</p>
5722
+ <p class="example">$config = array( &quot;unique_id&quot; =&gt; &quot;kigkonsult.se&quot; );
5723
+ $vcalendar = new vcalendar( $config );
5724
+ .. .
5725
+ $PHPtz = &quot;Europe/Stockholm&quot;;
5726
+ $xprops = array( &quot;X-LIC-LOCATION&quot; => $PHPtz );
5727
+ iCalUtilityFunctions::createTimezone( $vcalendar, $PHPtz, $xprops );
5728
+ .. .
5729
+ </p>
5730
+ Output (when using createCalendar or returnCalendar functions):<br>
5731
+ <span class="ref">
5732
+ BEGIN:VTIMEZONE<br>
5733
+ TZID:Europe/Stockholm<br>
5734
+ X-LIC-LOCATION:Europe/Stockholm<br>
5735
+ BEGIN:STANDARD<br>
5736
+ DTSTART:20101031T020000<br>
5737
+ TZOFFSETFROM:+0200<br>
5738
+ TZOFFSETTO:+0100<br>
5739
+ RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10<br>
5740
+ TZNAME:CET<br>
5741
+ END:STANDARD<br>
5742
+ BEGIN:DAYLIGHT<br>
5743
+ DTSTART:20100328T030000<br>
5744
+ TZOFFSETFROM:+0100<br>
5745
+ TZOFFSETTO:+0200<br>
5746
+ RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=3<br>
5747
+ TZNAME:CEST<br>
5748
+ END:DAYLIGHT<br>
5749
+ END:VTIMEZONE
5750
+ </span>
5751
+ <br>
5752
+ <br>
5753
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#iCalUtilityFunctions">[up]</a>
5754
+
5755
+ <a name="transformDateTime"></a><h4>4.2 transformDateTime</h4>
5756
+ Transforms a datetime from a time zone to another. (Requires <i>PHP</i> >= 5.2.0 and <i>PHP</i> DateTimeZone acceptable time zones)
5757
+ <br>
5758
+ <br>
5759
+ FALSE is returned if not using a &quot;strtotime&quot; acceptable datetime or unacceptable <i>PHP</i> time zones.
5760
+ If TRUE, the dateTime argument (below) is converted to the new time zone, otherwise unaltered.
5761
+ <p class="label">Format</p>
5762
+ <p class="format">transformDateTime( dateTime, timezoneFrom, timezoneTo [, format ] )</p>
5763
+ <p class="comment">dateTime = string datetime // <span class="ref">acceptable by strtotime function
5764
+ ex. &nbsp;&quot;14 august 2006 16.00.00&quot;
5765
+ (notice <a class="ref" href="#date_restriction">date restriction</a>)</span>
5766
+ timezoneFrom = string, a <i>PHP</i> (DateTimeZone) valid time zone
5767
+ timezoneTo = string, a <i>PHP</i> (DateTimeZone) valid time zone, default &quot;UTC&quot;
5768
+ format = string, format accepted by date(), default &quot;Ymd\THis&quot;
5769
+ </p>
5770
+ <p class="label">Example</p>
5771
+ <p class="example">
5772
+ .. .
5773
+ $d = date( &quot;Y-m-d H:i:s&quot; );
5774
+ $tzFr = &quot;Europe/Stockholm&quot;;
5775
+ if( FALSE !== iCalUtilityFunctions::transformDateTime( $d, $tzFr ))
5776
+ $event->setProperty( &quot;dtstart&quot;, $d.&quot;Z&quot; );
5777
+ else
5778
+ $event->setProperty( &quot;dtstart&quot;, $d, array( &quot;TZID&quot; => $tzFr ));
5779
+ .. .<br>
5780
+ </p>
5781
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a> <a href="#iCalUtilityFunctions">[up]</a>
5782
+
5783
+ <a name="Copyright_and_Licence"></a><h1>5. COPYRIGHT AND LICENSE</h1>
5784
+ <h2>Copyright</h2>
5785
+ iCalcreator class <br>
5786
+ copyright (c) 2007-2011 Kjell-Inge Gustafsson, kigkonsult<br>
5787
+ <a href="http://kigkonsult.se/iCalcreator/index.php" title="kigkonsult.se/iCalcreator" target="_blank">kigkonsult.se/iCalcreator</a><br>
5788
+ ical@kigkonsult.se<br>
5789
+
5790
+ <h2>License</h2>
5791
+
5792
+ This library is free software; you can redistribute it and/or
5793
+ modify it under the terms of the GNU Lesser General Public
5794
+ License as published by the Free Software Foundation; either
5795
+ version 2.1 of the License, or (at your option) any later version.
5796
+ <br><br>
5797
+ This library is distributed in the hope that it will be useful,
5798
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
5799
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5800
+ Lesser General Public License for more details.
5801
+ <br><br>
5802
+ You should have received a copy of the GNU Lesser General Public
5803
+ License along with this library; if not, write to the Free Software
5804
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
5805
+ or download it <a href="http://kigkonsult.se/downloads/dl.php?f=LGPL" target="_blank">here</a>.
5806
+ <br>
5807
+ <br>
5808
+ <a href="#INDEX">[index]</a> <a href="#top">[top]</a>
5809
+ </body>
5810
+ </html>
readme.txt CHANGED
@@ -1,10 +1,10 @@
1
  === All-in-One Event Calendar ===
2
  Contributors: theseed, hubrik, vtowel, yani.iliev
3
- Donate link: http://theseednetwork.com/software/all-in-one-event-calendar-wordpress/
4
  Tags: calendar, event, events, ics, ics calendar, ical-feed, ics feed, wordpress ics importer, wordpress ical importer, upcoming events, todo, notes, journal, freebusy, availability, web calendar, web events, webcal, google calendar, ical, iCalendar, all-in-one, ai1ec, google calendar sync, ical sync, events sync, holiday calendar, calendar 2011, events 2011, widget, events widget, upcoming events widget, calendar widget, agenda widget
5
  Requires at least: 3.1.3
6
  Tested up to: 3.3
7
- Stable tag: 1.2.2
8
 
9
  An event calendar system with month, week, agenda views, upcoming events widget, color-coded categories, recurrence, and import/export of .ics feeds.
10
 
@@ -57,6 +57,16 @@ The All-in-One Event Calendar Plugin also has a few features that will prove use
57
  * [**Get Premium Support »**](http://theseednetwork.com/get-supported) from [The Seed Studio](http://theseednetwork.com/)
58
 
59
  == Changelog ==
 
 
 
 
 
 
 
 
 
 
60
 
61
  = Version 1.2.2 =
62
  * Fixed: Issue with Week view having an improper width [#208](http://trac.the-seed.ca/ticket/208)
1
  === All-in-One Event Calendar ===
2
  Contributors: theseed, hubrik, vtowel, yani.iliev
3
+ Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=9JJMUW48W2ED8
4
  Tags: calendar, event, events, ics, ics calendar, ical-feed, ics feed, wordpress ics importer, wordpress ical importer, upcoming events, todo, notes, journal, freebusy, availability, web calendar, web events, webcal, google calendar, ical, iCalendar, all-in-one, ai1ec, google calendar sync, ical sync, events sync, holiday calendar, calendar 2011, events 2011, widget, events widget, upcoming events widget, calendar widget, agenda widget
5
  Requires at least: 3.1.3
6
  Tested up to: 3.3
7
+ Stable tag: 1.2.3
8
 
9
  An event calendar system with month, week, agenda views, upcoming events widget, color-coded categories, recurrence, and import/export of .ics feeds.
10
 
57
  * [**Get Premium Support »**](http://theseednetwork.com/get-supported) from [The Seed Studio](http://theseednetwork.com/)
58
 
59
  == Changelog ==
60
+ = Version 1.2.3 =
61
+ * Improvement: Days of the week in month recurrence [#170](http://trac.the-seed.ca/ticket/170)
62
+ * Improvement: Make Month view, Week view compatible with touchscreen devices [#210](http://trac.the-seed.ca/ticket/210)
63
+ * Improvement: Improve error handling in get_timezone_offset function[#219](http://trac.the-seed.ca/ticket/219)
64
+ * Improvement: Update iCalcreator class [#256](http://trac.the-seed.ca/ticket/256)
65
+ * Fixed: Widget Limit options (category, tag, etc) multiselect fails to display properly [#192](http://trac.the-seed.ca/ticket/192)
66
+ * Fixed: Private Events Show in Calendar and Upcoming Events. [#201](http://trac.the-seed.ca/ticket/201)
67
+ * Fixed: Dates getting mixed up between Ai1EC calendars [#229](http://trac.the-seed.ca/ticket/229)
68
+ * Fixed: Error displayed when event is a draft [#239](http://trac.the-seed.ca/ticket/239)
69
+ * Fixed: PHP Notice errors from widget [#255](http://trac.the-seed.ca/ticket/255)
70
 
71
  = Version 1.2.2 =
72
  * Fixed: Issue with Week view having an improper width [#208](http://trac.the-seed.ca/ticket/208)