Cloud Connected

"The only difference between Cloud CMS and your current on-premise document repository is that you don't have to worry about software or hardware installation and upgrades any longer."
Jeff Potts, Founder
Metaversant Group

Cloud CMS + jQuery Mobile in Five Minutes

Cloud CMS is an ideal cloud based content platform for jQuery Mobile framework. This blog provides details about how jQuery Mobile developers can easily plug Cloud CMS into their new or existing jQuery Mobile applications.

If you haven’t already installed jQuery Mobile, we recommend you visit jQuery framework’s web site to download their framework and check out their documentation.

To build a jQuery Mobile application that uses Cloud CMS as its content platform, all you need to do is to take a few simple steps:

Step 1 : Sign up with Cloud CMS

Cloud CMS offers a free sandbox account that you can use to play around with Cloud CMS at no cost. For the purposes of this guide, we’ll use this free sandbox account to connect and work with the APIs.

On the other hand, for your own private projects, you’ll want to first sign up with Cloud CMS for a free trial or a subscription account. If you have already signed up, then you can just substitute your own account details in the appropriate places.

Since Cloud CMS supports OAuth2 for platform authorization, you will need both client credential and user credential for your application.

To locate your client credential, sign in your Cloud CMS console and browse to Clients page and then select a client for authentication. From client dashboard page, you will find its key/secret pair.

For user credential, you can either use its username/password pair or any authentication grant that you have setup for that user.

Step 2 : Download Cloud CMS JavaScript driver

Cloud CMS JavaScript driver handles all HTTP/HTTPS calls, data conversions, OAuth2 authorization handshakes and any and all interaction with the Cloud CMS platform in a secure manner.

To get the latest version of the driver, you can visit its hosting site and download either its minified version or uncompressed version.

Step 3 : Setup web server proxy

If we want to run our Cloud CMS powered jQuery Mobile app as a pure HTML5/JavaScript application, we will need to place it under a web server such as Apache web server.

Due to the cross domain limitation of ajax calls, we will need to setup a reverse proxy that forwards HTTP/HTTPS request “/proxy/*” to “*”.

Here is a sample Apache configuration file (replace server name, server alias and other
directories with your own settings).

<VirtualHost *:80>



    RewriteEngine On
    RewriteRule .* - [E=host:%{HTTP_HOST}]

    ProxyRequests Off

    ProxyPassInterpolateEnv On
    ProxyPass /proxy interpolate
    ProxyPassReverse /proxy interpolate
    ProxyPassReverseCookieDomain ${host} interpolate

<Directory />
    Options -Indexes
    AllowOverride All


Place the above custom configuration file in your Apache conf directory and restart the
Apache server.

Step 4 : Build Cloud CMS powered jQuery Mobile applications

Let us first build a simple Hello World application (click here to download the full project).

1) Create a simple HTML5/JavaScript project with the Cloud CMS JavaScript driver and all required jQuery Mobile library files.

2) Create a HelloWorld.js file. It will first create an instance of Cloud CMS driver that makes connection to to your Cloud CMS platform using the provided credentials. Once the connection is made, it will then print out the name of the authenticated user.

$(document).bind('pageinit', function() {
  new Gitana({
    "clientId" : "676e3450-6131-46c2-99cc-496aa2ad80fa",
    "clientSecret" : "......"
    "username" : "demo",
    "password" : "demo"
  }).then(function() {
    var authInfo = this.getDriver().getAuthInfo();
    var name = authInfo.getPrincipalName();
    $('.content-primary h1').html('Hello '+name+'! Welcome to Cloud CMS!');

3) Create a hello-world.html file with links to the Cloud CMS JavaScript driver, jQuery Mobile library and the HelloWorld.js file.

<!DOCTYPE html>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="description" content="Hello world example that shows
how to connect to Cloud CMS using Cloud CMS JavaScript driver and
jQuery Mobile framework.">
  <title>Cloud CMS - jQuery UI Mobile Framework - Hello World</title>
  <link rel="stylesheet"
  <link rel="stylesheet"  href="../css/cloudcms.css" />
  <script src="../lib/thirdparty/jquery/jquery.js"></script>
  <script src="../lib/thirdparty/jquery/">
  <script src="../lib/cloudcms/js/gitana.js"></script>
  <script src="../js/basic/HelloWorld.js"></script>
<div data-role="page" class="type-index">
  <div data-role="header" data-theme="a">
    <h1>Cloud CMS jQuery Mobile Examples - Hello World</h1>
    <a href="../index.html" data-icon="home" data-iconpos="notext"
  <div data-role="content">
    <div class="content-primary">
  <div data-role="footer" class="footer-examples" data-theme="c">
    <p>Copyright &copy; 2012 Gitana Software | All Rights Reserved</p>

4) Open the hello-world.html with your browser and we should have a screen which looks like this.

You can find more advanced examples from here. All source code of the examples can be downloaded from

GitHub Project for Cloud CMS jQuery Mobile Examples

To learn more about using Cloud CMS JavaScript driver, you can also check out our documentation site and hosted online samples.

Share this post

comments powered by Disqus