Need help with buymeacoffee?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

appcraftstudio
141 Stars 8 Forks MIT License 171 Commits 2 Opened issues

Description

Buy Me a Coffee framework for iOS

Services available

!
?

Need anything else?

Contributors list

Swift

A supporter is worth a thousand followers.

Buy Me a Coffee is a modern creator platform. It takes two minutes to start your page and has all the features that you need to build your creative business.

Donations :moneybag:
Give your audience a friendly way to thank you.

Memberships :spiral_calendar:
Earn recurring revenue by offering a monthly or yearly membership.

Sell Extras :sparkles:
A new, creative way to offer Zoom calls, art commissions, anything.


Features

  • [X] Apple Pay
  • [X] iCloud Keychain

Requirements

CocoaPods

Swift Package Manager
Swift 5.0 Swift 5.3
Xcode 11.x Xcode 12.x

App Store Review

These are the two App Store Review Guidelines articles you have to know before using this framework:

3.1.1 In-App Purchase

  • Apps may use in-app purchase currencies to enable customers to “tip” digital content providers in the app.

3.2.1 Acceptable:

(vii) Apps may enable individual users to give a monetary gift to another individual without using in-app purchase, provided that (a) the gift is a completely optional choice by the giver, and (b) 100% of the funds go to the receiver of the gift. However, a gift that is connected to or associated at any point in time with receiving digital content or services must use in-app purchase.

Implement Buy Me a Coffee

  1. Import the BuyMeACoffee framework in your
    UIApplicationDelegate
    :
    swift
    import BuyMeACoffee
    
  2. Configure the
    BMCManager
    shared instance with the username you've chosen on www.buymeacoffee.com, typically in your app's
    application:didFinishLaunchingWithOptions:
    method:
    swift
    BMCManager.shared.configure(username: "appcraftstudio")
    
  3. In the view controller, override the
    viewDidLoad
    method to set the presenting view controller of the
    BMCManager
    object.
    swift
    BMCManager.shared.presentingViewController = self
    // You can also set a custom thank you message
    BMCManager.shared.thankYouMessage = "Thank you for supporting 🎉 App Craft Studio !"
    
  4. Add a
    BMCButton
    to your storyboard, XIB file, or instantiate it programmatically. To add the button to your storyboard or XIB file, add a View and set its custom class to
    BMCButton
    .
  5. Optional: If you want to customize the button, do the following:
    swift
    let button = BMCButton(configuration: .default)
    button.configuraton = .init(color: .orange, font: .cookie)
    


(Optional) Configure In-App Purchase

Depending the legal receiver of the gift configured on Buy Me a Coffee, App Store reviewers can ask for In-App Purchase implementation.
If the following In-App Purchase if configured for your application, it will be displayed as primary flow when user tap on the

BMCButton
.

If the framework can't retrieve In-App Purchase informations, the web flow will be used as fallback.

App Store Connect

Go to App Store Connect, search for the In-App Purchases section of your app, and then, create a new one with the following informations:

||| | --- | --- | | Type | Consumable | | Reference Name | Buy Me a Coffee | | Product ID |

your.app.bundle.identifier
.buymeacoffee | | Cleared for Sale | :whitecheckmark: | | Price | Tier 4 | | Display Name | Buy Me a Coffee | | Description | Hey there! You can now buy me a coffee! | Promotional Image | download here | | Review Screenshot | download here | | Review Notes | Buy Me a Coffee enable customers to “tip” digital content providers in the app. |

Capabilities

  1. Select the current workspace in the project navigator.
  2. Then, select the app target in the left panel.
  3. Go to the Signing & Capabilities tab.
  4. Add the In-App Purchase capability.

Installation

CocoaPods

You want to add pod

'BuyMeACoffee', '~> 1.0'
similar to the following to your Podfile:
rb
target 'MyApp' do
  pod 'BuyMeACoffee', '~> 1.0'
end
Then run a
pod install
inside your terminal, or from CocoaPods.app.

Swift Package Manager

  1. Using Xcode 11 or above go to File > Swift Packages > Add Package Dependency
  2. Paste the project URL: https://github.com/appcraftstudio/buymeacoffee.git
  3. Click on next and select the project target

Swift Package Manager


Buy Me a Coffee framework for iOS - Embed Buy Me a Coffee framework in your applications | Product Hunt Embed

Buy Me A Coffee

Copyright © 2020 App Craft Studio. All rights reserved.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.