This widget places an Iframe or a button for a popup, that has fields to search the attributes of the layers, 
and to zoom to objects that match the query.


----------------------------------------------------------------------------------------------------




#################### Example of implementation: ####################



- inside IFRAME (embedded):

<cwc2 type="LocateByAttribute" searchall="true" zoombuffer="500" popupheight="90" popupwidth="400" highlight="true" allowdownload="true" popup="false" VISIBLE="TRUE"/>


- or as a button that shows a POPUP:

<cwc2 styleresource="TextButtons" popupstyleresource="TextButtons" popupwidth="460" popupheight="215" Toolbar="false" Status="false" Menubar="false" Scrollbars="false" Image="icons/icon_locate.png" ImageTip="Search by the value of an attribute to find the matching objects" Label="Find By Value" type="LocateByAttribute" searchall="true" zoombuffer="500" highlight="true" allowdownload="true" popup="true" VISIBLE="TRUE">
   <image state="normal"/>
   <image state="selected"/>
   <image state="hover"/>
</cwc2>


######################################################################
These attributes are specific to the widget:

- POPUP is an optional parameter; if it is true, the searchpage is launched in a popup window from a button, otherwise an IFRAME is embedded
- POPUPHEIGHT is the height of the IFRAME or the WINDOW
- POPUPWIDTH is the width of the IFRAME or the WINDOW
- SEARCHALL is an optional parameter; if it is true, all attributes in all layers are searcheable.
- ZOOMBUFFER is an optional parameter; if it exists, its value is the buffer around the result. 
  If it doesn't exist, points are re-centred to instead. Its value is always in metres, and will be automatically converted 
  to the units of the projection. PREVIOUSLY CALLED POINTZOOMBUFFER
- HIGHLIGHT is an optional parameter; if it is true, the searchresults are highlighted. Note: requires a little 
  more processing time (for creation of temporary shapefile).
- ALLOWDOWNLOAD is an optional parameter; if it is true, the searchresults are downloadable as a zipped shapefile.
     ----> Note: This functionality is a potential copyright issue (if shapefiles are confidentail). Remove download.php if 
  	   you are concerned someone might steal your data.
- MAXNUMRESULTS is an optional parameter, specifying at how many results the application should stop searching. This can help 
increase overall performance, and prevent sending a huge HTML result back to the user.

The other attributes belong to the styleresource and popup functionalities
------------------------------------------------------------------------------------------------------------------------



If you do not use the SEARCHALL parameter, you must manually specify in the mapfile that you want 
certain layers and attributes to be searchable:

Place these tags in the metadata section of the layer that you want to be queryable:

   SPATIALSEARCH "ATTRIBUTE1,ATTRIBUTE2,ETC"       # holds a comma separated list of searchable attributes. 
                                                   # if value is 'ignore', this layers gets ignored when 'searchall' is true
   SPATIALSEARCHLIST "ATTRIBUTE3,ATTRIBUTE7,ETC"   # holds the attributes to be shown in the list of matching objects.


----------------------------------------------------------------------------------------------------



LASTLY (This goes wrong often!!!!!!!!!!!!!!!!!!!!!!!!!!!!!):

This widget is oficially in BETA STAGE. so make sure it matches the maturity level specified in
your chameleon.xml file!!!!!








------------ Usage with Ka-map --------------------- experimental


Place this in the HEAD section:

<script type="text/javascript" src="LocateByAttribute/LocateByAttribute_functions.js"></script>

And this anywhere in the body:

<IFRAME ID='searchByLocation' BORDER=0 HEIGHT=90 WIDTH=250 FRAMEBORDER=0 SRC='LocateByAttribute/search.phtml?standalone=true&usejavascript=true&maxnumresults=10&searchall=true&zoombuffer=500&allowdownload=true'></IFRAME>