= Sandbox for GUI components =

|| '''Date''' || 2010/08/01 ||
|| '''Contact(s)''' || Francois ||
|| '''Last edited''' ||  ||
|| '''Status''' || being discussed ||
|| '''Assigned to release''' || None ||
|| '''Resources''' || Available ||

== Overview ==

The proposal ask for '''creation of a dedicated sandbox''' in order to work on '''new GUI components in order to easily build new GUIs based on GeoNetwork''' server module.


Objectives:
 * Create components to compose Search, Admin, Editor interface
 * Provide a default GeoNetwork UI
 * Provide developers documentation on components
 * Clean existing client code based (removing JS dependencies)
 * Improve existing server services in order to provide simple access to each module (eg. User management, System admin)


These components are written in JS and depends on:
 * !OpenLayers
 * Ext.js
 * (optional) !GeoExt


Sandbox name : guiwidgets


A separate GUI application is created and minor changes should occur on the server side.


Example of a !GeoExt !MapPanel linked to search results :
[[Image(gnclient.png, 500)]]


... 

=== Proposal Type ===
 * '''Type''': GUI Change
 * '''App''': !GeoNetwork client
 * '''Module''': GUI

=== Links ===
 * '''Documents''':
 * '''Email discussions''':
 * '''Other wiki discussions''':

=== Voting History ===
 * Vote proposed by Francois on 2010/08/03
 * result was 
  * +1 Simon, Jeroen, Francois (non PSC members vote on IRC : Jose, Mathieu)
  * +0 Emanuele

----

== Proposal == 
=== Sandbox content ===
The sandbox will be initialize with the current work:
 * The prototype of the library with documentation [1]
 * A collection of examples to illustrate each components [2]
 * A sample application [2]

[1] http://www.opencarto.net/geonetwork/website/docsrc/build/html/dev-jsapi/index.html

[2] http://opencarto.net/geonetwork/apps/js/GeoNetwork/examples/

[3] http://opencarto.net/geonetwork/apps/search

[[Image(gn-js-modules.png, 500)]]



The sandbox will replicate the web module and use svn:external on other modules.


=== Current status ===
Current components are:
 * http://www.opencarto.net/geonetwork/website/docsrc/build/html/dev-jsapi/index.html 
 * and embed the !MapViewer of 2.6 release.


=== On-going work ===
 * Client side
  * How to deal with i18n ? 
   * trying to have one location for all GUI translation
   * XSL service which create a JS file from existing XML file
  * How to deal with role and privileges ?
 * Server side
  * admin interface
  * Change existing service without banner to try to plug them into other UI


==== Editor ====

[[Image(metadata-editor-widget.png, 500)]]

[[Image(metadata-editor-widget-regionslist-in-map-toolbar.png, 500)]]

[[Image(metadata-editor-widget-tabs.png, 500)]]

[[Image(metadata-editor-widget-validation-report.png, 500)]]


   
=== Backwards Compatibility Issues ===


=== New libraries added ===
 * No library added. 
 * Removed : Prototype, Sarissa, Scriptaculous, - to be continued -

== Risks ==

== Participants ==
 * Francois
 * Others welcomed !