PPTopMostControllerProtocol

This project aims to simplify the code behind "which controller/view is on screen".

Sometimes, you may want to dispatch an event to the current displayed controller. For example:

• A notification view like the download of the resource is complete,
• A view which tells you the status of the app, online or offline,
• etc

For those usages with a notification view, you probably want to display the view without any efforts to the displayed controller. And more important, the view should stay displayed even if you push a new view from navigation controller.

Just to be clear, this protocol only gives you the tools to get the current displayed controller. It's up to you to do something useful with this tool. There is an example on the sample code provided with a NotificationView. Please also take a look at RZNotificationView (coming soon)

Please also note that PPTopMostController does support modal controllers.

Try it with MacBuildServer

^{by MacBuildServer}

#Installation

The easiest way to install PPTopMostController is via the CocoaPods package manager, since it's really flexible and provides easy installation.

Via CocoaPods (coming soon)

If you don't have cocoapods yet (shame on you), install it:

$ [sudo] gem install cocoapods
$ pod setup

Go to the directory of your Xcode project, and Create and/or Edit your Podfile and add PPTopMostController:

$ cd /path/to/MyProject
$ touch Podfile
# Edit the podfile using your favorite editor
$ edit Podfile
platform :ios 
pod 'PPTopMostController', '~> the version you want'

Run the install:

$ pod install

Finally, open your project in Xcode from the .xcworkspace file (not the usual project file! This is really important)

$ open MyProject.xcworkspace

Import UIViewController+PPTopMostController.h file to your PCH file or your AppDelegate file.

You are ready to go.

Old fashionned way

1. Add PPTopMostController as a submodule to your project

$ cd /path/to/MyApplication
# If this is a new project, initialize git...
$ git init
$ git submodule add [email protected]:ipodishima/PPTopMostController.git vendor/PPTopMostController
$ git submodule update --init --recursive

2. In your XCode Project, take all the files from PPTopMostController-Files folder and drag them into your project.
3. Import UIViewController+PPTopMostController.h file to your PCH file or your AppDelegate file.
4. Start using this new controller!

ARC Support

PPTopMostController does not care about ARC and non-ARC. Do whatever you want!

Compatibility

From iOS 4 to iOS 6.

Usage

Get the current displayed controller

To get the top most controller displayed, just do

UIViewController *c = [UIViewController topMostController];

And you are done.

Add support for custom container

There is an example with PPRevealSideViewController on the sample.

1. Create a category on your container : YourContainer+PPTopMostController.h (don't forget to import the header somewhere)
2. Import the PPTopMostController protocol : #import "PPTopMostControllerProtocol.h"
3. Adopt the protocol

    @interface YourContainer (PPTopMostController) <PPTopMostControllerProtocol>

4. Conforms to it

   • (UIViewController *)visibleViewController { return /The controller you want to set it's top one. Remember that PPTopMostController go through controller hierarchy and find controllers conforming to PPTopMostControllerProtocol/; }

That's it!

License

This Code is released under the MIT License by Marian Paul for iPuP SARL

Please tell me when you use this protocol in your project! And if you have great controls build with PPTopMostController, let me a note, I will include the link on this readme

Regards,
Marian Paul aka ipodishima

http://www.ipup.pro