Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370 Docs For Class iCalComponent

 Class iCalComponent

Description
Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370

A Class for representing components within an iCalendar

Located in /iCalendar.php (line 301)


	
			
Method Summary
 iCalComponent iCalComponent ([ $content = null])
 void AddComponent (iCalComponent $new_component)
 void AddProperty (iCalProp $new_property, [string $value = null], [array $parameters = null])
 void ClearComponents ([string $type = null])
 void ClearProperties ([string $type = null])
 void CollectParameterValues ( $parameter_name)
 array &FirstNonTimezone ([ $type = null])
 array GetComponents ([string $type = null], [boolean $normal_match = true])
 string GetPParamValue (string $type,  $parameter_name)
 void GetProperties ([ $type = null])
 array GetPropertiesByPath ( $path)
 string GetPValue (string $type)
 void GetType ()
 boolean IsAttendee (string $email)
 boolean IsOrganizer (string $email)
 void MaskComponents (array $keep)
 void MaskProperties (array $keep, [array $component_list = null])
 void ParseFrom (string $content)
 void Render ([ $restricted_properties = null])
 void SetComponents (array $new_component, [string $type = null])
 void SetProperties ( $new_properties, [ $type = null])
 void SetType ( $type)
 void UnwrapComponent ( $content)
 void VCalendar ([array $extra_properties = null])
 void WrapComponent ( $content)
Methods
Strict Standards: Only variables should be passed by reference in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 712 Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370
Constructor iCalComponent (line 339)

A basic constructor

iCalComponent iCalComponent ([ $content = null])
  • $content
AddComponent (line 732)

Adds a new subcomponent

void AddComponent (iCalComponent $new_component)
  • iCalComponent $new_component: The new component to append to the set
AddProperty (line 601)

Adds a new property

void AddProperty (iCalProp $new_property, [string $value = null], [array $parameters = null])
  • iCalProp $new_property: The new property to append to the set, or a string with the name
  • string $value: The value of the new property (default: param 1 is an iCalProp with everything
  • array $parameters: The key/value parameter pairs (default: none, or param 1 is an iCalProp with everything)
ClearComponents (line 689)

Clear all components, or the components matching a particular type

void ClearComponents ([string $type = null])
  • string $type: The type of component - omit for all components
ClearProperties (line 564)

Clear all properties, or the properties matching a particular type

void ClearProperties ([string $type = null])
  • string $type: The type of property - omit for all properties
CloneConfidential (line 789)

Clone this component (and subcomponents) into a confidential version of it. A confidential event will be scrubbed of any identifying characteristics other than time/date, repeat, uid and a summary which is just a translated 'Busy'.

void CloneConfidential ()
CollectParameterValues (line 370)

Collect an array of all parameters of our properties which are the specified type

Mainly used for collecting the full variety of references TZIDs

void CollectParameterValues ( $parameter_name)
  • $parameter_name
FirstNonTimezone (line 621)

Get all sub-components, or at least get those matching a type

  • return: an array of the sub-components
array &FirstNonTimezone ([ $type = null])
  • $type
GetComponents (line 671)

Get all sub-components, or at least get those matching a type, or failling to match, should the second parameter be set to false.

  • return: an array of the sub-components
array GetComponents ([string $type = null], [boolean $normal_match = true])
  • string $type: The type to match (default: All)
  • boolean $normal_match: Set to false to invert the match (default: true)
GetPParamValue (line 552)

Get the value of the specified parameter for the first property matching the name. Obviously this isn't so useful for properties which may occur multiply, but most don't.

  • return: The value of the parameter for the property, or null in the case that there was no such property, or no such parameter.
string GetPParamValue (string $type,  $parameter_name)
  • string $type: The name of the parameter we are after.
  • $parameter_name
GetProperties (line 518)

Get all properties, or the properties matching a particular type

void GetProperties ([ $type = null])
  • $type
GetPropertiesByPath (line 843)

Return an array of properties matching the specified path

  • return: An array of iCalProp within the tree which match the path given, in the form [/]COMPONENT[/...]/PROPERTY in a syntax kind of similar to our poor man's XML queries. We also allow COMPONENT and PROPERTY to be !COMPONENT and !PROPERTY for ++fun.
array GetPropertiesByPath ( $path)
  • $path
GetPValue (line 536)

Get the value of the first property matching the name. Obviously this isn't so useful for properties which may occur multiply, but most don't.

  • return: The value of the property, or null if there was no such property.
string GetPValue (string $type)
  • string $type: The type of property we are after.
GetType (line 500)

Return the type of component which this is

void GetType ()
IsAttendee (line 652)

Return true if the person identified by the email address is down as an attendee or organizer for this meeting.

  • return: true if we found 'em, false if we didn't.
boolean IsAttendee (string $email)
  • string $email: The e-mail address of the person we're seeking.
IsOrganizer (line 636)

Return true if the person identified by the email address is down as an organizer for this meeting.

  • return: true if we found 'em, false if we didn't.
boolean IsOrganizer (string $email)
  • string $email: The e-mail address of the person we're seeking.
MaskComponents (line 750)

Mask components, removing any that are not of the types in the list

void MaskComponents (array $keep)
  • array $keep: An array of component types to be kept
MaskProperties (line 768)

Mask properties, removing any that are not in the list

void MaskProperties (array $keep, [array $component_list = null])
  • array $keep: An array of property names to be kept
  • array $component_list: An array of component types to check within
ParseFrom (line 391)

Parse the text $content into sets of iCalProp & iCalComponent within this iCalComponent

void ParseFrom (string $content)
  • string $content: The raw RFC2445-compliant iCalendar component, including BEGIN:TYPE & END:TYPE
Render (line 811)

Renders the component, possibly restricted to only the listed properties

void Render ([ $restricted_properties = null])
  • $restricted_properties
SetComponents (line 718)

Sets some or all sub-components of the component to the supplied new components

void SetComponents (array $new_component, [string $type = null])
  • string $type: The type of components to be replaced. Defaults to null, which means all components will be replaced.
  • array $new_component: of iCalComponent $new_components The new components to replace the existing ones
SetProperties (line 585)

Set all properties, or the ones matching a particular type

void SetProperties ( $new_properties, [ $type = null])
  • $new_properties
  • $type
SetType (line 508)

Set the type of component which this is

void SetType ( $type)
  • $type
UnwrapComponent (line 476)

This unescapes the (CRLF + linear space) wrapping specified in RFC2445. According to RFC2445 we should always end with CRLF but the CalDAV spec says that normalising XML parsers often muck with it and may remove the CR. We accept either case.

void UnwrapComponent ( $content)
  • $content
VCalendar (line 354)

Apply standard properties for a VCalendar

void VCalendar ([array $extra_properties = null])
  • array $extra_properties: Key/value pairs of additional properties
WrapComponent (line 488)

This imposes the (CRLF + linear space) wrapping specified in RFC2445. According to RFC2445 we should always end with CRLF but the CalDAV spec says that normalising XML parsers often muck with it and may remove the CR. We output RFC2445 compliance.

In order to preserve pre-existing wrapping in the component, we split the incoming string on line breaks before running wordwrap over each component of that.

void WrapComponent ( $content)
  • $content
Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370

Documentation generated on Wed, 04 Jul 2012 07:06:14 +0000 by phpDocumentor 1.4.3