= 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 GUI 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 : guimods


A separate GUI application is created and minor changes should occur on the server side (service improvements or new services for simple tasks like "get groups").


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 X on Y, result was +/-n (m non-voting members).

----

== 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:
{{{
    * GeoNetwork.Catalogue
    * Widgets
          o GeoNetwork.LoginForm
          o GeoNetwork.MetadataResultsToolbar
          o GeoNetwork.MetadataResultsView
          o GeoNetwork.TagCloudView
          o GeoNetwork.Templates
    * GeoNetwork.data
          o GeoNetwork.data.MetadataCSWResultsStore
          o GeoNetwork.data.MetadataResultsStore
          o GeoNetwork.data.MetadataSummaryStore
          o GeoNetwork.data.OpenSearchSuggestionReader
          o GeoNetwork.data.OpenSearchSuggestionStore
    * GeoNetwork.form
          o GeoNetwork.form.OpenSearchSuggestionTextField
    * GeoNetwork.util
          o GeoNetwork.util.CSWSearchTools
          o GeoNetwork.util.SearchFormTools
          o GeoNetwork.util.SearchTools
}}}
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 ?
  * Bugs
   * Layout resize issue in simple/advanced form
 * Server side
  * admin interface
  * add new simple service to get groups, categories, ...
  * Change existing service without banner to try to plug them into other UI
   
   
=== Backwards Compatibility Issues ===


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

== Risks ==

== Participants ==
 * Francois
 * Others welcomed !