This repository has been archived by the owner. It is now read-only.
Basic OSX calendar for mac / cocoa apps
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
SDFCalendarOSX.xcodeproj
SDFCalendarOSX
SDFCalendarOSXTests
.gitignore
.gitmodules
README.md

README.md

SDFCalendarOSX

A basic calendar for OSX (Yes, OSX, NOT iOS as there are a million of them out there). This is written to fill the lack of customisation in the NSDatePicker that apple provides. It features very basic functionality:

  • Date selection delegate.
  • Highlighting of currently selected date.
  • Highlighting of current date.

Note: to use this and modify the calendar you will need a moderate grasp of Objective-C. This framework can be a simple drop in and your good to go if you don't care too much about the look of it. However if you want to modify the look and feel you will need some skills.

Installation

Look inside the AppDelegate.m for code to set the calendar view to the current window.

Customisation

There are a few spots to go and modify the day cells and the calendar in general:

  • Day / calendar view layout: look in the XIB (nibs)
  • Colours: SDFCalendarOSXConstants.h
  • Day selection: Look inside the SDFCalendarOSXDayViewController.m
  • Customise day NIBs: Set the currentMonthDayViewNibName & nonCurrentMonthDayViewNibName before awakeFromNib is called, otherwise the framework defaults are used.

Note: A lot of the customisable ability lies in the SDFCalendarOSXCalendarViewController.h and SDFCalendarOSXDayViewController.h static setters. These need to be set BEFORE the nibs are loaded. In a window controller on initWithCoder is a good spot. an e.g. is setHeaderBackgroundColour.

Other

  • There are 2 asserts in the SDFCalendarOSXCalendarViewController.m that enforce the NSView the day views are inserted into conform to the grid size. What this means is that if the grid is 7 x 5 (x and y) then the width of the NSView for months has to be divisible by 7 exactly and the height by 5. This just keeps things sane.

Enchancements

  • Good autosizing of cells and month view
  • Fluid layout
  • Options: show current day highlight, show day header.

Documentation

All documentation will be inside the source files.

Issues

If you find anything wrong, please don't go and fork the project. Just add an issue and I'll take a look at fixing it. If you fix it yourself, awesome. Push it and let all of us enjoy the fix.

Credits

Thanks to Matthew York for the DateTools project. It made life a little bit easier when calculating the layout of the calendar days.

License

The MIT License (MIT)

Copyright (c) 2014 shaydes.dsgn

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.