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.
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
2. Application Options
When you select 'Edit application' after your app has been created, a number of extra app options can be set.
- Search: See this article for more info.
- Supported orientations: Set the orientations you intend to support - you can make a different choice for tablets and phones.
- 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.
- Google (Firebase) Analytics Key: You can add a Google (Firebase Analytics) Key for your iOS and Android App and also for the Browser Client. Also see this info about the Browser Client.
- 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.
ABOUT GOOGLE ANALYTICS:
Google Analytics for our Browser Client are actually Firebase Analytics but Google still calls them Google Analytics (that's confusing, we know).
To generate a Google Analytics Key:
- Login to analytics.google.com
- Create a new Property of type
- Add a Data Stream for
Webto the Property
- If needed, you can link this new Property to the old native Google Analytics property you used before. Look for the option User existing on-page tag
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.