aemm-plugin-entitlement

This plugin defines a global entitlement object, which provides methods related to entitlement and purchase . Although the object is in the global scope, it is not available until after the deviceready event.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(typeof cq.mobile.entitlement);
}

Installation

cordova plugin add aemm-plugin-entitlement

Object Properties

Offer object Properties

Name	Type	Notes
productId	String	the product/subscription id user input in "Products&Subscription" dashboard
label	String	the product/subscription name user input in "Products&Subscription" dashboard, will be null if not set by the user
description	String	the product/subscription description user input in "Products&Subscription" dashboard, will be null if not set by the user
price	String	price returned from the corresponding store, will be null if product is free
offerType	String	could be "product" or "subscription"
subscriptionType	String	could be "allAccess" or "standard", valid only if offertype is "subscription"
isFree	Boolean	true if the product is set as free in "Products&Subscription" dashboard

SubscriptionInfo object Properties

Name	Type	Notes
subscriptionOffers	Array	an array of Offer objects, would be empty if user has an active subscription
subscriptionState	Object	an SubscriptionState object

SubscriptionState object Properties

Name	Type	Notes
isSubscriber	Boolean	true if the user has been a subscriber at any point in time (i.e. for past and active subscribers alike), note that subscriptionState.isSubscriber = subscriptionState.store.isSubscriber OR subscriptionState.integrator.isSubscriber
isActiveSubscriber	Boolean	true if the user has an active subscription at this point in time, note that subscriptionState.isActiveSubscriber = subscriptionState.store.isActiveSubscriber OR subscriptionState.integrator.isActiveSubscriber
store	Object	a Store object which contains subscription state to product store
integrator	Object	an Integrator object which contains subsciption state to the integrator

Store object Properties

Name	Type	Notes
isSubscriber	Boolean	true if the user has been a subscriber at any point in time (i.e. for past and active subscribers alike)
isActiveSubscriber	Boolean	true if the user has an active subscription at this point in time
expirationDate	Number	the timestamp in milliseconds since the epoch, which represents when that subscription period ends, it could be null since not all subscriptions (both from the store and the integrator) have an expiration date.
subscriptionType	String	could be "allAccess" or "standard", valid only if isSubscriber is true
id	String	product id of the subscription product in the store

Integrator object Properties

Name	Type	Notes
isSubscriber	Boolean	true if the user has been a subscriber at any point in time (i.e. for past and active subscribers alike)
isActiveSubscriber	Boolean	true if the user has an active subscription at this point in time
expirationDate	Number	the timestamp in milliseconds since the epoch, which represents when that subscription period ends , it could be null since not all subscriptions (both from the store and the integrator) have an expiration date.
customData	String	customData will not be set if the sibling isSubscriber is false. If isSubscriber is true, it may or may not be set. customData can be returned by the integrator. It is intended to contain data that is transparent to Adobe and only meaningful to the customer.

Methods

• entitlement.getSubscriptionInfo
• entitlement.getOffers
• entitlement.purchaseOffer
• entitlement.restorePurchases

entitlement.getSubscriptionInfo

This method returns the subscription info for the current publication and device.

Parameter	Type	Description
successCallback	Function	The success callback, which accepts a SubscriptionInfo object
errorCallback	Function	The error callback

Supported Platforms

• iOS, Android

Quick Example

function successCallback(subscriptionInfo)
{
    var offers = subscriptionInfo.subscriptionOffers;
	for(var i=0; i<offers.length; i++)
	{
		var offer = offers[i];
		console.log(offer.productId);
		console.log(offer.subscriptionType);
	}

	var subscriptionState = subscriptionInfo.subscriptionState;
}
function errorCallback(errorCode)
{
	console.log(errorCode);
}
cq.mobile.entitlement.getSubscriptionInfo(successCallback, errorCallback);

entitlement.getOffers

This method requests the available offers (products and subscriptions) for the specified collection.

Parameter	Type	Description
collectionName	String	The name of the collection to fetch offers for, this must match the name found on Content Portal
successCallback	Function	The success callback,which accepts an array of Offer objects
errorCallback	Function	The error callback

Supported Platforms

• iOS, Android

Quick Example

var collectionName = "Collection X";
function successCallback(offers)
{
	for(var i=0; i<offers.length; i++)
	{
		var offer = offers[i];
		console.log(offer.productId);
		console.log(offer.offerType);
	}

}
function errorCallback(errorCode)
{
	console.log(errorCode);
}
cq.mobile.entitlement.getOffers(collectionName, successCallback, errorCallback);

entitlement.purchaseOffer

This method initiates a purchase request.

Parameter	Type	Description
productId	String	The productId of the offer to purchase
successCallback	Function	The success callback
errorCallback	Function	The error callback

Supported Platforms

• iOS, Android

Quick Example

var productId = "com.org.product.productId1";
function successCallback()
{
	console.log("Purchase %s succeed", productId);
}
function errorCallback(errorCode)
{
	console.log(errorCode);
}
cq.mobile.entitlement.purchaseOffer(productId, successCallback, errorCallback);

entitlement.restorePurchases

This method will initiate restore previous purchases for the user.

Parameter	Type	Description
successCallback	Function	The success callback
errorCallback	Function	The error callback

Supported Platforms

• iOS

Quick Example

function successCallback()
{
	console.log("Restore purchase succeed");
}
function errorCallback(errorCode)
{
	console.log(errorCode);
}
cq.mobile.entitlement.restorePurchases(successCallback, errorCallback);