Working with entitlement in a Twixl Publisher article-based app

Luk Dhondt 08-11-2016 How-To

By using entitlement in your app, you can determine which content a specific user can have access to. In the world of magazines, this is most frequently used to allow print subscribers to get free access to the digital editions by logging in with a user name and a password. But entitlement is also frequently used by companies that want employees or partners to login to an app that can be distributed both internally or via the App Stores.

When working with entitlement in an article-based app, all entitlement configuration can be done directly from your Twixl Distribution Platform account.

Configuring entitlements for your app

When navigating to the detail of your app, select Entitlements from the menu.
You can then select one of the preconfigured scenario’s:

  • Print Subscribers (for providing print subscribers free access to digital content - users can still see and purchase the different collections (issues) and also purchase a subscription through the App Store
  • User name & password (for a restriced access app, i.e. without a user name and password, users will not be able to access any content). This scenario also has a special default user called ‘No Entitlements’ that allows you to determine whether certain types of content will be displayed anyway when a user is not logged in.
  • Users & Groups: define access to your collections based on group access privileges - users belong to a group, collections can be visible in one or more groups.
  • Access Key (can be used for providing extra content to anyone with a valid access key)
  • Promo Code: allows readers to redeem a promo code and get an issue for free that normally needs to be purchased
  • Adobe DPS/AEM Direct Entitlement Server: useful for customers migrating from this solution that were previously using Adobe’s Direct Entitlement API.
  • Custom Entitlements Server (connect via a web service to an external database)

When you select a specific scenario, you will also be able to configure the labels of the login form.

Collection options

Once you have set the entitlement scenario, there are two collection options are very important in this respect:

1. Free of charge or in-app purchase

Each collection is set by default as “Free of charge”. Unchecking this option will make it an in-app purchase. In that case, you need to make sure that this in-app purchase is also defined on your Apple and/or Google developer account using the same product identifier.

When a reader navigates to a collection that has been defined as an in-app purchase, it will trigger the paywall to be displayed.
The paywall can display a number of different options:

  • the standalone purchase of a collection (or “issue”)
  • the purchase of a subscription (if you defined any)
  • a ‘Login’ button: tapping this will select the entitlement signin form to be displayed

2. Requires entitlement

If this setting is enabled for a collection, the entitlements signin form will be triggered when an unentitled user wants to navigate to that collection. If a reader then logs in with a valid user name and password, he will get access to the different content items in the collection.

IMPORTANT NOTE: if you check “Requires Entitlement” for the root collection, then the login form will be displayed on startup, and anyone who’s not entitled will not be able to access any content in the app.

Working with subscriptions

If you want to offer an App Store or Google Play subscription in an article-based app, there are two options:

  • Standard Subscription: this is the traditional type of subscription where you get access to new collections (i.e. issues) that are added during the period of your subscription.
  • All Access Subscription: this can be compared to e.g. a Spotify or Apple Music type of subscription: you get access to all content in the app, as long as your subscription remains valid.

Tweet this article: Working with entitlement in a Twixl Publisher article-based app

Share this post to your network.

Download the free trial of Twixl Publisher

Start using Twixl Publisher immediately, preview the result on your own device, share your creations with a colleague or client, get started!
Need any help? Visit our documentation site.

Download the trial Check out the documentation today

× Free trial/download