RedeemPointPopup

TerraCore v0

Introduction#

In the basic flow, the client app uses RedeemPointView to allow your users to enter loyalty points for shopping include opening RedeemPointPopup for choosing the number of points to use. But in some cases, the client wants to use a custom view instead of RedeemPointView. In these cases, the client needs to handle the popup or something else for member can choose the number of points to use.

This built-in popup allows your users to choose the number of loyalty points for using.

Usage#

Android
iOS

Using `LoyaltyRedeemPointPopup`#

Assume we have gotten MemberInfo, NetworkConfigResult from LoyaltyService. These data are neccessary for display our custom popup.

Open popup in Activity

class OurFancyActivity : AppCompatActivity() {

    private val redeemPointPopupCallback by lazy {
        object : RedeemPointPopupCallback {
            override fun onUsePoints(data: RedeemPointData) {
                viewDataBinding.tvYourPoints.text = "-${data.points}"
                Toast.makeText(requireContext(), "Used points: ${data.points}", Toast.LENGTH_LONG)
                    .show()
            }

            override fun onMemberInfoUpdate(currentMemberInfo: MemberInfo) {
                memberInfo = currentMemberInfo
            }

        }
    }

    private fun openLoyaltyRedeemPopup() {
         if (supportFragmentManager.findFragmentByTag(LoyaltyComponent.TAG_REDEEM_POINT_POPUP) == null) {
            LoyaltyComponent.getRedeemPointPopup(
                terraApp = TerraApp.getInstance(),
                orderAmount = 10000L,
                memberInfo = memberInfo,
                network = networkConfigResult,
                callback = redeemPointPopupCallback
            )
                .show(supportFragmentManager, LoyaltyComponent.TAG_REDEEM_POINT_POPUP)
        }
    }

}

Or open popup in Fragment

class OurFancyFragment : Fragment() {

    private val redeemPointPopupCallback by lazy {
        object : RedeemPointPopupCallback {
            override fun onUsePoints(data: RedeemPointData) {
                viewDataBinding.tvYourPoints.text = "-${data.points}"
                Toast.makeText(requireContext(), "Used points: ${data.points}", Toast.LENGTH_LONG)
                    .show()
            }

            override fun onMemberInfoUpdate(currentMemberInfo: MemberInfo) {
                memberInfo = currentMemberInfo
            }

        }
    }

    private fun openLoyaltyRedeemPopup() {
        if (childFragmentManager.findFragmentByTag(LoyaltyComponent.TAG_REDEEM_POINT_POPUP) == null) {
            LoyaltyComponent.getRedeemPointPopup(
                terraApp = TerraApp.getInstance(),
                orderAmount = 10000L,
                memberInfo = memberInfo,
                network = networkConfigResult,
                callback = redeemPointPopupCallback
            )
                .show(childFragmentManager, LoyaltyComponent.TAG_REDEEM_POINT_POPUP)
        }
    }

}

Using `LoyaltyRedeemPointPopup`#

Assume we have gotten MemberInfo, NetworkConfigResult from LoyaltyService. These data are neccessary for display our custom popup.

The ViewController must conform RedeemPointPopupDelegate.

import LoyaltyComponent
import LoyaltyModel

class ViewController: UIViewController {

    @objc func openPopup() {
        let popup = LoyaltyRedeemPointPopupModule.build(terraApp: terraApp,
                                                        orderAmount: 12000,
                                                        memberInfo: info,
                                                        config: config,
                                                        delegate: self)

        present(popup, animated: false, completion: nil)
    }

}

The delegate must conform to LoyaltyRedeemViewProtocol

public protocol LoyaltyRedeemViewProtocol: class {
    var controller: LoyaltyRedeemPointController? { get set }

    /// This function is called when LoyaltySDK prepared to load config from api
    func onPrepareLoading()

    /// Call when choose `Use` point in RedeemPopup
    /// - Parameter data: redeem point data
    func onRedeemPointChange(data: RedeemPointData)

    /// This function is called when LoyaltySDK loaded network config from api
    /// Client app can implement setting config here
    /// - Parameter config: loyalty network config
    func didGetNetworkConfig(config: NetworkConfigResult)

    /// This function is called every time LoyaltySDK loaded member info from api
    /// Client app can implement filling user point, tier,... here
    /// - Parameter memberInfo: loyalty member info
    func didGetMemberInfo(memberInfo: MemberInfo?)

    /// This method is called every time order amount is updated
    func onUpdateOrderAmount()

}

Introduction#

Usage#

Using LoyaltyRedeemPointPopup#

Using LoyaltyRedeemPointPopup#

Using `LoyaltyRedeemPointPopup`#

Using `LoyaltyRedeemPointPopup`#