Sample Site Guide



The Cloud CMS Sample Site provides a collection of pre-built sample content, forms, definitions, workflow models and more. It is offered as a means for demonstrating some of the features of Cloud CMS. It is not intended as a finished product or solution but rather as an example of how the features and capabilities of Cloud CMS can be brought together to deliver a compelling deliver for your project, application or team.

The Cloud CMS Sample Site includes a hosted sample web site that is automatically deployed for you to the Cloud CMS hosting tier (*.cloudcms.net). This tier lets you run your web site or web application in the cloud but also lets you extend the public facing API through customizations to Node.js should you desire to do so.

See how to "Build your prototype website in 10 easy steps" with Cloud CMS

There are many possible Use Cases and features that could be included in the Sample Site as we go forward. Our intention is to provide real-world examples and a kitchen-sink of features so that you can jumpstart your own implementations. We're always interested in feedback as to what we should add next! Please let us know your thoughts regarding what is important to you.


Installation

If you don't yet have a Cloud CMS account, you will need to create one: request a trial account. The Cloud CMS Sample Site is installed when you select "Web Content Management" for the start project when you first sign into your trial.

You can also install or re-install the Cloud CMS Sample Site at any time by creating a new project and picking "Sample Project" from within the wizard.


What's Inside?

The Cloud CMS Sample Site provides a suite of sample data and pre-built use-cases:

  • Browse the Cupcakes Catalog

    A basic product inventory system that uses classifiers to select and display content, product information, ratings and reviews within a public facing web site.

  • Check out the Travel Guide

    An online guide that allows users to discover travel options and routes between cities along with prices, arrival and departure times and destination information.

  • Deploy to the Cloud

    Deploy the pre-built web site from GitHub to our Cloud Hosting servers. Your web site will be given its own URL and will be available online in a matter of moments.

  • Make updates to the Sample Web Site

    While you're free to build your front-end any way you'd like, we've provided a simplified GitHub project that you can fork and deploy. Make updates and push your changes live!

  • Build your own Mobile and Web Apps

    If you want to prototype out or connect your own Mobile or Web App to Cloud CMS, you can use the Sample Site content as an easy way to get started!

  • Next Steps

    Find out about more things you can do with the Sample Site!


Cupcakes Catalog

Background

This sample site is for managing Cupcake content and includes the content types for a cupcakes, reviews and reviewers. It will show how content can be managed, and then deployed out to a hosted website in Cloud CMS. We have created an html website to present the your content in a familiar setting. The html code is in github since this is a common developer practice.

  • Catalog Product (Cupcake)
  • Person (Reviewers)
  • Catalog Product Review (Cupcake Review by a Reviewer)

View Documents and Associations

  • Navigate to a Product folder (Home/Samples/Catalog/Products)
  • Double click "Chocolate Delight" or any other cupcake
  • Able to view image and metadata

Edit

  • Select "Properties" from the dropdown
  • Form is displayed
  • Update some content in the Body field
  • SAVE changes

View updated Content in the deployed Website

Navigate though Cupcake sample Website

  • Select "Product Catalog"
  • Select the cupcake you updated
  • You will see your change (you may need the refresh and clear Cache to see any updates)

Add a new piece of content

  • Navigate to a Product folder (Home/Samples/Catalog/Products)
  • In the Actions dropdown select "Create a Document"
  • Choose Content type: select "Catalog Product" for Cupcakes
  • The default content entry form is displayed for "Catalog Product"
  • Enter content in the fields
  • Save
  • Add an image
    • Open up the newly created cupcake
    • Select "Upload Attachment" in Document Actions
    • Either drag and drop a file or use the file selector

Travel Guide

Background

This sample site is for managing Cities, Airlines, and Routes. It will show how content can be managed, and then deployed out to a hosted website in Cloud CMS. We have created an html website to present the your content in a familiar setting. The html code is in github since this is a common developer practice.

  • Guide City (Cities)
  • Guide Providers (Airlines)
  • Routes (Association: City to City route)

View Documents and Associations

  • Navigate to a Cities folder (Home/Samples/Guide/Cities)
  • Double click "Barcelona" or any other City
  • Able to view image and metadata

Edit

  • Select Properties from the dropdown
  • Form is displayed
  • Update some content in the Body field
  • SAVE changes

View updated Content in the deployed Website

Navigate though City Guide sample Website

  • Select "City Guide"
  • Select the city you updated
  • You will see your change (you may need the refresh and clear Cache to see any updates)

Add a new piece of content

  • Navigate to a Cities folder (Home/Samples/Guide/Cities)
  • In the Actions dropdown select "Create a Document"
  • Choose Content type: select "Guide City" for Cities
  • The default content entry form is displayed for "Guide City"
  • Enter content in the fields
  • Save
  • Add an image
    • Open up the newly created City
    • Select "Upload Attachment" in Document Actions
    • Either drag and drop a file or use the file selector

Deployment

A hosted sample website has been created for you within Cloud CMS. The default deployment is set in Applications -> Deployments:

  • "More" dropdown
  • Select "Applications"
  • Select "Deployments"
  • The default deployment is setup for the sample site. It will look something like http://391e7601-93e4-4cb4-abf5-8419845cdb06-hosted.cloudcms.net
  • Click the URL to go to the deployed Sample Website

Source Code

  • The path is set in Applications -> Source
  • For the Sample site we have placed the html in Github
  • You have access to the code in Github so you are free to fork it, extend it and dig into it to learn about how it works.

Building your own Apps

The Sample Site content provides a great starting point for building your own apps. If you've got a front-end going and you want to get at some good content, then we encourage you to go for it! Query against it, search for it, retrieve it, create new content - anything you like.

To connect, all your need to do is get the developer API Keys for connecting to your Cloud CMS Application instance. You can do this by logging in to Cloud CMS and clicking on the Developers link at the top of the page.

Once you have those keys, please read through the Developers Guide. We've provided guidance for building your first apps on top of Node.js, Android, JavaScript/HTML and many other frameworks.


Next Steps

We recommend you do the following with the Sample Site:

  • Navigate and go crazy with updates
    • Note: there are no guarantees the sample website will work with all your changes. Potentially you may need to modify the frontend html code
  • Review the content types, forms, application configuration, frontend code
  • Let us know if Cloud CMS may be a fit for you and you need help with your solution

Once you've done all that, be sure to check out this stuff as well!