CodeAtlas / VeeContactPicker

A replacement of the iOS ABPeoplePickerNavigationController, supporting contacts' images.
MIT License
103 stars 27 forks source link

VeeContactPicker

CI Status Version License Platform

VeeContactPicker Example

VeeContactPicker is an Objective-C replacement of the buggy ABPeoplePickerNavigationController: a ViewController for selecting contacts from the address book.

Features

How to use it - Basic

Add contact usage key to project info.plist file :

<key>NSContactsUsageDescription</key> 
<string>This app requires contacts access to function properly.</string> 

Import the ViewController:

# import "VeeContactPickerViewController.h"

Initialize it and set the delegate:

VeeContactPickerViewController *veeContactPickerViewController = [[VeeContactPickerViewController alloc] initWithDefaultConfiguration];
veeContactPickerViewController.contactPickerDelegate = self;
//do you want to select multiple contacts? veeContactPickerViewController.multipleSelection = YES;
[self presentViewController:veeContactPickerViewController animated:YES completion:nil];

Implement the delegate:

- (void)didSelectContact:(id<VeeContactProt>)veeContact
{
    //veeContact was selected
}

- (void)didSelectContacts:(NSArray<id<VeeContactProt>> *)veeContacts
{
    //veeContact were selected
}

- (void)didCancelContactSelection
{
  //No contact was selected
}

- (void)didFailToAccessAddressBook
{
  //Show an error?
}

That's all folks!

How to use it - Details

You can customize some properties of the picker by changing the VeeContactPickerOptions object and pass it to the initializer:

- (instancetype)initWithOptions:(VeeContactPickerOptions*)veeContactPickerOptions;

For example, if you don't like the contacts' initials images as the placeholder, you can set your own placeholder image:

VeeContactPickerOptions *veeContactPickerOptions = [VeeContactPickerOptions alloc] initWithDefaultOptions];
veeContactPickerOptions.showInitialsPlaceholder = NO;
veeContactPickerOptions.contactThumbnailImagePlaceholder = [UIImage imageNamed:@"your_placeholder"];
//...
VeeContactPickerViewController *veeContactPickerViewController = [[VeeContactPickerViewController alloc] initWithOptions:veeContactPickerOptions];
//...

Contact's image placeholder are provided by AGCInitials. You can customize the color palette if you want, see the README of AGCInitials.

veeContactPickerOptions.veeContactPickerStrings
- (instancetype)initWithVeeContacts:(NSArray<id<VeeContactProt>>*)veeContacts;

Picker Appearance:

You can customize the appearance of the contact picker by manipulating the object VeeContactPickerAppearanceConstants, before loading the picker.

For example:

[[VeeContactPickerAppearanceConstants sharedInstance] setNavigationBarTintColor:[UIColor purpleColor]];
[[VeeContactPickerAppearanceConstants sharedInstance] setNavigationBarTranslucent:NO];
[[VeeContactPickerAppearanceConstants sharedInstance] setContactCellPrimaryLabelFont:[UIFont yourFont]];
//...
[self presentViewController:veeContactPickerViewController animated:YES completion:nil];

Run the example

To run the example project, clone the repo, and run pod install from the Example directory first.

Or you can even try the example online with Appetize.

Requirements

Installation

VeeContactPicker is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "VeeContactPicker"

Author

Code Atlas SRL info@codeatlas.it Andrea Cipriani andrea.g.cipriani@gmail.com - Main developer

License

VeeContactPicker is available under the MIT license. See the LICENSE file for more info.

App Store

VeeContactPicker is already used in the App Store for our app Veer Contacts Widget; if you appreciate our work, you can download the app for free! ๐Ÿค—