Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucabecchetti/InAppNotify
Swift library to manage in app notification in swift language, like WhatsApp, Telegram, Frind, ecc.
https://github.com/lucabecchetti/InAppNotify
Last synced: 3 months ago
JSON representation
Swift library to manage in app notification in swift language, like WhatsApp, Telegram, Frind, ecc.
- Host: GitHub
- URL: https://github.com/lucabecchetti/InAppNotify
- Owner: lucabecchetti
- License: mit
- Created: 2017-07-19T16:21:31.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-09-07T15:03:38.000Z (about 2 years ago)
- Last Synced: 2024-04-24T14:48:36.803Z (6 months ago)
- Language: Swift
- Homepage:
- Size: 301 KB
- Stars: 435
- Watchers: 13
- Forks: 36
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - InAppNotify - Swift library to manage in-app notification in swift language, like WhatsApp, Telegram, Frind, etc. (UI / Alert & Action Sheet)
- awesome-ios-star - InAppNotify - Swift library to manage in-app notification in swift language, like WhatsApp, Telegram, Frind, etc. (UI / Alert & Action Sheet)
README
# InAppNotify - Manage in App notifications
[](https://cocoapods.org/pods/InAppNotify) [](https://cocoapods.org/pods/InAppNotify) [](https://cocoapods.org/pods/InAppNotify) [](https://cocoapods.org/pods/InAppNotify)
During develop of my app [Frind](http://www.frind.it), I needed to manage in app notifications like whatsapp or telegram, but i didn't find nothing that liked me, so, i created this library. Choose InAppNotify for your next project, I'll be happy to give you a little help!
★★ Star our github repository to help us!, or ☕ pay me a coffee ★★
Created by Luca Becchetti
## Screenshots
## Requirements
- iOS 8+
- swift 4.0
## Main features
Here's a highlight of the main features you can find in InAppNotify:
* **Multiple orientation** We support `portrait` and `landscape` orientation
* **Fully customizable**. You can customize all programmatically
* **Swipe gesture** Up to dismiss, or down to show reply text field
## You also may like
Do you like `InAppNotify`? I'm also working on several other opensource libraries.
Take a look here:
* **[CountriesViewController](https://github.com/lucabecchetti/CountriesViewController)** - Countries selection view
* **[SwiftMultiSelect](https://github.com/lucabecchetti/SwiftMultiSelect)** - Generic multi selection tableview
* **[SwiftMulticastProtocol](https://github.com/lucabecchetti/SwiftMulticastProtocol)** - send message to multiple classes
## Installation with CocoaPods
[CocoaPods](http://cocoapods.org) is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like InAppNotify in your projects. You can install it with the following command:
```bash
$ gem install cocoapods
```
#### Podfile
To integrate InAppNotify into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
target 'TargetName' do
use_frameworks!
pod 'InAppNotify'
end
```
Then, run the following command:
```bash
$ pod install
```
## How to use
First of all import library in your project
```swift
import InAppNotify
```
The basic code to show a simple notification is:
```swift
//If you are in a UIViewController
InAppNotify.Show(Announcement(title: "Hello world! my first example!"), to: self)
```
### InAppNotify.Show method
This is a static method used to present a notitication, it takes two parameters, first is an instance of Announcement object, the second is a subclass of UIViewController
### Create announcement object
This library can show only an instance of "Announcement" object, you can pass many parameters to his initializer:
```swift
let announce = Announcement(
//Title, the first line
title : "I am titile",
//Subtitle, the second line
subtitle : "I am subititle",
//Image local, show if no urlImage is set
image : UIImage(named: "test"),
//URL of remote image
urlImage : "https://.....",
//Seconds before disappear
duration : 3,
//Interaction type. none or text
interactionType : InteractionType.none,
//Pass data to annoucement
userInfo : ["id" : 10],
//Action callback
action: { (type, string, announcement) in
//You can detect the action by test "type" var
if type == CallbackType.tap{
print("User has been tapped")
}else if type == CallbackType.text{
print("Reply from notification: \(string!)")
}else{
print("Notification has been closed!")
}
}
)
```
### Present announcement object
When object is created you can present it with this code:
```swift
//If you are in a UIViewController
InAppNotify.Show(announce, to: self)
```
### Interact with notification
When you create an announcement, you can interact with it passed an action callback:
```swift
//Inside initialization of announcement
action: { (type, string, announcement) in
//You can detect the action by test "type" var
if type == CallbackType.tap{
print("User has been tapped")
}else if type == CallbackType.text{
print("Reply from notification: \(string!)")
}else{
print("Notification has been closed!")
}
}
```
From the callbacak you can access the announcement object that has been triggered this method, announcement has a particolar attribute called "userInfo" (it's of type "Any") that you can set when create object, and read here.
If you want to enable a textField interaction when pull down notification, pass this parameter to announcement object:
```swift
//Inside initialization of announcement
interactionType : InteractionType.text,
```
This will present a textArea where user can write! to modify the text button ("send" by default) use this code:
```swift
InAppNotify.sendString = "Send"
```
To read user input, if you have set an action callback, test if the type is "text" and access string variable:
```swift
//Inside callback
if type == CallbackType.text{
print("Reply from notification: \(string!)")
}
```
### Customization
InAppNotify supports themes, by default we have two themes, accessibile from "Themes" class:
- Themes.dark
- Themes.light
To use a theme you have to set a global variable of the library, example:
```swift
//Set dark theme
InAppNotify.theme = Themes.dark
```
Of course, you can create your custom theme programmatically, here an example:
```swift
//Create and use a custom theme
InAppNotify.theme = Theme(
titleFont : UIFont.boldSystemFont(ofSize: 18),
subtitleFont : UIFont.systemFont(ofSize: 13),
backgroundColor : UIColor(red:0.90, green:0.58, blue:0.15, alpha:1.00),
dragIndicatorColor : UIColor(red:0.95, green:0.80, blue:0.19, alpha:1.00),
titleColor : UIColor.white,
subtitleColor : UIColor.white,
shadowColor : UIColor.darkGray.cgColor,
inputTextBackgroundColor : UIColor(red:0.95, green:0.80, blue:0.19, alpha:1.00),
inputTextColor : UIColor.white,
sendButtonHighlightedColor : UIColor.darkGray,
sendButtonNormalColor : UIColor.black,
separatorLineColor : UIColor.black
)
```
## Projects using InAppNotify
- Frind - [www.frind.it](https://www.frind.it)
- BirthReminder - [https://captainyukinoshitahachiman.github.io/BirthReminder](https://captainyukinoshitahachiman.github.io/BirthReminder/)
### Your App and InAppNotify
I'm interested in making a list of all projects which use this library. Feel free to open an Issue on GitHub with the name and links of your project; we'll add it to this site.
## Credits & License
InAppNotify is owned and maintained by [Luca Becchetti](http://www.lucabecchetti.com)
As open source creation any help is welcome!
The code of this library is licensed under MIT License; you can use it in commercial products without any limitation.
The only requirement is to add a line in your Credits/About section with the text below:
```
In app notification by InAppNotify - http://www.lucabecchetti.com
Created by Becchetti Luca and licensed under MIT License.
```
## About me
I am a professional programmer with a background in software design and development, currently developing my qualitative skills on a startup company named "[Frind](https://www.frind.it) " as Project Manager and ios senior software engineer.
I'm high skilled in Software Design (10+ years of experience), i have been worked since i was young as webmaster, and i'm a senior Php developer. In the last years i have been worked hard with mobile application programming, Swift for ios world, and Java for Android world.
I'm an expert mobile developer and architect with several years of experience of team managing, design and development on all the major mobile platforms: iOS, Android (3+ years of experience).
I'm also has broad experience on Web design and development both on client and server side and API /Networking design.
All my last works are hosted on AWS Amazon cloud, i'm able to configure a netowrk, with Unix servers. For my last works i configured apache2, ssl, ejabberd in cluster mode, Api servers with load balancer, and more.
I live in Assisi (Perugia), a small town in Italy, for any question, [contact me](mailto:[email protected])