[open-ils-commits] [GIT] Evergreen ILS branch rel_2_10 updated. de1b65801b42f701252a749b61ea9bd701942286

[Evergreen Git]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".

The branch, rel_2_10 has been updated
       via  de1b65801b42f701252a749b61ea9bd701942286 (commit)
      from  7ff929013d500a09a79283e19934cb9e74064a74 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit de1b65801b42f701252a749b61ea9bd701942286
Author: Eva Cerninakova <cerninakova at jabok.cz>
Date:   Tue Sep 20 10:36:30 2016 -0700

    Docs: improving documentation for catalog searching widgets
    
    Signed-off-by: Jane Sandberg <sandbej at linnbenton.edu>

diff --git a/docs/opac/search_form.txt b/docs/opac/search_form.txt
index b16e537..f1561da 100644
--- a/docs/opac/search_form.txt
+++ b/docs/opac/search_form.txt
@@ -6,10 +6,12 @@ simple search form to any HTML page. The following code demonstrates
 how to create a quick search box suitable for the header of your web
 site:
 
-.Sample search form
+Simple search form
+------------------
+
 [source,html]
 ------------------------------------------------------------------------------
-<form action="http://example.com/eg/opac/results" method="get">    <!-- <1> -->
+<form action="http://example.com/eg/opac/results" method="get" accept-charset="UTF-8">    <!-- <1> -->
     <input type="search" alt="Catalog Search" maxlength="200"
             size="20" name="query"
             placeholder="Search catalog for..." />
@@ -26,3 +28,68 @@ site:
 <3> Replace ''4'' with the ID number of the organizational unit at which you
     wish to anchor your search. This is the value of the ''locg'' parameter in
     your normal search.
+
+Advanced search form
+--------------------
+
+[source,html]
+--------------------------------------------------------------------------------
+<form role="search" id="searchForm" method="get" class="searchform" action="http://your_catalog/eg/opac/results" accept-charset="UTF-8">
+     <label id="searchLabel" for="search"><b>Search the Catalog: </b></label>
+     <input type="search" value="" name="query" id="search" size="30">   
+     <label id="search_qtype_label"><b>Type:</b> 
+     <select name="qtype" id="qtype"    aria-label="Select query type:">
+        <option value='keyword' selected="selected">Keyword</option>
+        <option value='title'>Title</option>
+        <option value='jtitle'>Journal Title</option>
+        <option value='author'>Author</option>
+        <option value='subject'>Subject</option>
+        <option value='series'>Series</option>
+     </select>
+     </label>    
+   
+     <label id="search_itype_label"><b>Format: </b> 
+     <select id='item_type_selector' name='fi:item_type' aria-label="Select item type:">
+       <option value=''>All Formats</option>
+       <option value='a'>Books and Journals</option>
+       <option value='i'>Nonmusical Sound Recording</option>
+       <option value='j'>Musical Sound Recording</option>
+       <option value='g'>Video</option>
+       </select>    
+     </label> 
+    
+    <label id="search_locg_label"><b>Library: </b>
+    <select aria-label='Select search library'   name='locg'>
+            <option value='1' class="org_unit"> 
+                All Libraries 
+            </option> 
+            <option value='2' selected="selected" class="org_unit"> 
+                 Central Library
+            </option> 
+             <option value='10'   class="org_unit"> 
+                    Little Library
+            </option> 
+     </select>        
+     </label>
+          <input class="searchbutton" type="submit" value="SEarch" />                  
+</form>
+--------------------------------------------------------------------------------
+
+Encoding
+--------
+
+For non English characters it is vital to set the attribute `accept-charset="UTF-8"`  in the form tag (as in the examples above). If the parameter is  not set, records with non English characters will not be retrieved.
+
+Setting the document type
+-------------------------
+
+You can set the document types to be searched using the attribute `option value=` in the form. For the value use MARC 21 code defining the type of record (i.e. https://www.loc.gov/marc/bibliographic/bdleader.html[Leader, position 06]).
+
+For example, for musical recordings you could use `<option value='j'>Musical Sound Recording</option>`
+
+Setting the library
+-------------------
+
+Instead of searching the entire consortium, you can set the Library to be searched in using the attribute `option value=` in the form. For the value use Evergreen database.organization unit ID. 
+
+

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

Summary of changes:
 docs/opac/search_form.txt |   71 +++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 69 insertions(+), 2 deletions(-)


hooks/post-receive
-- 
Evergreen ILS