Content Glass CG-Button is a web application that let users of website to share widgets with friends. In addition the web admin of a website that install Content Glass, using the managed-app installation approach that integrate website install with CG service portal, can also share widgets with all users (public scope), define pages where widgets created by users are shared publicly, view report of widgets created on the website and perform other operations on widgets, which are not allowed for ordinary users.

A widget in the scope of this book is a piece of software (mini-app) running on a website by Content Glass engine. We will discuss with widgets that has some User-Interface although this is not mandatory. CG applications can create widgets for various tasks that does not show any UI. widgets for example can be used by application to store some settings ib the context of some conditions.

Widgets managed by Content Glass API are stored on the cloud and are loaded into website given some condition. We define the set of conditions that cause widget to be loaded as state. And we define the practice of associating data (in this case in the form of widgets) with state and exposing the data given some state conditions occur - State Oriented Sharing.

Content Glass is therefore a platform for creating state Oriented Sharing applications and in this book we focus on specific environment - web, where state-oriented information is presented or act (as said, not all widgets have UI) in the for of widgets - mini apps run on a website at some given condition.

Most of the widgets we will discuss here as associate with a state defined by web URL that may be as address of web page, an address of website domain or a top-level domain shared by multiple websites. However Content Glass widgets are not limited to these three type of states. In fact Content Glass is build and design to handle multi dimensional states. For example state may compose web address together with some user properties together with location. One of the sample CG applications I developed was a simulation of run-dime advisory system that shows medical advice to surgery-room team based on physical measurements of the patient. I bring this as an example of more sophisticated state-oriented-sharing use case. In this case a state was defined as combination of three measurements taken from patient. Anyway the issue of developing state-oriented-sharing apps using simple/complex states is an advanced issue targeted to Content Glass apps developers and is out of scope. The only important thing now is to understand the basic concept of state-oriented-sharing.

Anyway, most of the widgets that will be discussed here use the URL of a webpage or the Website domain as associated state. Meaning that if a widget was shared in association with web-page it will be presented to the peers-group set by owner when other peers visit this same web page. And if a widget is associated with website domain, if will be presented to peers-group when visiting the website where widget was created.

This guide explain how to use widgets provided by CG-Button. While working with widgets such as note or video box may be handled intuitively, working with other widgets such as Personalization, Shopping list, connectors, HTML-Box etc' may requires some guiding which is intend to be provided by this users manual.