MapplsFeedbackUIKit for iOS¶

Introduction ¶

FeedbackUI Kit for IOS is a UI kit to use wrapper for Mappls's feedback API. It allows developers to integrate feedback module in their application. Using feedback module user can submit location related feedback to Mappls's server.

Note: Sample for UI view controllers with source code is also provided by Mappls which user can directly use to show feedback screen. Information about how to use UI sample is also provided in this documentation.

If you don’t want to implement own logic and use sample from Mappls Jump to Sample UI Kit section.

Version History ¶

Version	Dated	Description
`2.0.0`	14 Nov, 2024	- UI screen is changed. - URL property for icon is used to show icon for Report Categories.
`1.0.4`	23 Sep, 2024	Options is added to `Push` or `Present` feedback controller .
`1.0.3`	20 Jun, 2024	Theme support is added.
`1.0.2`	23 Sep, 2022	Added a Bool property `isShowStepProgress` to hide stepProgress.
`1.0.1`	14 Sept, 2022	Bug fixes.
`1.0.0`	22 June, 2022	Initial release.

Setup your Project ¶

Using CocoaPods ¶

To install the MapplsFeedbackUIKit using CocoaPods:

Create a Podfile with the following specification:

pod 'MapplsFeedbackUIKit', '2.0.0'

Run pod repo update && pod install and open the resulting Xcode workspace.

Authorization ¶

MapplsAPICore ¶

It is required to set Mappls keys to use any MAPPL's SDK. Please refer the documenatation here

Usage ¶

MapplsFeedbackUIKitManager is the class which will help to use this UI Control.Access shared instance of that class and call getViewController method to get instance of ViewController and present or push according to requirement.

let navVC = MapplsFeedbackUIKitManager.shared.getViewController(location: "78.120,28.2300",appVersion: Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String, osVersionoptional: UIDevice.current.systemVersion, deviceName: UIDevice.current.name, theme: .night)

self.present(navVC, animated: true, completion: nil)

Push Controller¶

let navVC = MapplsFeedbackUIKitManager.shared.getController(location: "78.120,28.2300",appVersion: Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String, osVersionoptional: UIDevice.current.systemVersion, deviceName: UIDevice.current.name, theme: .auto)
        navVC.modalPresentationStyle = .fullScreen
self.navigationController?.pushViewController(navVC, animated: true)

MapplsFeedbackUIKit implicitly uses functionalities of MapplsFeedBackKitManager module and provides a beautiful user expereience to submit feedback.

Theme ¶

Feedback UI also supports different themes. Avaialable options are Day, Night and Auto. In case of Auto it will behave as per system settings.

Below is code to initialize feedback ui with theme:

let navVC = MapplsFeedbackUIKitManager.shared.getViewController(location: CLLocation(latitude: mapView.centerCoordinate.latitude, longitude: mapView.centerCoordinate.longitude), theme: MapplsFeedbackTheme.auto)

Also different colors of Day and Night theme are configurable by accessing shared instance of class DayThemeColors and NightThemeColors respectively. Available properties to set are as below: