Popup Widgets

iOS guide to Popup Widgets

The WidgetPopupViewController is a presentation controller provided by the EngagementSDK.

It is a pop-up style presenter that displays realtime widgets from the Producer one-at-a-time. The WidgetPopupViewController manages a queue of widgets and will automatically show the next widget in the queue after displayed widget is dismissed.

A swipe to dismiss gesture will be applied to all widgets allowing users to only engage with the widgets they care most about.

Getting Started

To setup the WidgetPopupViewController, first you need to add it to your layout. This will be the same as adding any UIViewController to your layout.

Then, you need set a ContentSession to start displaying real time widgets.

class MyViewController: UIViewController {
  
  private let widgetVC = WidgetPopupViewController()
  private let contentSession: ContentSession
  
  init(contentSession: ContentSession) {
    self.contentSession = contentSession
		super.init(nibName: nil, bundle: nil)
  }
  
  override func viewDidLoad() {
    super.viewDidLoad()
    
    // Add widgetVC to layout
    addChild(widgetVC)
		widgetVC.didMove(toParent: self)
    widgetVC.view.translatesAutoresizingMaskIntoConstraints = false     
    view.addSubview(widgetVC.view)
    
    // Apply layout constraints
    NSLayoutConstraint.activate([
    	widgetVC.view.topAnchor.constraint(equalTo: view.topAnchor),
      widgetVC.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
      widgetVC.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
      widgetVC.view.bottomAnchor.constraint(equalTo: view.bottomAnchor)
    ])
    
    widgetVC.session = contentSession
  }
  
}

Themeing Widgets

You can apply a Theme to the WidgetPopupViewController to change the styles of the stock widget UI that are displayed.

let widgetVC = WidgetPopupViewController()
let myTheme = Theme()
widgetVC.setTheme(myTheme)

Using Custom Widgets

If you're developing your own Custom Widget UI, you can easily configure the WidgetPopupViewController to use your custom UI instead of the stock UI. Read more here

Updated about 1 year ago