cordova-plugin-permissionScope

This plugin is a wrapper of the very helpful Swift framework PermissionScope. It defines a global PermissionScope object, which permits to requesting permissions from users.

Installation

cordova plugin add cordova-plugin-permissionScope --save

The iOS part is written in Swift and the Swift support plugin is configured as a dependency.

:warning: Because this plugin doesn't support Swift 3 at the moment, the following preference has to be added in your project :

<preference name="UseLegacySwiftLanguageVersion" value="true" />

Supported Platforms

• iOS

Methods

PermissionScope.init(config, success, error)

Inits and customizes the dialog and all the alerts displayed from direct requests. If called without any parameter then the default config is restored.

The following properties are available:

Property | Comment ----- | ------- headerLabel | Header UILabel with the message "Hey, listen!" by default. bodyLabel | Header UILabel with the message "We need a couple things\r\nbefore you get started." by default. closeButtonTitle | Title for the close button. "Close" by default. closeButtonTextColor | Hex color code for the close button's text color (ie: #cccccc). closeOffset | Offset used to position the Close button (ie: {-200,0}). permissionButtonTextColor | Hex color code for the permission buttons' text color (ie: #cccccc). permissionButtonBorderColor | Hex color code for the permission buttons' border color (ie: #cccccc). permissionButtonΒorderWidth | Border width for the permission buttons. permissionButtonCornerRadius | Corner radius for the permission buttons. permissionLabelColor | Hex color code for the permission labels' text color (ie: #cccccc). authorizedButtonColor | Hex color code used for permission buttons with authorized status (ie: #cccccc). unauthorizedButtonColor | Hex color code used for permission buttons with unauthorized status. By default, inverse of authorizedButtonColor (ie: #cccccc). deniedAlertTitle | Title for the denied alert. deniedAlertMessage | Message for the denied alert. deniedCancelActionTitle | Title for the denied alert's cancel button. "OK" by default. deniedDefaultActionTitle | Title for the denied alert's default button. "Show me" by default. disabledAlertTitle | Title for the disabled alert. disabledAlertMessage | Message for the disabled alert. disabledCancelActionTitle | Title for the disabled alert's cancel button. "OK" by default. disabledDefaultActionTitle | Title for the disabled alert's default button. "Show me" by default.

PermissionScope.show(success, error)

Displays the permissions dialog if permissions have to be approved else does nothing.

PermissionScope.add<TYPE>Permission(message, success, error)

The following methods permit to set up permissions asked from the dialog :

• PermissionScope.addNotificationsPermission(message, success, error)
• PermissionScope.addLocationInUsePermission(message, success, error)
• PermissionScope.addLocationAlwaysPermission(message, success, error)
• PermissionScope.addContactsPermission(message, success, error)
• PermissionScope.addEventsPermission(message, success, error)
• PermissionScope.addMicrophonePermission(message, success, error)
• PermissionScope.addCameraPermission(message, success, error)
• PermissionScope.addPhotosPermission(message, success, error)
• PermissionScope.addRemindersPermission(message, success, error)
• PermissionScope.addBluetoothPermission(message, success, error)
• PermissionScope.addMotionPermission(message, success, error)

Message is a label displayed below the permission button. Its goal is to explain why a permission has to be approved.

PermissionScope.request<TYPE>Permission(success, error)

The following methods permit to check whether a particular permission has been granted else it displays an alert :

• PermissionScope.requestNotificationsPermission(success, error)
• PermissionScope.requestLocationInUsePermission(success, error)
• PermissionScope.requestLocationAlwaysPermission(success, error)
• PermissionScope.requestContactsPermission(success, error)
• PermissionScope.requestEventsPermission(success, error)
• PermissionScope.requestMicrophonePermission(success, error)
• PermissionScope.requestCameraPermission(success, error)
• PermissionScope.requestPhotosPermission(success, error)
• PermissionScope.requestRemindersPermission(success, error)
• PermissionScope.requestBluetoothPermission(success, error)
• PermissionScope.requestMotionPermission(success, error)

Examples

PermissionScope.init({
  headerLabel: 'Hello',
  bodyLabel: 'Before you get started',
  closeButtonTextColor: '#cccccc',
  closeButtonTitle: 'Return',
  permissionButtonTextColor: '#30ab7d',
  permissionButtonBorderColor: '#30ab7d',
  closeOffset: '{-200, 0}',
  authorizedButtonColor: '#cccccc',
  unauthorizedButtonColor: '#c2262d',
  permissionButtonCornerRadius: '20',
  permissionLabelColor: '#ff5500',
  permissionButtonΒorderWidth: '5',
  deniedCancelActionTitle: 'Cancel',
  deniedDefaultActionTitle: 'Settings',
  deniedAlertTitle: 'Permission',
  deniedAlertMessage: 'Please enable all the permissions',
  disabledCancelActionTitle: 'Cancel',
  disabledDefaultActionTitle: 'Settings',
});

PermissionScope.addBluetoothPermission('Please enable access to your Bluetooth');
PermissionScope.addCameraPermission('Please enable access to your Camera');
PermissionScope.addPhotosPermission('Please enable access to your Photos');

PermissionScope.show();

The result could be something like this :

Here is the default version :

PermissionScope.init({
  denieddDefaultActionTitle: 'Settings'
});

PermissionScope.requestEventsPermission();

Here is what you should obtain if the permission has not been granted :

App

An app is available in the tests/app folder and is generated from the Cordova Plugin TestFramework. It permits to launch auto tests and manual tests.

To install it, please follow these steps :

npm run install && cordova run --device