tinycal

tinycal is a small HTML calendar box, displaying calendar information from local and/or remote calendar files or even urls, ex. Google calendar.

tinycal offers access to calendar information in month, week, day, list and component views and offers also ablility to download a (complete, part of or single event within) calendar file. tinycal is only 220px in width (configurable), "calendar-in-a-box"

tinycal displays "vevent" (default), "vtodo" or "vjournal" calendar component ' types except any (included) "valarm" components and supports recurring events (component properties rdate, rrule etc).

More than one tinycal box can be showed on the same page, showing contents from different sources.

tinycal is written completely in javascript and used in a HTML page as script-tags, using Ajax technology and a PHP Axaj backend.

tinycal uses prototype 1.5.0 javascript framework (included within package) for display and Axaj logics and iCalCreator (iCalcreator.class.php) (not included within the download package) for managing calendar files by the Ajax backend PHP script.

Features

tinycal is preset to display, in the configured start view, the current date (week) at initiation.

In the following, event(-s) represent "vevent", "vtodo" or "vjournal" calendar component(-s).

Menu

The tinycal menu displays (in order left to right):

 - arrow icon for the previous month / week / day / list section / event

 - text for the month (and year) / week number (and year) / day date

 - arrow icon for the next month / week / day / list section / event

 - icons for list , day , week and month views. (all opt., configurable)

Month view

In the "month" view, day cells with events are marked with bold characters. Holding the mouse over a bold day date, the number of calendar components are displayed. Clicking a day date number opens the "day" view (if not disallowed), clicking a week number in the week column the opens "week" view (if not disallowed).

The menu arrow icons offers ability to go to previous or next month.

The "month" view is default (configurable) the start view. There is also an overall option to disallow usage of the "month" view.

Week view

In the "week" view, every event is marked with a "diamond" at the day/start hour cell (if set, otherwise at the top). Holding the mouse over a "diamond", the component "SUMMARY" property are displayed. Clicking a "diamond" opens the "component" view (if not disallowed). Clicking a day date number in the day date row opens the "day" view (if not disallowed).

The menu arrow icons offers ability to go to previous or next week.

The "week" view is configurable to use as start view. There is also an overall option to disallow usage of the "week" view.

Day view

In the "day" view, every events "SUMMARY" property are displayed at the event start hour(if set or else as an "All-Day-event", at the top in the day hour column), clicking text opens the "component" view (if not disallowed).

The menu arrow icons offers ability to go to previous or next day.

The "day" view is configurable to use as start view. There is also an overall option to disallow usage of the "day" view.

List view

In the "list" view, events are displayed in date/time order, day-by-day, with configurable event content; properties (within a preset selection) to show, property order and with or without label. Clicking an event opens the "component" view (if not disallowed). The calendar list is displayed in sections (size configurable) for minimizing tinycal height.

The menu arrow icons offers ability to display previous or next list section.

The "list" view is configurable to use as start view. There is also an overall option to disallow usage of the "list" view.

Component view

In the "component" view, the event details are displayed with configurable content; properties to show, property order and with or without label.

The menu arrow icons offers ability to display previous or next event.

There is an overall option to disallow usage of the "component" view.

Download

tinycal is configurable to allow downloads, total (whole calendar file) and extracts within the scope of the current view, all default allowed. At the bottom of the tinycal box and at the left side, there is an icon and text for total download, and, at the right, text for the current view and icon . When allowing download, ensure that the calendar files include METHOD property (ex. 'PUBLISH' value) and X-Properties and values for "X-WR-CALNAME", "X-WR-CALDESC" and "X-WR-TIMEZONE" to allow compatibility with calendar software (MS et.al.), see included "createTestfile.php" for creation details.

Miscellaneous

If the component property "PRIORITY" is used, a red "diamond" in the "week" view, a red "SUMMARY" text in the "day" view and red DTSTART time in the "list" view is used to mark "HIGH" priority (value 1-4), yellow colour is used to mark "MEDIUM" priority (5). For "LOW" priority (value 6-9) or no priority at all, black is used in "week" and "day" view. Also the "list" and "component" view use colour marks when displaying the "PRIORITY" "HIGH" and "MEDIUM" property values.

Clicking the bottom row ("tinycal v2.2.. .") opens and closes information about tinycal copyright, licence and components; namn, version, licence and link to homepage.

Is it presumed that the component property "UID" (unique id) are set in ALL calendar resources to ensure a unique component identity and proper sorting of calendar components. If missing, iCalcreator is adding an "UID" to every event.

Recurrent events are supported and are displayed in all days they occur.

Roadmap

New release of eventCreator (2.4), using the new features from iCalcreator 2.6 and will support
- parsing and editing of existing iCal files and included events
- using iCalcnv package to allow import csv and export csv/xls files.
- creation of iCal file and events
- event alarms and recurrent events
- extended Ajax support.

New release of eventManager, a port of eventCreator (2.4) to Joomla.

Minor bug fix/function improvement releases of iCalcreator.

Next major release (3.x) of iCalcreator is a PHP 5.x, more strict object-oriented, refactored version.