phranck / Ccnpreferenceswindowcontroller

Overview

CCNPreferencesWindowController is an Objective-C subclass of NSWindowController that automatically manages your custom view controllers for handling app preferences.

Here is a shot of the included example application:

CocoaPods

You can add CCNPreferencesWindowController by using CocoaPods. Just add this line to your Podfile:

pod 'CCNPreferencesWindowController'

Carthage

Add CCNPreferencesWindowController to your Cartfile to have it installed by Carthage.

github "phranck/CCNPreferencesWindowController" >= 1.4.3

Build it by running the command carthage update, then drag CCNPreferencesWindowController.framework into your Xcode project.

Usage

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    // init the preferences window controller
    self.preferences = [CCNPreferencesWindowController new];
    self.preferences.centerToolbarItems = YES;	// or NO

    // setup all preference view controllers
    [self.preferences setPreferencesViewControllers:@[
        [PreferencesGeneralViewController new],
        [PreferencesNetworkViewController new],
        [PreferencesBonjourViewController new]
    ]];
}

- (IBAction)showPreferencesWindow:(id)sender {
    [self.preferences showPreferencesWindow];
}

That's all.

Requirements

CCNPreferencesWindowController was written using ARC and "modern" Objective-C 2. At the moment it has only support for OS X 10.10 Yosemite. OS X 10.9 Mavericks should work too, but it's untested yet.

Contribution

The code is provided as-is, and it is far from being complete or free of bugs. If you like this component feel free to support it. Make changes related to your needs, extend it or just use it in your own project. Pull-Requests and Feedbacks are very welcome. Just contact me at [email protected] or send me a ping on Twitter @TheCocoaNaut.

Documentation

The complete documentation you will find on CocoaDocs.

License

This software is published under the MIT License.

Software that uses CCNPreferencesWindowController

• Review Times - A small Mac tool that shows you the calculated average of the review times for both the Mac App Store and the iOS App Store
• WhatRoute - WhatRoute is a network diagnostic utility designed for Apple Macintosh computers. Primarily it provides a Traceroute function, but can also perform Ping, Domain Name Service queries, Whois queries and monitor the traffic to and from your computer.