On this page, you will find comprehensive documentation on EPContactsPicker, a contacts picker component for iOS applications, helping you get familiar with its usage, installation process, and customization options. EPContactsPicker provides a convenient and straightforward way to pick a single or multiple contacts from the device’s contacts list.
Installation
EPContactsPicker can be installed using different methods which are detailed below.
CocoaPods
You can use CocoaPods to install EPContactsPicker
by adding it to your ‘Podfile’:
platform :ios, '8.0'
pod 'EPContactsPicker'
Manually
Alternatively, you can integrate EPContactsPicker into your project manually:
- Download and drop the ‘/EPContactsPicker’ folder in your project.
- Link the framework ‘Contacts.framework’
Usage
After installation, using EPContactsPicker in your iOS applications is straightforward and comprises of a few steps which are:
- Import the EPContactsPicker at the top of your view controller:
import EPContactsPicker
- Instantiate a contacts picker object and present it:
let contactPickerScene = EPContactsPicker(delegate: self, multiSelection:true, subtitleCellType: SubtitleCellValue.phoneNumber
- For handling the picked contacts, conform your view controller to the EPContactsPickerDelegate protocol and implement the relevant methods.
Customization
EPContactsPicker provides several options for customization to suit individual project requirements:
- Multi Selection: You can enable or disable multi-selection by setting the
multiSelection
attribute. - Subtitle Cell Type: The
subtitleCellValue
attribute allows you to set the type of subtitle (email or phone number) displayed beneath the contact name. - Theme Color: To adjust the theme color of the contact picker view, use the
themeColor
attribute.
License
EPContactsPicker is available under the MIT license. Details can be found within the LICENSE file in the project’s GitHub repository.