This is a PMCalendar fork which does not use ARC. There are some API changes. I don't care. :)

MulleCalendar v0.3

Yet another calendar component for iOS. Compatible with iOS 4.0 (iPhone & iPad) and higher.

UI is inspired by ocrickard's OCCalendarController. It's quite good component, but doesn't have some useful features which I wanted to see. Unfortunately OCCalendarController very hard to maintain, so I decided to create my own implementation.

MulleCalendar supports selection of multiple dates within one or several months, appears as a popover (if you used UIPopoverController before, you'll find MulleCalendar management very similar), supports orientation changes out of the box and does not require any third party frameworks.

MulleCalendar uses iOS' CoreGraphics and CoreText frameworks.

It's definitely not bug-free, so if you're going to use MulleCalendar in production, please test it hard ;)

Legal

MulleCalendar is released under the MIT License.

Screenshots

  

Usage

• Add MulleCalendar directory to your Xcode project
• Add CoreGraphics and CoreText frameworks to your project
• #import "MulleCalendar.h"
• Create instance of MulleCalendarController with specific theme name (see below) and size:

        MulleCalendarController *calendarController = [[MulleCalendarController alloc] initWithThemeName:@"my super theme name" andSize:CGSizeMake(300, 200)];

• Or use defaults:

        // default theme name (default.plist) and size (see default.plist for details)
        MulleCalendarController *calendarController = [[MulleCalendarController alloc] init];

        // default theme name (default.plist) and specific size
        MulleCalendarController *calendarController = [[MulleCalendarController alloc] initWithSize:CGSizeMake(300, 200)];

        // specific theme name and default calendar size for this theme
        MulleCalendarController *calendarController = [[MulleCalendarController alloc] initWithThemeName:@"my super theme name"];

• Implement MulleCalendarControllerDelegate methods to be aware of controller's state change:

        - (BOOL)calendarControllerShouldDismissCalendar:(MulleCalendarController *)calendarController;
        - (void)calendarControllerDidDismissCalendar:(MulleCalendarController *)calendarController;
        - (void)calendarController:(MulleCalendarController *)calendarController didChangePeriod:(MullePeriod *)newPeriod;

• Don't forget to assign delegate!

        calendarController.delegate = self;

• Present calendarController from a view (i.e. UIButton), so calendar could position itself during rotation:

         [calendarController presentCalendarFromView:pressedButton
                            permittedArrowDirections:MulleCalendarArrowDirectionUp | MulleCalendarArrowDirectionLeft
                                           isPopover:YES
                                            animated:YES];

• Or CGRect:

         [calendarController presentCalendarFromRect:CGRectMake(100, 100, 10, 10)
                                              inView:self.view
                            permittedArrowDirections:MulleCalendarArrowDirectionUp | MulleCalendarArrowDirectionLeft
                                           isPopover:YES
                                            animated:YES];

• Dismiss it:

         [calendarController dismissAnimated:YES];

MullePeriod

    @interface MullePeriod : NSObject

    @property (nonatomic, strong) NSDate *startDate;
    @property (nonatomic, strong) NSDate *endDate;

    /**
     * Creates new period with same startDate and endDate
     */
    + (id) oneDayPeriodWithDate:(NSDate *) date;

    + (id) periodWithStartDate:(NSDate *) startDate endDate:(NSDate *) endDate;

    - (NSInteger) lengthInDays;

    /**
     * Creates new period from self with proper order of startDate and endDate.
     */
    - (MullePeriod *) normalizedPeriod;

    @end

Implemented properties

    @property (nonatomic, assign) id<MulleCalendarControllerDelegate> delegate;

Selected period

    @property (nonatomic, strong) MullePeriod *period;

Period allowed for selection

    @property (nonatomic, strong) MullePeriod *allowedPeriod;

Monday is a first day of week. If set to NO then Sunday is a first day

    @property (nonatomic, assign, getter = isMondayFirstDayOfWeek) BOOL mondayFirstDayOfWeek;

If NO, only one date can be selected. Otherwise, user can pan to select period

    @property (nonatomic, assign) BOOL allowsPeriodSelection;

If YES, user can long press on arrow to fast iterate through months

    @property (nonatomic, assign) BOOL allowsLongPressMonthChange;

Direction of the arrow (similar to UIPopoverController's arrowDirection)

    @property (nonatomic, readonly) MulleCalendarArrowDirection arrowDirection;

Size of a calendar controller

    @property (nonatomic, assign) CGSize size;

Returns whether the popover is visible (presented) or not

    @property (nonatomic, assign, readonly, getter = isCalendarVisible) BOOL calendarVisible;

Themes (beta!)

Themes allows you to create your own calendar component look without touching MulleCalendar code. In theory... On practice current implementation is a compromise between flexibility and speed of drawing of the component. Therefore, some theme properties which you expect to be working does not work :).

However, current implementation is powerful enough to create for example something like this:

 

Themes documentation is in progress, so for now please use two examples ("default.plist" and "apple calendar.plist") as a reference.

If you wish to share theme you created for MulleCalendar, please contact me, I'll add it together with a link to your project :).