http://qcal.lukevisinoni.com/ 2010-09-05T13:05:09-07:00 http://qcal.lukevisinoni.com/ http://qcal.lukevisinoni.com/lib/images/favicon.ico text/html 2010-04-18T05:07:09-07:00 http://qcal.lukevisinoni.com/doku.php?id=date&rev=1271592429&do=diff Dates in qCal are represented by the qCal_Date object (naturally). qCal_Date is immutable, meaning once you instantiate it, there is no way to change the date it represents. So if you need a new date, create a new object. Instantiation new qCal_Date( [ int $year [, int $month [, int $day [, bool $rollover ]]]] ) text/html 2010-01-16T02:48:01-07:00 http://qcal.lukevisinoni.com/doku.php?id=datetime&rev=1263638881&do=diff The qCal_DateTime object is basically just an aggregation of qCal_Date and qCal_Time with a few extra convenience methods. Instantiation new qCal_Time( [ int $year [, int $month [, int $day [, int $hour [, int $minute [, int $second [, mixed $timezone [, bool $rollover ]]]]]]]] ) text/html 2010-01-18T02:46:32-07:00 http://qcal.lukevisinoni.com/doku.php?id=icalendar_component_properties&rev=1263811592&do=diff iCalendar components are basically just a collection of pre-defined or custom properties. When creating an iCalendar component, there are typically several required properties and many optional properties that you can define in order to configure the way the component will behave when read by a calendar user agent such as Microsoft Outlook or Mozilla Sunbird. text/html 2010-01-18T02:49:09-07:00 http://qcal.lukevisinoni.com/doku.php?id=icalendar_component_property_parameters&rev=1263811749&do=diff A property can have attributes associated with it. These "property parameters" contain meta-information about the property or the property value. Property parameters are provided to specify such information as the location of an alternate text representation for a property value, the language of a text property value, the data type of the property value and other attributes. text/html 2010-01-19T13:24:23-07:00 http://qcal.lukevisinoni.com/doku.php?id=icalendar_components&rev=1263936263&do=diff Within the iCalendar specification, components are a collection of properties that define calendaring and scheduling information. Each iCalendar file contains one or more core iCalendar objects which, in turn, must contain at least one of the following components. text/html 2010-01-15T00:46:40-07:00 http://qcal.lukevisinoni.com/doku.php?id=icalendar_object&rev=1263545200&do=diff The iCalendar object is sort of the container that holds all of the calendaring and scheduling information in an iCalendar file. In an iCalendar file, it is required that there is at least one iCalendar object and that it must be the outer-most parent of all of the components and properties contained within the file. It is also required that there be at least one component within the iCalendar object for it to be valid. text/html 2010-01-15T00:41:38-07:00 http://qcal.lukevisinoni.com/doku.php?id=icalendar_value_types&rev=1263544898&do=diff Much like PHP and other programming languages, iCalendar defines several “types” for which values must fall into. In PHP, these “value types” are “boolean”, “integer”, “float”, “string”, “array”, and “object”. In the iCalendar spec, iCalendar property values fall into a larger set of more specific “value types”. text/html 2010-09-01T10:38:20-07:00 http://qcal.lukevisinoni.com/doku.php?id=installation&rev=1283362700&do=diff Downloading and extracting the library The qCal library is available for download in two flavors. Both are archives and both contain the exact same files. There is what is called a “tarball” (the one with the .tar.gz extension) and there is a ZIP file (the one with the .zip extension). It is up to you which flavor you want to download. Windows users are advised to download the ZIP file. text/html 2010-01-19T14:12:29-07:00 http://qcal.lukevisinoni.com/doku.php?id=qcal_component&rev=1263939149&do=diff This is the class from which all other component classes inherit from. There are some component classes that have a lot of features on top of what comes from this class, and there are some that have almost no extra functionality. But either way, I would advise you read this section before reading about any of its descendents (qCal_Component_Vevent for instance). text/html 2010-01-20T22:48:29-07:00 http://qcal.lukevisinoni.com/doku.php?id=start&rev=1264056509&do=diff qCal is an open-source, object-oriented, iCalendar library for PHP5. It is written using common design patterns and best practices. As of right now, the latest version is 0.0.2. Installation * Downloading and extracting the library * Uploading to your web server * Setting up autoload * Running the unit tests text/html 2010-01-20T12:10:53-07:00 http://qcal.lukevisinoni.com/doku.php?id=time&rev=1264018253&do=diff Times in qCal are represented by the qCal_Time object (naturally). qCal_Time is immutable, meaning once you instantiate it, there is no way to change the time it represents. So if you need a new time, create a new object. Instantiation new qCal_Time( [int $hour [, int $minute [, int $second [, mixed $timezone [, bool $rollover ]]]]] ) text/html 2010-01-14T01:47:58-07:00 http://qcal.lukevisinoni.com/doku.php?id=timezone&rev=1263462478&do=diff Because qCal works independently of PHP's built-in timezone functionality, a qCal_Timezone class was necessary. Any time you need to work with time in qCal, there will be a qCal_Timezone associated with it. In classes that require a timezone, the qCal_Timezone object defaults to whatever the server's default timezone is, but if you want to specify a different and/or custom timezone, you will need to use this class.