Organizing the Portal

WSO2 Gadget Server portal provides a comprehensive set of features. The portal user can perform actions such as add, remove, copy and move. Apart from that, each gadget can be configured using gadget specific configurations.

Managing Portal Themes

Portal users can select their desired themes and activate them on gadget server portal.Selection of desired themes can be done either by uploading new user specific custom themes or either by selecting from pre-defined GS portal themes.















When a portal user is going to upload his own custom theme,he has to upload a zip file which should adhere to a specific tree structure.Following tree shows such a hirarchy for a predefined theme called "GS-Dark".

.
|-- black.png
|-- images
|   |-- 1px.gif
|   |-- addGadgetsBg.jpg
|   |-- arrow_right.gif
|   |-- dashboard.gif
|   |-- defaultGadgetsBg.jpg
|   |-- gadget-close.gif
|   |-- gadgetDescriptionBg.jpg
|   |-- gadget-settings.gif
|   |-- gadget-toggle-down.gif
|   |-- gadget-toggle-settings.gif
|   |-- gadget-toggle-up.gif
|   |-- gs-header-logo.gif
|   |-- hide.gif
|   |-- infoCardBg.jpg
|   |-- loading.gif
|   |-- loginPageImage.jpg
|   |-- logoBg.jpg
|   |-- mainBg.jpg
|   |-- mainTabsBg.jpg
|   |-- maximize.gif
|   |-- minimize.gif
|   |-- myshadow.png
|   |-- powered_gadget_server.gif
|   |-- show.gif
|   |-- spacer.gif
|   |-- table-header.gif
|   |-- tabsBg.jpg
|   `-- Thumbs.db
|-- localstyles
|   `-- gadget-server.css
`-- theme-conf.xml
 

Theme config file describes the theme configuration such as theme name,author,css file path,thumbnail,description about the theme. The configuration for the "GS-Dark" theme is as follows.

<resource path="/themes/test-2/conf" isCollection="true">
	<mediaType>application/octet-stream</mediaType>
	<properties>
		<property key="name">GS Dark</property>
		<property key="author">WSO2</property>
		<property key="css.name">localstyles/gadget-server.css</property>
        	<property key="thumb">black.png</property>
        	<property key="description">The theme is clean and simple all to help you get a stylish and functional look.
        	Theme is also designed with customization in mind. Meaning, with a little work, the theme can be completely personalized.
		</property>
        </properties>
</resource>

Hence a gadget server user can create their specific custom themes and upload them easily by looking in to the samples given above.

Configuring Gadgets

By default the gadget authors can set gadget preferences for each gadget. These preferences can be viewed and modified by the users by opening the settings drop down in gadgets preferences.

Tabs / Cloning

New Tab

The portal facilitates the addition of new tabs with customized layouts to accommodate more gadgets.Users can add new tabs by giving a name and selecting a layout for each newly created tab from the provided six predefined layout templates.Finally the portal creates an empty gadget layout page.















After a new tab created,add gadgets into it.To display the added gadgets according to the selected customized layout,simply drag and drop them.

Cloning

A Portal user can clone an available tab to be used as the foundation for a new tab.

Moving / Copying Gadget

Moving a gadget

Gadgets Can be moved from one tab to another. Once a gadget is moved, the user can either remove the old gadget from it's previous location or keep it as it is.

Copy a gadget

Gadgets Can be copied to the same tab as a new gadget.

Finding Gadget Details

Once the gadget is added, the user can inquire the gadget details by clicking on about gadget in the preferences menu.