Small Talks/2009/July/Use Garuda to customise Portallayout

Author
Ajeet Singh, India

Date
July 4, 2009

Version
Applicable to zk 3.5.0-F -2009-7-4 and later

Introduction

Gaurda is a component package, it contains GaurdaPortallayout and GarudaPanel. Garuda use to reminiscence the position and states of the panels.

Features

1. Handling the position of the Panels: Garuda provides the functionality that the position of the panel is saved based on its last modified position. This feature is provide using GaurdaPortallayout.

2. Handling the states of the Panels: Garuda also provides the functionality that the states of the panel is saved based on its last state.

 1. Collapse State : The collapse state is saved for each panel. Whether the collapse state is true or false.
 2. Close State : The close state of the panels are persisted. Whether the panels were closed or opened while the user was logging off.

How to Use

1. Copy Garuda jars to the war's lib folder. 
2. Assign unique id to potallayout.
3. Assign unique id to each panel.
4. Specify "use=net.sf.karn.extendedComponent.Garuda.GarudaPortallayout" in portallayout tag.
5. Specify "use=net.sf.karn.extendedComponent.Garuda.GarudaPanel" in panel tag.
6. Implement the datasource

Example

. . .
<portallayout id="zp1" use="net.sf.karn.extendedComponent.Gaurda.GarudaPortallayout">
	<portalchildren width="30%">
		<panel id="panel1" use="net.sf.karn.extendedComponent.Garuda.GarudaPanel" height="150px" title="Google Tools" collapsible="true" closable="true">
			<panelchildren>
                                                   . . .
                                                </panelchildren>
		</panel>
		<panel id="panel2" use="net.sf.karn.extendedComponent.Garuda.GarudaPanel" height="300px" title="LabPixies Clock" collapsible="true" closable="true">
			<panelchildren>
		                   . . .
                                </panelchildren>
		</panel>
	</portalchildren>
	
	<portalchildren width="30%">
		<panel id="panel3" use="net.sf.karn.extendedComponent.Garuda.GarudaPanel" height="300px" title="ToDo" collapsible="true" closable="true">
					</panel>
		<panel id="panel4" use="net.sf.karn.extendedComponent.GarudaPanel" height="100px" title="Wikipedia" collapsible="true" closable="true">
			<panelchildren>
                                       . . .	
		               </panelchildren>
		</panel>
	</portalchildren>
	
	<portalchildren width="40%">
		<panel id="panel5" use="net.sf.karn.extendedComponent.Garuda.GarudaPanel" height="400px" title="Trio" collapsible="true" closable="true">
			<panelchildren>
			   . . .	
                                  </panelchildren>
		</panel>
	</portalchildren>
</portallayout>
. . .

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.