/Calendar

A set of views and controllers for displaying and scheduling events on iOS

Primary LanguageObjective-CMIT LicenseMIT

CalendarLib

Version License Platform

CalendarLib is a set of views and controllers for displaying and scheduling events on iOS.

Day Planner View Day Planner View Month Planner View Month Planner View Year Calendar View

Features

  • Create and schedule events with iCal-like views and controllers
  • 3 kinds of views are available (a day planner view, a month planner view and a year view)
  • Scroll infinitely through days / months, or restrict scrolling to a given date range
  • Restrict range of displayed hours in the day planner view
  • Page through weeks in the day planner view or months in the month planner view
  • Use a standard view for event cells or create your own custom views
  • Easily customize appearance and layout (date format, colors, fonts, size of headers, number of visible days...)
  • Create events by tap-and-hold on the view
  • Drag-and-drop events to another date or time
  • Scroll through days / months while dragging
  • Specialized controllers for EventKit data source but can easily work with any custom event provider
  • Background event loading for the EventKit controllers
  • Ability to show an activity indicator for days while events are loading
  • Restrict ability to create or move events to certain dates through datasource protocol methods
  • Zoom in/out the day planner view to increase or decrease the height of hour slots
  • Dim certain time ranges in the day planner view

Compatibility

iPad / iPhone with iOS 8 or higher.

Installation

CocoaPods

The best way is to use CocoaPods. Add the following line to your Podfile :

pod "CalendarLib"

The old way

If you don't want to use CocoaPods, you need to copy the content of the CalendarLib folder into your project, as well as the source of the two dependencies : OSCache and OrderedDictionary.

Getting started

  1. If you want to use EventKit as a data source, create an instance of MGCDayPlannerEKViewController or MGCMonthPlannerEKViewController, or subclass them for your own needs.

    Don't forget to add the following frameworks to the project:

    • EventKit.framework
    • EventKitUI.framework
  2. If you want to use another event provider, subclass one of MGCDayPlannerViewController or MGCMonthPlannerViewController and implement the data source protocol methods.

  3. If you want to use a custom event cell, subclass MGCEventView or MGCStandardEventView and register the class with the day / month planner view.

See the demo project to get an idea of how to use the library and check the documentation

License

CalendarLib is available under the MIT license. See the LICENSE file.

Change-log

A summary of each CalendarLib release can be found in the CHANGELOG.