= Appcelerator Calendar Module

This is a module that displays an iPhone-like calendar widget, based on the work of Keith Lazuka, dba The Polypeptides .

== Building

First download the code: git clone git@github.com:smontgomerie/Appcelerator-Calendar-Module.git

cd Appcelerator-Calendar-Module

Then build the code. ./build.py

Install the calendar into your app. cp calendarmodule-iphone-xxx.zip ~/Library/Application\ Support/Titanium/

Finally, in your app's tiapp.xml file:

You'll need to at least touch your iPhone app before including it (assuming you're building with Xcode, not Titanium).

== Basic Usage

To add a view:

var calendarView = Ti.Calendar.createView({
    top:0
    /*headerColor: "red",
     calendarColor: "#aaa8a8"*/
});
calendarView.show();
win.add(calendarView);

When a date is selected, a 'dateSelected' event is thrown:

calendarView.addEventListener('dateSelected', function(e) {
    try {
       // Do something with the date
    } catch(e) {
        Ti.API.info(e);
    }
});

The component is able to show that there is an event on a certain date with a dot icon. To set which dates are set:

var datesArray = [new Date()];
calendarView.setDates(datesArray);

You can also use the calendar to save a date (and this needs to be refactored):

calendarView.saveEvent(start, end, event.summary, event.location, event.description);

Note: this requires the EventKit Framework to be included for this to work.

That's pretty much it! Any edits/improvements are appreciated.