JoomGap Boilerplate

JoomGap Boilerplate is a starter project to create a hybrid mobile app for Joomla! CMS, powered by Cordova/PhoneGap, AngularJS and Ionic.

This project is the product of many years of iterative development and combined community knowledge from open source projects. It does not impose a specific development philosophy or framework, so you're free to architect your code in the way that you want.

• Homepage: http://www.joomgap.com/
• Source: https://github.com/JoomGap/JGBoilerplate
• Twitter: @JoomGap

Quick start

Choose one of the following options:

1. Download the latest stable release from joomgap.com.
2. Or, clone the git repo — git clonehttps://github.com/JoomGap/JGBoilerplate.git
3. Create a new App in PhoneGap build.
4. Build and download APK (Android) or IPA (iOS) file.
5. Copy the file to your mobile phone and install it.
6. Have fun!

How to integrate JG Boilerplate with Joomla! CMS

JG Boilerplate includes JoomGap Simple Library to integrate Joomla! CMS.

A call to Joomla! can be simply implemented in this way:

``` q = JgSimpleResource.get(url, params).$promise;

q.then(function(response) { if ( (response) && (response.success) ) { console.log(response.data); } }); ```

JGSimple - JoomGap Simple API for Joomla! CMS

Bare bones API to connect a JoomGap starter with Joomla!.

JGSimple is the simplest AngularJS module to connect with a web resource, powered by Joomla! CMS.

• In development mode (desktop setup), API Url is called via JSONP technique. Additionally, a new parameter has been added to configure the resource parameters.

JSONP (or JSON with Padding) is a technique used by web developers to overcome the cross-domain restrictions imposed by browsers to allow data to be retrieved from systems other than the one the page was served by.

-- Wikipedia

• In production mode, where there are no CORS restrictions, API Url is called via POST call.

Once the module is instantiated and loaded, it offers a promise to connect with an entry point.

Features

• Cordoba/PhoneGap mobile application.
• Includes:
  • Cordoba/PhoneGap project
  • PhoneGap (iOS / Android / Windows)
  • PhoneGap build-ready configuration
  • AngularJS
  • AngularJS Animate
  • AngularJS Resource
  • AngularJS Sanitize
  • AngularJS UI Router
  • JoomGap Simple Library
  • Ionic Framework
  • ngCordova

Useful Commands

Start a local development server for app dev/testing.

ionic serve

Compile Saas to build stylesheets.

gulp

Updating Ionic. Update bower.json, driftyco/ionic-bower#....

gulp install

Mobile operating system support

• Android 5 and 6
• Apple iOS 8 and 9

This doesn't mean that JoomGap Boilerplate cannot be used in older OS, just that we'll ensure compatibility with the ones mentioned above.

Screenshots

Installation Step 1 - Android

Installation Step 2 - Android

Welcome screen - Android

License

The code is available under the GNU GENERAL PUBLIC LICENSE Version 3.