<p align="center" >
</p>
EPContactsPicker
===========
Contacts picker component using new contacts framework by apple
[](http://cocoapods.org/pods/EPContactsPicker)
[](https://developer.apple.com/swift/)
[](http://cocoadocs.org/docsets/EPContactsPicker)
[](https://travis-ci.org/ipraba/EPContactsPicker)
[](https://github.com/ipraba/EPContactsPicker/blob/master/LICENSE)
[](https://twitter.com/HaveYouMetPrabu)
Preview
-------
 
Installation
------------
####CocoaPods
EPContactsPicker is available on CocoaPods. Just add the following to your project Podfile:
```
pod 'EPContactsPicker'
use_frameworks!
```
####Manual Installation
Just drag and drop the `EPContactsPicker` folder into your project
Requirements
------------
iOS9+
Swift 2.0+
ARC
For manual installation you might have to add these frameworks in your Build Phases
`ContactsUI.framework` and `Contacts.framework`.
Features
--------
EPContacts Picker provides lot of features which lets you customize the picker
1. Single selection and multiselection option
2. Search Contacts
3. Making the secondary data to show as requested(Phonenumbers, Emails, Birthday and Organisation)
4. Section Indexes to easily navigate throught the contacts
5. Showing initials when image is not available
6. EPContact object to get the properties of the contacts
Initialization
--------------
Init the picker by passing delegate, multiselection option and the secondary data(Phone number, Email, brithday and Organisation) to be displayed
let contactPickerScene = EPContactsPicker(delegate: self, multiSelection:false, subtitleCellType: SubtitleCellValue.Email)
let navigationController = UINavigationController(rootViewController: contactPickerScene)
self.presentViewController(navigationController, animated: true, completion: nil)
Delegates
--------
EPContactsPicker provides you four delegates for getting the callbacks on the picker
```swift
optional func epContactPicker(_: EPContactsPicker, didContactFetchFailed error : NSError)
optional func epContactPicker(_: EPContactsPicker, didCancel error : NSError)
optional func epContactPicker(_: EPContactsPicker, didSelectContact contact : EPContact)
optional func epContactPicker(_: EPContactsPicker, didSelectMultipleContacts contacts : [EPContact])
```
EPContact Object
----------------
EPContact object provides you the properties of a contact. This contains properties like displayname, initials, firstname, lastname, organisation, birthdayString etc
License
-------
EPContactsPicker is available under the MIT license. See the [LICENSE](https://github.com/ipraba/EPContactsPicker/blob/master/LICENSE) file for more info.
Contributors
------------
[@ipraba](https://github.com/ipraba)