= Custom Metadata Display  =

|| '''Date''' || 2012/04/19 ||
|| '''Contact(s)''' || [http://wiki.osgeo.org/wiki/User:Jeichar Jesse Eichar] ||
|| '''Last edited''' || ||
|| '''Status''' || draft ||
|| '''Assigned to release''' || 2.8 ||
|| '''Resources''' || R&D Camptocamp ||
|| '''Code''' || https://github.com/camptocamp/geocat/compare/formatter ||
|| '''Ticket''' || #875 ||

== Overview ==

Provide a service for viewing metadata documents with a custom XSL which is identified via the URL, instead of the normal Geonetwork metadata.show.  In addition provide administration tools for managing the XSL files.

=== Proposal Type ===
 * '''Type''': New Service
 * '''App''': !GeoNetwork
 * '''Module''': 

=== Links ===
 
 * '''Email discussions''':
 * '''IRC discussions''':
 
=== Voting History ===

 * None as yet

----

== Motivations ==

Certain Geonetwork installations are used by several districts for similar purposes but occasionally the districts would like the ability to have links to metadata documents that have custom formatting and branding.  A service which can be used to format a metadata according to a custom XSL could be useful in the following use-cases:
 
 * Embed the metadata into other sites
 * Share metadata through some sort of distribution channel that should have a certain type of branding
 * provide a lightweight CSW based search client which displays the metadata with the custom/branded formatting

== Proposal == 

Several new services would be added to the org.fao.geonet.services.metadata.format package:
 
 * Format - Obtain the metadata, localization files, etc... and execute the xsl transform.  
  * Format will have two services mapped to it (html and xml), with respective content types
  * Format services will be accessible by all users
 * RegisterXsl - Service for uploading an xsl file, it will require admin access
 * RemoveXsl - Service for deleting an xsl file, it will require admin access

There will be an Administration User interface for managing the XSL files.

=== Backwards Compatibility Issues ===

No compatibility issues

== Risks ==

Nothing notable

== Participants ==
 * As above