Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hbb20/countrycodepickerproject

Country Code Picker (CCP) is an android library which provides an easy way to search and select country or international phone code. Also supports Android EditText phone mask and international phone validation.
https://github.com/hbb20/countrycodepickerproject

andriod-country-spinner android android-edittext-phone-mask android-library android-phone-formatting ccp country-codes country-flags country-phone country-picker country-selector country-spinner international-phone international-phone-input international-phone-view libphonenumber library phone-validation phonecode-spinner phonenumber

Last synced: 22 days ago
JSON representation

Host: GitHub
URL: https://github.com/hbb20/countrycodepickerproject
Owner: hbb20
License: apache-2.0
Created: 2016-01-20T10:28:34.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2023-12-19T22:01:17.000Z (11 months ago)
Last Synced: 2024-10-14T21:20:41.422Z (22 days ago)
Topics: andriod-country-spinner, android, android-edittext-phone-mask, android-library, android-phone-formatting, ccp, country-codes, country-flags, country-phone, country-picker, country-selector, country-spinner, international-phone, international-phone-input, international-phone-view, libphonenumber, library, phone-validation, phonecode-spinner, phonenumber
Language: Java
Homepage:
Size: 5.74 MB
Stars: 1,519
Watchers: 37
Forks: 505
Open Issues: 141
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: License.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        Country Code Picker Library ![MavenCentral](https://maven-badges.herokuapp.com/maven-central/com.hbb20/ccp/badge.svg)

==================================

![ViewCount](https://views.whatilearened.today/views/github/hbb20/CountryCodePickerProject.svg) [![GitHub issues](https://img.shields.io/github/issues/hbb20/CountryCodePickerProject)](https://github.com/hbb20/CountryCodePickerProject/issues)  [![GitHub forks](https://img.shields.io/github/forks/hbb20/CountryCodePickerProject)](https://github.com/hbb20/CountryCodePickerProject/network) [![GitHub stars](https://img.shields.io/github/stars/hbb20/CountryCodePickerProject)](https://github.com/hbb20/CountryCodePickerProject/stargazers) [![GitHub license](https://img.shields.io/github/license/hbb20/CountryCodePickerProject)](https://github.com/hbb20/CountryCodePickerProject/blob/master/License.txt) 

![GitHub search hit counter](https://img.shields.io/github/search/hbb20/CountryCodePickerProject/CountryCodePicker)

If you are looking for an android library for Country Selector or Country Spinner or Country Phone Code selector, this is the perfect place for you.

Country Code Picker (CCP)  or



  is an android library which provides an easy way to search and select country or country phone code for the telephone number.

  

  ![AwesomeCCPLIbrary](https://i.makeagif.com/media/10-02-2017/RyO2k_.gif)

Introduction

------------

* Give a professional touch to your well designed form like login screen, sign up screen, edit profile screen with CCP. When used as phone code picker, it helps by removing confusion about how to add phone number and making view more understandable. 

	  

* With CCP you can get following views easily without boilerplate code. (Left: Phone code selector. Right: Country Selector)

    -          

    

* Tapping on CCP will open a dialog to search and select country (Left: Phone code selector. Right: Country Selector)

    -  

How to add to your project

--------------

Add this to your gradle file and sync. See [CHANGELOG](https://github.com/hbb20/CountryCodePickerProject/blob/master/CHANGELOG.md) for detailed list of changes.

  ````groovy

          dependencies {

            implementation 'com.hbb20:ccp:X.Y.Z'

          }

   ````

   ![MavenCentral](https://maven-badges.herokuapp.com/maven-central/com.hbb20/ccp/badge.svg)

  * If you are using version lower than 2.0.0 then please read [update guide](https://github.com/hbb20/CountryCodePickerProject/wiki/Update-Guide-for-v2.0.0) before upgrading to v2.0.0. or above*

  * Version 2.3.1 and above uses AndroidX

  * Version 2.5.0 and above hosted on MavenCentral

Features

--------

If you prefer experience along with explanations, an demo android app is available that demonstrates all the features of this library. Click below button to download from Playstore.




* [Super easy to integrate ](https://github.com/hbb20/CountryCodePickerProject/wiki/How-to-integrate-into-your-project)

* [Full Number Support](https://github.com/hbb20/CountryCodePickerProject/wiki/Full-Number-Support)

	- Auto-Formatting

	- Number Validation

	- Validity Change Listener

	- Read / Load full number

* [Use as Country Selector / Country Spinner](https://github.com/hbb20/CountryCodePickerProject/wiki/Use-as-a-Country-Selector)

* [Country preference](https://github.com/hbb20/CountryCodePickerProject/wiki/Country-Preference)

* [Custom master list](https://github.com/hbb20/CountryCodePickerProject/wiki/Custom-Master-Country-List)

* [Country Selection Change Listener](https://github.com/hbb20/CountryCodePickerProject/wiki/Country-Change-Listener)

* [Multi-language support](https://github.com/hbb20/CountryCodePickerProject/wiki/Multi-Language-Support)

* Customizable [CCP theme](https://github.com/hbb20/CountryCodePickerProject/wiki/CCP-Theme-Customization) and [Dialog Theme](https://github.com/hbb20/CountryCodePickerProject/wiki/CCP-Dialog-Theme-Customization) 

* [Auto detect Country](https://github.com/hbb20/CountryCodePickerProject/wiki/Auto-detect-country)

* [Auto detect Language](https://github.com/hbb20/CountryCodePickerProject/wiki/XML-Properties#appccp_autodetectlanguagetrue-default--false-)

* [Remembers last selection](https://github.com/hbb20/CountryCodePickerProject/wiki/XML-Properties#appccp_rememberlastselectiontrue-default--false-)

* [Fast Scroller](https://github.com/hbb20/CountryCodePickerProject/wiki/XML-Properties#appccpdialog_showfastscrollerfalse-default-true-) 

## Available XML properties

To check all xml properties available for CCP and CCP Selection ppDialog, please visit the [wiki page](https://github.com/hbb20/CountryCodePickerProject/wiki/XML-Properties).

## Credits

- [Fast Scroller library](https://github.com/FutureMind/recycler-fast-scroll) by [Future Minds](https://github.com/FutureMind)

- Optimized [Android port](https://github.com/MichaelRocks/libphonenumber-android) of [libphonenumber](https://github.com/googlei18n/libphonenumber) by [Michael Rozumyanskiy](https://github.com/MichaelRocks) 

- Hebrew translation by [David Brownstone](https://github.com/dfbrownstone)

- Chinese translation by [KENNETH2008](https://github.com/kenneth2008)

- Indonesia translation by [Maulana Firdaus](https://github.com/firdausmaulan)

- Spanish translation by [Armando Gomez](https://github.com/ArmandoGomez)

- Turkish translation by [Ugurcan Yildirim](https://github.com/ugurcany)

- Ukrainian language support by [VyacheslavMartynenko](https://github.com/VyacheslavMartynenko)

- Italian language support by [Fabrizio Gueli](https://github.com/fabriziogueli)

- Korean language support by [kduhyun](https://github.com/kduhyun)

- Portuguese translation corrections by [Elifázio Bernardes da Silva](https://github.com/elifazio)

- Flag border color option by [Maulana Firdaus](https://github.com/firdausmaulan)

- Dutch language support by [Bozintan Iuliana](https://github.com/IulianaDiana)

- Punjabi language support by [Dhruv Bhakta](https://github.com/DBB411)

- Arabic translation corrections by [Ahmed Wahdan](https://github.com/WahdanZ)

- Swedish language support by [Tobias Hillén](https://github.com/tobiashillen)

- Addition of Kosovo Country by [Aleksei Kliuev](https://github.com/aleksei-klv)

- Uzbek language support by [Mirmuhsin](https://github.com/Mirmuhsin)

- Afrikaans language support by [marilie](https://github.com/marilie)

- Czech language support by [Jakub Begera](https://github.com/jakubbegera)

- Greek language support by [khanboy1989](https://github.com/khanboy1989)

- Danish language support by [porkyhead](https://github.com/porkyhead)

- Vietnamese language support by [Ricardo Markiewicz](https://github.com/Gazer)

- Urdu language support by [Hamza Ahmed Khan](https://github.com/hamzaahmedkhan)

- Kazakh language support by [Zhanbolat Raimbekov](https://github.com/janbolat)

- Marathi language support by [Kaustubh Kulkarni](https://github.com/kaustubhk24)

- Slovenian language support by [pastafarianGit](https://github.com/pastafarianGit)

- Tagalog (Filipino/Tagalog) language support by [Noor ul Ain Ali](https://github.com/noorulain17)

- Thai language support by [offerre](https://github.com/offerre)

- BASQUE language support by [David Benito Fdz.](https://github.com/Davidbf)

- Hungarian language support by [valivalter](https://github.com/valivalter)

- Belarusian language supprt by [Vlad Petrushkevich](https://github.com/Vladuken)

- Hausa language support by [Auwal Alhassan Abubakar](https://github.com/A4Gumel)

- Tamil language support by [Kamalakannan G](https://github.com/kamal-lab)

# Contribution

- To add a new country, follow the [guide to add new country](https://github.com/hbb20/CountryCodePickerProject/wiki/Guide-to-add-new-country-in-list).

- To add a new Language support, follow the [guide to add new language support](https://github.com/hbb20/CountryCodePickerProject/wiki/Add-New-Language-Support).

## License

[Apache Version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html)

    Copyright (C) 2016 Harsh Bhakta

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.