Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kovpas/PMCalendar
Yet another calendar component for iOS. Compatible with iOS 4.0 (iPhone & iPad) and higher. Supports presenting as a popover and very flexible UI tuning. Default theme is inspired by https://github.com/ocrickard/OCCalendar
https://github.com/kovpas/PMCalendar
calendar-component cocoapods objective-c popover
Last synced: about 1 month ago
JSON representation
Yet another calendar component for iOS. Compatible with iOS 4.0 (iPhone & iPad) and higher. Supports presenting as a popover and very flexible UI tuning. Default theme is inspired by https://github.com/ocrickard/OCCalendar
- Host: GitHub
- URL: https://github.com/kovpas/PMCalendar
- Owner: kovpas
- License: mit
- Created: 2012-07-14T17:49:27.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2020-01-18T21:53:51.000Z (almost 5 years ago)
- Last Synced: 2024-03-15T10:51:32.641Z (9 months ago)
- Topics: calendar-component, cocoapods, objective-c, popover
- Language: Objective-C
- Homepage:
- Size: 880 KB
- Stars: 380
- Watchers: 39
- Forks: 88
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - PMCalendar - Yet another calendar component for iOS. Compatible with iOS 4.0 (iPhone & iPad) and higher. Supports presenting as a popover and very flexible UI tuning. Default theme is inspired by https://github.com/ocrickard/OCCalendar (popover)
- awesome - PMCalendar - Yet another calendar component for iOS. Compatible with iOS 4.0 (iPhone & iPad) and higher. Supports presenting as a popover and very flexible UI tuning. Default theme is inspired by https://github.com/ocrickard/OCCalendar (cocoapods)
README
PMCalendar v0.3.2
==========
[](http://cocoadocs.org/docsets/PMCalendar)
[](http://cocoadocs.org/docsets/PMCalendar)
Yet another calendar component for iOS. Compatible with iOS 4.0 (iPhone & iPad) and higher.
UI is inspired by [ocrickard](https://github.com/ocrickard)'s [OCCalendarController](https://github.com/ocrickard/OCCalendar). It's quite good component, but doesn't have some useful features which I wanted to see. Unfortunately [OCCalendarController](https://github.com/ocrickard/OCCalendar) very hard to maintain, so I decided to create my own implementation.
PMCalendar supports selection of multiple dates within one or several months, appears as a popover (if you used UIPopoverController before, you'll find PMCalendar management very similar), supports orientation changes out of the box and does not require any third party frameworks.
PMCalendar uses iOS' CoreGraphics and CoreText frameworks.
It's definitely not bug-free, so if you're going to use PMCalendar in production, please test it hard ;)
Feel free to concact me in case of any questions or suggestions. If you feel you know how to improve PMCalendar don't hesitate to contact me or send a pull request.
Legal
----------
PMCalendar is released under the MIT License.
Screenshots
----------
 
Usage
----------
- Add PMCalendar directory to your Xcode project
- Add CoreGraphics and CoreText frameworks to your project
- #import "PMCalendar.h"
- Create instance of PMCalendarController with specific theme name (see below) and size:
``` objective-c
PMCalendarController *calendarController = [[PMCalendarController alloc] initWithThemeName:@"my super theme name" andSize:CGSizeMake(300, 200)];
```
- Or use defaults:
``` objective-c
// default theme name (default.plist) and size (see default.plist for details)
PMCalendarController *calendarController = [[PMCalendarController alloc] init];
```
``` objective-c
// default theme name (default.plist) and specific size
PMCalendarController *calendarController = [[PMCalendarController alloc] initWithSize:CGSizeMake(300, 200)];
```
``` objective-c
// specific theme name and default calendar size for this theme
PMCalendarController *calendarController = [[PMCalendarController alloc] initWithThemeName:@"my super theme name"];
```
- Implement PMCalendarControllerDelegate methods to be aware of controller's state change:
``` objective-c
- (BOOL)calendarControllerShouldDismissCalendar:(PMCalendarController *)calendarController;
- (void)calendarControllerDidDismissCalendar:(PMCalendarController *)calendarController;
- (void)calendarController:(PMCalendarController *)calendarController didChangePeriod:(PMPeriod *)newPeriod;
```
- Don't forget to assign delegate!
``` objective-c
calendarController.delegate = self;
```
- Present calendarController from a view (i.e. UIButton), so calendar could position itself during rotation:
``` objective-c
[calendarController presentCalendarFromView:pressedButton
permittedArrowDirections:PMCalendarArrowDirectionUp | PMCalendarArrowDirectionLeft
isPopover:YES
animated:YES];
```
- Or CGRect:
``` objective-c
[calendarController presentCalendarFromRect:CGRectMake(100, 100, 10, 10)
inView:self.view
permittedArrowDirections:PMCalendarArrowDirectionUp | PMCalendarArrowDirectionLeft
isPopover:YES
animated:YES];
```
- Dismiss it:
``` objective-c
[calendarController dismissAnimated:YES];
```
PMPeriod
----------
``` objective-c
@interface PMPeriod : 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.
*/
- (PMPeriod *) normalizedPeriod;
@end
```
Implemented properties
----------
``` objective-c
@property (nonatomic, assign) id delegate;
```
**Selected period**
``` objective-c
@property (nonatomic, strong) PMPeriod *period;
```
**Period allowed for selection**
``` objective-c
@property (nonatomic, strong) PMPeriod *allowedPeriod;
```
**Monday is a first day of week. If set to NO then Sunday is a first day**
``` objective-c
@property (nonatomic, assign, getter = isMondayFirstDayOfWeek) BOOL mondayFirstDayOfWeek;
```
**If NO, only one date can be selected. Otherwise, user can pan to select period**
``` objective-c
@property (nonatomic, assign) BOOL allowsPeriodSelection;
```
**If YES, user can long press on arrow to fast iterate through months**
``` objective-c
@property (nonatomic, assign) BOOL allowsLongPressMonthChange;
```
**Direction of the arrow (similar to UIPopoverController's arrowDirection)**
``` objective-c
@property (nonatomic, readonly) PMCalendarArrowDirection arrowDirection;
```
**Size of a calendar controller**
``` objective-c
@property (nonatomic, assign) CGSize size;
```
**Returns whether the popover is visible (presented) or not**
``` objective-c
@property (nonatomic, assign, readonly, getter = isCalendarVisible) BOOL calendarVisible;
```
Themes (beta!)
----------
Themes allows you to create your own calendar component look without touching PMCalendar 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 refernce.
If you wish to share theme you created for PMCalendar, please contact me, I'll add it together with a link to your project :).