Q for Android is a demo theme for mobile apps and Progressive Web Apps (PWA) built with WP-AppKit, a WordPress plugin to create mobile apps connected to WordPress (more on that at http://getwpappkit.com).

It is installed by default with the WP-AppKit plugin. However, you will be able to download a fresh installation from this repository

Installation

Download WP-AppKit: https://github.com/uncatcrea/wp-appkit/releases
Install WP-AppKit as you would do for any other WordPress plugins (ie. drop the plugin folder in /wp-content/plugins)
Activate WP-AppKit using the Plugins WordPress admin panel. (Browse the Installed Plugins list and click the Activate link of WP-AppKit.)
Now you should have a brand new /wp-content/themes-wp-appkit folder (yes, this is where app themes are stored)
Download the Q for Android from this repository and drop its folder in /wp-content/themes-wp-appkit
Don't forget to rename the theme's folder if Q for Android is already installed.
In WordPress, use the WP-AppKit admin panel to create a new app and choose one of the themes in the Appearance box
From there you're free to test in your browser (using the Chrome's Emulation Mode) or directly try to compile

If new to WP-AppKit, you might want to read this article: http://uncategorized-creations.com/1212/compiling-app-using-wp-appkit-phonegap-build/.

Theme's Overview

What's implemented

At the moment, Q for Android theme implements:

A shiny material design UI (including transitions and ripple effect)
Off-canvas menu (you can update it in the app's edit panel)
Archive template (eg. post list) with infinite post list
Single template (eg. a post) with the most common HTML elements (eg. strong, em, blockquote...)
Responsive embeds
The refresh process
Offline cache (meaning that you can read loaded posts offline)
Post thumbnail captions and subhead support
A responsive interface
Favorites support

Android UI

Ripple effect
Status bar color matches the theme
Android spinner

Cordova Plugins

Q for Android relies on Cordova plugins to:

Open external links in default browser (ie. Chrome): https://github.com/apache/cordova-plugin-inappbrowser

WP-AppKit export function adds these plugins automatically to your config.xml file. If you don't use the export, make sure to add them in order the theme to be able to work properly.

Responsive Images

Q for Android hooks into the WP-AppKit web services to modify the source code of images in the post content. It eases the way to style the responsive images later. See prepare-content.php in the php folder of the themes.

Thumbnail Captions and Subheads

Q for Android hooks into the WP-AppKit web services to modify add thumbnail captions and subheads (if available) in the post content. See add-custom-data.php in the php folder of the themes. Note that subheads are expected as a post custom field.

Compatibility with WP-AppKit add-ons:

Q for Android is compatible with all WP-AppKit add-ons:

WP-AppKit Offline Favorites
OneSignal for WP-AppKit
PushWoosh for WP-AppKit
Google Analytics for WP-AppKit

uncatcrea/q-android