Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/wajahatkarim3/mediumclap-android

👏 The Medium's Clapping Effect developed in Android
https://github.com/wajahatkarim3/mediumclap-android

android android-animation android-demo animation animation-demo clap medium medium-clinics

Last synced: 6 days ago
JSON representation

👏 The Medium's Clapping Effect developed in Android

Awesome Lists containing this project

README

        

# 👏 MediumClap-Android
[![Build status](https://build.appcenter.ms/v0.1/apps/c7b7ac7b-34b7-4a0d-89b3-8c325cc047a7/branches/master/badge)](https://appcenter.ms) [![](https://img.shields.io/badge/Android%20Weekly-%23317-blue.svg)](https://androidweekly.net/issues/issue-317) [![](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)]() [![](https://img.shields.io/badge/MaterialUp-MediumClap-yellowgreen.svg)](https://www.uplabs.com/posts/medium-clap-android) [![Android Arsenal]( https://img.shields.io/badge/Android%20Arsenal-Medium%20Clap%20Button-green.svg?style=flat )]( https://android-arsenal.com/details/1/7031 )
[![](https://img.shields.io/badge/Available%20On-ProductHunt-orange.svg)](https://www.producthunt.com/posts/medium-clap-button-in-android) [![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/wajahatkarim3) [![Twitter](https://img.shields.io/twitter/url/https/github.com/wajahatkarim3/MediumClap-Android.svg?style=social)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fwajahatkarim3%2FMediumClap-Android)


Built with ❤︎ by
Wajahat Karim and

contributors




A Custom Floating Action Button (FAB) library like clapping effect on Medium

![](https://raw.githubusercontent.com/wajahatkarim3/MediumClap-Android/master/art/demo_2.gif)

### 📄 How-To Article
* [Publishing your Android, Kotlin or Java library to jCenter from Android Studio](https://android.jlelse.eu/publishing-your-android-kotlin-or-java-library-to-jcenter-from-android-studio-1b24977fe450)

## ✔️ Changelog
Changes exist in the [releases](https://github.com/wajahatkarim3/MediumClap-Android/releases) tab.

## 💻 Installation
Add this in your app's build.gradle file:
```groovy
dependencies {
implementation 'com.wajahatkarim:clapfab:2.0.0'
}
```

Or add ClapFab as a new dependency inside your pom.xml

```xml

com.wajahatkarim3
clapfab
2.0.0
pom

```

## ❔ Usage

```xml

```

## 🎨 Customization and Attributes

All customizable attributes for ClapFab

Attribute Name
Default Value
Description

app:cf_default_icon
@drawable/ic_clap_hands_outline
The default icon of the ClapFab button


app:cf_filled_icon
@drawable/ic_clap_hands_filled
The filled icon after clapping of the ClapFab button


app:cf_default_icon_color
@color/colorClapIcon
The color of default icon of the ClapFab button


app:cf_filled_icon_color
@color/colorClapIcon
The filled color of icon after clapping of the ClapFab button


app:cf_max_clap_count
50
The maximum count of clapping of the ClapFab button


app:cf_count_circle_color
@color/colorClapIcon
The color of count's circle background


app:cf_count_text_color
@android:color/white
The color of count's circle text


app:cf_dots_1_color
@color/dotsColor1
The color of particle's dots 1


app:cf_dots_2_color
@color/dotsColor2
The color of particle's dots 2


app:cf_clap_count
0
The default clap count


app:cf_format_clap_count
true
True, if the formatter for clap count is enabled. Formatter will convert 1000 to 1.0K etc.


app:cf_long_press_enabled
true
The flag to turn on/off the long press auto-clap ability. Default is true.


app:cf_long_press_clap_interval
300
The interval to automatically clap on long press in milliseconds. Default is 300ms

## Clap Listener
```java
ClapFAB clapFAB = (ClapFAB) findViewById(R.id.clapFAB);
clapFAB.setClapListener(new ClapFAB.OnClapListener() {
@Override
public void onFabClapped(@NotNull ClapFAB clapFab, int count, boolean isMaxReached) {
// count is the current count of the clapping
// isMaxReached is true when button has already reached the maximum count
// and is not being clapped anymore. Otherwise its false
}
});
```

## 📃 Libraries Used
* ViewAnimator [https://github.com/florent37/ViewAnimator](https://github.com/florent37/ViewAnimator)
* DotsView from Like Animation [https://github.com/jd-alexander/LikeButton](https://github.com/jd-alexander/LikeButton)

## 💥 Achievements
* #1 on [Github Trending in Kotlin](https://github.com/trending/kotlin?since=daily) language from 22nd June, 2018 to 24th June, 2018
* Featured in [Caster IO's](http://www.caster.io/) weekly [#AndroidDev Digest](https://www.androiddevdigest.com/) in the [Issue #193](https://www.androiddevdigest.com/digest-193/)
* Featured in [Infinum's](https://infinum.co/) weekly #AndroidSweets newsletter issue #4
* Featured in Mindork's [Kotlin Weekly Update 44](https://medium.com/mindorks/kotlin-weekly-update-44-70b7969027f9)
* Featured in [Android Weekly China's](https://androidweekly.cn/) Issue [#185](https://androidweekly.cn/android-dev-weekly-issue-185/)
* Mentioned in an [article about publishing libraries on jCenter](https://android.jlelse.eu/publishing-your-android-kotlin-or-java-library-to-jcenter-from-android-studio-1b24977fe450) on [AndroidPub](https://android.jlelse.eu/)

## 💰 Donations

This project needs you! If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, feel free to donate. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!

**PayPal**

* **[Donate $5](https://www.paypal.me/WajahatKarim/5)**: Thank's for creating this project, here's a tea (or some juice) for you!
* **[Donate $10](https://www.paypal.me/WajahatKarim/10)**: Wow, I am stunned. Let me take you to the movies!
* **[Donate $15](https://www.paypal.me/WajahatKarim/15)**: I really appreciate your work, let's grab some lunch!
* **[Donate $25](https://www.paypal.me/WajahatKarim/25)**: That's some awesome stuff you did right there, dinner is on me!
* **[Donate $50](https://www.paypal.me/WajahatKarim/50)**: I really really want to support this project, great job!
* **[Donate $100](https://www.paypal.me/WajahatKarim/100)**: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
* **[Donate $2799](https://www.paypal.me/WajahatKarim/2799)**: Go buddy, buy Macbook Pro for yourself!

Of course, you can also choose what you want to donate, all donations are awesome!

## 👨 Developed By

```
Wajahat Karim
```
- Website (http://wajahatkarim.com)
- Twitter (http://twitter.com/wajahatkarim)
- Medium (http://www.medium.com/@wajahatkarim3)
- LinkedIn (http://www.linkedin.com/in/wajahatkarim)

# 👍 How to Contribute
1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

# 📃 License

Copyright 2022 Wajahat Karim

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.