Login

Learning & Support

Documentation

Creating your article-based app

Twixl Support Team Updated: - Created :

Everything starts with an Application on our Twixl Distribution Platform. It's the very backbone to present mobile content. This KB-article explains the ins and outs.

1. Add Application

1.1. Application Type

When you add a new Twixl app on the Twixl Distribution Platform, you can choose between several "templates" to get you started. We'll add more of these in the future. For more info about each of these templates, see: Getting Started & Sample Apps

1.2. Application Mode

The next thing to select, is the Application Mode. The idea is that you start with a Development App and once your Development App has been tested and approved, you can then copy this Development App to a Production App. You can of course start with a Production App right away as well.

ABOUT APPLICATION MODES AND APPLICATION BUILDS:

Development and Production Apps are linked to several Application Build Types. For a complete overview, see:

1.3. Application options

As a final step, the following information should be entered:

  • Application Name
  • Application Title: Use this to customize the title shown in the home screen of your app. Leave empty to use the application name
  • Application Identifier: This should be a reverse DNS name like com.twixlmedia.appname - only lowercase characters, numbers and dots should be used.
  • Application Icon: Upload an icon that will be displayed in your app list - it will be resized automatically
  • Support Email: The email address where the support emails should be sent to.
  • Application Type: Article-based

Application Options

When you select 'Edit application' after your app has been created, a number of extra app options can be set.

  1. Privacy Policy: Apple and Google require you to provide a Privacy Policy URL inside your apps.
  2. Search: See this article for more info.
  3. Supported orientations: Set the orientations you intend to support - you can make a different choice for tablets and phones.
  4. Navigation Toolbar: Set toolbar background color, toolbar foreground colors (i.e. for displaying the title), toolbar tint color (for navigation actions), app tint color (for messages in the app). For the Toolbar, you can also select custom fonts - see more on this here.
  5. Google Analytics Key: See this info about the Browser Client.
  6. Application behavior:
    • Prompt for App Store Rating: Prompts the user to rate your app in the App Store.
    • Allow Collection Download: Add the possibility for readers to selectively download content for offline access. See this KB-article for more info.
    • Keep All Data Offline: With this option enabled, an article-based application will be forced to download all available content when booting for the first time. With this option you can mimic the behaviour of a legacy single-issue app. See this KB-article for more info.
    • Sharing on Social Media: When allowing sharing on social media, users can share articles. For more info, see this KB-article.
    • Encrypt PDF Files: Enables on-the-fly encryption for PDF content items. That way, PDF files are protected on mobile devices (most relevant on 'open' systems like Android).
    • Externally Managed Content: Enable this when you have an external system that manages the content. This puts the content items and collections of your app in read-only mode on the Twixl Distribution Platform. For more info, see this KB-article.

WARNING ABOUT Keep All Data Offline:

Requires users to download all app contents on first startup. Ideal for certain in-house apps, but not recommended for App Store apps, as such an app may be rejected by Apple.

Was this article helpful?

0 out of 1 found this helpful