Plugin Gadgets - User manual v1.3.0, v1.4.0, v1.5.0

Introduction
Features
1. Adding a pre-configured gadget
  1. Service parameters
  2. Preview example : Weather
2. Adding a widget container
  1. Service parameters
  2. Service rendering

Introduction

This plugin provides services for adding widgets ( iGoogle or Netvibes) to your pages.

It uses the open source Shindig project, which provides an implementation of OpenSocial standards for rendering gadgets. plugin also supports UWA gadgets.

In addition, it is possible to add feeds RSS or pages HTML to your gadgets.

Features

Adding a pre-configured gadget

Open the add services menu and add the service named Gadget.

This service lets you add a gadget whose parameters (user preferences) can be configured.

In the service settings interface, select the gadget of your choice from the gadget library, and fill in the configuration fields for the chosen gadget.

Service parameters

Parameters	Description	Is it compulsory?
Title	The service title. Leave blank if you don't want a title for this service.	no
Url gadgets	Select the gadget to be inserted. The gadgets available are those defined in your gadget library . This list depends on your application.	yes
Gadget settings	The parameters required by the selected gadget.	yes
Iframe width	The width of the iframe in which the gadget will be inserted.	yes
Iframe height	The height of the iframe in which the gadget will be inserted.	yes
Display	Choice of view used to render the service.	yes

Preview example : Weather

Adding a widget container

Open the add services menu and add the service named Widget container.

This service allows you to add a "free zone" to your page, where visitors can add and configure the gadgets of their choice.

Service parameters

Parameters	Description	Is it compulsory?
Title	Service title Leave blank if you don't want a title for this service.	no
Columns	Number of columns used in the container layout.	yes
Allow drag & drop	Check this box to allow visitors to drag & drop gadgets.	no
Authorize deletion	Check this box to allow visitors to delete gadgets in the container.	no
To minimize	Check this box to allow visitors to minimize container gadgets.	no
Free insertion	Check this box to allow visitors to add their own gadgets (not necessarily from the library).	no
Maximum number of gadgets	The maximum number of gadgets allowed in the container. Leave empty to avoid applying a limitation.	no
Service identifier	This field is used to link or separate service instances. For example: If you want to insert this service twice in the same page and the services use different gadgets, you need to specify different identifiers in this field. If you want to insert this service in two different places (pages), but you want these two zones to share the same gadgets, you need to specify the same identifier for both services in this field.	no
Display	Choice of view used to render the service.	yes

Service rendering

Gadget library overview

Visitors select gadgets to add from those defined in the gadget library.

If free insertion is allowed in the service parameters, visitors can add their own gadgets by specifyingURL .

Overview of a set of widgets in a two-column container

Overview of gadget parameters

If the gadget has user preferences, visitors can modify their own preferences by clicking on the Edit button (often located on the gadget's top bar).

Preferences are saved for the user's next visit.

Moving gadgets (drag&drop)

If drag & drop is enabled in the service settings, visitors can move gadgets within the container.

1 - Drag

2 - Drop