Under Construction This proposal is under construction and is not ready for review.

<ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA[

Zend Framework: Zend_Ical Component Proposal

Table of Contents

1. Overview

Zend_Ical is a component that provides an easy interface to work with ICS calendar files.

2. References

• iCal Wikipedia Entry
• RFC 2445

3. Component Requirements, Constraints, and Acceptance Criteria

• This component will handle ICS files from different data sources (filesystem, FTP and webDAV).
• This component will be able to write data back to ICS files.
• This component will will strictly follow the RFC 2445.
• This component will be able to get dates for a given time range.
• This component will be able to search through calendar data.
• This component will validate any input before writing it to ICS files.
• This component will not cache any data using Zend_Cache or the filesystem.

4. Dependencies on Other Framework Components

• Zend_Exception
• Zend_Date

5. Theory of Operation

Zend_Ical will take a path or URL to an ICS file as argument for the constructor method and a boolean, which indicates whether the ICS file is write protected or not. Then you can call different methods to gather data from the ICS file or add additional data to it, if it is not write protected. If you try to write to a write protected file, Zend_Ical will throw a Zend_Ical_Exception.

6. Milestones / Tasks

• Milestone 1: design notes will be published here
• Milestone 2: Working prototype checked into http://svn.zendframework.dasprids.de/Zend_Ical/
• Milestone 3: Working prototype checked into the incubator.
• Milestone 4: Unit tests exist, work, and are checked into SVN.
• Milestone 5: Initial documentation exists.

7. Class Index

• Zend_Ical
• Zend_Ical_Exception
• Zend_Ical_Parser
• Zend_Ical_Source_Exception
• Zend_Ical_Source_Interface
• Zend_Ical_Source_Filesystem
• Zend_Ical_Source_Ftp
• Zend_Ical_Source_Http

8. Use Cases

Fetching data

9. Class Skeletons