Zend Framework: Zend_Calendar Component Proposal

Table of Contents

1. Overview

The proposed Zand_Calendar here provides a calendar data structure with multi-day events. The main purpose of this component is a monthly calendar page creation. The component does not provide the rendering by itself, but a designer has to implement it by him/herself. Using already existing partial view helper, this can be made in a clean manner.

2. References

• Demo application
• Demo application in github
• Zend_Calendar - Ramses Paiva
• Zend_Calendar - Kyle Spraggs
• Pear calendar package

3. Component Requirements, Constraints, and Acceptance Criteria

• This component will provide a calendar data structure.
• This component will support events.
• This component will support both monday and sunday as a week start day.
• This component will support caching.
• This component will be locale aware.
• This component will support Zend_Config.
• This component will not provide rendering.
• This component might benefit from Zend_Date_TimeSpan

4. Dependencies on Other Framework Components

• Zend_Exception
• Zend_Date

5. Theory of Operation

Instantiate Zend_Calendar and add events for example from database if you like. After this Zend_Calendar acts like a calendar data structure. Events can be fetched date by date or as a date range. To render a month view, all month weekdays can be get at one time with events and day tags, which are intented to be used in html class attributes.

6. Milestones / Tasks

• Milestone 1: [DONE] Create feasibility model
• Milestone 2: [DONE] Create the proposal
• Milestone 3: [DONE] Initial class design
• Milestone 4: Create working prototype
• Milestone 5: Revise proposal for ZF2
• Milestone 6: Proposal ready for recommendation

7. Class Index

• Zend_Calendar
• Zend_Calendar_Exception
• Zend_Calendar_Event_Abstract
• Zend_Calendar_Event_Array

8. Use Cases

9. Class Skeletons